O trabalho de conectar uma IA ao WhatsApp sempre foi o mesmo: escrever a integração. Definir as funções, descrever cada parâmetro para o modelo, tratar a resposta, manter isso vivo quando a API muda. Meia semana de trabalho antes de a primeira mensagem sair.

O MCP corta essa etapa. A WAME publica um servidor Model Context Protocol em https://mcp.wame.api.br, e o seu agente descobre sozinho o que consegue fazer.

O que muda na prática

Sem MCP, você escreve algo assim para cada capacidade que o agente precisa:

const tools = [{
  name: 'enviar_whatsapp',
  description: 'Envia uma mensagem de texto no WhatsApp',
  parameters: {
    type: 'object',
    properties: {
      to: { type: 'string', description: 'Número com DDI' },
      text: { type: 'string' },
    },
    required: ['to', 'text'],
  },
}];
// ...e o handler que de fato chama a API, e o tratamento de erro,
// e a mesma coisa de novo para ler conversas, mandar mídia, criar grupo...

Com MCP, você não escreve nada disso. O servidor já declara as ferramentas, e o agente as lê ao conectar.

Conectar

No Claude Code, um comando:

claude mcp add --transport http wame https://mcp.wame.api.br

Em Cursor, Claude Desktop ou qualquer cliente com interface de MCP, o caminho é o mesmo: adicionar um servidor HTTP e colar https://mcp.wame.api.br. O cliente pede a autorização da sua instância e pronto.

Depois disso, você conversa:

"Veja se alguém do time comercial ficou sem resposta hoje e me mostre."

E o agente chama find_pending_replies e list_chats por conta própria. Você não escolheu a ferramenta — ele escolheu.

As 21 ferramentas

Elas cobrem o ciclo inteiro de uma conversa, não só o disparo:

Conversar

Ler e entender

Operar

Grupos

list_groups, get_group, create_group, update_group, manage_group_participants, leave_group — criar grupo, entrar, sair, adicionar e remover participante.

Três canais, o mesmo agente

send_message aceita channel. Isso não é detalhe de API: é consequência de a WAME entregar WhatsApp, Instagram Direct e Messenger na mesma instância, com um único formato de webhook.

O agente que responde no WhatsApp responde no Direct do Instagram sem uma linha a mais. Se você já leu sobre os três canais na mesma API, é a mesma instância — agora acessível por IA.

Onde isso é útil de verdade

Triagem de caixa de entrada. "Quais conversas de ontem ficaram sem resposta e qual o assunto de cada uma?" O agente lê, resume e devolve uma lista. Ninguém abre 40 conversas na mão.

Operação assistida. "Manda o comprovante em PDF pro cliente que perguntou sobre a nota fiscal." Ele acha o contato, encontra a mensagem e envia a mídia.

Suporte a quem desenvolve. Dentro do Cursor ou do Claude Code, com o MCP conectado, dá para testar o comportamento real da API enquanto você escreve o código que vai usá-la. O agente manda a mensagem de teste, lê o que chegou e você compara com o que o seu handler esperava.

Automação em fluxo. No n8n, o mesmo servidor MCP entra como ferramenta de um nó de agente — útil quando o fluxo já existe e você só quer dar a ele capacidade de conversar. Se o seu caso é um bot completo com memória por contato, o caminho mais direto continua sendo o template pronto de n8n.

O que o MCP não é

Não substitui a API. Se o seu sistema precisa mandar uma confirmação de pedido quando o status muda no banco, isso é uma chamada da sua API, não um agente decidindo. Código determinístico continua sendo a resposta certa para fluxo determinístico.

Não é um bot pronto. O MCP dá capacidade ao agente; a conversa, o tom e as regras continuam sendo sua definição.

Não dá acesso ao que você não autorizou. O escopo é a instância conectada. E send_template, que é a única ferramenta capaz de atingir muita gente de uma vez, pede confirm antes de disparar — de propósito.

Como começar

1. Crie uma instância no portal — a não oficial conecta por QR Code em segundos, e serve perfeitamente para testar.
2. Conecte o MCP com o comando acima.
3. Peça algo simples ao agente: "qual o status da minha instância?". Se ele responder, está tudo no lugar.
4. Só então aponte para a instância de produção.

A página do MCP da WAME tem a referência completa das ferramentas, os limites de cada uma e os prompts que costumam funcionar melhor.

Conclusão

Integrar IA ao WhatsApp deixou de ser um projeto e virou uma linha de configuração. O ganho real não é economizar as horas da integração — é que, quando a API ganha uma capacidade nova, o agente passa a enxergá-la sem você reescrever nada. A ferramenta nova aparece na lista, e ele a usa.

Se você entrega sistemas para clientes, isso vale ainda mais: o mesmo código serve todo projeto, e agora o mesmo agente também.

Perguntas frequentes

O que é o MCP da WAME?+

É um servidor Model Context Protocol hospedado em https://mcp.wame.api.br que expõe a WAME API como ferramentas para agentes de IA. Em vez de você escrever código para o agente falar com o WhatsApp, ele descobre as ferramentas sozinho e chama direto: enviar mensagem, ler conversas, responder, criar grupo, disparar template.

Preciso programar para usar o MCP?+

Não para conectar. No Claude Code é um comando: claude mcp add --transport http wame https://mcp.wame.api.br. Em clientes com interface, você cola a URL do servidor. A partir daí o agente já enxerga as ferramentas. Programar só é necessário se você quiser embutir isso dentro do seu próprio produto.

O MCP funciona com WhatsApp, Instagram e Messenger?+

Sim. As ferramentas de envio aceitam um parâmetro de canal, porque a WAME entrega os três canais oficiais da Meta numa única instância. O mesmo agente atende os três sem integração separada por canal.

É seguro dar acesso do WhatsApp a um agente de IA?+

O acesso é o da instância que você autorizou, e nada além. Ferramentas de disparo em massa, como o envio de template para vários destinatários, exigem confirmação explícita antes de executar. A recomendação é começar com uma instância de teste e só depois apontar para a de produção.

Qual a diferença entre usar MCP e usar a API direto?+

A API direto é para o seu sistema: código que você escreve, testa e faz deploy. O MCP é para o agente: ele lê a descrição das ferramentas e decide qual chamar em tempo de execução. Os dois usam a mesma instância e a mesma conta — MCP não substitui a API, ele evita escrever integração para o caso em que quem age é uma IA.

Continue lendo

Como criar um chatbot de IA com a API da OpenAI para responder no WhatsApp

Um webhook, uma chamada à API da OpenAI e uma resposta pela WAME API: o código completo de um chatbot de IA que atende no WhatsApp, Instagram e Messenger. Com memória por contato, controle de custo e o que fazer quando a IA não deve responder.

Cobrança por Pix dentro do WhatsApp pela API: como enviar e o que muda na conversão

Mandar o código Pix no WhatsApp resolve o pior ponto da cobrança digital: o cliente não precisa sair do app. Como enviar a cobrança pela API, tratar a confirmação e evitar os erros que transformam a facilidade em suporte.

Erros da API do WhatsApp: o que cada um significa e como tratar

A mensagem não saiu e o log diz apenas 'erro ao enviar'. Os erros que você vai encontrar de verdade — janela fechada, número inválido, template não aprovado, limite atingido, instância caída — e o tratamento certo para cada um.