Pular para o conteúdo principal
Use as notificações para obter diretamente o status das mensagens enviadas. Elas permitem que você obtenha informações relevantes, como o número de mensagens lidas de suas mensagens individuais, em massa ou de campanha. Ao usar as notificações, você pode entender o comportamento do usuário e usar essas informações para melhorar sua campanha de marketing ou escolher um tipo de mensagem melhor para ser mais preciso em suas comunicações. Você pode obter informações específicas sobre uma notificação pelo seu ID ou todas as notificações para preencher seu banco de dados ou Dashboard.

​
Obter Notificações

Este endpoint permite que você recupere notificações enviadas anteriormente. 
GET https://api.jelou.ai/v1/external/bots/{botId}/notifications

​
Parâmetros de Path

PropriedadeTipoDescriçãoObrigatório
botIdstringID do bot.Sim

​
Parâmetros de Query

PropriedadeTipoDescriçãoObrigatório
messageIdstringID da mensagem.Não
campaignIdstringID da campanha.Não
elementNamestringNome do elemento.Não
fromdateData de início.Não
todateData de término.Não
limitnumberLimite de paginação (Máx: 50).Não
pagenumberNúmero da página (Padrão: 1).Não

​
Exemplo de Requisição

curl --request GET \
  --url 'https://api.jelou.ai/v1/external/bots/BOT_ID/notifications?limit=50&from=2024-01-01&to=2024-12-31&page=1' \
  --header 'Authorization: Basic {{Base64EncodedUsername:Password}}'

​
Lista de status de mensagem

StatusDescrição
DELIVERED_CHANNELA mensagem foi recebida pelo WhatsApp.
DELIVERED_USERA mensagem foi recebida pelo usuário.
READO usuário leu a mensagem.
REPLYO usuário respondeu à mensagem.
CREATEDA mensagem foi recebida pela Jelou.
FAILEDA mensagem não pôde ser entregue.

​
Status de leitura da mensagem

StatusDescrição
trueO usuário leu a mensagem.
falseO usuário não leu a mensagem.

​
Respostas da API

O payload contém os seguintes campos:
PropriedadeDescrição
sentStatusStatus de entrega do template.
createdAtData de envio da mensagem.
deliveryChannelAtData de entrega ao canal WhatsApp.
deliveryUserAtData de entrega da mensagem pelo WhatsApp.
readAtData em que a mensagem foi lida pelo usuário.
destinationNúmero de telefone do usuário.
elementNameNome do template.
idID da mensagem.
errorMotivo da falha na entrega do template (se aplicável).
replyResposta do usuário (disponível quando o status é REPLY).

​
Análise de métricas

Analise as taxas de entrega, leitura e resposta para otimizar futuras campanhas.
Use os dados de notificação para:
  • Medir engajamento: Calcule a porcentagem de mensagens lidas em relação às entregues.
  • Identificar problemas: Detecte números inválidos ou bloqueados por meio de erros FAILED.
  • Otimizar agendamentos: Analise timestamps para encontrar os melhores horários de envio.
  • Melhorar conteúdo: Use respostas (REPLY) para entender quais mensagens geram mais interação.