Webhooks são notificações automáticas que a OmniChat envia para o seu sistema sempre que um objeto é alterado na plataforma — como um novo pedido, uma conversa encerrada ou uma mensagem recebida. É a forma mais eficiente de manter sistemas externos sincronizados em tempo real.
ℹ️ Se você deseja receber notificações específicas de mensagens, consulte o artigo Webhooks para Mensagens na Central de Ajuda.
Como configurar
Defina um endpoint no seu sistema para receber as notificações
Exemplo: https://my.sistema.com/webhook/Informe esse endereço ao time de suporte da OmniChat para que a configuração seja ativada
Formato das notificações
Sempre que um objeto for alterado, a OmniChat enviará uma requisição POST com a seguinte estrutura:
Campo | Tipo | Descrição |
| string | Identificador do objeto alterado |
| string | Tipo do objeto (ex: Message, Order, Chat) |
| string | Tipo do evento ocorrido |
| number | Momento do disparo (Unix timestamp) |
ℹ️ O payload contém apenas o identificador do objeto. Para buscar todas as informações, faça uma consulta à API OmniChat usando o objectId recebido.
Casos de uso comuns
Atualizar pedidos no ERP quando o status mudar na OmniChat
Disparar fluxos automatizados ao encerrar um atendimento
Registrar mensagens em sistemas de análise ou CRM externo
Sincronizar dados de clientes entre plataformas
✅ Com Webhooks, seus sistemas externos se atualizam automaticamente — sem polling, sem atrasos.