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
Como configurar uma URL de notificação
Ao criar uma nova URL, você precisará:- 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.
- Informar a URL de destino (endpoint).
- Definir o tipo de autenticação que o endpoint usará.
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
campaignIdnemtemplate, porque essas mensagens não pertencem a uma campanha. - O campo
errorsó aparece no statusFAILED. - Nos canais da Gupshup,
idcorresponde 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 flexibilidadeVocê 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
Falha
Falha
Enviado quando a mensagem não pôde ser entregue.
Entregue ao canal
Entregue ao canal
Enviado quando a mensagem foi entregue ao canal (WhatsApp).
Entregue ao usuário
Entregue ao usuário
Enviado quando a mensagem foi entregue ao dispositivo do usuário.
Lido
Lido
Enviado quando o usuário leu a mensagem.
Resposta
Resposta
Enviado quando o usuário responde à mensagem.
Mensagens service
Service · Com falha
Service · Com falha
Enviado quando a mensagem não pôde ser entregue.
Service · Entregue no canal
Service · Entregue no canal
Enviado quando a mensagem foi entregue ao canal (WhatsApp).
Service · Entregue ao usuário
Service · Entregue ao usuário
Enviado quando a mensagem foi entregue ao dispositivo do usuário.
Service · Lido
Service · Lido
Enviado quando o usuário leu a mensagem.