Conecte outros programas: API, webhooks e alertas no Slack ou Teams

Em Integrações (em Configurações) você pode conectar o Kaam360 a outros programas. Isso faz parte do pacote Business. Só administradores podem abri-lo.

Leia seus dados com uma chave de API

1. Abra Configurações e escolha Integrações.
2. Em Chaves de API, digite um Nome (por exemplo Zapier ou Planilha da contabilidade) e pressione Criar chave de API.
3. Copie a chave que aparece. Ela é mostrada só uma vez. Qualquer pessoa com a chave pode ler todos os dados da sua organização, então mantenha-a em segredo.
4. Entregue a chave ao programa. Ele a envia no cabeçalho Authorization: Bearer .... A página Como usar a API mostra os endereços e um exemplo.
5. Uma chave só pode ler, a não ser que você marque Permitir que esta chave adicione leads ao criá-la. Então ela também pode adicionar novos leads (veja abaixo). Ela nunca pode alterar nem excluir mais nada. Pressione Revogar para bloquear uma chave na hora. Uma chave também deixa de funcionar quando a pessoa que a criou é desativada em Usuários; crie uma nova a partir da conta de outro administrador.

Use o Zapier ou o Make

O Zapier e o Make são serviços que ligam programas entre si sem nenhuma programação. Você não precisa de um aplicativo especial do Kaam360 para eles.

1. Crie uma chave de API como acima. Marque Permitir que esta chave adicione leads se quiser que formulários, anúncios ou planilhas enviem leads para o Kaam360.
2. No Zapier ou no Make, escolha uma etapa que chame um endereço da web (no Zapier: Webhooks by Zapier; no Make: HTTP). Use o cabeçalho Authorization: Bearer ... com a sua chave.
3. Para ler dados, chame os endereços listados em Como usar a API (por exemplo /api/v1/leads ou /api/v1/deals). Para adicionar um lead, envie um POST para /api/v1/leads com o sobrenome ou o e-mail do lead.
4. A página Como usar a API também tem um link para /api/v1/openapi.json, a API inteira descrita por escrito. Desenvolvedores e ferramentas podem lê-la. O guia completo para desenvolvedores, com a API mais nova (versão 2), está em /developers.
5. Para ser avisado quando algo acontece, use Outro programa (JSON assinado) em webhooks.

Receba alertas no Slack ou no Microsoft Teams

1. No Slack ou no Teams, crie um incoming webhook para o canal desejado e copie o endereço da web dele.
2. Em Integrações, em Webhooks e alertas de chat, digite um Nome, escolha Um canal do Slack ou Um canal do Microsoft Teams e cole o Endereço da web.
3. Em Avisar quando, marque o que você quer saber. Não marque nada para saber de tudo.
4. Pressione Adicionar endereço e depois Enviar teste. Uma mensagem curta de teste deve aparecer no canal.

Avise outro programa

1. Escolha Outro programa (JSON assinado) e digite o endereço da web dele. Ele deve começar com https:// e estar na internet pública.
2. Copie o segredo de assinatura que aparece. Ele é mostrado só uma vez. O outro programa o usa para conferir se uma mensagem veio mesmo do Kaam360.
3. Cada mensagem é um JSON com um id, o nome do evento, um breve resumo e os principais detalhes. Use a API para buscar o registro completo.
4. Cada mensagem é assinada: o cabeçalho X-Kaam360-Signature contém um HMAC-SHA256 do horário de envio (X-Kaam360-Timestamp) e da mensagem. Quem recebe deve recusar uma mensagem com mais de cinco minutos, para que uma mensagem copiada não possa ser enviada de novo mais tarde. O guia para desenvolvedores tem código pronto para essa verificação.
5. Para alterar um endereço, seus eventos ou sua observação, pressione Editar. Se o segredo puder ter vazado, pressione Novo segredo de assinatura: o antigo para de funcionar na hora, então entregue o novo ao outro programa imediatamente.

Do que você pode ser avisado

Um cliente ou um lead foi adicionado, um negócio foi ganho ou perdido, um projeto foi criado ou alterado, uma tarefa foi adicionada, alterada ou concluída, uma fatura foi criada, emitida (enviada), paga ou anulada, um pagamento de projeto passou para outra etapa, um contrato foi assinado e um chamado de suporte foi aberto.

O registro de entregas

O Registro de entregas lista todas as mensagens das últimas duas semanas: quando foram enviadas, para qual endereço, a resposta de quem recebeu (o código de status e quanto tempo levou) e o resultado.

1. Escolha um endereço, um resultado (Entregues, Aguardando nova tentativa, Abandonado) ou um evento para ver só esses.
2. Pressione Mostrar o que foi enviado para ver a mensagem e o início da resposta de quem recebeu.
3. Pressione Enviar novamente para enviar mais uma vez uma mensagem entregue ou abandonada. Ela mantém o mesmo id, para que quem recebe saiba que é uma repetição.

Se algo der errado

• Se quem recebe estiver fora do ar, o Kaam360 tenta de novo após 1 minuto, 5 minutos, 30 minutos, 2 horas e 12 horas, e então desiste.
• Um endereço que falha 15 vezes seguidas é desativado, e todos que podem gerenciar integrações recebem um e-mail. Um aviso vermelho na página diz quando isso aconteceu. Corrija o problema, pressione Retomar e depois envie de novo as mensagens perdidas pelo Registro de entregas.
• Endereços dentro de uma rede privada (como localhost, 10.0.0.1 ou 192.168.1.5) não são permitidos, e isso é verificado de novo a cada mensagem enviada.
• Se você não vê Integrações, talvez o seu pacote não o inclua, ou a sua função não tenha a permissão "Gerenciar integrações".