Skip to main content

​
Eventos do Webhook

O Grwthy dispara dois tipos de eventos para o webhook configurado na instância.

​
messages.upsert

Disparado quando uma nova mensagem é recebida no seu número WhatsApp.

​
Tipos de Mensagem

TipoDescrição
textMensagem de texto
imageImagem com legenda opcional
documentArquivo de documento
audioÁudio ou nota de voz
videoVídeo com legenda opcional
locationLocalização compartilhada
contactsCartões de contato
interactiveResposta de botão ou seleção de lista
reactionReação com emoji
stickerFigurinha

​
Exemplo de Payload

{
  "event": "messages.upsert",
  "instanceName": "minha-loja",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "metaMessageId": "wamid.HBgNNTUxMTk5OTk5OTk5FQIAEhgUM0EB",
    "fromNumber": "5511888888888",
    "pushName": "João",
    "messageType": "text",
    "message": {
      "text": {
        "body": "Olá!"
      }
    },
    "messageTimestamp": 1709654400,
    "fromMe": false
  }
}

​
messages.update

Disparado quando o status de uma mensagem enviada é atualizado.

​
Fluxo de Status

queued → sent → delivered → read
                    ↘
                   failed
StatusDescrição
queuedMensagem aceita e aguardando envio
sentMensagem aceita pelo WhatsApp
deliveredEntregue no dispositivo do destinatário
readDestinatário abriu a mensagem
failedNão pôde ser entregue

​
Exemplo de Payload

{
  "event": "messages.update",
  "instanceName": "minha-loja",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "metaMessageId": "wamid.HBgNNTUxMTk5OTk5OTk5FQIAEhgUM0EB",
    "status": "delivered",
    "timestamp": 1709654410
  }
}