whatsapp-docs-mcp 1.0.0

package/docs/mensagens/recursos_adicionais/media.md

@@ -0,0 +1,419 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media -->
+<!-- Scraped: 2025-12-20T17:28:07.495Z -->
+
+# Mídia
+
+Updated: 17 de nov de 2025
+
+Você usa quatro pontos de extremidade diferentes para gerenciar mídias:
+
+Ponto de extremidade
+
+Usos
+
+[`POST /PHONE_NUMBER_ID/media`](#upload-media)
+
+Carregar mídias.
+
+[`GET /MEDIA_ID`](#get-media-url)
+
+Recuperar o URL de uma mídia específica.
+
+[`DELETE /MEDIA_ID`](#delete-media)
+
+Excluir uma mídia específica.
+
+[`GET /MEDIA_URL`](#download-media)
+
+Baixar mídias de um URL.
+
+Consulte [Tipos de mídias compatíveis](#supported-media-types) para ver os tipos e os limites de tamanho compatíveis.
+
+## Obter ID de mídia
+
+Algumas solicitações de API descritas neste documento exigem um ID de mídia. Os IDs de mídia são retornados pela API ao [carregar mídias](#upload-media) e incluídos em webhooks de mensagens de mídia recebidas ([mensagens de imagem](/documentation/business-messaging/whatsapp/webhooks/reference/messages/image), [mensagens de vídeo](/documentation/business-messaging/whatsapp/webhooks/reference/messages/video) etc.)
+
+Os IDs de mídia retornados pela API expiram após 30 dias. Os IDs de mídia nos webhooks expiram após sete dias.
+
+## Carregar mídias
+
+Para carregar mídia, faça uma chamada `POST` para `/PHONE_NUMBER_ID/media` e inclua os parâmetros listados abaixo. Todos os arquivos de mídia enviados por meio desse ponto de extremidade são criptografados e permanecem por 30 dias, a menos que sejam excluídos antes.
+
+Ponto de extremidade
+
+Autenticação
+
+`/PHONE_NUMBER_ID/media`
+
+(Consulte [Get Phone Number ID](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers#get-all-phone-numbers))
+
+Os desenvolvedores podem autenticar as chamadas de API com o token de acesso gerado em **Painel de Apps** > **WhatsApp** > **Configuração da API**.
+
+  
+
+Os parceiros de soluções devem fazer a autenticação usando um token de acesso com a permissão `whatsapp_business_messaging`.
+
+### Parâmetros
+
+Nome
+
+Descrição
+
+`file`
+
+**Obrigatório.**
+
+O caminho do arquivo armazenado no diretório local. Por exemplo: "@/local/path/file.jpg".
+
+`type`
+
+**Obrigatório.**
+
+O tipo de arquivo de mídia que está sendo carregado. Consulte a seção [Tipos de mídia compatíveis](#supported-media-types) para saber mais.
+
+`messaging_product`
+
+**Obrigatório.**
+
+O serviço de mensagens usado para a solicitação. Nesse caso, use `whatsapp`.
+
+### Solicitação
+
+```
+curl 'https://graph.facebook.com/<API_VERSION>/<PHONE_NUMBER_ID>/media' \
+-H 'Authorization: Bearer <ACCESS_TOKEN>' \
+-F 'messaging_product=whatsapp' \
+-F 'file=@<FILE_PATH_AND_NAME>;type=<MIME_TYPE>'
+```
+
+### Resposta
+
+Caso a solicitação seja bem-sucedida:
+
+```
+{
+  "id": "<MEDIA_ID>"
+}
+```
+
+### Exemplo de solicitação
+
+```
+curl 'https://graph.facebook.com/v24.0/106540352242922/media' \
+-H 'Authorization: Bearer EAAJB...' \
+-F 'messaging_product=whatsapp' \
+-F 'file=@/media/template_assets/black_friday_2025.mp4;type=video/mp4'
+```
+
+### Exemplo de resposta
+
+```
+{  "id": "1037543291543636"}
+```
+
+## Obter o URL de mídia
+
+É possível consultar diretamente um [ID de mídia](#get-media-id) para obter um URL de mídia, que pode ser usado com seu token de acesso para [baixar o ativo de mídia](#download-media).
+
+A partir de 12 de novembro de 2025, os webhooks de mídia recebida ([mensagens de imagem](/documentation/business-messaging/whatsapp/webhooks/reference/messages/image), [mensagens de vídeo](/documentation/business-messaging/whatsapp/webhooks/reference/messages/video) etc.) incluirão automaticamente o URL da mídia e vão atribuí-lo a uma nova propriedade `url`. **Essa propriedade será lançada de forma gradual para os desenvolvedores ao longo de várias semanas e talvez não esteja disponível para você imediatamente.**
+
+Os URLs de mídia **expiram após cinco minutos**. Você deve consultar o ID novamente para obter um novo URL.
+
+### Sintaxe da solicitação
+
+```
+curl 'https://graph.facebook.com/<API_VERSION>/<MEDIA_ID>?phone_number_id=<BUSINESS_PHONE_NUMBER_ID>' \
+-H 'Authorization: Bearer EAAJB'
+```
+
+Observe que `phone_number_id` é opcional. Se incluída, a solicitação será processada apenas se a identificação do número de telefone comercial incluída na consulta corresponder à identificação do número de telefone comercial na qual a mídia foi carregada.
+
+### Sintaxe da resposta
+
+A resposta bem-sucedida inclui um objeto com o URL da mídia. O URL só é válido por cinco minutos. Para usar esse URL, consulte [Baixar mídia](#download-media).
+
+```
+{
+  "messaging_product": "whatsapp",
+  "url": "<MEDIA_URL>",
+  "mime_type": "<MEDIA_MIME_TYPE>",
+  "sha256": "<SHA_256_HASH>",
+  "file_size": "<MEDIA_FILE_SIZE>",
+  "id": "<MEDIA_ID>"
+}
+```
+
+## Excluir mídia
+
+Use o ponto de extremidade **DELETE /<MEDIA\_ID>** para excluir um ativo de mídia.
+
+### Sintaxe da solicitação
+
+```
+curl -X DELETE 'https://graph.facebook.com/<API_VERSION>/<MEDIA_ID>?phone_number_id=<BUSINESS_PHONE_NUMBER_ID>' \
+-H 'Authorization: Bearer EAAJB...'
+```
+
+Observe que `phone_number_id` é opcional. Se incluída, a solicitação será processada apenas se a identificação do número de telefone comercial incluída na consulta corresponder à identificação do número de telefone comercial na qual a mídia foi carregada.
+
+### Exemplo de resposta
+
+```
+{  "success": true}
+```
+
+## Baixar mídia
+
+Para baixar mídias, faça uma solicitação `GET` no URL da mídia e inclua seu token de acesso. **Se o token for omitido, a solicitação falhará.**
+
+Observe que, ao recuperar uma mídia a partir de uma identificação de mídia recebida via webhook, a identificação de mídia só estará disponível para baixar por sete dias.
+
+### Sintaxe da solicitação
+
+```
+curl '<MEDIA_URL>' \
+-H 'Authorization: Bearer EAAJB...' \
+-o '<DESIRED_FILE_NAME>'
+```
+
+Em caso de sucesso, a API responderá com os dados binários do ativo de mídia. Os cabeçalhos de resposta contêm um cabeçalho de tipo de conteúdo para indicar o tipo MIME dos dados retornados. Confira os [tipos de mídia compatíveis](#supported-media-types).
+
+Se a tentativa de download falhar, você receberá um código de resposta `404 Not Found`. Nesse caso, recomendamos que tente [recuperar um novo URL de mídia](#get-media-url) e baixá-lo novamente. Se isso não resolver o problema, renove seu token de acesso e tente baixar o ativo de mídia novamente.
+
+## Tipos de mídia compatíveis
+
+### Áudio
+
+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
+
+### Documento
+
+Tipo de documento
+
+Extensão
+
+Tipo MIME
+
+Tamanho máximo
+
+Texto
+
+.txt
+
+text/plain
+
+100 MB
+
+Microsoft Excel
+
+.xls
+
+application/vnd.ms-excel
+
+100 MB
+
+Microsoft Excel
+
+.xlsx
+
+application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
+
+100 MB
+
+Microsoft Word
+
+.doc
+
+application/msword
+
+100 MB
+
+Microsoft Word
+
+.docx
+
+application/vnd.openxmlformats-officedocument.wordprocessingml.document
+
+100 MB
+
+Microsoft PowerPoint
+
+.ppt
+
+application/vnd.ms-powerpoint
+
+100 MB
+
+Microsoft PowerPoint
+
+.pptx
+
+application/vnd.openxmlformats-officedocument.presentationml.presentation
+
+100 MB
+
+PDF
+
+.pdf
+
+application/pdf
+
+100 MB
+
+### Imagem
+
+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
+
+### Figurinha
+
+As imagens WebP só podem ser enviadas em [mensagens de figurinha](/documentation/business-messaging/whatsapp/messages/sticker-messages).
+
+Tipo de figurinha
+
+Extensão
+
+Tipo MIME
+
+Tamanho máximo
+
+Figurinha animada
+
+.webp
+
+image/webp
+
+500 KB
+
+Figurinha estática
+
+.webp
+
+image/webp
+
+100 KB
+
+### Vídeo
+
+Somente o codec de vídeo H.264 e o codec de áudio AAC são aceitos. Somente stream de áudio único ou sem stream de áudio.
+
+  
+  
+
+Tipo de vídeo
+
+Extensão
+
+Tipo MIME
+
+Tamanho máximo
+
+3GPP
+
+.3gp
+
+video/3gpp
+
+16 MB
+
+Vídeo no formato MP4
+
+.mp4
+
+video/mp4
+
+16 MB
+
+Um tipo MIME incompatível (`131053`) é um erro comum. Recomendamos que você inspecione os arquivos de mídia para verificar o tipo MIME e confirme que as extensões do nome do arquivo reflitam os tipos deles. Por exemplo, se estiver usando UNIX, você pode inspecionar um arquivo por meio da linha de comando para determinar seu tipo MIME:
+
+`file -I your-image-asset.png`
+
+## Restrições de download de mensagens de mídia
+
+O tamanho máximo de arquivo aceito para mensagens de mídia na API de Nuvem é 100 MB. Caso o cliente envie um arquivo com mais de 100 MB, você receberá um webhook com o código de erro [131052](/documentation/business-messaging/whatsapp/support/error-codes#other-errors) e `title`:
+
+_“O arquivo de mídia é muito grande. Tamanho máximo do arquivo aceito atualmente: 100 MB. Peça ao cliente para enviar um arquivo de mídia com tamanho inferior a 100 MB"_.
+
+Recomendamos que você envie aos clientes uma mensagem de aviso informando que o arquivo de mídia excede o tamanho máximo permitido quando esse evento de webhook for disparado.
+
+## Saiba mais
+
+Blog do WhatsApp Business – [Como enviar mensagens de mídia pelo WhatsApp em um app](https://l.facebook.com/l.php?u=https%3A%2F%2Fbusiness.whatsapp.com%2Fblog%2Fmedia-messages-via-app&h=AT2c4gedJCTPU1DhUzZomqZyAJZ9jD8y6yY3WaisvWSIbC7BbVPoXCkvLcqjPbQ1vpfj6p55rp9vJKcw65BFrR7fsFfJ76xgEV_jDYtP93RruYc0E9KYsBCgBiG1SF1Mo7-yrunwY7uaA4Yq9Ga8pEkARWM)
+
+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/recursos_adicionais/payload_encryption.md

@@ -0,0 +1,8 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/payload-encryption -->
+<!-- Scraped: 2025-12-20T17:28:53.112Z -->
+
+## Esta página não está disponível no momento
+
+Isso pode ter ocorrido devido a um erro técnico que estamos trabalhando para corrigir. Tente recarregar esta página.
+
+Recarregar página

package/docs/mensagens/recursos_adicionais/typing_indicators.md

@@ -0,0 +1,117 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/typing-indicators -->
+<!-- Scraped: 2025-12-20T17:28:32.563Z -->
+
+# Indicadores de digitação
+
+Updated: 21 de out de 2025
+
+Quando você recebe um webhook de **mensagens** indicando uma [mensagem recebida](/documentation/business-messaging/whatsapp/webhooks/reference/messages), é possível usar o valor `message.id` para marcar a mensagem como lida e exibir um indicador de digitação. Dessa forma, o usuário do WhatsApp saberá que você está escrevendo uma resposta. Essa é uma boa prática quando você leva alguns segundos para responder.
+
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/488360772_654124507349470_2240843625651955811_n.png?_nc_cat=110&ccb=1-7&_nc_sid=e280be&_nc_ohc=SOmR3VEATaIQ7kNvwFICFZM&_nc_oc=AdmEKViP8uwXabo6KNoa5gxXstpEeRWO7IW2IqlktzChF8DTaemxuW9XgyjutmuYHMA&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=Yy_6Bs5Hnba6LTP3X7hJkw&oh=00_Afkl5rWPVXizmdtXPQRBws7_vYYStOXQVOuVLFctdmDmxw&oe=6961179C)
+
+O indicador de digitação será removido depois que você responder ou após 25 segundos, o que ocorrer primeiro. Para evitar uma experiência ruim para o usuário, só exiba o indicador de digitação se você for responder.
+
+## Sintaxe da solicitação
+
+```
+curl -X POST \
+'https://graph.facebook.com/<API_VERSION>/<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages'
+-H 'Authorization: Bearer <ACCESS_TOKEN>' \
+-H 'Content-Type: application/json' \
+-d '
+{
+  "messaging_product": "whatsapp",
+  "status": "read",
+  "message_id": "<WHATSAPP_MESSAGE_ID>",
+  "typing_indicator": {
+    "type": "text"
+  }
+}'
+```
+
+## 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
+
+`<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>`
+
+_String_
+
+**Obrigatório.**
+
+Identificação do número de telefone do WhatsApp Business.
+
+`106540352242922`
+
+`<WHATSAPP_MESSAGE_ID>`
+
+_String_
+
+**Obrigatório.**
+
+Identificação da mensagem do WhatsApp. Essa identificação é atribuída à propriedade `messages.id` nos webhooks de **mensagem recebida**[mensagens](/documentation/business-messaging/whatsapp/webhooks/reference/messages).
+
+`wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBJDQjZCMzlEQUE4OTJBMTE4RTUA`
+
+## Resposta
+
+Caso a solicitação seja bem-sucedida:
+
+```
+{  "success": true}
+```
+
+## Exemplo de solicitação
+
+```
+curl 'https://graph.facebook.com/v24.0/106540352242922/messages' \
+-H 'Content-Type: application/json' \
+-H 'Authorization: Bearer EAAJB...' \
+-d '
+{
+  "messaging_product": "whatsapp",
+  "status": "read",
+  "message_id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBJDQjZCMzlEQUE4OTJBMTE4RTUA",
+  "typing_indicator": {
+    "type": "text"
+  }
+}'
+```
+
+## Resposta
+
+Caso a solicitação seja bem-sucedida:
+
+```
+{  "success": true}
+```
+
+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/AGENTS.md

@@ -0,0 +1,24 @@
+# Tipos de Mensagens
+
+Tipos de mensagens disponíveis
+
+## Documentos Disponíveis
+
+- [Address Messages](./address_messages.md)
+- [Audio Messages](./audio_messages.md)
+- [Contacts Messages](./contacts_messages.md)
+- [Document Messages](./document_messages.md)
+- [Image Messages](./image_messages.md)
+- [Interactive Cta Url Messages](./interactive_cta_url_messages.md)
+- [Interactive Flow Messages](./interactive_flow_messages.md)
+- [Interactive List Messages](./interactive_list_messages.md)
+- [Interactive Reply Buttons Messages](./interactive_reply_buttons_messages.md)
+- [Location Messages](./location_messages.md)
+- [Location Request Messages](./location_request_messages.md)
+- [Message With Link](./message_with_link.md)
+- [Reaction Messages](./reaction_messages.md)
+- [Sticker Messages](./sticker_messages.md)
+- [Template Messages](./template_messages.md)
+- [Text Messages](./text_messages.md)
+- [Video Messages](./video_messages.md)
+