whatsapp-docs-mcp 1.0.0

package/docs/ativos_da_conta/telefones_comerciais/two_step_verification.md

@@ -0,0 +1,66 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/two-step-verification -->
+<!-- Scraped: 2025-12-20T17:24:14.354Z -->
+
+# Confirmação em duas etapas
+
+Updated: 5 de nov de 2025
+
+É necessário configurar a confirmação em duas etapas para seu número de telefone, pois isso fornece uma camada extra de segurança para as contas comerciais. Para isso, faça uma ligação `POST` para `/PHONE_NUMBER_ID` e anexe os parâmetros abaixo. Não existe um ponto de extremidade para desabilitar a confirmação em duas etapas.
+
+Ponto de extremidade
+
+Autenticação
+
+`/PHONE_NUMBER_ID`
+
+(consulte [Obter o ID do número de telefone](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers#get-all-phone-numbers))
+
+Os parceiros de soluções devem fazer a autenticação usando um token de acesso com as permissões `whatsapp_business_management` e `whatsapp_business_messaging`.
+
+### Parâmetros
+
+Nome
+
+Descrição
+
+`pin`
+
+**Obrigatório.**
+
+Um PIN de seis dígitos usado para a confirmação em duas etapas.
+
+### Exemplo
+
+Exemplo de solicitação:
+
+```
+curl -X  POST \
+ 'https://graph.facebook.com/v24.0/FROM_PHONE_NUMBER_ID' \
+ -H 'Authorization: Bearer ACCESS_TOKEN' \
+ -H 'Content-Type: application/json' \
+ -d '{"pin" : "6_DIGIT_PIN"}'
+```
+
+Exemplo de resposta:
+
+```
+{  "success": true}
+```
+
+Todas as chamadas à API exigem autenticação com tokens de acesso.
+
+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 as permissões `whatsapp_business_messaging` e `whatsapp_business_management`. Para saber mais, consulte [Tokens de acesso do usuário do sistema](/documentation/business-messaging/whatsapp/access-tokens#system-user-access-tokens).
+
+## Como redefinir o PIN
+
+Se você esquecer ou perder seu PIN, poderá atualizá-lo seguindo estas etapas no Gerenciador do WhatsApp:
+
+-   Acesse [Configurações](https://business.facebook.com/settings/), entre no Facebook para Empresas e clique na organização que você está usando para gerenciar a WABA (conta do WhatsApp Business).-   Na tela de configurações, clique em **Contas do WhatsApp** e encontre a WABA da qual você deseja atualizar o PIN. Clique na WABA para abrir um painel com as respectivas informações no lado direito da página.-   No painel de informações da WABA, clique em **Configurações**.-   Na nova aba, clique em **Gerenciador do WhatsApp**.-   No Gerenciador do WhatsApp, encontre o número de telefone e clique em **Configurações**.-   Clique em **Confirmação em duas etapas**.-   Na aba de confirmação em duas etapas, clique em **Alterar PIN**.-   Você precisará digitar o novo PIN e confirmá-lo. Seu PIN foi atualizado com sucesso.
+
+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/catalogos/AGENTS.md

@@ -0,0 +1,12 @@
+# Catálogos
+
+Catálogos de produtos e serviços
+
+## Documentos Disponíveis
+
+- [Receive Responses](./receive_responses.md)
+- [Sell Products And Services](./sell_products_and_services.md)
+- [Set Commerce Settings](./set_commerce_settings.md)
+- [Share Products](./share_products.md)
+- [Upload Inventory](./upload_inventory.md)
+

package/docs/catalogos/receive_responses.md

@@ -0,0 +1,28 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/catalogs/sell-products-and-services/receive-responses -->
+<!-- Scraped: 2025-12-20T17:44:16.422Z -->
+
+# Como receber respostas dos clientes
+
+Updated: 22 de out de 2025
+
+Depois de receber mensagens sobre um ou vários itens, os usuários do WhatsApp podem pedir mais informações sobre um produto ou fazer um pedido. Essas ações são comunicadas por meio do webhook de [mensagens](/documentation/business-messaging/whatsapp/webhooks/reference/messages).
+
+## Status de mensagem enviada
+
+Os status de mensagens enviadas (enviada, entregue, lida) são descritos em [webhooks de mensagens de status](/documentation/business-messaging/whatsapp/webhooks/reference/messages/status).
+
+## Como pedir informações
+
+Ao receber uma mensagem de produto único ou de vários produtos, os usuários do WhatsApp podem pedir mais informações enviando um SMS em uma conversa do WhatsApp existente ou tocando no botão **Enviar mensagem para a empresa** ou **Enviar mensagem** ao visualizar um produto específico.
+
+As mensagens enviadas depois de tocar no botão **Conversar com a empresa** ou **Conversar** são descritas em [webhooks de mensagens de texto](/documentation/business-messaging/whatsapp/webhooks/reference/messages/text) e incluirão uma propriedade `context`, cujo valor é um objeto que descreve o produto que o usuário estava visualizando quando tocou no botão.
+
+## Pedidos
+
+Quando um usuário adiciona um ou mais produtos ao carrinho de compras e faz um pedido, um [webhook de mensagens de pedido](/documentation/business-messaging/whatsapp/webhooks/reference/messages/order) é disparado, descrevendo o conteúdo do pedido. Use o conteúdo do pedido para atendê-lo.
+
+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/catalogos/sell_products_and_services.md

@@ -0,0 +1,24 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/catalogs/sell-products-and-services -->
+<!-- Scraped: 2025-12-20T17:43:39.089Z -->
+
+# Vender produtos e serviços
+
+Updated: 4 de nov de 2025
+
+Empresas que usam a WhatsApp Business API podem mostrar e enviar produtos e serviços aos clientes para que eles naveguem por itens e os adicionem ao carrinho sem sair da conversa. Para usar a API em atividades comerciais, siga estes guias:
+
+-   [**Carregar inventário na Meta:**](/documentation/business-messaging/whatsapp/catalogs/sell-products-and-services/upload-inventory) carregue o inventário da empresa usando a API ou o [Gerenciador de Comércio da Meta](https://business.facebook.com/commerce/).-   [**Conectar um catálogo à sua conta do WhatsApp Business:**](https://www.facebook.com/business/help/158662536425974) conecte um catálogo que foi categorizado como **comércio eletrônico** à conta do WhatsApp Business.-   [**Definir configurações comerciais:**](/documentation/business-messaging/whatsapp/catalogs/sell-products-and-services/set-commerce-settings) defina as configurações do telefone comercial.-   [**Compartilhar produtos com os clientes:**](/documentation/business-messaging/whatsapp/catalogs/sell-products-and-services/share-products) use mensagens multiproduto e de produto único para enviar itens aos clientes.-   [**Receber respostas de clientes:**](/documentation/business-messaging/whatsapp/catalogs/sell-products-and-services/receive-responses) rastreie webhooks para receber perguntas e pedidos dos clientes.
+
+## Políticas
+
+Nunca envie mensagens que violem nossas Políticas Comerciais e de Negócios. Além disso, as mensagens multiproduto e de produto único estão sujeitas às regras atuais de compartilhamento de dados e monitoramento aplicadas aos catálogos:
+
+-   Rejeição no nível do catálogo de produtos: o WhatsApp analisa automaticamente os itens adicionados a um catálogo conectado a uma conta do WhatsApp Business. Se um item adicionado violar a política, sinalizaremos o produto, e a empresa será direcionada para as Políticas Comerciais do WhatsApp.-   Opções de denúncia do usuário no nível do catálogo de produtos: os usuários podem denunciar um produto específico enviado por mensagem. Após a denúncia, o produto será analisado para verificação da violação.
+
+As empresas podem usar o [Gerenciador de Comércio da Meta](https://business.facebook.com/commerce/) para contestar a reprovação de itens.
+
+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/catalogos/set_commerce_settings.md

@@ -0,0 +1,163 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/catalogs/sell-products-and-services/set-commerce-settings -->
+<!-- Scraped: 2025-12-20T17:43:57.949Z -->
+
+# Definir configurações comerciais
+
+Updated: 14 de nov de 2025
+
+É possível habilitar ou desabilitar o carrinho de compras e o catálogo de produtos com base no número de telefone comercial. Por padrão, o carrinho de compras é habilitado e o ícone da vitrine fica oculto em todos os telefones comerciais associados a uma conta do WhatsApp Business.
+
+## Requisitos
+
+-   Um [token do sistema](/documentation/business-messaging/whatsapp/access-tokens#system-user-access-tokens) ou um [token de usuário](/documentation/business-messaging/whatsapp/access-tokens#user-access-tokens).-   A permissão [whatsapp\_business\_management](/docs/permissions/reference/whatsapp_business_management).-   Se você estiver usando um [token do sistema](/documentation/business-messaging/whatsapp/access-tokens#system-user-access-tokens), será preciso conceder a esse usuário o controle total sobre a conta do WhatsApp Business.-   Empresas com sede na Índia precisam [cumprir todas as leis relacionadas a vendas online](https://www.facebook.com/help/1104628230079278).
+
+## Obter números de telefone comerciais
+
+Use o ponto de extremidade [Conta do WhatsApp Business > Números de telefone](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers#get-all-phone-numbers) para obter uma lista de todos os telefones comerciais associados a uma conta do WhatsApp Business.
+
+## Habilitar/desabilitar o carrinho
+
+Use o ponto de extremidade [Número de telefone comercial > Configurações comerciais do WhatsApp](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/phone-number-api) para habilitar ou desabilitar o carrinho de compras em um telefone comercial específico.
+
+Caso o carrinho esteja habilitado, os botões relacionados aparecerão nas visualizações da conversa, do catálogo e dos detalhes do produto:
+
+![Three WhatsApp messenger screenshots with callout of various cart UI components displayed](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/513870481_1426428692034436_5288360534924361904_n.png?_nc_cat=108&ccb=1-7&_nc_sid=e280be&_nc_ohc=5pymBygM_iwQ7kNvwH1mkna&_nc_oc=AdkTXUQ3koPh4j6WvZEr9yOb4C_EL6_i_v5QH4Cp35i7FKT-ZOdQ8VHar7Hhv2agkUY&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=_FQiyxAafmeIYrJMY-oK6w&oh=00_Afnj_a1hOebU63dFYHWBST1iW5if8ZCHTFDBzwo31DFt_w&oe=69611F96)
+
+  
+  
+Se estiver desabilitado, os clientes poderão ver os produtos e os respectivos detalhes, mas os botões relacionados ao carrinho não aparecerão em nenhuma visualização.
+
+### Sintaxe da solicitação
+
+```
+POST /<BUSINESS_PHONE_NUMBER_ID>/whatsapp_commerce_settings
+  ?is_cart_enabled=<IS_CART_ENABLED>
+```
+
+### Parâmetros
+
+Espaço reservado
+
+Exemplo de valor
+
+Descrição
+
+`<BUSINESS_PHONE_NUMBER_ID>`
+
+`106850078877666`
+
+A identificação do número de telefone comercial.
+
+`<IS_CART_ENABLED>`
+
+`true`
+
+Booliano. Defina como `true` para habilitar o carrinho ou como `false` para desabilitá-lo. O valor-padrão é `true`.
+
+### Exemplo de solicitação
+
+```
+curl -X POST 'https://graph.facebook.com/v24.0/106850078877666/whatsapp_commerce_settings?is_cart_enabled=true' \
+-H 'Authorization: Bearer EAAJB...'
+```
+
+### Exemplo de resposta
+
+```
+{  "success": true}
+```
+
+## Habilitar/desabilitar o catálogo
+
+Use o ponto de extremidade [Número de telefone comercial > Configurações comerciais do WhatsApp](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/phone-number-api) para habilitar ou desabilitar o catálogo de produtos em um telefone comercial específico.
+
+Caso o catálogo esteja habilitado, o ícone da vitrine e os botões relacionados aparecerão nas visualizações da conversa e do perfil comercial:
+
+![Two WhatsApp messenger screenshots with callout of various catalog UI components displayed](https://scontent-gru2-2.xx.fbcdn.net/v/t39.2365-6/513359223_1234792844894756_6573923522221485884_n.png?_nc_cat=102&ccb=1-7&_nc_sid=e280be&_nc_ohc=AzrG0L1PHAgQ7kNvwFn9tTH&_nc_oc=AdnbPE6B_B8UPQqcpDRH7IYnmFnhVvYC5j3-uVePknS0-cN7CHKkD8b_jUoQMAY2Ys0&_nc_zt=14&_nc_ht=scontent-gru2-2.xx&_nc_gid=_FQiyxAafmeIYrJMY-oK6w&oh=00_Afmy-TY5f7_0OspFOkNvmU9iWlz36M2X6YbQ3reWgRYhxQ&oe=696119F3)
+
+Se estiver desabilitado, o ícone da vitrine e os botões não aparecerão em nenhuma visualização, e a prévia do catálogo com miniaturas não será exibida na visualização do perfil comercial.
+
+Ao desabilitar o catálogo, os links wa.me que direcionam para ele, assim como o botão **Ver catálogo** que aparece quando você envia o link do catálogo em uma mensagem, exibirão o aviso **Link de catálogo inválido** quando tocados.
+
+### Sintaxe da solicitação
+
+```
+POST /<BUSINESS_PHONE_NUMBER_ID>/whatsapp_commerce_settings
+  ?is_catalog_visible=<IS_CATALOG_VISIBLE>
+```
+
+### Parâmetros
+
+Espaço reservado
+
+Exemplo de valor
+
+Descrição
+
+`<BUSINESS_PHONE_NUMBER_ID>`
+
+`106850078877666`
+
+A identificação do número de telefone comercial.
+
+`<IS_CATALOG_VISIBLE>`
+
+`true`
+
+Booliano. Defina como `true` para mostrar o ícone da vitrine do catálogo ou como `false` para ocultá-lo. O valor padrão é `false`.
+
+### Exemplo de solicitação
+
+```
+curl -X POST 'https://graph.facebook.com/v24.0/106850078877666/whatsapp_commerce_settings?is_catalog_visible=true' \
+-H 'Authorization: Bearer EAAJB...'
+```
+
+### Exemplo de resposta
+
+```
+{  "success": true}
+```
+
+## Obter configurações comerciais
+
+Use o ponto de extremidade [Número de telefone comercial > Configurações comerciais do WhatsApp](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/phone-number-api) para obter as configurações de um telefone comercial específico.
+
+### Sintaxe da solicitação
+
+```
+GET /<BUSINESS_PHONE_NUMBER_ID>/whatsapp_commerce_settings
+```
+
+### Parâmetros
+
+Espaço reservado
+
+Exemplo de valor
+
+Descrição
+
+`<BUSINESS_PHONE_NUMBER_ID>`
+
+`106850078877666`
+
+A identificação do número de telefone comercial.
+
+### Exemplo de solicitação
+
+```
+curl -X GET 'https://graph.facebook.com/v24.0/106850078877666/whatsapp_commerce_settings' \
+-H 'Authorization: Bearer EAAJB...'
+```
+
+### Exemplo de resposta
+
+```
+{  "data": [    {      "is_cart_enabled": true,      "is_catalog_visible": true,      "id": "727705352028726"    }  ]}
+```
+
+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)