Pular para o conteúdo principal
As URLs de notificação permitem enviar eventos do WhatsApp para sistemas externos em tempo real, tanto dos seus modelos quanto das suas mensagens service. Em Configurações você pode criar uma URL associada a um canal específico.
Isso proporciona controle independente baseado no fluxo ou caso de uso.

Para que servem?

Permitem que seu sistema receba automaticamente informações quando um evento ocorre em uma campanha ou mensagem. Por exemplo:
  • Confirmar que uma mensagem foi lida
  • Detectar uma falha de envio
  • Registrar quando um usuário responde
Tudo sem intervenção manual.

Como configurar uma URL de notificação

Ao criar uma nova URL, você precisará:
  1. Selecionar os eventos que deseja receber. Escolha pelo menos um em qualquer um dos dois seletores:
    • Eventos de modelos: Entregue no canal, Entregue ao usuário, Lido, Falha e Resposta.
    • Eventos de mensagens service: Entregue no canal, Entregue ao usuário, Lido e Falha.
  2. Informar a URL de destino (endpoint).
  3. Definir o tipo de autenticação que o endpoint usará.
Cada configuração é feita por canal, o que permite personalizar a integração de acordo com a lógica de cada fluxo.
Para receber eventos do tipo Leitura, o usuário do WhatsApp deve ter a função de confirmações de leitura (tiques azuis) habilitada no seu dispositivo. Se o usuário tiver essa opção desativada, a plataforma não receberá a notificação de leitura e, portanto, o evento não será enviado para sua URL de notificação.

Eventos de mensagens service

As mensagens service são as que seu canal ou seus operadores enviam e que não são modelos. Os status delas são notificados com os mesmos tipos de autenticação dos eventos de modelos.
  • Você pode criar uma URL só para mensagens service ou adicionar esses eventos a uma URL existente. Nesse caso, a URL continua recebendo os eventos de modelos.
  • O payload inclui "type": "service" para que você o diferencie dos eventos de modelos.
  • Não inclui campaignId nem template, porque essas mensagens não pertencem a uma campanha.
  • O campo error só aparece no status FAILED.
  • Nos canais da Gupshup, id corresponde ao ID que a Gupshup atribui à mensagem (gsId).
  • Não existe o evento Resposta, porque ele só se aplica aos botões de um modelo.
Os status podem chegar em uma ordem diferente da real. Por exemplo, DELIVERED_USER pode chegar antes de DELIVERED_CHANNEL. Use timestamp para ordená-los.

Benefícios

Maior flexibilidade
Você pode definir uma URL para um evento específico ou agrupar todos em uma só.
Mais segurança
Configure o método de autenticação que melhor se adapta ao seu ambiente técnico.
Administração mais simples
Menos configurações duplicadas e melhor organização.
Melhor experiência operacional
Interface clara para gerenciar notificações de forma organizada e eficiente.
As URLs de notificação são essenciais quando você precisa integrar a Jelou com um CRM, sistemas internos ou ferramentas de analytics em tempo real.

Exemplos de eventos

A seguir estão exemplos do payload que você receberá na sua URL de notificação de acordo com o tipo de evento:

Modelos

Enviado quando a mensagem não pôde ser entregue.
Enviado quando a mensagem foi entregue ao canal (WhatsApp).
Enviado quando a mensagem foi entregue ao dispositivo do usuário.
Enviado quando o usuário leu a mensagem.
Este evento só é recebido se o usuário tiver as confirmações de leitura (tiques azuis) habilitadas no WhatsApp.
Enviado quando o usuário responde à mensagem.

Mensagens service

Enviado quando a mensagem não pôde ser entregue.
Enviado quando a mensagem foi entregue ao canal (WhatsApp).
Enviado quando a mensagem foi entregue ao dispositivo do usuário.
Enviado quando o usuário leu a mensagem.
Este evento só é recebido se o usuário tiver as confirmações de leitura (tiques azuis) habilitadas no WhatsApp.