Evento messages.received

Evento `messages.received`

Disparado quando uma mensagem é recebida.

Além de mensagens recebidas de contatos (fromMe: false), este evento também é disparado para mensagens enviadas pelo próprio número em outro dispositivo ou celular, com fromMe: true. Mensagens enviadas via API da D-API geram o evento messages.sent, e não messages.received.

Payload

string

required

Sempre "messages.received"

string

required

ID da sessão que recebeu a mensagem

string

required

Timestamp ISO 8601 do recebimento

string

required

ID único para rastreamento

object

required

Show Campos de data

string

required

ID único da mensagem

string

required

string

required

Conteúdo textual da mensagem

number

required

Unix timestamp em milissegundos

boolean

required

Se a mensagem foi enviada por você

boolean

required

Se é mensagem de grupo

string

required

Nome do grupo (vazio se não for grupo)

string

required

Nome do remetente

string | null

required

URL do arquivo no S3 (para mensagens com mídia)

object

required

Show Campos de from

string

required

WhatsApp ID (ex: 5511999999999@s.whatsapp.net)

string

required

ID interno do WhatsApp

string

required

Nome do contato

object

required

Show Campos de to

string

required

WhatsApp ID do destinatário

string

required

Nome do destinatário

object

Presente em mensagens de mídia (image, video, audio, document, sticker)

Show Campos de media_data

string

required

URL original do WhatsApp (temporária)

number

required

Tamanho em bytes

string

required

MIME type do arquivo

number

Largura (image/video/sticker)

number

Altura (image/video/sticker)

string

Legenda (image/video/document)

number

Duração em segundos (audio/video)

boolean

Push-to-talk / mensagem de voz (audio)

string

Nome do arquivo (document)

boolean

Se é sticker animado (sticker)

object

Dados específicos para contact, location, reaction e poll_update

Show ContactData (type=contact)

string

required

Nome do contato

string

required

Telefone do contato

string

required

Nome de exibição

string

required

VCard completo

Show LocationData (type=location)

number

required

Latitude

number

required

Longitude

string

required

Nome do local

string

required

Endereço

string

required

Imagem em Base64

Show ReactionData (type=reaction)

string

required

ID da mensagem original

string

required

Emoji da reação

number

required

Timestamp da reação

string

required

Participante alvo (em grupos)

Show EditedMessageData (type=edited_message)

string

required

ID da mensagem que foi editada. Use este campo — e não data.id, que é o ID do evento de edição — para localizar a mensagem no seu banco.

string

required

Novo conteúdo da mensagem. É o mesmo valor que chega em data.message.

number

required

Unix timestamp em milissegundos de quando a edição foi feita

number

required

Sempre 14 (identificador interno do WhatsApp para edição)

object

Referência bruta à mensagem original, como recebida do WhatsApp. Prefira original_message_id.

Show PollUpdateData (type=poll_update)

object

required

Referência à enquete original

object

required

Dados criptografados do voto

Show ListResponseData (type=list_response)

string

required

ID da opção selecionada

string

required

Título da opção selecionada

string

Descrição da opção selecionada

number

required

Tipo da lista

object

Show Campos

string

Título da lista

string[]

Opções disponíveis

Show TemplateButtonReplyData (type=template_button_reply)

string

required

ID do botão selecionado

string

required

Texto do botão selecionado

number

required

Índice do botão (0-based)

string

required

ID da mensagem com os botões

Show ListData (type=list)

string

required

Título da lista

string

Descrição/corpo da mensagem

string

required

Texto do botão para abrir a lista

string

Texto do rodapé

number

required

Tipo da lista

array

required

Show Section

string

Título da seção

array

Show Row

string

ID da opção

string

Título da opção

string

Descrição da opção

Show CarouselData (type=carousel)

string

required

Sempre "carousel"

array

required

Show Card

string

Título do card

string

Corpo do card

Show NativeFlowData (type=nativeflow)

string

required

Sempre "nativeflow"

string

Título do header

string

Subtítulo do header

boolean

Se tem mídia anexada

string

Corpo da mensagem

string

Texto do rodapé

array

required

Show Button

string

quick_reply | cta_url

string

JSON com parâmetros do botão

object

Presente em respostas e mensagens CTWA

Show Campos de context_info

string

ID da mensagem citada

string

ID da mensagem citada

object

Show Campos

string

Conteúdo da mensagem citada

string

Tipo da mensagem citada

string

Autor da mensagem citada

string

App de origem CTWA (ex: facebook)

string

Fonte CTWA (ex: ctwa_ad)

object

Dados do anúncio (ver ExternalAdReply)

object

Dados do anúncio CTWA (duplicado no root de data)

Show Campos de external_ad_reply

string

required

Texto do anúncio

string

required

Título do anúncio

string

required

Click ID para atribuição

string

required

ID do anúncio

string

required

Tipo (ex: ad)

string

required

URL do anúncio

number

required

Tipo de mídia

string

required

URL da mídia do anúncio

string

required

URL da thumbnail

Exemplos por Tipo

text

{
  "event": "messages.received",
  "sessionId": "my-session",
  "timestamp": "2026-01-24T22:51:32.601Z",
  "traceId": "c17dee440402792623e3ad6d925cb000",
  "data": {
    "id": "AC9831DDA691236BA3CE4909A187B703",
    "type": "text",
    "message": "Olá!",
    "timestamp": 1769295092000,
    "fromMe": false,
    "is_group": false,
    "group_name": "",
    "from": {
      "jid": "5511999999999@s.whatsapp.net",
      "lid": "163896103039140@lid",
      "name": "João"
    },
    "from_name": "João",
    "to": {
      "jid": "558005915338@s.whatsapp.net",
      "name": "Minha Empresa"
    },
    "media_url": null
  }
}

image

{
  "event": "messages.received",
  "sessionId": "my-session",
  "timestamp": "2026-01-24T23:08:46.618Z",
  "traceId": "c303a70535496ac2ef475d1454e5091d",
  "data": {
    "id": "3EB0F61B5D1F94FAFCD306",
    "type": "image",
    "message": "",
    "timestamp": 1769296125000,
    "fromMe": false,
    "is_group": false,
    "group_name": "",
    "from": {
      "jid": "5511999999999@s.whatsapp.net",
      "lid": "78700997521528@lid",
      "name": "João"
    },
    "from_name": "João",
    "to": {
      "jid": "558005915338@s.whatsapp.net",
      "name": "Minha Empresa"
    },
    "media_data": {
      "url": "https://mmg.whatsapp.net/...",
      "width": 1179,
      "height": 1127,
      "caption": "",
      "file_length": 108529,
      "mimetype": "image/jpeg"
    },
    "media_url": "https://s3.us-east-005.backblazeb2.com/d-api-media/my-session/image/3EB0F61B5D1F94FAFCD306.jpg",
    "body": ""
  }
}

video

{
  "event": "messages.received",
  "sessionId": "my-session",
  "timestamp": "2026-01-24T23:09:25.997Z",
  "traceId": "696a8af1fffc77be1da98883fbf47a18",
  "data": {
    "id": "3EB0611DADDC69F4FCE999",
    "type": "video",
    "message": "",
    "timestamp": 1769296161000,
    "fromMe": false,
    "is_group": false,
    "group_name": "",
    "from": {
      "jid": "5511999999999@s.whatsapp.net",
      "lid": "78700997521528@lid",
      "name": "João"
    },
    "from_name": "João",
    "to": {
      "jid": "558005915338@s.whatsapp.net",
      "name": "Minha Empresa"
    },
    "media_data": {
      "url": "https://mmg.whatsapp.net/...",
      "width": 2160,
      "height": 3840,
      "caption": "",
      "duration": 9,
      "file_length": 15033300,
      "mimetype": "video/mp4"
    },
    "media_url": "https://s3.us-east-005.backblazeb2.com/d-api-media/my-session/video/3EB0611DADDC69F4FCE999.mp4",
    "body": ""
  }
}

audio

{
  "event": "messages.received",
  "sessionId": "my-session",
  "timestamp": "2026-01-24T23:07:23.963Z",
  "traceId": "57b56b9da28101ef39a2bbacb02bf79e",
  "data": {
    "id": "3EB04F2EA624ED5AE5E994",
    "type": "audio",
    "message": "Audio message",
    "timestamp": 1769296042000,
    "fromMe": false,
    "is_group": false,
    "group_name": "",
    "from": {
      "jid": "5511999999999@s.whatsapp.net",
      "lid": "78700997521528@lid",
      "name": "João"
    },
    "from_name": "João",
    "to": {
      "jid": "558005915338@s.whatsapp.net",
      "name": "Minha Empresa"
    },
    "media_data": {
      "url": "https://mmg.whatsapp.net/...",
      "is_ptt": true,
      "duration": 1,
      "file_length": 3228,
      "mimetype": "audio/ogg; codecs=opus"
    },
    "media_url": "https://s3.us-east-005.backblazeb2.com/d-api-media/my-session/audio/3EB04F2EA624ED5AE5E994.ogg"
  }
}

document

{
  "event": "messages.received",
  "sessionId": "my-session",
  "timestamp": "2026-01-24T22:52:36.560Z",
  "traceId": "f52c470bc7e83b615fe02f7ae6de99a4",
  "data": {
    "id": "AC4E4E0D20923933E79133FED55E86FA",
    "type": "document",
    "message": "",
    "timestamp": 1769295155000,
    "fromMe": false,
    "is_group": false,
    "group_name": "",
    "from": {
      "jid": "5511999999999@s.whatsapp.net",
      "lid": "163896103039140@lid",
      "name": "João"
    },
    "from_name": "João",
    "to": {
      "jid": "558005915338@s.whatsapp.net",
      "name": "Minha Empresa"
    },
    "media_data": {
      "url": "https://mmg.whatsapp.net/...",
      "caption": "",
      "filename": "contrato.pdf",
      "file_length": 561909,
      "mimetype": "application/pdf"
    },
    "media_url": "https://s3.us-east-005.backblazeb2.com/d-api-media/my-session/application/AC4E4E0D20923933E79133FED55E86FA.pdf",
    "body": ""
  }
}

sticker

{
  "event": "messages.received",
  "sessionId": "my-session",
  "timestamp": "2026-01-24T23:25:41.529Z",
  "traceId": "0cc5f31ce4eeba9d93b69c644047d132",
  "data": {
    "id": "3EB07121F4AA1FECE1EB77",
    "type": "sticker",
    "message": "Sticker",
    "timestamp": 1769297140000,
    "fromMe": false,
    "is_group": false,
    "group_name": "",
    "from": {
      "jid": "5511999999999@s.whatsapp.net",
      "lid": "78700997521528@lid",
      "name": "João"
    },
    "from_name": "João",
    "to": {
      "jid": "558005915338@s.whatsapp.net",
      "name": "Minha Empresa"
    },
    "media_data": {
      "url": "https://mmg.whatsapp.net/...",
      "width": 0,
      "height": 0,
      "file_length": 31670,
      "mimetype": "image/webp",
      "is_animated": false
    },
    "media_url": "https://s3.us-east-005.backblazeb2.com/d-api-media/my-session/image/3EB07121F4AA1FECE1EB77.webp"
  }
}

contact

{
  "event": "messages.received",
  "sessionId": "my-session",
  "timestamp": "2026-01-24T23:07:52.683Z",
  "traceId": "5e2ce9f64316e43de9f9be26bc883cc6",
  "data": {
    "id": "3EB0E400D2D23FCC5F62",
    "type": "contact",
    "message": "Contact: João Silva",
    "timestamp": 1769296072000,
    "fromMe": false,
    "is_group": false,
    "group_name": "",
    "from": {
      "jid": "5511999999999@s.whatsapp.net",
      "lid": "78700997521528@lid",
      "name": "João"
    },
    "from_name": "João",
    "to": {
      "jid": "558005915338@s.whatsapp.net",
      "name": "Minha Empresa"
    },
    "data": {
      "contact_name": "João Silva",
      "contact_phone": "5511988887777",
      "display_name": "João Silva",
      "vcard": "BEGIN:VCARD\nVERSION:3.0\nN:Silva;João;;;\nFN:João Silva\nTEL;type=CELL;waid=5511988887777:+55 11 98888-7777\nEND:VCARD"
    },
    "media_url": null
  }
}

location

{
  "event": "messages.received",
  "sessionId": "my-session",
  "timestamp": "2026-01-24T23:14:40.667Z",
  "traceId": "9acf700c9a579d390acfaabcd47d813a",
  "data": {
    "id": "2A3245D5D360B969BC24",
    "type": "location",
    "message": "Location: -23.550520, -46.633308",
    "timestamp": 1769296480000,
    "fromMe": false,
    "is_group": false,
    "group_name": "",
    "from": {
      "jid": "5511999999999@s.whatsapp.net",
      "lid": "78700997521528@lid",
      "name": "João"
    },
    "from_name": "João",
    "to": {
      "jid": "558005915338@s.whatsapp.net",
      "name": "Minha Empresa"
    },
    "data": {
      "degrees_latitude": -23.550520,
      "degrees_longitude": -46.633308,
      "name": "",
      "address": "",
      "thumbnail": "/9j/4AAQSkZJRgABAQAA..."
    },
    "media_url": null
  }
}

reaction

{
  "event": "messages.received",
  "sessionId": "my-session",
  "timestamp": "2026-01-24T23:22:59.675Z",
  "traceId": "902f8bc16e32af74bca7b23c1696377f",
  "data": {
    "id": "3EB0798CB87F57E7E8FDEE",
    "type": "reaction",
    "message": "👍",
    "timestamp": 1769296979000,
    "fromMe": false,
    "is_group": false,
    "group_name": "",
    "from": {
      "jid": "5511999999999@s.whatsapp.net",
      "lid": "78700997521528@lid",
      "name": "João"
    },
    "from_name": "João",
    "to": {
      "jid": "558005915338@s.whatsapp.net",
      "name": "Minha Empresa"
    },
    "data": {
      "original_message_id": "2A3245D5D360B969BC24",
      "reaction_text": "👍",
      "reaction_timestamp": 1769296978000,
      "target_participant": ""
    },
    "media_url": null
  }
}

edited_message

Quando alguém edita uma mensagem já enviada, o WhatsApp não atualiza a mensagem original: ele envia um novo evento. Por isso a edição chega como um messages.received comum, com type: "edited_message".data.id é o ID do evento de edição. A mensagem que foi editada está em data.data.original_message_id — é por ele que você atualiza o registro no seu banco.Edições de legenda de mídia (imagem, vídeo, documento) também chegam por aqui, com a legenda nova em message.

{
  "event": "messages.received",
  "sessionId": "my-session",
  "timestamp": "2026-01-24T23:24:11.204Z",
  "traceId": "5c1f7b90a4d2ee318f6b0c47d9a1e2f3",
  "data": {
    "id": "3EB0C7A91F4D2E88B103AA",
    "type": "edited_message",
    "message": "Reunião às 15h (corrigido)",
    "timestamp": 1769297051000,
    "fromMe": false,
    "is_group": false,
    "group_name": "",
    "from": {
      "jid": "5511999999999@s.whatsapp.net",
      "lid": "78700997521528@lid",
      "name": "João"
    },
    "from_name": "João",
    "to": {
      "jid": "558005915338@s.whatsapp.net",
      "name": "Minha Empresa"
    },
    "data": {
      "protocol_type": 14,
      "edited_text": "Reunião às 15h (corrigido)",
      "original_message_id": "2A3245D5D360B969BC24",
      "edit_timestamp": 1769297051000
    },
    "media_url": null
  }
}

Resposta (quoted message)

{
  "event": "messages.received",
  "sessionId": "my-session",
  "timestamp": "2026-01-24T23:24:49.030Z",
  "traceId": "9cece6b5f07ce817f862c4d5c973081f",
  "data": {
    "id": "3EB0957D85886312C6D1AF",
    "type": "text",
    "message": "Sim, confirmo!",
    "timestamp": 1769297088000,
    "fromMe": false,
    "is_group": false,
    "group_name": "",
    "from": {
      "jid": "5511999999999@s.whatsapp.net",
      "lid": "78700997521528@lid",
      "name": "João"
    },
    "from_name": "João",
    "to": {
      "jid": "558005915338@s.whatsapp.net",
      "name": "Minha Empresa"
    },
    "context_info": {
      "participant": "145453781897334@lid",
      "stanza_id": "3EB056EB4B9E27BA4AA356",
      "quoted_message_id": "3EB056EB4B9E27BA4AA356",
      "quoted_message": {
        "body": "Você confirma o pedido?",
        "type": "text"
      }
    },
    "media_url": null
  }
}

CTWA (Click to WhatsApp Ads)

{
  "event": "messages.received",
  "sessionId": "my-session",
  "timestamp": "2026-01-24T21:58:50.581Z",
  "traceId": "c6dd8822b3949cd97d9247775ee779c2",
  "data": {
    "id": "AC73BAB4948202189805FABAF691A878",
    "type": "text",
    "message": "Olá, vi o anúncio e gostaria de mais informações.",
    "timestamp": 1769255953000,
    "fromMe": false,
    "is_group": false,
    "group_name": "",
    "from": {
      "jid": "5511999999999@s.whatsapp.net",
      "lid": "67237780156470@lid",
      "name": "João"
    },
    "from_name": "João",
    "to": {
      "jid": "558005915338@s.whatsapp.net",
      "name": "Minha Empresa"
    },
    "context_info": {
      "entry_point_conversion_app": "facebook",
      "entry_point_conversion_source": "ctwa_ad",
      "external_ad_reply": {
        "body": "Texto do anúncio que o usuário viu",
        "ctwa_clid": "AffEzn5xEXlKpHmH8uQxUUPR7EIGYRQAt9mGNf6MOUkcOk-Da-5Uej76qNm7vWqEG-zW5otYD_SJ2uGg7nwmeOIGMccQhfsFSryba4VJ6YzxfwYBc0oQwe3f59tjool8tKcmhTx-Ag",
        "media_type": 2,
        "media_url": "https://www.facebook.com/reel/863712683259771/",
        "render_larger_thumbnail": true,
        "show_ad_attribution": true,
        "source_id": "120237659567410455",
        "source_type": "ad",
        "source_url": "https://fb.me/6LTWcWnZ8",
        "thumbnail_url": "https://scontent.xx.fbcdn.net/...",
        "title": "Título do anúncio"
      }
    },
    "external_ad_reply": {
      "body": "Texto do anúncio que o usuário viu",
      "ctwa_clid": "AffEzn5xEXlKpHmH8uQxUUPR7EIGYRQAt9mGNf6MOUkcOk-Da-5Uej76qNm7vWqEG-zW5otYD_SJ2uGg7nwmeOIGMccQhfsFSryba4VJ6YzxfwYBc0oQwe3f59tjool8tKcmhTx-Ag",
      "media_type": 2,
      "media_url": "https://www.facebook.com/reel/863712683259771/",
      "render_larger_thumbnail": true,
      "show_ad_attribution": true,
      "source_id": "120237659567410455",
      "source_type": "ad",
      "source_url": "https://fb.me/6LTWcWnZ8",
      "thumbnail_url": "https://scontent.xx.fbcdn.net/...",
      "title": "Título do anúncio"
    },
    "media_url": null
  }
}

list_response

{
  "event": "messages.received",
  "sessionId": "my-session",
  "timestamp": "2026-01-25T17:13:05.199Z",
  "traceId": "c636ed01bbc3b58174997b7379841e31",
  "data": {
    "id": "3EB00E07AFE6175651FCE9",
    "type": "list_response",
    "message": "Sim",
    "timestamp": 1769361184000,
    "fromMe": false,
    "is_group": false,
    "group_name": "",
    "from": {
      "jid": "5511999999999@s.whatsapp.net",
      "name": "João"
    },
    "from_name": "João",
    "to": {
      "jid": "558005915338@s.whatsapp.net",
      "name": "Minha Empresa"
    },
    "context_info": {
      "participant": "5551920018823@s.whatsapp.net",
      "quoted_message": {
        "body": "",
        "type": "unsupported"
      },
      "quoted_message_id": "3EB0180F79608C5E1ACEE7",
      "stanza_id": "3EB0180F79608C5E1ACEE7"
    },
    "data": {
      "selected_row_id": "t1",
      "selected_title": "Sim",
      "description": "aham",
      "list_type": 1,
      "original_list": {
        "title": "Teste",
        "options": ["Sim"]
      }
    },
    "media_url": null
  }
}

template_button_reply

{
  "event": "messages.received",
  "sessionId": "my-session",
  "timestamp": "2026-01-25T17:11:35.713Z",
  "traceId": "f60da86820a5e9a776df323b339ce92b",
  "data": {
    "id": "3EB00B49BF1006ED22FFE2",
    "type": "template_button_reply",
    "message": "Confirmar",
    "timestamp": 1769361095000,
    "fromMe": false,
    "is_group": false,
    "group_name": "",
    "from": {
      "jid": "5511999999999@s.whatsapp.net",
      "name": "João"
    },
    "from_name": "João",
    "to": {
      "jid": "558005915338@s.whatsapp.net",
      "name": "Minha Empresa"
    },
    "data": {
      "quoted_message_id": "3EB0319B37B762E820E8AC",
      "selected_display_text": "Confirmar",
      "selected_id": "btn_confirm",
      "selected_index": 0
    },
    "media_url": null
  }
}

list

{
  "event": "messages.received",
  "sessionId": "my-session",
  "timestamp": "2026-01-25T20:15:06.493Z",
  "traceId": "5458c3c3605f3d5dee7076349890912d",
  "data": {
    "id": "3EB0B74CA34A5FC973F4C2",
    "type": "list",
    "message": "mensagem aqui",
    "timestamp": 1769372106000,
    "fromMe": false,
    "is_group": false,
    "group_name": "",
    "from": {
      "jid": "5511999999999@s.whatsapp.net",
      "lid": "224901986312214@lid",
      "name": "João"
    },
    "from_name": "João",
    "to": {
      "jid": "558005915338@s.whatsapp.net",
      "name": "Minha Empresa"
    },
    "data": {
      "title": "Teste",
      "description": "mensagem aqui",
      "button_text": "Abrir",
      "footer_text": "",
      "list_type": 1,
      "sections": [
        {
          "title": "Teste",
          "rows": [
            {
              "row_id": "t1",
              "title": "Sim",
              "description": "aham"
            }
          ]
        }
      ]
    },
    "media_url": null
  }
}

carousel

{
  "event": "messages.received",
  "sessionId": "my-session",
  "timestamp": "2026-01-25T20:15:09.153Z",
  "traceId": "44663f6360711dc8e6788b6772c2efa9",
  "data": {
    "id": "3EB024449A497D01E1DB93",
    "type": "carousel",
    "message": "",
    "timestamp": 1769372108000,
    "fromMe": false,
    "is_group": false,
    "group_name": "",
    "from": {
      "jid": "5511999999999@s.whatsapp.net",
      "lid": "224901986312214@lid",
      "name": "João"
    },
    "from_name": "João",
    "to": {
      "jid": "558005915338@s.whatsapp.net",
      "name": "Minha Empresa"
    },
    "data": {
      "type": "carousel",
      "cards": [
        {
          "header_title": "",
          "body": "Teste"
        }
      ]
    },
    "media_url": null,
    "body": ""
  }
}

nativeflow (quick_reply)

{
  "event": "messages.received",
  "sessionId": "my-session",
  "timestamp": "2026-01-25T20:15:12.493Z",
  "traceId": "e53bbcc4cf1b479082617887d8424343",
  "data": {
    "id": "3EB0C41EA80CCF889B8E52",
    "type": "nativeflow",
    "message": "Corpo da mensagem",
    "timestamp": 1769372112000,
    "fromMe": false,
    "is_group": false,
    "group_name": "",
    "from": {
      "jid": "5511999999999@s.whatsapp.net",
      "lid": "224901986312214@lid",
      "name": "João"
    },
    "from_name": "João",
    "to": {
      "jid": "558005915338@s.whatsapp.net",
      "name": "Minha Empresa"
    },
    "data": {
      "type": "nativeflow",
      "header_title": "Título",
      "header_subtitle": "",
      "header_has_media_attachment": false,
      "body": "Corpo da mensagem",
      "footer": "Rodapé",
      "buttons": [
        {
          "name": "quick_reply",
          "params_json": "{\"display_text\":\"Confirmar\",\"id\":\"btn_confirm\"}"
        }
      ]
    },
    "media_url": null
  }
}

nativeflow (cta_url)

{
  "event": "messages.received",
  "sessionId": "my-session",
  "timestamp": "2026-01-25T20:15:10.945Z",
  "traceId": "02858caf7cd7f62f347f10f2c1ad13bf",
  "data": {
    "id": "3EB04C63B7280B8146BC50",
    "type": "nativeflow",
    "message": "Corpo da mensagem",
    "timestamp": 1769372110000,
    "fromMe": false,
    "is_group": false,
    "group_name": "",
    "from": {
      "jid": "5511999999999@s.whatsapp.net",
      "lid": "224901986312214@lid",
      "name": "João"
    },
    "from_name": "João",
    "to": {
      "jid": "558005915338@s.whatsapp.net",
      "name": "Minha Empresa"
    },
    "data": {
      "type": "nativeflow",
      "header_title": "Título",
      "header_subtitle": "",
      "header_has_media_attachment": false,
      "body": "Corpo da mensagem",
      "footer": "Rodapé",
      "buttons": [
        {
          "name": "cta_url",
          "params_json": "{\"display_text\":\"Abrir site\",\"url\":\"https://exemplo.com\",\"merchant_url\":\"https://exemplo.com\"}"
        }
      ]
    },
    "media_url": null
  }
}

Mensagem enviada pelo próprio celular (fromMe: true)

{
  "event": "messages.received",
  "sessionId": "my-session",
  "timestamp": "2026-01-24T22:55:00.000Z",
  "traceId": "c17dee440402792623e3ad6d925cb222",
  "data": {
    "id": "3EB0A1B2C3D4E5F60718",
    "type": "text",
    "message": "Já estou a caminho!",
    "timestamp": 1769295300000,
    "fromMe": true,
    "is_group": false,
    "group_name": "",
    "from": {
      "jid": "558005915338@s.whatsapp.net",
      "name": "Minha Empresa"
    },
    "from_name": "Minha Empresa",
    "to": {
      "jid": "5511999999999@s.whatsapp.net",
      "name": "João"
    },
    "media_url": null
  }
}

Mensagem de grupo (is_group: true)

{
  "event": "messages.received",
  "sessionId": "my-session",
  "timestamp": "2026-01-24T23:30:10.120Z",
  "traceId": "b91f0a2d6c4e5f7081923a4b5c6d7e8f",
  "data": {
    "id": "3EB0D2E3F4A5B6C70819",
    "type": "text",
    "message": "Bom dia, pessoal!",
    "timestamp": 1769297410000,
    "fromMe": false,
    "is_group": true,
    "group_name": "Equipe de Vendas",
    "participant": "5511999999999@s.whatsapp.net",
    "from": {
      "jid": "5511999999999@s.whatsapp.net",
      "name": "João"
    },
    "from_name": "João",
    "to": {
      "jid": "120363012345678901@g.us",
      "name": "Equipe de Vendas"
    },
    "media_url": null
  }
}

Identificando Tipos

Condição	Tipo
`data.type === "text"`	Mensagem de texto
`data.type === "image"`	Imagem
`data.type === "video"`	Vídeo
`data.type === "audio"`	Áudio/PTT
`data.type === "document"`	Documento
`data.type === "sticker"`	Sticker
`data.type === "contact"`	Contato
`data.type === "location"`	Localização
`data.type === "reaction"`	Reação
`data.type === "poll_update"`	Atualização de enquete
`data.type === "list_response"`	Resposta de lista interativa
`data.type === "template_button_reply"`	Clique em botão
`data.type === "list"`	Mensagem de lista interativa
`data.type === "carousel"`	Carrossel de cards
`data.type === "nativeflow"`	Mensagem com botões (quick_reply/cta_url)
`data.context_info?.quoted_message`	É resposta
`data.context_info?.entry_point_conversion_source === "ctwa_ad"`	Veio de anúncio

Media URLs

Arquivos de mídia são automaticamente salvos no S3 e disponibilizados em data.media_url.

Tipo	Extensão	Exemplo
image	.jpg, .png	`https://s3.../image/{id}.jpg`
video	.mp4	`https://s3.../video/{id}.mp4`
audio	.ogg	`https://s3.../audio/{id}.ogg`
document	.pdf, .docx	`https://s3.../application/{id}.pdf`
sticker	.webp	`https://s3.../image/{id}.webp`

Introdução

API Oficial (SaaS)

Assistente de Integração

Ligações

Webhooks

Evento messages.received