WhatsApp Business Tools MCP

npx add-mcp 'https://mcp.facebook.com/whatsapp_business_tools'

WhatsApp Business Tools MCP

Para desenvolvedores que criam soluções na WhatsApp Business Platform (Cloud API) — o servidor WhatsApp Business Tools MCP permite que seu agente de IA e assistente de IDE gerenciem e depurem sua integração com o WhatsApp Business em um só lugar. Ele permite que um agente descubra as empresas e contas do WhatsApp que você administra, integre e registre números de telefone, crie e gerencie modelos de mensagem, configure webhooks e envie mensagens — agindo como você, nos aplicativos e empresas que você administra.

Observação: Observação: a interface e o conjunto de ferramentas do servidor WhatsApp Business Tools MCP estão em beta e podem mudar.

Visão geral

A tabela a seguir resume os detalhes do servidor:

Atributo	Valor
Nome do servidor	WhatsApp Business Tools
Transporte	HTTP com streaming
Endpoint	https://mcp.facebook.com/whatsapp_business_tools
Autenticação	Login da conta de desenvolvedor da Meta (OAuth)
ID do cliente	Não é necessário. O servidor reconhece automaticamente os clientes compatíveis.
URI de redirecionamento	Não é necessário. Você não cria nem configura um aplicativo da Meta para este servidor.
Clientes compatíveis	Claude Code, Claude Desktop, ChatGPT, Codex CLI, aplicativo Codex
Status	Beta - a interface e o conjunto de ferramentas podem mudar

Antes de começar

Para conectar um cliente, você precisa usar um dos clientes compatíveis listados acima, em uma versão atual.

O servidor está sendo disponibilizado gradualmente, então talvez ainda não esteja disponível para sua conta, mesmo depois que seu cliente se conectar.

O servidor atua nos seus próprios ativos. Portanto, antes que um agente possa usar a maioria das ferramentas, você também precisa de:

• Acesso de administrador a uma empresa que você queira gerenciar (a função MANAGE).
• Um aplicativo com o WhatsApp ativado do qual você seja administrador, conectado a essa empresa — um aplicativo com o caso de uso WhatsApp Business Messaging (ou o produto WhatsApp em um aplicativo mais antigo). Você precisa ter acesso de administrador ao aplicativo, não apenas à empresa.
• Termos de Serviço da WhatsApp Business Cloud API aceitos para essa empresa. O envio de mensagens e o registro de números de telefone ficam bloqueados até que um administrador os aceite.

Se algum pré-requisito estiver faltando, a ferramenta retornará um erro com instruções sobre o que corrigir e um link para a página onde você pode fazer isso.

Conectar seu cliente

Para conectar um cliente compatível e concluir a autorização OAuth, siga Conectar um cliente MCP à Meta. Use o nome e o endpoint do servidor indicados na Visão geral. Este servidor não exige um ID do cliente, então use o registro automático.

Escopos

O servidor solicita as seguintes permissões durante o consentimento:

Escopo	Acesso
business_management	Descobrir e usar as empresas que você administra e selecionou durante o consentimento.
whatsapp_business_management	Gerenciar contas do WhatsApp Business, números de telefone, modelos de mensagem e webhooks.
whatsapp_business_messaging	Enviar mensagens dos seus números de telefone registrados.

Você pode revisar essas permissões e revogar o acesso no Facebook, em Configurações > Sua atividade > Integrações comerciais.

Verificar sua conexão

Peça ao agente para listar as ferramentas disponíveis neste servidor, usando o nome que você informou ao conectá-lo. Em seguida, execute uma ferramenta somente de leitura, como whatsapp_biz_businesses, para listar as empresas que você administra. A conexão está funcionando quando essa chamada retorna suas empresas, em vez de um erro de autenticação ou permissão.

Limites de taxa

As solicitações têm limites de taxa por usuário e por ferramenta para proteger a plataforma. Se você exceder o limite, a ferramenta retornará um erro de limite de taxa; tente novamente após uma breve espera.

Ferramentas

O WhatsApp Business Tools MCP disponibiliza ferramentas com o prefixo de namespace whatsapp_biz_. A maioria das ferramentas é limitada a uma empresa que você administra, então uma sessão típica começa listando suas empresas e escolhendo uma. O conjunto de ferramentas está evoluindo durante o beta.

Descoberta

• whatsapp_biz_businesses — Lista as empresas que você administra e autorizou durante o consentimento. Use esta ferramenta primeiro para escolher uma empresa. Exemplo: "Liste as empresas do WhatsApp que posso gerenciar."
• whatsapp_biz_accounts — Lista as contas do WhatsApp (e as contas de mensagens) de uma empresa. Exemplo: "Mostre as contas do WhatsApp da empresa 1234567890."
• whatsapp_biz_phone_numbers — Lista os números de telefone de uma empresa ou conta do WhatsApp, com o status e o estado da integração. Exemplo: "Liste os números de telefone desta empresa e seus status."

Integração de números de telefone

• whatsapp_biz_add_phone_number — Adiciona um número de telefone a uma conta do WhatsApp. Exemplo: "Adicione o número de telefone +1 555 010 1234 à minha conta do WhatsApp."
• whatsapp_biz_send_verification_code — Envia um código de verificação para um número de telefone. Exemplo: "Envie um código de verificação por SMS para este número."
• whatsapp_biz_verify_phone_number — Verifica um número de telefone com o código recebido. Exemplo: "Verifique este número com o código 123456."
• whatsapp_biz_register_phone_number — Registra um número verificado para que ele possa enviar e receber mensagens. Exemplo: "Registre este número para enviar mensagens."

Modelos de mensagem

• whatsapp_biz_list_templates / whatsapp_biz_get_template — Lista e inspeciona modelos de mensagem de uma conta. Exemplo: "Liste os modelos aprovados desta conta."
• whatsapp_biz_create_template / whatsapp_biz_update_template / whatsapp_biz_delete_template — Cria, atualiza e exclui modelos de mensagem. Exemplo: "Crie um modelo de marketing chamado order_update em en_US."

Mensagens

• whatsapp_biz_send_message — Envia uma mensagem de texto livre (entregue somente durante a janela de atendimento ao cliente de 24 horas) ou uma mensagem de modelo aprovado de um número registrado. Confirma o destinatário com você antes de enviar. Exemplo: "Envie o modelo order_update para +1 555 010 9999 deste número."

Webhooks

• whatsapp_biz_configure_webhooks — Define a URL de callback e o token de verificação para o tópico do WhatsApp e assina os campos permitidos. Exemplo: "Configure os webhooks desta empresa com o callback https://example.com/webhook."
• whatsapp_biz_subscribe_webhook — Inscreve uma conta do WhatsApp nos webhooks do seu aplicativo para que os eventos dela sejam entregues. Exemplo: "Inscreva esta conta do WhatsApp nos webhooks."

Configuração da conta

• whatsapp_biz_configure_payments — Configura uma forma de pagamento para que a conta possa enviar mensagens cobradas. Exemplo: "Ajude-me a configurar os pagamentos desta conta."
• whatsapp_biz_verify_business — Verifica o status da verificação da empresa e inicia o processo. Exemplo: "Qual é o status da verificação da empresa e como posso iniciá-la?"
• whatsapp_biz_system_user_token — Obtém um link para gerar um token de acesso de usuário do sistema para sua empresa, para que você possa criar uma solução de mensagens personalizada que chame diretamente a WhatsApp Cloud API. A geração do token ocorre com segurança nas Configurações da empresa — a ferramenta retorna um link direto para a página Usuários do sistema, onde você seleciona um usuário do sistema e gera o token. Para saber mais, consulte Criar um usuário do sistema e gerar um token de acesso permanente. Exemplo: "Envie-me um link para criar um token de acesso de usuário do sistema para esta empresa."

Comentários

Se você tiver comentários ou quiser ver mais ferramentas, compartilhe seus comentários.

Relacionados

• Visão geral do MCP
• Conectar um cliente MCP à Meta
• Documentação da WhatsApp Business Platform

---

Índice completo da documentação deste produto: https://developers.facebook.com/documentation/mcp/llms.txt