Com os webhooks, a OmniChat avisa o seu sistema na hora em que algo acontece nos seus atendimentos e campanhas. Pode ser um ERP, um CRM ou uma automação. Você cadastra um endereço (o endpoint), escolhe os eventos e passa a receber cada um deles em tempo real.
Artigos sobre webhooks
Como cadastrar, editar, pausar e excluir um webhook: o passo a passo na tela.
Referência de eventos e campos: o que chega no seu endpoint, com exemplos.
Como a entrega funciona: requisitos do endpoint, ordem dos eventos e tentativas.
Histórico de entregas e erros comuns: como acompanhar as entregas e resolver falhas.
Perguntas frequentes sobre webhooks: respostas rápidas.
Para que servem
Atualizar o CRM quando um atendimento é encerrado ou muda de etapa no funil.
Registrar no seu sistema as mensagens recebidas e enviadas.
Acompanhar o status de entrega das mensagens de campanha.
Disparar uma automação quando um contato responde a uma campanha.
Eventos disponíveis
Origem | Evento na tela | Quando acontece |
Atendimentos | Atendimento roteado | Quando um atendimento é encaminhado para um agente ou time. |
Atendimentos | Atendimento encerrado | Quando um atendimento é finalizado. |
Atendimentos | Mudança de etapa no funil | Quando um atendimento muda de etapa no funil (pipeline). |
Atendimentos | Mensagem recebida | Quando o contato envia uma mensagem em um atendimento. |
Atendimentos | Mensagem enviada | Quando uma mensagem é enviada ao contato em um atendimento. Notas internas não são enviadas. |
Atendimentos | Status da mensagem | Quando o status de entrega de uma mensagem enviada por campanha ou por outra origem, como a API, muda (enviada, entregue, lida ou falha). Mensagens dos agentes no atendimento não geram este evento. |
Campanhas | Resposta de campanha | Quando um contato responde a uma mensagem de campanha (botão ou texto livre). |
Campanhas | Status da mensagem de campanha | Quando o status de entrega de uma mensagem de campanha muda (enviada, entregue, lida ou falha). |
Os detalhes de cada evento, com exemplo e campos, estão no artigo Referência de eventos e campos.
O que você precisa ter
Um endpoint HTTPS que aceite chamadas POST com corpo JSON.
Alguém que prepare esse endpoint para responder rápido e validar a autenticação. O artigo Como a entrega funciona explica os requisitos.
Webhooks antigos
Os webhooks antigos agora são legado. Eles continuam funcionando, mas não recebem novidades. Para novas integrações, use os webhooks desta tela. A documentação deles continua em Webhooks OmniChat (legado) e Webhooks para mensagens (legado).