WhatsApp Business Platform
WhatsApp Business Platform
Recursos

Mensagens de texto

Updated: 3 de nov de 2025
Os SMS contêm somente um corpo de texto e uma prévia de link opcional.

Sintaxe da solicitação

Use o ponto de extremidade POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages para enviar uma mensagem de texto 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": "text",
  "text": {
    "preview_url": <ENABLE_LINK_PREVIEW>,
    "body": "<BODY_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
<BODY_TEXT>
String
Obrigatório.
Corpo de texto. Os URLs são inseridos automaticamente como hiperlinks.
Tamanho máximo de 4.096 caracteres.
As requested, here's the link to our latest product: https://www.meta.com/quest/quest-3/
<ENABLE_LINK_PREVIEW>
Booliano
Opcional.
Defina como true para que o cliente do WhatsApp tente renderizar uma prévia de link de qualquer URL na string de texto do corpo.
Consulte Prévia do link abaixo.
true
<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
O cliente do WhatsApp pode tentar renderizar uma prévia do primeiro URL na string de texto do corpo, caso contenha um. Os URLs devem começar com http:// ou https://. Se vários URLs estiverem na string de texto do corpo, apenas o primeiro será renderizado.
Caso seja omitido ou não seja possível recuperar uma prévia do link, um link clicável será renderizado.

Exemplo de pedido

Exemplo de solicitação para enviar um SMS com prévias de link habilitadas e uma string de texto do corpo contendo um link.
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": "text",
  "text": {
    "preview_url": true,
    "body": "As requested, here'\''s the link to our latest product: https://www.meta.com/quest/quest-3/"
  }
}'

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