Introdução


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 HSM
  • url_attendance_callback - Callback de atendimentos
  • url_report_webhook - Callback de relatórios
  • url_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

WebhookDescrição
Atendimentos WhatsAppMensagens trocadas no atendimento
HSM WhatsAppStatus dos disparos de WhatsApp
Estatísticas de CampanhaEstatísticas de campanhas em lote
Mensagens de BotMensagens recebidas por bots
Fechamento de TicketFechamento manual de tickets
SMS DLRCallback de envio SMS
SMS MOCallback de resposta SMS
RelatóriosNotificação de relatórios prontos
TicketsMensagens de ticket em tempo real