whatsapp-docs-mcp 1.0.0

package/docs/mensagens/tipos_de_mensagens/sticker_messages.md

@@ -0,0 +1,157 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/sticker-messages -->
+<!-- Scraped: 2025-12-20T17:27:07.479Z -->
+
+# Mensagens com figurinhas
+
+Updated: 3 de nov de 2025
+
+As mensagens com figurinhas exibem imagens animadas ou estáticas de figurinhas em uma mensagem do WhatsApp.
+
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/441292863_1203428507688350_9164958282076997505_n.png?_nc_cat=103&ccb=1-7&_nc_sid=e280be&_nc_ohc=XXUWWD8578QQ7kNvwG0Fn5R&_nc_oc=AdkFi_LQBKC2oeWNUmG__r1wV28gVr5PEwl1BRLSZpkdvnNkBnZYJ5bgB8PexFDNUOw&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=-MGhOmSHgt71kQAuSWY15A&oh=00_Afk7dtA356q4VRgCodOtLZJ1lJ8h_cry48KJhixfPaSNbg&oe=696112BC)
+
+## 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 com figurinha 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": "sticker",
+  "sticker": {
+    "id": "<MEDIA_ID>", <!-- Only if using uploaded media -->
+    "link": "<MEDIA_URL>", <!-- Only if using hosted media (not recommended) -->
+  }
+}'
+```
+
+### Parâmetros do corpo do post
+
+Espaço reservado
+
+Descrição
+
+Exemplo de valor
+
+`<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
+
+`<MEDIA_ID>`
+
+_String_
+
+**Obrigatório para mídias carregadas. Caso contrário, omita.**
+
+Identificação 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 carregado](/documentation/business-messaging/whatsapp/business-phone-numbers/media#upload-media).
+
+`https://www.luckyshrub.com/assets/animated-smiling-plant.webp`
+
+`<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 figurinha compatíveis
+
+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
+
+## Exemplo de solicitação
+
+Exemplo de solicitação para enviar uma imagem de figurinha animada a um usuário do WhatsApp.
+
+```
+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": "sticker",
+  "sticker": {
+    "id" : "798882015472548"
+  }
+}'
+```
+
+## 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)

package/docs/mensagens/tipos_de_mensagens/template_messages.md

@@ -0,0 +1,20 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/template-messages -->
+<!-- Scraped: 2025-12-20T17:27:14.549Z -->
+
+# Mensagens de modelo
+
+Updated: 4 de nov de 2025
+
+As mensagens de modelo são usadas para enviar [modelos](/documentation/business-messaging/whatsapp/templates/overview) aos usuários do WhatsApp. Os modelos podem incluir mensagens de atendimento ao cliente, lembretes sobre horas marcadas, atualizações de pagamento e envio, e muito mais.
+
+![](https://scontent-gru2-2.xx.fbcdn.net/v/t39.2365-6/555677225_1191798406305539_8221742988743767334_n.png?_nc_cat=102&ccb=1-7&_nc_sid=e280be&_nc_ohc=qF4u5PUe1_4Q7kNvwGOdhcM&_nc_oc=AdlPnBdHcxE6bIyX_hEeg4wxY57WjCiFaeN8YcNbJ7MNE3Y9XDxqz1LPLQSpzgmjH1E&_nc_zt=14&_nc_ht=scontent-gru2-2.xx&_nc_gid=2HsAyDPyPD-tNzGfdsQ9_w&oh=00_AfnSNhc7XyHhu-nzTmc9As1IHbExUvRQhls3oVhFy72sqA&oe=69612FE3)
+
+Os modelos são reutilizáveis e podem ser enviados a usuários do WhatsApp fora de uma [janela de atendimento ao cliente](/documentation/business-messaging/whatsapp/messages/send-messages#customer-service-windows), mas devem ser aprovados antes de serem enviados em uma mensagem de modelo. Além disso, eles estão sujeitos a vários processos que podem afetar a capacidade de envio deles aos usuários, como pontuações de qualidade, pausa e regularidade.
+
+Como há muitas informações sobre modelos, disponibilizamos a documentação [Modelos](/documentation/business-messaging/whatsapp/templates/overview), que explica como usá-los de forma efetiva.
+
+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/text_messages.md

@@ -0,0 +1,142 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/text-messages -->
+<!-- Scraped: 2025-12-20T17:27:22.034Z -->
+
+# SMS
+
+Updated: 3 de nov de 2025
+
+Os SMS contêm somente um corpo de texto e uma prévia de link opcional.
+
+![](https://scontent-gru2-2.xx.fbcdn.net/v/t39.2365-6/440742591_797870012016470_1123226266833971975_n.png?_nc_cat=106&ccb=1-7&_nc_sid=e280be&_nc_ohc=0og1R4bzYQsQ7kNvwFDM9TH&_nc_oc=Adn8MCGzE9i_5kN91aW1k6pJPGgLHQuEwT7hTqBNVLXvvFN3Y9HMAwQ0pmywHbuWSGg&_nc_zt=14&_nc_ht=scontent-gru2-2.xx&_nc_gid=Vmy2JqkaL2EK5Zsw3bhRqg&oh=00_AfnUcgWgw8YVq02VX0JCOAaDqSNdzIh-LWsrHV5HSE7odQ&oe=696117AB)
+
+## 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 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_
+
+**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
+
+`<BODY_TEXT>`
+
+_String_
+
+**Obrigatório.**
+
+Corpo de texto. Os URLs são automaticamente inseridos como hiperlink.
+
+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 para `true` para que o cliente do WhatsApp tente renderizar uma prévia de link de qualquer URL na string de texto do corpo.
+
+Veja [Prévia do link](#link-preview) 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`
+
+## Prévia do link
+
+O cliente do WhatsApp pode tentar renderizar uma prévia do primeiro URL na string de texto do corpo, caso contenha um. URLs devem começar com `http://` ou `https://`. Se vários URLs estiverem na string de texto do corpo, apenas o primeiro URL 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 solicitação
+
+Exemplo de solicitação para enviar uma mensagem de texto com prévias de link habilitadas e uma string de texto do corpo contendo um link.
+
+```
+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": "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](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/video_messages.md

@@ -0,0 +1,149 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/video-messages -->
+<!-- Scraped: 2025-12-20T17:27:30.064Z -->
+
+# Mensagens de vídeo
+
+Updated: 3 de nov de 2025
+
+As mensagens de vídeo mostram uma prévia em miniatura de uma imagem de vídeo com uma legenda opcional. Quando o usuário do WhatsApp toca na prévia, o vídeo é carregado e exibido.
+
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/440793312_1179905419842171_7706273386179077435_n.png?_nc_cat=100&ccb=1-7&_nc_sid=e280be&_nc_ohc=iMMgyhQtNO0Q7kNvwE_TsWR&_nc_oc=AdmRG98zUub3EBXriceQm9CgKl4gKtx-sXdDThvd5hM2cbhs_Qm9VvXgp2CmR0M-GUQ&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=dH3KBYgpTBbG0Qdmj1ia3Q&oh=00_AfmKczeWmiJpqkrpdLxsFGEzPCNPCMlFXRA3sOEA-PBRuA&oe=69612F53)
+
+## Como enviar mensagens de vídeo
+
+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 vídeo a um usuário do WhatsApp.
+
+### Sintaxe da solicitação
+
+```
+POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages
+```
+
+### Corpo da publicação
+
+```
+{
+  "messaging_product": "whatsapp",
+  "recipient_type": "individual",
+  "to": "{{wa-user-phone-number}}",
+  "type": "video",
+  "video": {
+    "id" : "<MEDIA_ID>", /* Only if using uploaded media */
+    "link": "<MEDIA_URL>", /* Only if linking to your media */
+    "caption": "<VIDEO_CAPTION_TEXT>"
+  }
+}
+```
+
+### Parâmetros do corpo da publicação
+
+Espaço reservado
+
+Descrição
+
+Valor de exemplo
+
+`<VIDEO_CAPTION_TEXT>`
+
+_String_
+
+**Opcional.**
+
+Texto da legenda do vídeo.
+
+Máximo de 1.024 caracteres.
+
+`A succulent eclipse!`
+
+`<MEDIA_ID>`
+
+_String_
+
+**Obrigatório para usar um ativo de mídia carregado (recomendado)**.
+
+Identificação do ativo de [mídia carregada](/documentation/business-messaging/whatsapp/business-phone-numbers/media#upload-media).
+
+`1166846181421424`
+
+`<MEDIA_URL>`
+
+_String_
+
+**Obrigatório se estiver vinculado ao seu ativo de mídia (não recomendado)**
+
+O URL do ativo de vídeo no servidor público. Para melhor desempenho, recomendamos que você [carregue o ativo de mídia](/documentation/business-messaging/whatsapp/business-phone-numbers/media#upload-media).
+
+`https://www.luckyshrub.com/assets/lucky-shrub-eclipse-viewing.mp4`
+
+`<WHATSAPP_USER_PHONE_NUMBER>`
+
+_String_
+
+**Obrigatório.**
+
+Número de telefone do usuário do WhatsApp.
+
+`+16505551234`
+
+## Formatos de vídeo compatíveis
+
+Apenas 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
+
+## Exemplo de solicitação
+
+Exemplo de solicitação para enviar uma mensagem de vídeo com legenda a um usuário do WhatsApp.
+
+```
+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": "video",
+  "video": {
+    "id" : "1166846181421424",
+    "caption": "A succulent eclipse!"
+  }
+}'
+```
+
+## 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)

package/docs/mensagens/visao_geral/AGENTS.md

@@ -0,0 +1,8 @@
+# Visão Geral
+
+Visão geral sobre envio de mensagens
+
+## Documentos Disponíveis
+
+- [Send Messages](./send_messages.md)
+