WhatsApp Business Tools MCP: ligar WhatsApp a um agente de IA

A 15 de setembro de 2026, a Meta lançou o servidor MCP oficial WhatsApp Business Tools. Este liga um agente de IA — Claude Code, Codex, ChatGPT ou Cursor — à plataforma WhatsApp Business. Em vez de alternar entre a Developer Console, o Business Manager e a documentação da API, descreve a tarefa ao agente e este adiciona um número, cria um modelo de mensagem, configura webhooks e envia uma mensagem de teste.

O servidor ainda está em beta: o acesso está a ser disponibilizado gradualmente e o lançamento destina-se ao desenvolvimento e aos testes, não ao envio de mensagens em grande escala em produção. Abaixo encontra as preparações e os passos de ligação para quatro clientes. Os comandos e as definições foram verificados com base na documentação oficial da Meta a 18 de setembro de 2026.

Pode encontrar informações sobre como trabalhar com o Ailoot na documentação.

O que é o WhatsApp Business Tools MCP?#

O MCP (Model Context Protocol) é uma norma aberta para ligar sistemas externos a agentes de IA. Saiba mais no artigo Servidores MCP para Claude Code: 7 integrações prontas a usar. As ligações verificadas com comandos de instalação estão no catálogo MCP.

Antes deste lançamento, configurar uma integração com o WhatsApp era assim: abrir a Developer Console, criar uma aplicação, associar uma empresa, adicionar um número de telefone, verificá-lo com um código, gerar um token, configurar um webhook, consultar a documentação da API — e só então escrever a primeira linha de código.

A Meta descreve assim a ideia por detrás do servidor (traduzido do inglês):

A Meta tem agora dois servidores MCP, que é fácil confundir. O Meta Social Technologies MCP é uma ferramenta de desenvolvimento de uso geral: pesquisa na documentação, descoberta de pontos finais da Graph API e diagnóstico de erros de aplicações. O WhatsApp Business Tools MCP serve para trabalhar com contas WhatsApp, números de telefone, modelos, webhooks e mensagens de teste. Complementam-se e, se necessário, pode ligar ambos.

O que pode exatamente fazer o agente depois de ligado?#

As ferramentas do servidor estão agrupadas sob o prefixo whatsapp_biz_. De acordo com a documentação oficial:

• Visão geral: whatsapp_biz_businesses, whatsapp_biz_accounts, whatsapp_biz_phone_numbers—as empresas, contas e números de telefone a que tem acesso.
• Configuração do número de telefone: whatsapp_biz_add_phone_number, whatsapp_biz_send_verification_code, whatsapp_biz_verify_phone_number, whatsapp_biz_register_phone_number.
• Modelos: whatsapp_biz_list_templates, whatsapp_biz_get_template, whatsapp_biz_create_template, whatsapp_biz_update_template, whatsapp_biz_delete_template.
• Mensagens: whatsapp_biz_send_message—texto livre durante a janela de conversação de 24 horas ou um modelo aprovado fora dessa janela; o agente confirma consigo o destinatário antes de enviar.
• Webhooks: whatsapp_biz_configure_webhooks, whatsapp_biz_subscribe_webhook.
• Configuração da conta: whatsapp_biz_configure_payments, whatsapp_biz_verify_business, whatsapp_biz_system_user_token—uma ligação para criar um token de utilizador do sistema para chamadas diretas à Cloud API.

Quando um cliente envia primeiro uma mensagem à empresa, abre-se uma janela de serviço ao cliente: pode responder com texto livre durante 24 horas. Cada nova mensagem do cliente prolonga a janela. Quando esta se fecha, só pode contactar o cliente com um modelo aprovado. O agente conhece esta regra e, se o destinatário estiver fora da janela, sugere o envio de um modelo em vez de texto normal.

O servidor inclui controlos de acesso. Inicia sessão através da sua conta Meta e seleciona empresas específicas; os tokens não são incluídos no histórico da conversa. Cada leitura é efetuada no seu contexto, as chamadas são registadas e as ações que alteram dados exigem uma pessoa autenticada; uma chave da aplicação do servidor, por si só, não é suficiente.

O que deve verificar antes de ligar?#

O servidor age em seu nome e só trabalha com os seus recursos, por isso verifique o seguinte antes da primeira chamada:

1. Tem uma empresa Meta na qual é administrador (a função MANAGE).
2. Tem uma aplicação Meta com o cenário WhatsApp Business Messaging ativado (ou o produto WhatsApp, nas aplicações mais antigas) e é administrador dessa aplicação especificamente; as permissões ao nível da empresa, por si só, não são suficientes.
3. A empresa aceitou os termos da WhatsApp Business Cloud API — sem isso, o registo do número de telefone e o envio de mensagens ficam bloqueados.

Segundo a Meta, surgem frequentemente problemas com os termos de utilização, os métodos de pagamento e a verificação da empresa sem uma explicação clara. O agente verifica-os antecipadamente e fornece uma ligação direta para aceitar os termos, indicar um método de pagamento ou iniciar a verificação da empresa.

Como ligar o servidor ao Claude Code?#

Se ainda não instalou o Claude Code, comece pelo guia Como instalar o Claude Code a partir do site oficial.

1. Adicionar o servidor

   No terminal, execute:

   claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools
   

   O servidor é remoto, por isso não precisa de o instalar localmente.

2. Iniciar sessão através da Meta

   Numa sessão do Claude Code, escreva /mcp e selecione whatsapp_business_tools. Abre-se uma janela do navegador para iniciar sessão na sua conta Meta. Se o navegador não abrir, copie a ligação do cliente e abra-a manualmente.

3. Conceder permissões

   No ecrã de consentimento, selecione as empresas e as aplicações com WhatsApp a que permite o acesso. O servidor solicitará três permissões: business_management (encontrar empresas nas quais é administrador), whatsapp_business_management (contas, números de telefone, modelos, webhooks) e whatsapp_business_messaging (enviar mensagens a partir dos seus números).

4. Verificar a ligação

   Reinicie o Claude Code, inicie sessão novamente através de /mcp e pergunte ao agente que ferramentas consegue ver no servidor whatsapp_business_tools. Em seguida, faça uma leitura segura: «Lista as empresas que posso gerir» — o agente chama whatsapp_biz_businesses. Se não houver ferramentas ou surgir um erro de início de sessão, verifique o endereço do servidor e inicie sessão novamente.

O início de sessão OAuth está associado ao arranque do cliente: depois de reiniciar o Claude Code, terá de iniciar sessão novamente. Pode revogar o acesso a qualquer momento nas definições em facebook.com, na secção “Business Integrations”.

Como ligar o Codex, o ChatGPT e o Claude Desktop?#

Codex App. Abra as definições (a roda dentada no canto inferior esquerdo), aceda a MCP Servers e selecione Add servers. Escolha Streamable HTTP e introduza:

• Nome: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools
• Autenticação: OAuth

Clique em Authenticate e inicie sessão no navegador.

ChatGPT. Settings, Plugins, Browse plugins, ícone “+” no canto superior direito. Introduza um nome, o mesmo URL e OAuth como tipo de autenticação.

Claude Desktop. Settings, Connectors, Add custom connector. Nome: WhatsApp Business Tools; URL: o mesmo endereço do servidor.

Depois de o adicionar em qualquer cliente, siga a mesma sequência de verificação: reinicie, inicie sessão novamente, consulte a lista de ferramentas e leia em segurança a lista de empresas.

O que acontece na primeira sessão: da lista de empresas à mensagem de teste?#

Uma primeira sessão típica com o servidor ligado:

1. «Lista as empresas que giro» — o agente chama whatsapp_biz_businesses e escolhe a empresa de que precisa.
2. «Mostra-me as contas WhatsApp e os números de telefone desta empresa» — whatsapp_biz_accounts e whatsapp_biz_phone_numbers, com os respetivos estados.
3. «Adiciona o meu número de telefone de teste à conta» — whatsapp_biz_add_phone_number.
4. «Envia um código de verificação por SMS» — whatsapp_biz_send_verification_code. O código chega ao seu telefone.
5. «Verifica o número com o código 123456» — whatsapp_biz_verify_phone_number e, em seguida, regista-o com whatsapp_biz_register_phone_number.
6. «Cria um modelo order_update no idioma preferido pelos destinatários para notificações de encomendas» — whatsapp_biz_create_template; o agente fornece uma ligação para consultar o estado de aprovação.
7. «Envia uma mensagem de teste para o meu número» — whatsapp_biz_send_message; o agente confirma o destinatário antes de enviar.
8. «Configura um webhook em https://example.com/webhook» — whatsapp_biz_configure_webhooks e subscrição através de whatsapp_biz_subscribe_webhook.

Depois disso, as mensagens recebidas dos clientes chegam ao endereço indicado — normalmente, um CRM, um serviço de apoio ao cliente ou um bot vai buscá-las aí. O processamento nesse endereço é desenvolvido separadamente; o servidor trata apenas da configuração.

Quais são as limitações da versão beta?#

Há quatro limitações do servidor a ter em conta.

Estado beta. A Meta afirma que a interface e o conjunto de ferramentas podem mudar e que o acesso está a ser disponibilizado gradualmente. Se ainda não consegue ligar-se ao servidor, é possível que ainda não lhe tenha sido disponibilizado.

Finalidade. O lançamento destina-se ao desenvolvimento e aos testes; não se destina ao envio em massa em produção. Para enviar mensagens em produção, precisará de uma integração completa com a Cloud API — por exemplo, utilizando um token de utilizador do sistema, cuja ligação é disponibilizada pela ferramenta whatsapp_biz_system_user_token.

Limites. Há um limite de pedidos por utilizador para cada ferramenta. Se exceder o limite, a ferramenta devolve um erro de limite — aguarde e tente novamente.

Regra da janela de 24 horas. Fora da janela de conversação com o cliente, só pode enviar modelos aprovados.

Porque é que isto é importante para uma empresa?#

Um cenário típico para uma pequena empresa: os clientes enviam mensagens pelo WhatsApp e pretende responder rapidamente e enviar notificações sobre o estado das encomendas. Anteriormente, a configuração inicial implicava trabalhar por conta própria em vários painéis da Meta ou contratar um programador. Agora, pode concluir esta parte numa conversa com um agente. Continua a ter de desenvolver separadamente o processamento das mensagens recebidas no seu próprio endereço — essa é a tarefa seguinte depois de configurar o webhook.

O servidor também é útil se a sua integração já estiver em funcionamento. Os modelos de mensagem precisam de atualizações regulares: uma nova promoção, um novo texto de notificação. Através do servidor, o agente cria ou edita um modelo e mostra o respetivo estado de aprovação sem o enviar para o painel.

Uma abordagem semelhante — um agente liga-se a um sistema externo e trabalha com ele com base na sua descrição — é ilustrada com documentação no guia Como ligar o NotebookLM ao Claude Code através do MCP.

E agora?#

Passaram três dias desde o anúncio do servidor. Pode começar com um comando e iniciar sessão através da Meta; depois, peça ao agente uma lista das suas empresas. A seguir, conforme as suas necessidades: números de telefone, modelos, webhooks, mensagens de teste.

Pode encontrar outras formas de ligar um agente a sistemas externos na coleção de servidores MCP para Claude Code — mais sete integrações funcionais para diferentes tarefas.

Conheça o Ailoot.