Webhooks
Os webhooks permitem que sua aplicação receba notificações em tempo real sobre eventos do Nexus. Quando um evento ocorre, o Nexus envia uma requisição HTTP POST para a URL configurada com os dados do evento.
Configuração
WhatsApp e Relatórios
Configure as URLs de webhook através do endpoint POST /whatsapp/config/ com os campos:
url_hsm_callback- Callback de HSMurl_attendance_callback- Callback de atendimentosurl_report_webhook- Callback de relatóriosurl_tickets_webhook- Callback de mensagens de ticket em tempo real
SMS
Para SMS, as URLs são configuradas no corpo da requisição ao enviar a mensagem:
url_callback_dlr- Callback de status de envio (DLR)url_callback_mo- Callback de respostas (MO)
Retentativas
Caso a API retorne erro, serão feitas novas tentativas de envio imediatos. Caso o erro persista, serão feitas novas tentativas espaçadas ao longo do dia. Não são feitas novas tentativas em caso de erro 4xx.
Webhooks Disponíveis
| Webhook | Descrição |
|---|---|
| Atendimentos WhatsApp | Mensagens trocadas no atendimento |
| HSM WhatsApp | Status dos disparos de WhatsApp |
| Estatísticas de Campanha | Estatísticas de campanhas em lote |
| Mensagens de Bot | Mensagens recebidas por bots |
| Fechamento de Ticket | Fechamento manual de tickets |
| SMS DLR | Callback de envio SMS |
| SMS MO | Callback de resposta SMS |
| Relatórios | Notificação de relatórios prontos |
| Tickets | Mensagens de ticket em tempo real |
