🔔 O que é um webhook?
Um webhook é uma notificação automática enviada pelo Klivo Chat para um endpoint externo (URL) quando um evento específico ocorre — como uma nova mensagem recebida ou uma conversa resolvida. Em vez de o seu sistema consultar o Klivo Chat repetidamente, o webhook "empurra" a informação em tempo real.
📋 Eventos disponíveis
conversation_created— nova conversa criadaconversation_status_changed— status de conversa alteradoconversation_updated— conversa atualizadamessage_created— nova mensagem enviada ou recebidamessage_updated— mensagem atualizadawebwidget_triggered— widget de chat aberto pelo usuáriocontact_created— contato criadocontact_updated— contato atualizadoconversation_typing_on— status de digitação ativadoconversation_typing_off— status de digitação desativado
🛠️ Criando um webhook
Acesse Configurações → Integrações → Webhooks
Clique em Configurar. Disponível para administradores.
Clique em "Adicionar Novo Webhook"
Um formulário de configuração será exibido.
Insira a URL do endpoint
Deve ser uma URL HTTPS pública que aceite requisições POST. Não pode ser localhost.
Selecione os eventos
Marque apenas os eventos que seu sistema precisa receber. Evite assinar eventos desnecessários.
Salve e teste
Clique em Salvar e depois forçe uma atualização dentro do que foi assinalado para enviar uma requisição de teste ao seu endpoint.
📦 Exemplo de payload
O Klivo Chat envia os dados em formato JSON via POST. Exemplo para o evento message_created:
{
"event": "message_created",
"id": "1",
"content": "Olá, preciso de ajuda!",
"message_type": "incoming",
"created_at": "2026-05-01T14:30:00Z",
"conversation": {
"id": 42,
"status": "open",
"inbox_id": 3
},
"contact": {
"id": 17,
"name": "João Silva",
"phone_number": "+5511999990001"
}
}Use ferramentas como webhook.site ou RequestBin para inspecionar os payloads recebidos durante o desenvolvimento, antes de integrar com o sistema definitivo.