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

event

string

required

Sempre "messages.received"

sessionId

string

required

ID da sessão que recebeu a mensagem

timestamp

string

required

Timestamp ISO 8601 do recebimento

traceId

string

required

ID único para rastreamento

data

object

required

Show Campos de data

string

required

ID único da mensagem

type

string

required

message

string

required

Conteúdo textual da mensagem

timestamp

number

required

Unix timestamp em milissegundos

fromMe

boolean

required

Se a mensagem foi enviada por você

is_group

boolean

required

Se é mensagem de grupo

group_name

string

required

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

from_name

string

required

Nome do remetente

media_url

string | null

required

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

from

object

required

Show Campos de from

jid

string

required

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

lid

string

required

ID interno do WhatsApp

name

string

required

Nome do contato

object

required

Show Campos de to

jid

string

required

WhatsApp ID do destinatário

name

string

required

Nome do destinatário

media_data

object

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

Show Campos de media_data

url

string

required

URL original do WhatsApp (temporária)

file_length

number

required

Tamanho em bytes

mimetype

string

required

MIME type do arquivo

width

number

Largura (image/video/sticker)

height

number

Altura (image/video/sticker)

caption

string

Legenda (image/video/document)

duration

number

Duração em segundos (audio/video)

is_ptt

boolean

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

filename

string

Nome do arquivo (document)

is_animated

boolean

Se é sticker animado (sticker)

data

object

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

Show ContactData (type=contact)

contact_name

string

required

Nome do contato

contact_phone

string

required

Telefone do contato

display_name

string

required

Nome de exibição

vcard

string

required

VCard completo

Show LocationData (type=location)

degrees_latitude

number

required

Latitude

degrees_longitude

number

required

Longitude

name

string

required

Nome do local

address

string

required

Endereço

thumbnail

string

required

Imagem em Base64

Show ReactionData (type=reaction)

original_message_id

string

required

ID da mensagem original

reaction_text

string

required

Emoji da reação

reaction_timestamp

number

required

Timestamp da reação

target_participant

string

required

Participante alvo (em grupos)

Show PollUpdateData (type=poll_update)

poll_creation_message_key

object

required

Referência à enquete original

vote

object

required

Dados criptografados do voto

Show ListResponseData (type=list_response)

selected_row_id

string

required

ID da opção selecionada

selected_title

string

required

Título da opção selecionada

description

string

Descrição da opção selecionada

list_type

number

required

Tipo da lista

original_list

object

Show Campos

title

string

Título da lista

options

string[]

Opções disponíveis

Show TemplateButtonReplyData (type=template_button_reply)

selected_id

string

required

ID do botão selecionado

selected_display_text

string

required

Texto do botão selecionado

selected_index

number

required

Índice do botão (0-based)

quoted_message_id

string

required

ID da mensagem com os botões

Show ListData (type=list)

title

string

required

Título da lista

description

string

Descrição/corpo da mensagem

button_text

string

required

Texto do botão para abrir a lista

footer_text

string

Texto do rodapé

list_type

number

required

Tipo da lista

sections

array

required

Show Section

title

string

Título da seção

rows

array

Show Row

row_id

string

ID da opção

title

string

Título da opção

description

string

Descrição da opção

Show CarouselData (type=carousel)

type

string

required

Sempre "carousel"

cards

array

required

Show Card

header_title

string

Título do card

body

string

Corpo do card

Show NativeFlowData (type=nativeflow)

type

string

required

Sempre "nativeflow"

header_title

string

Título do header

header_subtitle

string

Subtítulo do header

header_has_media_attachment

boolean

Se tem mídia anexada

body

string

Corpo da mensagem

footer

string

Texto do rodapé

buttons

array

required

Show Button

name

string

quick_reply | cta_url

params_json

string

JSON com parâmetros do botão

context_info

object

Presente em respostas e mensagens CTWA

Show Campos de context_info

stanza_id

string

ID da mensagem citada

quoted_message_id

string

ID da mensagem citada

quoted_message

object

Show Campos

body

string

Conteúdo da mensagem citada

type

string

Tipo da mensagem citada

participant

string

Autor da mensagem citada

entry_point_conversion_app

string

App de origem CTWA (ex: facebook)

entry_point_conversion_source

string

Fonte CTWA (ex: ctwa_ad)

external_ad_reply

object

Dados do anúncio (ver ExternalAdReply)

external_ad_reply

object

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

Show Campos de external_ad_reply

body

string

required

Texto do anúncio

title

string

required

Título do anúncio

ctwa_clid

string

required

Click ID para atribuição

source_id

string

required

ID do anúncio

source_type

string

required

Tipo (ex: ad)

source_url

string

required

URL do anúncio

media_type

number

required

Tipo de mídia

media_url

string

required

URL da mídia do anúncio

thumbnail_url

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
  }
}

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

Assistente de Integração

Ligações

Webhooks

Evento messages.received