WhatsApp Business Platform
WhatsApp Business Platform
Recursos

Mensagens de imagem

Updated: 3 de nov de 2025
As mensagens de imagem exibem uma única imagem e uma legenda opcional.

Sintaxe da solicitação

Use o ponto de extremidade POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages para enviar uma mensagem de imagem a um usuário do WhatsApp.
curl 'https://graph.facebook.com/<API_VERSION>/<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-d '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<WHATSAPP_USER_PHONE_NUMBER>",
  "type": "image",
  "image": {
    "id": "<MEDIA_ID>", <!-- Only if using uploaded media -->
    "link": "<MEDIA_URL>", <!-- Only if using hosted media (not recommended) -->
    "caption": "<MEDIA_CAPTION_TEXT>"
  }
}'

Parâmetros de solicitação

Espaço reservado Descrição Valor de exemplo
<ACCESS_TOKEN>
String
EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
<API_VERSION>
String
Opcional.
Versão da Graph API.
v25.0
<MEDIA_CAPTION_TEXT>
String
Opcional.
Texto da legenda do ativo de mídia.
Máximo de 1.024 caracteres.
The best succulent ever?
<MEDIA_ID>
String
Obrigatório para mídias carregadas. Caso contrário, omita.
Identificação do ativo de mídia carregado.
1013859600285441
<MEDIA_URL>
String
Obrigatório para mídias hospedadas. Caso contrário, omita.
URL do ativo de mídia hospedado no servidor público. Para melhor desempenho, recomendamos usar id e uma identificação de ativo de mídia carregado.
https://www.luckyshrub.com/assets/succulents/aloe.png
<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>
String
Obrigatório.
Identificação do número de telefone do WhatsApp Business.
106540352242922
<WHATSAPP_USER_PHONE_NUMBER>
String
Obrigatório.
Número de telefone do usuário do WhatsApp.
+16505551234

Formatos de imagem compatíveis

As imagens devem ser de 8 bits, RGB ou RGBA.


Tipo de imagem Extensão Tipo MIME Tamanho máximo
JPEG
.jpeg
image/jpeg
5 MB
PNG
.png
image/png
5 MB

Exemplo de pedido

Exemplo de solicitação para enviar uma mensagem de imagem com legenda a um usuário do WhatsApp.
curl 'https://graph.facebook.com/v25.0/106540352242922/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "+16505551234",
  "type": "image",
  "image": {
    "id" : "1479537139650973",
    "caption": "The best succulent ever?"
  }
}'

Exemplo de resposta

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "+16505551234",
      "wa_id": "16505551234"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA"
    }
  ]
}
Você achou esta página útil?
Ícone de polegar para cima
Ícone de polegar para baixo