Pular para o conteúdo principal

O que são Eventos?

Eventos são avisos que nossa plataforma envia automaticamente sempre que algo importante acontece. Por exemplo, quando uma nova mensagem é recebida ou enviada, nós enviamos um evento avisando sobre isso. Você pode escutar esses eventos usando um webhook, permitindo que seu sistema responda automaticamente quando esses eventos acontecerem.

Como os eventos são enviados?

Todos os eventos que enviamos possuem a mesma estrutura básica, facilitando a sua integração:
  • created_at: Indica quando o evento foi disparado.
  • data: Contém as informações específicas que variam conforme o tipo do evento.
  • id: Um identificador único para referência e auditoria.
  • type: Indica o que exatamente aconteceu, como message.received, message.sent, etc.

Eventos repetidos

Em casos raros, o mesmo acontecimento pode gerar mais de um evento. Isso pode ocorrer, por exemplo, quando uma entrega é refeita após uma falha ou quando o WhatsApp reenvia uma mensagem que já havia chegado. Cada envio recebe um id de evento novo, por isso ele não serve para identificar repetições. Para descartar repetições, use o identificador do objeto dentro de data. Em message.received e message.sent, a combinação de type com data.id (o id da mensagem) identifica o acontecimento: se você já processou um message.received com aquele data.id, pode ignorar os seguintes. A exceção é message.edited, em que cada edição legítima chega com o mesmo data.id; nele, o critério é o data.edited_at (veja o evento em eventos disponíveis). Confira todos os eventos disponíveis.