# WhatsApp Business Tools MCP: ligar WhatsApp a um agente de IA
> Servidor MCP oficial da Meta para o WhatsApp Business: o que o agente pode fazer, o comando de ligação no Claude Code, a configuração no Codex e no ChatGPT e as limitações da versão beta.
Source: https://ailoot.ai/blog/pt-pt/whatsapp-business-mcp/
Canonical: https://ailoot.ai/blog/pt-pt/whatsapp-business-mcp/
Language: pt-PT
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-234
Revision: sha256-27090a7f5feaf886f78f0a7c67556b2343b4007537df35a8e6c4b910d6b6d5a6
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](https://ailoot.ai/docs/).
## O que é o WhatsApp Business Tools MCP?
Pontos principais
Este é o servidor MCP remoto oficial da Meta, que disponibiliza a um agente de IA ferramentas para gerir a plataforma WhatsApp Business: contas, números de telefone, modelos de mensagem, webhooks e envio de mensagens de teste. O acesso utiliza OAuth: inicia sessão com a sua conta Meta e seleciona as empresas com as quais permite que o servidor trabalhe.
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](https://ailoot.ai/blog/pt-pt/mcp-servers-claude-code/). 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):
Descreve aquilo de que precisas e o agente descobre por si as contas, os números de telefone, os modelos e as chamadas à API.
— Meta for Developers, https://developers.facebook.com/blog/post/2026/09/15/whatsapp-business-messaging-mcp-ai-agent/
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?
Pontos principais
O servidor suporta quatro grupos de tarefas. Configurar um número de telefone desde o início: adicioná-lo, enviar um código de verificação, verificá-lo e registá-lo. Modelos de mensagem: criar e editar um modelo e consultar o respetivo estado de aprovação. Webhooks: indicar um URL de callback e subscrever campos. Verificações de pré-requisitos: o agente deteta quando os termos ainda não foram aceites ou quando o pagamento não foi configurado e fornece uma ligação direta para resolver o problema.
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?
Pontos principais
Três pré-requisitos: a função MANAGE na empresa Meta que pretende gerir; direitos de administrador numa aplicação com o cenário WhatsApp ativado; e aceitação dos termos da WhatsApp Business Cloud API. Se faltar alguma coisa, a ferramenta devolve um erro que explica o problema e inclui uma ligação para a página onde o pode resolver.
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?
Pontos principais
Execute o comando `claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools`, escreva `/mcp` na sessão, selecione o servidor e inicie sessão através da Meta. Depois de reiniciar o cliente, terá de iniciar sessão novamente.
Se ainda não instalou o Claude Code, comece pelo guia [Como instalar o Claude Code a partir do site oficial](https://ailoot.ai/blog/pt-pt/install-claude-code/).
1. ### Adicionar o servidor
No terminal, execute:
```bash
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?
Pontos principais
Os três utilizam o mesmo endereço de servidor e o início de sessão OAuth; só muda a localização nas definições. Codex App: Settings, MCP Servers, adicionar um servidor Streamable HTTP. ChatGPT: Settings, Plugins, adicionar através do URL. Claude Desktop: Settings, Connectors, conector personalizado.
**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?
Pontos principais
A sequência é: listar as empresas, escolher uma, consultar as respetivas contas e números de telefone, adicionar um número de telefone, enviar um código de verificação por SMS ou chamada, verificar o número com o código, registá-lo, criar um modelo, enviar uma mensagem de teste e configurar um webhook. É o próprio utilizador que fornece o código SMS ao agente.
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](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?
Pontos principais
O servidor está em beta: o conjunto de ferramentas pode mudar e o acesso está a ser disponibilizado gradualmente, não a todos ao mesmo tempo. O lançamento destina-se ao desenvolvimento e aos testes; não é adequado para o envio de mensagens em grande escala em produção. Existem limites de pedidos por utilizador para cada ferramenta e é necessário iniciar sessão novamente depois de reiniciar o cliente.
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?
Pontos principais
Agora pode concluir a configuração inicial da integração com o WhatsApp numa única conversa com um agente: este conhece a sequência de passos e compreende os erros da plataforma. Os principais casos de utilização são o apoio ao cliente, as notificações de encomendas e marcações e a preparação de modelos.
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?
Pontos principais
Verifique os pré-requisitos, ligue o servidor com um comando, inicie sessão e consulte em segurança a lista de empresas. Depois, adicione um número de telefone de teste e envie a primeira mensagem. Lembre-se de que está em beta: prepare uma integração completa com a Cloud API para enviar mensagens em produção.
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](https://ailoot.ai/blog/pt-pt/mcp-servers-claude-code/) — mais sete integrações funcionais para diferentes tarefas.
### Fontes
- [Meta for Developers: Anúncio do WhatsApp Business Tools MCP (15.09.2026)](https://developers.facebook.com/blog/post/2026/09/15/whatsapp-business-messaging-mcp-ai-agent/)
- [Meta: Documentação do WhatsApp Business Tools MCP](https://developers.facebook.com/documentation/mcp/whatsapp-business-tools-mcp)
- [Meta: Visão geral dos servidores MCP para programadores](https://developers.facebook.com/documentation/mcp)
- [Plataforma WhatsApp Business: Documentação](https://developers.facebook.com/documentation/business-messaging/whatsapp)
Conheça o [Ailoot](https://ailoot.ai/).
## Perguntas frequentes
### Qual é a primeira verificação de ligação mais segura?
Depois do início de sessão OAuth, examine as ferramentas e leia as empresas que pode gerir. Isto verifica o acesso antes de adicionar telefone, criar modelos, configurar webhooks ou enviar uma mensagem de teste.
### Configurar um webhook também cria o tratamento das mensagens?
Não. O servidor MCP configura o callback e as subscrições, mas tem de criar separadamente o CRM, serviço de apoio ou bot que recebe e processa as mensagens nesse endereço.
## Ailoot · A empresa e a sua carteira de projetos
A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI.
A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões.
A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.