whatsapp-docs-mcp 1.0.0

package/docs/mensagens/tipos_de_mensagens/address_messages.md

@@ -0,0 +1,465 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/address-messages -->
+<!-- Scraped: 2025-12-20T17:25:16.954Z -->
+
+# Mensagens de endereço
+
+Updated: 7 de nov de 2025
+
+Esse recurso está disponível apenas para empresas com sede na Índia e os respectivos clientes locais.
+
+Por meio de mensagens de endereço, os usuários podem compartilhar endereços de envio com as empresas no WhatsApp de um jeito mais simples.
+
+As mensagens de endereço são mensagens interativas com quatro partes principais: `header`, `body`, `footer` e `action`. Dentro do componente de ação, a empresa especifica o nome “address\_message” e os parâmetros relevantes.
+
+A tabela abaixo apresenta os campos compatíveis com as mensagens de endereço.
+
+Nome do campo
+
+Etiqueta de exibição
+
+Tipo de entrada
+
+Países com suporte
+
+Limitações
+
+`name`
+
+Nome
+
+texto
+
+Índia
+
+Nenhum
+
+`phone_number`
+
+Número de telefone
+
+tel
+
+Índia
+
+Somente números de telefone válidos
+
+`in_pin_code`
+
+Código PIN
+
+texto
+
+Índia
+
+Comprimento máximo: 6
+
+`house_number`
+
+Número do apartamento/casa
+
+texto
+
+Índia
+
+Nenhum
+
+`floor_number`
+
+Número do andar
+
+texto
+
+Índia
+
+Nenhum
+
+`tower_number`
+
+Número da torre
+
+texto
+
+Índia
+
+Nenhum
+
+`building_name`
+
+Nome do edifício/condomínio
+
+texto
+
+Índia
+
+Nenhum
+
+`address`
+
+Endereço
+
+texto
+
+Índia
+
+Nenhum
+
+`landmark_area`
+
+Ponto de referência/área
+
+texto
+
+Índia
+
+Nenhum
+
+`city`
+
+Cidade
+
+texto
+
+Índia
+
+Nenhum
+
+`state`
+
+Estado
+
+texto
+
+Índia
+
+Nenhum
+
+## Exemplo de chamada de API
+
+Este é um exemplo da chamada de API para mensagem de endereço. O atributo `country` é um campo obrigatório nos parâmetros de ação. Se ele não for incluído, ocorrerá um erro de validação.
+
+```
+curl -X  POST \
+'https://graph.facebook.com/<API_VERSION>/<FROM_PHONE_NUMBER_ID>/messages' \
+-H 'Authorization: Bearer <ACCESS_TOKEN>' \
+-H 'Content-Type: application/json' \
+-d '
+{
+  "messaging_product": "whatsapp",
+  "recipient_type": "individual",
+  "to": "<PHONE_NUMBER>",
+  "type": "interactive",
+  "interactive": {
+    "type": "address_message",
+    "body": {
+      "text": "Thanks for your order! Tell us what address you’d like this order delivered to."
+    },
+    "action": {
+      "name": "address_message",
+      "parameters": {
+        "country": "<COUNTRY_ISO_CODE>"
+      }
+    }
+  }
+}'
+```
+
+## Solução de erros
+
+Se o código de área do número de telefone do país em questão não estiver correto, as empresas não conseguirão solicitar a mensagem de endereço ao destinatário. Por exemplo, as empresas não conseguirão solicitar uma mensagem de endereço a um destinatário cujo país seja "Índia", mas cujo número de telefone tenha código de área "65".
+
+Após o envio da mensagem de endereço, a empresa aguarda o usuário preencher o endereço e enviá-lo de volta. O endereço inserido pelo usuário é compartilhado por meio do [webhook](/documentation/business-messaging/whatsapp/webhooks/overview) registrado no [processo de configuração](/documentation/business-messaging/whatsapp/webhooks/overview).
+
+## Etapas da mensagem de endereço
+
+Estas são as etapas da mensagem de endereço:
+
+-   A empresa envia uma mensagem de endereço ao usuário com o nome de ação `address_message`.-   O usuário interage com a mensagem clicando na CTA, que exibe a tela da mensagem de endereço. O usuário preenche o endereço e envia o formulário.-   Depois disso, o parceiro recebe uma notificação de webhook com os detalhes do endereço enviado pelo usuário.
+
+**Exemplo de mensagem de endereço na Índia**
+
+![Image](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/565829166_1339318437926807_3659527486531714210_n.jpg?_nc_cat=103&ccb=1-7&_nc_sid=e280be&_nc_ohc=uBuydZ9CoYwQ7kNvwHJEbhM&_nc_oc=AdkZVczlTJ7EGXN4DMEdGTxD7okVX-gqpI0QlrT-612NWxfjrbG7ddkjwFD5adZXj6c&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=fZIISxQarkg8CjFHFNmoWA&oh=00_Afl-y3oQgUcBCkDiVVSMNu2sx9hwEhMb9NqQkWNYak8YMA&oe=696114F3)![Image](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/560182401_1339318284593489_3917170764968888761_n.jpg?_nc_cat=107&ccb=1-7&_nc_sid=e280be&_nc_ohc=kz1lOpnNvLwQ7kNvwF7fv-a&_nc_oc=AdlyCogITZGR8hUecr-jUsVz_AcRUOzJQ6tEgreJwtqhmjX5z9I6U6kxhoNRUem56Wg&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=fZIISxQarkg8CjFHFNmoWA&oh=00_AflKf9Zbq6PLaAT3cZETVooRasR_v5DnutvxCVwDpA5ZZQ&oe=696127E3)![Image](https://scontent-gru2-2.xx.fbcdn.net/v/t39.2365-6/561656043_1339318467926804_8340276620740620111_n.jpg?_nc_cat=105&ccb=1-7&_nc_sid=e280be&_nc_ohc=qQW9YafGWzkQ7kNvwF2XDRx&_nc_oc=Adl4TLNyT1DrVq7nPtMiazuMkelO7EBoCHmHAuesFOKdQ-OOOXpibcfqFTViKw10ApE&_nc_zt=14&_nc_ht=scontent-gru2-2.xx&_nc_gid=fZIISxQarkg8CjFHFNmoWA&oh=00_Afk6gBtf72v4TN34mEgQRZp6y-CStweD7VF5Sit2TenhLA&oe=696113D3)![Image](https://scontent-gru1-1.xx.fbcdn.net/v/t39.2365-6/561778150_1339318131260171_5843569977396603182_n.jpg?_nc_cat=101&ccb=1-7&_nc_sid=e280be&_nc_ohc=kLJIq1wX9T0Q7kNvwEG0UWK&_nc_oc=AdkMnpIFtP55PYqpQzQF9rlmx7wADq7c4fiBTNKs4B_boUTGqtWAKgh4VH126rI1I9w&_nc_zt=14&_nc_ht=scontent-gru1-1.xx&_nc_gid=fZIISxQarkg8CjFHFNmoWA&oh=00_Afm6sEQdrXHHbQBMA3DRLy8268kX2j0Gq4Z0eqJghxJs2g&oe=69610D92)
+
+O diagrama de sequência a seguir mostra um fluxo de integração típico de uma mensagem de endereço.
+
+![Image](https://scontent-gru1-1.xx.fbcdn.net/v/t39.2365-6/564006097_1339318367926814_6312454230710951737_n.jpg?_nc_cat=104&ccb=1-7&_nc_sid=e280be&_nc_ohc=p_lKJxI_wR8Q7kNvwHmtk3m&_nc_oc=AdnMtnufPy2Z7_fCrv1ABn6qYgWX4OIKtR3VcJO5jLq4-1kpkpzp8y-STjyOugRlnAU&_nc_zt=14&_nc_ht=scontent-gru1-1.xx&_nc_gid=fZIISxQarkg8CjFHFNmoWA&oh=00_AfmRNXrRS4FrobZw2NbpAIpIbv3y9c62QmhKjrqUPEisLg&oe=69613413)
+
+## Parâmetros de ação adicionais
+
+A empresa pode passar atributos adicionais (por exemplo, `values`, `validation_errors` ou `saved_addresses`) como parte dos parâmetros de ação interativos. Veja abaixo mais informações sobre o uso de cada um deles.
+
+Parâmetro de ação
+
+Uso
+
+`values`
+
+As empresas preenchem automaticamente os campos de endereço (por exemplo, preenchem automaticamente o campo "cidade" com "Índia").
+
+`saved_addresses`
+
+Para empresas, elas podem passar endereços salvos anteriormente associados ao usuário.
+
+Para usuários, eles terão a opção de escolher o endereço salvo em vez de preenchê-lo manualmente.
+
+`validation_errors`
+
+As empresas podem indicar erros nos campos de endereço, e o WhatsApp impedirá que o usuário envie o formulário antes que os problemas sejam corrigidos.
+
+### Enviar mensagem de endereço para um usuário
+
+Faça uma chamada `POST` a `/<PHONE_NUMBER_ID/messages` usando a API do WhatsApp para enviar mensagens de endereço criptografadas de ponta a ponta para o usuário:
+
+```
+curl -X  POST \
+'https://graph.facebook.com/<API_VERSION>/<FROM_PHONE_NUMBER_ID>/messages' \
+-H 'Authorization: Bearer <ACCESS_TOKEN>' \
+-H 'Content-Type: application/json' \
+-d '
+{
+  "messaging_product": "whatsapp",
+  "recipient_type": "individual",
+  "to": "<PHONE_NUMBER>",
+  "type": "interactive",
+  "interactive": {
+    "type": "address_message",
+    "body": {
+      "text": "Thanks for your order! Tell us what address you’d like this order delivered to."
+    },
+    "action": {
+      "name": "address_message",
+      "parameters": "JSON Payload"
+    }
+  }
+}'
+```
+
+Para enviar uma mensagem de endereço sem endereços salvos, o WhatsApp exibirá ao usuário ou à empresa um formulário de endereço a ser preenchido com um novo endereço.
+
+```
+curl -X  POST \
+'https://graph.facebook.com/<API_VERSION>/<FROM_PHONE_NUMBER_ID>/messages' \
+-H 'Authorization: Bearer <ACCESS_TOKEN>' \
+-H 'Content-Type: application/json' \
+-d '
+{
+  "messaging_product": "whatsapp",
+  "recipient_type": "individual",
+  "to": "+91xxxxxxxxxx",
+  "type": "interactive",
+  "interactive": {
+    "type": "address_message",
+    "body": {
+      "text": "Thanks for your order! Tell us what address you’d like this order delivered to."
+    },
+    "action": {
+      "name": "address_message",
+      "parameters": {
+        "country": "IN",
+        "values": {
+          "name": "<CUSTOMER_NAME>",
+          "phone_number": "+91xxxxxxxxxx"
+        }
+      }
+    }
+  }
+}'
+```
+
+Para enviar uma mensagem de endereço com endereços salvos, o WhatsApp apresentará ao usuário ou à empresa a opção de selecionar um dos endereços salvos ou adicionar um novo. Os usuários podem ignorar o endereço salvo e inserir um novo.
+
+```
+curl -X  POST \
+'https://graph.facebook.com/<API_VERSION>/<FROM_PHONE_NUMBER_ID>/messages' \
+-H 'Authorization: Bearer <ACCESS_TOKEN>' \
+-H 'Content-Type: application/json' \
+-d '
+{
+  "messaging_product": "whatsapp",
+  "recipient_type": "individual",
+  "to": "91xxxxxxxxxx",
+  "type": "interactive",
+  "interactive": {
+    "type": "address_message",
+    "body": {
+      "text": "Thanks for your order! Tell us what address you’d like this order delivered to."
+    },
+    "action": {
+      "name": "address_message",
+      "parameters": {
+        "country": "IN",
+        "saved_addresses": [
+          {
+            "id": "address1",
+            "value": {
+              "name": "<CUSTOMER_NAME>",
+              "phone_number": "+91xxxxxxxxxx",
+              "in_pin_code": "400063",
+              "floor_number": "8",
+              "building_name": "",
+              "address": "Wing A, Cello Triumph,IB Patel Rd",
+              "landmark_area": "Goregaon",
+              "city": "Mumbai"
+            }
+          }
+        ]
+      }
+    }
+  }
+}'
+```
+
+## Verificar a resposta
+
+Uma resposta bem-sucedida inclui um objeto `messages` com um ID para a mensagem recém-criada.
+
+```
+{
+  "messaging_product": "whatsapp",
+  "contacts": [
+    {
+      "input": "<PHONE_NUMBER>",
+      "wa_id": "<WHATSAPP_ID>"
+    }
+  ],
+  "messages": [
+    {
+      "id": "wamid.ID"
+    }
+  ]
+}
+```
+
+Respostas com falha conterão uma mensagem de erro. Veja [Mensagens de erro e status](/documentation/business-messaging/whatsapp/support/error-codes) para mais informações.
+
+## Enviar uma mensagem de endereço com erros de validação
+
+Uma mensagem de endereço será reenviada ao usuário caso ocorra um erro de validação no servidor da empresa. A empresa deverá devolver o conjunto de valores previamente inseridos pelo usuário com os respectivos erros de validação de cada campo inválido, conforme mostrado no exemplo de carga abaixo.
+
+```
+curl -X  POST \
+'https://graph.facebook.com/<API_VERSION>/<FROM_PHONE_NUMBER_ID>/messages' \
+-H 'Authorization: Bearer <ACCESS_TOKEN>' \
+-H 'Content-Type: application/json' \
+-d
+'{
+  "messaging_product": "whatsapp",
+  "recipient_type": "individual",
+  "to": "91xxxxxxxxxx",
+  "type": "interactive",
+  "interactive": {
+    "type": "address_message",
+    "body": {
+      "text": "Thanks for your order! Tell us what address you’d like this order delivered to."
+    },
+    "action": {
+      "name": "address_message",
+      "parameters": {
+          "country": "IN",
+          "values": {
+             "name": "CUSTOMER_NAME",
+             "phone_number": "+91xxxxxxxxxx",
+             "in_pin_code": "666666",
+             "address": "Some other location",
+             "city": "Delhi"
+          },
+          "validation_errors": {
+             "in_pin_code": "We could not locate this pin code."
+          }
+       }
+    }
+  }
+}'
+```
+
+## Receber notificações sobre o envio de endereços
+
+As empresas receberão notificações de envio de endereço por meio de [webhooks](/documentation/business-messaging/whatsapp/webhooks/overview), como o exemplo abaixo.
+
+```
+{  "messages": [    {      "id": "gBGGFlAwCWFvAgmrzrKijase8yA",      "from": "<PHONE_NUMBER>",      "interactive": {        "type": "interactive",        "action": "address_message",        "nfm_reply": {          "name": "address_message",          "response_json": "<response_json from client>",          "body": "<body text from client>"        },        "timestamp": "1670394125"      }    }  ]}
+```
+
+A notificação de webhook tem os valores a seguir.
+
+Nome do campo
+
+Tipo
+
+Descrição
+
+`interactive`
+
+Objeto
+
+Contém a resposta do cliente.
+
+`type`
+
+String
+
+Seria `nfm_reply`, indicando que se trata de uma resposta do fluxo nativo (NFM, pelas iniciais em inglês) do cliente.
+
+`nfm_reply`
+
+Objeto
+
+Contém os dados recebidos do cliente.
+
+`response_json`
+
+String
+
+Os valores dos campos de endereço preenchidos pelo usuário no formato JSON que sempre estão presentes.
+
+`body` (opcional)
+
+String
+
+O corpo do texto do cliente, o que o usuário vê.
+
+`name` (opcional)
+
+String
+
+Seria `address_message`, indicando o tipo de resposta de ação NFM do cliente.
+
+Veja abaixo uma resposta do tipo NFM enviada na solicitação de mensagem de endereço na Índia.
+
+```
+{
+  "messages": [
+    {
+      "context": {
+        "from": "FROM_PHONE_NUMBER_ID",
+        "id": "wamid.HBgLMTIwNjU1NTAxMDcVAgARGBI3NjNFN0U5QzMzNDlCQjY0M0QA"
+      },
+      "from": "<PHONE_NUMBER>",
+      "id": "wamid.HBgLMTIwNjU1NTAxMDcVAgASGCA5RDhBNENEMEQ3RENEOEEzMEI0RUExRDczN0I1NThFQwA=",
+      "timestamp": "1671498855",
+      "type": "interactive",
+      "interactive": {
+        "type": "nfm_reply",
+        "nfm_reply": {
+          "response_json": "{\"saved_address_id\":\"address1\",\"values\":{\"in_pin_code\":\"400063\",\"building_name\":\"\",\"landmark_area\":\"Goregaon\",\"address\":\"Wing A, Cello Triumph, IB Patel Rd\",\"city\":\"Mumbai\",\"name\":\"CUSTOMER_NAME\",\"phone_number\":\"+91xxxxxxxxxx\",\"floor_number\":\"8\"}}",
+          "body": "CUSTOMER_NAME\n +91xxxxxxxxxx\n 400063, Goregaon, Wing A, Cello Triumph,IB Patel Rd, Mumbai, 8",
+          "name": "address_message"
+        }
+      }
+    }
+  ]
+}
+```
+
+## Recurso não compatível
+
+Caso o cliente não ofereça suporte para `address_message`, as mensagens serão removidas silenciosamente. Além disso, a empresa receberá uma mensagem de erro por meio do webhook. Veja abaixo a notificação enviada por webhook:
+
+```
+{  "statuses": [    {      "errors": [        {          "code": 1026,          "href": "/docs/whatsapp/api/errors",          "title": "Receiver Incapable"        }      ],      "id": "gBGGFlAwCWFvAgkyHMGKnRu4JeA",      "message": {        "recipient_id": "+91xxxxxxxxxx"      },      "recipient_id": "91xxxxxxxxxx",      "status": "failed",      "timestamp": "1670394125",      "type": "message"    }  ]}
+```
+
+Você achou esta página útil?
+
+![Ícone de polegar para cima](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)
+
+![Ícone de polegar para baixo](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)

package/docs/mensagens/tipos_de_mensagens/audio_messages.md

@@ -0,0 +1,211 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/audio-messages -->
+<!-- Scraped: 2025-12-20T17:25:24.359Z -->
+
+# Mensagens de áudio
+
+Updated: 3 de nov de 2025
+
+É possível usar a API de Nuvem para enviar mensagens de voz e mensagens de áudio básicas.
+
+## Mensagens de voz
+
+Uma mensagem de voz (também chamada de recado de voz, mensagem de áudio ou apenas áudio) é uma gravação de uma ou mais pessoas falando e pode incluir sons de fundo, como música. As mensagens de voz incluem recursos como download automático, foto do perfil e ícone de voz, que não estão disponíveis em mensagens de áudio básicas. Se o usuário tiver definido a transcrição de [mensagem de voz](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F241617298315321%2F&h=AT0NVrQNzbG93oXgSVWVk7qvq0nrjtJY7XIzXHrpI-kYSSrHlT4pa751thCtC7AqZK5MNUKpPfSuzdl_YB9csPG7LZi3QzQmHz__-p15GX0QpezO1bY5SPepkia6HKkSqWMKK1cDaFcolzFDAwXZcGx2AQY) como **Automática**, uma transcrição de texto da mensagem também será incluída.
+
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/562379210_2249057198900177_5743647093897895635_n.png?_nc_cat=100&ccb=1-7&_nc_sid=e280be&_nc_ohc=91sucyCpVBkQ7kNvwEKRx51&_nc_oc=Adn8MKuML-npHwmJfgIARRsBI1Hh0ceNRLEybxmJHS6voYuZPueptaVw5p5O-T4mIm8&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=HLaPCQBcd8WDJe_N4elEBg&oh=00_AfloufDUH4D8AgqYxUGv9I9ZGJLHMPzS1DMjcxAlwi6Pig&oe=696123CC)
+
+-   As mensagens de voz exigem arquivos .ogg codificados com o codec **OPUS**. Caso você envie um tipo de arquivo diferente ou um arquivo codificado com um codec diferente, a transcrição da mensagem de voz falhará.-   O ícone de reprodução só aparecerá se o arquivo tiver 512 KB ou menos. Caso contrário, ele será substituído por um ícone de download (uma seta voltada para baixo).-   A imagem do perfil da empresa é usada como imagem do perfil, acompanhada por um ícone de microfone.-   As transcrições de voz aparecem somente se o usuário tiver habilitado a opção [Transcrição **automática** de mensagens de voz](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F241617298315321%2F&h=AT0NVrQNzbG93oXgSVWVk7qvq0nrjtJY7XIzXHrpI-kYSSrHlT4pa751thCtC7AqZK5MNUKpPfSuzdl_YB9csPG7LZi3QzQmHz__-p15GX0QpezO1bY5SPepkia6HKkSqWMKK1cDaFcolzFDAwXZcGx2AQY). Se o usuário tiver definido essa opção como **Manual**, o texto "Transcrever" aparecerá e o texto transcrito será exibido ao tocar nessa opção. Se o usuário tiver definido a transcrição de mensagens de voz como **Nunca**, nenhuma transcrição será exibida.
+
+## Mensagens de áudio básicas
+
+As mensagens de áudio básicas exibem um ícone de download e um ícone de música. Quando o usuário do WhatsApp toca no ícone de reprodução, ele precisa baixar manualmente a mensagem de áudio para que o cliente do WhatsApp carregue e reproduza o arquivo.
+
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/561815849_2827972817396551_127160148973074084_n.png?_nc_cat=100&ccb=1-7&_nc_sid=e280be&_nc_ohc=nguY3m4oD34Q7kNvwGQ0RCn&_nc_oc=AdnPKHAOYzzoS0wiC-HYFFCCYFoIdfdUuP6jV3azsFteuaaMYsVsab9CZnb-91U1YxY&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=HLaPCQBcd8WDJe_N4elEBg&oh=00_Afl-uAcwmoOYMcSjUgiMKBxzDy6hzf5-MeT2c2g0IjViAg&oe=69612920)
+
+-   O ícone de download será substituído por um ícone de reprodução se o usuário do WhatsApp tiver ativado o [download automático](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F366146522333492%2F&h=AT0NVrQNzbG93oXgSVWVk7qvq0nrjtJY7XIzXHrpI-kYSSrHlT4pa751thCtC7AqZK5MNUKpPfSuzdl_YB9csPG7LZi3QzQmHz__-p15GX0QpezO1bY5SPepkia6HKkSqWMKK1cDaFcolzFDAwXZcGx2AQY) de mídias de áudio e se as condições para o download automático forem atendidas (por exemplo, o aparelho estiver conectado a uma rede Wi-Fi).-   Se você enviar um arquivo .ogg codificado com o código OPUS como uma mensagem de áudio básica, o ícone de música será substituído por um ícone de microfone. Além disso, se o usuário tiver ativado a [transcrição de mensagens de voz](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F241617298315321%2F&h=AT0NVrQNzbG93oXgSVWVk7qvq0nrjtJY7XIzXHrpI-kYSSrHlT4pa751thCtC7AqZK5MNUKpPfSuzdl_YB9csPG7LZi3QzQmHz__-p15GX0QpezO1bY5SPepkia6HKkSqWMKK1cDaFcolzFDAwXZcGx2AQY)**Automática** ou **Manual**, um texto transcrito ou o texto "Transcrever" acompanhará a mensagem.
+
+## Sintaxe da solicitação
+
+Use o ponto de extremidade [POST /<WHATSAPP\_BUSINESS\_PHONE\_NUMBER\_ID>/messages](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/message-api) para enviar uma mensagem de áudio 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": "audio",
+  "audio": {
+    "id": "<MEDIA_ID>", <!-- Only if using uploaded media -->
+    "link": "<MEDIA_URL>", <!-- Only if using hosted media (not recommended) -->
+    "voice": <IS_VOICE?> <!-- Only include if sending voice message -->
+  }
+}'
+```
+
+## Parâmetros de solicitação
+
+Espaço reservado
+
+Descrição
+
+Valor de exemplo
+
+`<ACCESS_TOKEN>`
+
+_String_
+
+**Obrigatório.**
+
+[Token do sistema](/documentation/business-messaging/whatsapp/access-tokens#system-user-access-tokens) ou [token da empresa](/documentation/business-messaging/whatsapp/access-tokens#business-integration-system-user-access-tokens).
+
+`EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD`
+
+`<API_VERSION>`
+
+_String_
+
+**Opcional.**
+
+Versão da Graph API.
+
+v24.0
+
+`<IS_VOICE?>`
+
+_Booliano_
+
+**Opcional.**
+
+Defina como `true` se estiver enviando uma [mensagem de voz](#voice-messages). As mensagens de voz devem ser arquivos Ogg codificados com o codec **OPUS**.
+
+Para enviar uma [mensagem de áudio básica](#basic-audio-message), defina como `false` ou omita totalmente.
+
+`true`
+
+`<MEDIA_ID>`
+
+_String_
+
+**Obrigatório para mídias carregadas. Caso contrário, omita.**
+
+ID do [ativo de mídia carregado](/documentation/business-messaging/whatsapp/business-phone-numbers/media#upload-media).
+
+`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 carregada](/documentation/business-messaging/whatsapp/business-phone-numbers/media#upload-media).
+
+`https://www.luckyshrub.com/media/ringtones/wind-chime.mp3`
+
+`<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 áudio compatíveis
+
+Tipo de áudio
+
+Extensão
+
+Tipo MIME
+
+Tamanho máximo
+
+AAC
+
+.aac
+
+audio/aac
+
+16 MB
+
+AMR
+
+.amr
+
+audio/amr
+
+16 MB
+
+MP3
+
+.mp3
+
+audio/mpeg
+
+16 MB
+
+Áudio MP4
+
+.m4a
+
+audio/mp4
+
+16 MB
+
+Áudio OGG
+
+.ogg
+
+audio/ogg (somente codecs OPUS; audio/ogg base não é compatível; somente entrada mono)
+
+16 MB
+
+Os erros mais comuns associados a arquivos de áudio são tipos MIME incompatíveis (o tipo MIME não corresponde ao tipo de arquivo indicado pelo nome do arquivo) e codificação inválida para arquivos Ogg (somente codec OPUS). Caso ocorra um erro ao enviar uma mensagem com um arquivo de mídia, verifique se o tipo MIME real do arquivo de áudio corresponde ao tipo listado acima. Para arquivos Ogg, codifique com o codec OPUS.
+
+## Exemplo de solicitação
+
+Exemplo de solicitação para enviar uma mensagem de imagem usando uma identificação de mídia carregada e uma legenda.
+
+```
+curl 'https://graph.facebook.com/v24.0/106540352242922/messages' \
+-H 'Content-Type: application/json' \
+-H 'Authorization: Bearer EAAJB...' \
+-d '
+{
+  "messaging_product": "whatsapp",
+  "recipient_type": "individual",
+  "to": "+16505551234",
+  "type": "audio",
+  "audio": {
+    "id" : "1013859600285441",
+    "voice": true
+  }
+}'
+```
+
+## 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](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)
+
+![Ícone de polegar para baixo](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)