Tema
Webhooks
Um webhook avisa outro sistema, em tempo real, quando algo acontece no atendimento: uma conversa foi resolvida, um contato foi criado, uma avaliação foi registrada. É o caminho contrário da chave de API: lá o seu sistema chama o Konversia, aqui é o Konversia que chama o seu sistema.
Só o dono
Funcionário não enxerga esta área.
Criar um destino
Informe o endereço HTTPS que vai receber os eventos e marque quais eventos esse destino deve receber. Um mesmo evento pode ir para vários destinos, e cada destino pode escolher um conjunto diferente de eventos.
O endereço precisa ser público: endereços internos, como os de uma rede privada, não são aceitos. Cada empresa pode cadastrar até 5 destinos.
O segredo aparece uma única vez
Ao criar o destino, um segredo é gerado e mostrado uma vez só. Ele serve para o seu sistema confirmar que a entrega realmente veio do Konversia. Copie e guarde num lugar seguro antes de sair da tela: não existe como recuperá-lo depois. Se perder, remova o destino e crie outro.
Os eventos disponíveis
| Evento | Quando acontece |
|---|---|
| Mensagem recebida | O cliente final enviou uma mensagem. Serve para replicar a conversa em outro sistema ou disparar um alerta. |
| Status de mensagem mudou | Uma mensagem enviada pela empresa teve seu status de entrega atualizado, por exemplo entregue, lida ou falhou. Serve para acompanhar se o envio chegou ao destino. |
| Atendimento iniciado | Uma conversa nova começou com um cliente. Serve para registrar a chegada de um lead ou abrir um chamado em outro sistema. |
| Atendimento atribuído | Um atendente foi colocado ou removido de uma conversa. Serve para manter a fila de trabalho sincronizada com outra ferramenta. |
| Atendimento resolvido | A conversa foi marcada como resolvida. Serve para fechar um chamado espelhado ou disparar uma pesquisa de satisfação externa. |
| Atendimento reaberto | Uma conversa que estava resolvida voltou a ficar em aberto. Serve para reabrir o chamado correspondente em outro sistema. |
| Contato criado | Um contato novo foi cadastrado a partir de uma conversa do WhatsApp. Serve para criar o registro correspondente em um CRM externo. |
| Contato atualizado | Nome, telefone, e-mail ou bloqueio de um contato mudou. Serve para manter os dados do cliente sincronizados em outro sistema. |
| Avaliação registrada | O cliente respondeu a pesquisa de satisfação. Serve para alimentar relatório ou avisar alguém quando a nota é baixa. |
| Cliente mudou de etapa no funil | Um cliente do CRM avançou ou voltou de etapa no funil de vendas. Serve para manter o funil sincronizado com outra ferramenta. Só existe para empresas com o módulo de CRM ligado. |
Quando um destino para de responder
Cada entrega que falha é tentada de novo automaticamente, com o intervalo entre tentativas aumentando a cada vez, ao longo de cerca de 9 horas. A escala de espera entre uma tentativa e a próxima é: imediata, 1 minuto, 5 minutos, 30 minutos, 2 horas e 6 horas (seis tentativas ao todo). Se o mesmo destino acumular falhas demais seguidas, ele é desligado sozinho: para de receber eventos até que você remova e cadastre de novo, já com o problema do seu lado corrigido.
Isso também acontece na hora se o próprio destino avisar que não existe mais (por exemplo, quando o cenário do Zapier ou do Make foi apagado do outro lado).
Reenviar uma entrega
Só a entrega marcada como Perdida mostra o botão de reenviar. Perdida quer dizer que as seis tentativas automáticas acabaram e ela não vai mais ser tentada sozinha, então o reenvio manual é a única saída.
Uma entrega marcada como Falhou ainda está na fila de tentativas automáticas e não precisa de reenvio: se você corrigiu o problema do seu lado, a próxima tentativa já vai encontrar tudo funcionando.
Histórico
A aba mostra as entregas mais recentes de todos os seus destinos, com situação, resposta e número da tentativa, para ajudar a depurar a integração. O histórico é mantido por 30 dias.