Integração nativa · IA

Seu agente de IA no WhatsApp

O servidor MCP da WPPAPI conecta Claude Code, Claude Desktop e qualquer agente compatível com MCP ao seu número de WhatsApp — em 5 minutos, com copy-paste do painel.

Testar 3 dias grátis Documentação completa

O que é MCP?

MCP (Model Context Protocol) é o padrão aberto que dá "mãos" a agentes de IA: em vez de só conversar, o agente chama tools — funções reais expostas por um servidor. O pacote@iproute/wppapi-mcpé esse servidor para o seu WhatsApp: ele roda na sua máquina ou no seu servidor e transforma a sua instância WPPAPI em tools que qualquer agente compatível sabe usar.

O diferencial é o human-in-the-loop nativo: com a toolask_user, o agente te chama no WhatsApp quando precisa de uma decisão eaguarda a sua resposta antes de continuar. Nenhum webhook público para configurar — o recebimento é por polling na API.

Human-in-the-loop

O agente pergunta antes de agir

Tarefas longas não ficam mais travadas esperando você voltar ao terminal. O agente manda a pergunta no seu WhatsApp, você responde de onde estiver, e ele segue com a sua decisão.

Aprovações: “posso publicar esse deploy?” — você responde sim/não
Dúvidas no meio da tarefa: “qual ambiente: staging ou produção?”
Notificações de progresso e conclusão com notify_user
Modo listener: suas mensagens no WhatsApp viram tarefas do agente

agente:  preciso de uma aprovação…
         → ask_user("Posso deletar os
           arquivos da pasta tmp?")

você (no WhatsApp): "pode, menos o .env"

agente:  entendido — deletei tudo,
         exceto o .env ✅

As 9 tools

Envio, leitura e human-in-the-loop — tudo com escopo de API keySEND, separada do token principal e revogável a qualquer momento.

whatsapp_statusStatus da instância (conectada? qual número?)

send_messageEnvia texto para um número ou chatId (grupos incluídos)

send_fileEnvia mídia por URL (imagem, arquivo, vídeo, voz)

check_numberVerifica se um número tem WhatsApp

list_chatsLista as conversas recentes

get_messagesLê as mensagens recentes de uma conversa

notify_userTe notifica no WhatsApp (sem bloquear o agente)

ask_userTe pergunta no WhatsApp e aguarda a sua resposta

wait_for_replyContinua aguardando uma resposta, sem reenviar a pergunta

Configuração em 1 minuto

Na aba IA / Agentes do detalhe da instância, o painel gera a credencial e os snippets já preenchidos. Para o Claude Code, é um comando:

claude mcp add whatsapp \
  --env WPPAPI_BASE_URL=https://api.wpp-api.com \
  --env WPPAPI_INSTANCE_ID=sua-instancia \
  --env WPPAPI_TOKEN=sua-api-key \
  --env WPPAPI_OWNER_PHONE=5511999999999 \
  -- npx -y @iproute/wppapi-mcp

Também há snippet pronto para Claude Desktop (.mcp.json) e para o modo HTTP com autenticação (WPPAPI_MCP_AUTH_TOKEN), para agentes rodando em servidor.

Boas práticas (leia antes de automatizar)

A WPPAPI é uma API não-oficial do WhatsApp: automação agressiva (rajadas, mensagens frias em massa) pode levar ao banimento do número. Prefira fluxos em que o destinatário espera a mensagem.
Use uma API key de escopo SEND para o agente — nunca o token principal da instância.
No modo HTTP, defina sempreWPPAPI_MCP_AUTH_TOKEN ou exponha apenas em rede confiável.
Respeite opt-in e LGPD: o fato de o agente poder escrever para qualquer número não significa que ele deva.

5 minutos para o primeiro “oi” do seu agente

Crie a conta, conecte uma instância e gere a credencial na aba IA / Agentes. Sem cartão.

Começar trial de 3 dias