Servidor MCP de WhatsApp: enviar e ler mensagens do WhatsApp com um agente de IA
Um servidor MCP de WhatsApp transforma a Cloud API em ferramentas que um agente pode chamar: abrir uma conversa, enviar uma mensagem, ler a caixa de entrada, enviar um template aprovado. Publicar ele não pode, porque o WhatsApp não tem publicações. O difícil não é o encanamento, é a janela de 24 horas. Tudo abaixo foi verificado em 21 de outubro de 2026.
O que um servidor MCP de WhatsApp pode e não pode fazer
O WhatsApp é um canal de conversa, não uma superfície de publicação. Então a lista de ferramentas que um agente recebe é curta e afiada: listar conversas, abrir uma conversa por número de telefone em formato internacional, enviar texto, enviar um template aprovado, ler mensagens recebidas. Não há publicações, não há comentários e portanto não há analytics. Qualquer servidor MCP de WhatsApp que te prometa reach e impressions está descrevendo algo que não existe na API.
O que precisa embaixo é uma conta do WhatsApp Business. Na PlugKit essa conexão passa pelo Embedded Signup da Meta: chame GET /v1/connect/whatsapp?profileId=..., abra a authUrl que ele devolve, e a pessoa entra com o Facebook, escolhe ou cria uma WABA e verifica o número. As permissões pedidas são whatsapp_business_messaging e whatsapp_business_management.
Uma pegadinha da documentação da PlugKit que custa um dia: conecte um número real. Um número de teste da Meta carrega um token de 24 horas e para de funcionar na manhã seguinte, o que parece exatamente uma integração quebrada.
A janela de 24 horas, vista por um agente
Esta é a regra que decide se a mensagem do seu agente sai ou não. Texto livre só é aceito dentro de 24 horas desde a última mensagem do contato para você. Fora dessa janela, texto livre é recusado e só um template aprovado passa.
Para um agente, isso tem uma consequência prática que a maioria dos tutoriais pula. O agente não consegue saber, pelo texto de um pedido, se a janela está aberta; ele precisa ler a conversa primeiro. Então o laço útil é: listar a conversa, olhar o timestamp da última mensagem recebida e depois escolher entre texto livre e template. Um agente que pula a leitura vai produzir falhas cheias de confiança, e dizer para alguém que a mensagem saiu quando ela foi recusada é pior do que um erro.
As campanhas seguem a mesma janela. Não existe ajuste que a abra.
Templates: a única saída da janela
Um template é texto pré-aprovado com marcadores numerados. Liste os aprovados em uma conta com GET /v1/accounts/{ACCOUNT_ID}/message-templates, e então envie passando template com name, language e variables, que preenchem {{1}}, {{2}} na ordem. Nome e idioma precisam coincidir exatamente, e components aceita componentes crus da Meta quando você precisa de um header ou de botões.
Duas coisas para dizer explicitamente ao seu agente. Ele não pode inventar um template, porque a aprovação acontece fora do seu código. E ele não deve escolher um template cuja categoria não combina com a intenção: a cobrança por mensagem da Meta fatura por categoria, então mandar um template de marketing para fazer o trabalho de um utility é um custo que você causa a si mesmo.
O que as mensagens custam
A Meta passou a cobrar por mensagem em 1 de julho de 2025, substituindo o antigo modelo por conversa. Você paga na entrega, pela categoria da mensagem e pelo código do país do destinatário. Mensagens dos usuários para você são gratuitas.
| Categoria | Precisa de template aprovado | Enviável fora da janela de 24 horas | Cobrado |
|---|---|---|---|
| Marketing | sim | sim | sim |
| Utility | sim | sim | sim, e desde 1 de outubro de 2026 também dentro de uma janela de atendimento aberta |
| Authentication | sim | sim | sim |
| Service | não | não | as primeiras 1 000 por número comercial e por mês não são cobradas desde 1 de outubro de 2026, depois disso sim |
| Meta Business Agent | não | não | sim, por token em vez de por mensagem |
Três datas para manter claras: cobrança por mensagem desde 1 de julho de 2025; a categoria Meta Business Agent acrescentada em 1 de julho de 2026; e 1 de outubro de 2026, que trouxe as 1 000 mensagens de serviço não cobradas por número e por mês, sem acumular, mais a cobrança de mensagens utility enviadas dentro de uma janela de atendimento aberta. A Meta só muda preços no primeiro dia de um trimestre, o que faz desta uma das contas mais fáceis de prever.
Um ponto positivo que vale aproveitar: quando alguém te escreve de um anúncio Click to WhatsApp no Android ou no iOS e você responde dentro da janela de atendimento, abre uma janela de ponto de entrada gratuito de até 7 dias, durante a qual mensagens de marketing, utility, authentication e service não são cobradas. Mensagens do Meta Business Agent continuam sendo. A tabela completa está em Preços da API do WhatsApp Business.
Por que automatizar o WhatsApp Web é o atalho errado
Procure um servidor MCP de WhatsApp e a maior parte do que você encontra pilota o WhatsApp Web ou uma biblioteca cliente de engenharia reversa, normalmente pareando um número pessoal por QR code. A demo fica ótima. Também significa que um cliente não oficial está mandando tráfego em nome do seu número, o que é o caminho direto para perdê-lo, e quando ele vai embora você perde o número que seus clientes já têm. Para isso não existe fila de recurso.
A Cloud API oficial custa dinheiro por mensagem e obriga você a aprovar templates. Essas duas frições são o que você está comprando: o número continua seu. O mesmo raciocínio vale em todas as plataformas, e a versão ampla está em automação do WhatsApp.
Conecte no Claude, ChatGPT ou Cursor
O servidor MCP hospedado da PlugKit cobre o WhatsApp junto com as plataformas de publicação, então um único endpoint dá as duas coisas a um agente. Ele fica em https://api.plugkit.co/mcp sobre Streamable HTTP, com 103 tools e três workflows prontos em 21 de outubro de 2026. No Claude Code:
claude mcp add -t http plugkit https://api.plugkit.co/mcp
Nos apps do Claude, Customize, depois Connectors, depois Add, depois um conector personalizado, e cole a mesma URL. O ChatGPT aceita no modo desenvolvedor. Cursor e VS Code aceitam um link de um clique ou algumas linhas de JSON. A autenticação é OAuth 2.1 com PKCE e sem client secret, com mcp:read para ler conversas e mcp:write para enviar. Comece com mcp:read por uma semana: ler uma caixa de entrada é reversível, enviar uma mensagem de WhatsApp para um cliente não é.
Se as mensagens recebidas pararem de chegar, a correção é POST /v1/connect/whatsapp/{ACCOUNT_ID}/subscribe-webhooks, que reinscreve sem reconectar. Quando os envios falham, leia GET /v1/accounts/{ACCOUNT_ID} para isActive, needsReconnection e disconnectedReason; a Meta pode se recusar a atender um número mesmo com o token perfeitamente válido, e isso aparece como erro da Meta, não como erro de autenticação.
A PlugKit custa $49 por mês para 5 contas conectadas, cancela quando quiser, com 7 dias grátis sem cartão e uma conta conectada durante o teste. As taxas das mensagens de WhatsApp são da Meta e cobradas pela Meta, não repassadas pela PlugKit. Para o mesmo padrão em plataformas que têm publicações, veja o servidor MCP do Instagram e o servidor MCP do LinkedIn.
Perguntas frequentes
O Claude pode enviar mensagens de WhatsApp?
Sim, por um servidor MCP conectado à WhatsApp Cloud API. O Claude não tem acesso próprio ao WhatsApp. Com o servidor adicionado, enviar uma mensagem é uma chamada de ferramenta, sujeita às mesmas regras de janela de 24 horas e de templates que qualquer outro cliente da Cloud API.
Existe um servidor MCP de WhatsApp oficial da Meta?
Não. A Meta publica a Cloud API; a camada MCP é construída por terceiros em cima dela. É por isso que vale checar se um servidor usa a Cloud API ou pilota o WhatsApp Web, porque só o primeiro é autorizado.
Por que a mensagem de WhatsApp do meu agente foi recusada?
Quase sempre a janela de 24 horas. Se o contato não te escreveu nas últimas 24 horas, texto livre é recusado e você precisa de um template aprovado. A segunda causa mais comum é um nome ou idioma de template que não coincide exatamente.
Um servidor MCP de WhatsApp pode ler meu histórico de mensagens?
Ele consegue ler as conversas que chegaram pelo número comercial conectado, entregues por webhook. Ele não consegue importar o histórico de uma conta pessoal do WhatsApp, e qualquer coisa que diga fazer isso está pilotando um cliente não oficial.
O WhatsApp dá algum analytics para um agente?
Não. Não existem publicações no WhatsApp, então não existem métricas de publicação. Estados de entrega e de leitura existem no nível da mensagem, mas reach, impressions e engajamento não se aplicam a esse canal.
Um plug para cada plataforma que seu agente usa
$49 por mês para 5 contas conectadas, cancele quando quiser. Todos os recursos em todos os planos.
Pegue sua chave de API →