Skip to main content

Documentação do Webhook para messages.update

Descrição:​

O evento messages.update é acionado quando ocorrem atualizações nas mensagens, como alterações no status de entrega, mensagens excluídas, etc.

Payload do Webhook:​

Quando o evento messages.update é acionado, um payload com as seguintes propriedades é enviado ao endpoint do webhook configurado:

{
  "eventType": "messages.update",
  "instance": "ID_DA_INSTANCIA",
  "messageId": "ID_DA_MENSAGEM",
  "recipient": "NUMERO_DO_RECIPIENTE@s.whatsapp.net",
  "fromMe": true,
  "status": "STATUS_DA_MENSAGEM",
  "datetime": TIMESTAMP
}

Propriedades do Payload:​

  • eventType: (string) Tipo do evento, neste caso, sempre será messages.update.
  • instance: (string) ID da instância que está enviando a mensagem.
  • messageId: (string) ID único da mensagem.
  • recipient: (string) Número do telefone do destinatário no formato internacional, seguido por @s.whatsapp.net.
  • fromMe: (boolean) true se a mensagem foi enviada pela instância, false se foi recebida por ela.
  • status: (string) Status atual da mensagem. Exemplo: DELIVERY_ACK.
  • datetime: (number) Timestamp da data e hora da atualização da mensagem.

Exemplo de Retorno:

{
  "instance": "instance.id",
  "eventType": "messages.update",
  "messageId": "A20DA9C0183A2D35A260F53F5D2B9244",
  "status": "DELIVERY_ACK",
  "datetime": "2023-09-22T15:15:00Z"
}

Problemas Comuns:​

Código 405: Certifique-se de que você está usando o método correto (POST ou PUT) conforme especificado no início deste tópico.

Conclusão​

O uso do webhook "MESSAGES_UPDATE" permite que você otimize a comunicação com seus contatos, garantindo que as mensagens foram entregues e visualizadas. Além disso, você terá maior controle e precisão sobre o fluxo de mensagens, melhorando significativamente a experiência de comunicação entre você e seus usuários.

Caso tenha qualquer dúvida ou encontre problemas, não hesite em contatar nosso suporte.