O MCP da Wame é um servidor remoto que dá ao Claude — e a qualquer agent que fale Model Context Protocol — as tools para ler e enviar mensagens nos três canais, em nome de uma instância só. Você cola uma URL, autoriza, e pede em português.
https://mcp.wame.api.br› vê se alguém me chamou e responde as dúvidas sobre a API
4 tool calls · 1 instância · 3 canais disponíveis
Bom dia! Como integro em PHP?
09:41
Bom dia, Ana! Em PHP você usa o SDK oficial ou cURL direto: POST /SUA_KEY/message/text com to e text. Te mando o link da doc?
09:41
O mesmo agent, a mesma instância, a mesma conversa — só o canal muda. Nenhum código foi escrito para isso acontecer.
a diferença
Em qualquer outro lugar, WhatsApp, Instagram e Messenger são três integrações, três credenciais e três conectores para manter. Na Wame são uma conta. O agent aprende um conjunto de tools e alcança as três.
na prática
Nenhum comando decorado. Você escreve o pedido; o agent escolhe as tools.
“quem me mandou mensagem hoje?”
list_chatsread_messagesLê as conversas por recência, com não lidas e horário, e resume o que interessa.
“manda pro 5566999999999 o PDF da proposta”
send_mediaImagem, vídeo, áudio ou documento a partir de uma URL pública, com legenda.
“dispara o template de boas-vindas pra esses 30 contatos”
list_templatessend_templateMostra a prévia primeiro e só envia depois que você aprova. Até 50 por chamada.
“fica de olho e me avisa quando a Ana responder”
wait_for_messageSegura a chamada esperando mensagem nova e encadeia rodadas de 55s sem deixar buraco.
as tools
O servidor monta a lista a partir da instância que você autorizou. Template não aparece em conta não oficial; grupo não aparece em conta oficial. O agent não consegue tentar o que não existe.
Quando a instância tem mais de um canal, as tools de envio ganham o parâmetro channel — com enum contendo só os canais que aquela instância realmente tem.
| tool | parâmetros | o que faz |
|---|---|---|
send_message | to, text, channel? | Envia texto. Aceita número, grupo ([email protected]) ou id do find_contact. |
send_media | to, type, url, caption? | Envia imagem, vídeo, áudio ou documento de uma URL pública. |
reply_to_message | messageId, to, text | Responde citando a mensagem original. |
react_to_message | messageId, emoji | Reage com emoji. Emoji vazio remove a reação. |
list_chats | limit?, onlyUnread? | Conversas por recência, com não lidas e horário. Até 30. |
read_messages | chatId, limit?, page? | Mensagens da conversa, da mais recente para a mais antiga. Até 100 por página. |
wait_for_message | timeoutSeconds?, chatId? | Espera mensagem nova chegar e devolve na hora. Até 55s por rodada, encadeável. |
find_contact | query | Busca na agenda por nome ou número. Até 8 resultados. |
check_number_registered | number | Confere se o número existe no WhatsApp antes de enviar. |
mark_as_read | messageId, typing? | Visto azul, com "digitando…" opcional junto. |
set_typing | to, status | Mostra digitando, gravando áudio, online ou offline. |
get_instance_status | — | Estado da instância: conectada, canais ativos, nome de exibição. |
Template é recurso da WABA. Numa instância não oficial estas tools simplesmente não existem — o agent não vê o que não pode usar.
| tool | parâmetros | o que faz |
|---|---|---|
list_templates | onlyApproved? | Templates da conta com o status na Meta e quantas variáveis o corpo espera. |
send_template | templateName, recipients[], confirm? | Dispara template aprovado para até 50 números. Prévia obrigatória antes do envio. |
get_analytics | report?, since?, until? | Uso contra o limite, conversas, mensagens, desempenho de template e custo. |
A Cloud API não faz grupo nenhum — não lista, não cria, não envia. Numa instância oficial estas tools não aparecem.
| tool | parâmetros | o que faz |
|---|---|---|
list_groups | — | Grupos de que a instância participa, com nome e nº de participantes. |
get_group | groupId, includeInvite? | Detalhes, participantes, quem é admin e link de convite. |
create_group | name, participants[] | Cria o grupo e notifica todo mundo na hora. |
update_group | groupId, name, description | Renomeia e altera a descrição. Exige ser administradora. |
manage_group_participants | groupId, action, participants[] | Adiciona, remove, promove ou rebaixa participante. |
leave_group | groupId | Sai do grupo. |
conectar
Uma URL e a key da sua instância. Leva menos de um minuto, e vale igual para Instagram e Messenger.
Abre o Claude já no formulário de conector, com o endereço preenchido. O Claude vai pedir que você confira a URL antes de continuar — é a proteção dele contra link de origem externa.
Adicionar ao ClaudeEm Configurações › Conectores, clique em Adicionar conector personalizado e cole:
https://mcp.wame.api.brNo Claude, em Configurações › Conectores, clique em Adicionar conector personalizado e cole https://mcp.wame.api.br. Ou use o botão acima, que já abre o modal preenchido.
O Claude abre a página de autorização da Wame, onde você cola a key da instância. Ela está no painel, em Configurações da instância.
Volte para a conversa e mande "quem me chamou no WhatsApp?". O agent já enxerga as tools da sua instância — e só as que ela realmente tem.
A key da instância fica no painel, em Configurações da instância. Abrir o painel.
Ainda não tem instância?Criar agora
por que a Wame
Plataforma brasileira, no mercado desde 2017, Meta Business Partner. A lista abaixo não é posicionamento — é o que você consegue fazer nesta conta e não consegue nas outras.
WhatsApp, Instagram e Messenger oficiais na mesma conta, com os mesmos endpoints e o mesmo envelope de webhook. Uma credencial, um conector, três redes.
QR Code sem app na Meta, ou Cloud API com Embedded Signup — na mesma plataforma e no mesmo SDK. Você escolhe por instância, não por fornecedor.
Nada de criar app no Meta for Developers, virar Tech Provider ou configurar token e webhook na mão. Você ativa uma instância e pronto.
Sem servidor, sem Docker, sem Baileys ou Evolution para manter no ar às três da manhã. 99,9% de uptime é responsabilidade nossa.
A IA opera a conta direto pelo protocolo, sem você escrever uma linha de integração. Não é um bot que você programa: é um agent que já sabe usar.
Números virtuais com WhatsApp já ativado, Pix dentro da mensagem, botões e listas, webhooks filtráveis por evento e por número.
| recurso | Wame | Self-hosted | Só oficial | Direto na Meta |
|---|---|---|---|---|
| WhatsApp, Instagram e Messenger na mesma instância | sim | não | parcial | não |
| Conectar por QR Code, sem app na Meta | sim | sim | não | não |
| API oficial da Meta (Cloud API) | sim | não | sim | sim |
| Servidor MCP pronto para agents de IA | sim | não | não | não |
| Sem virar Tech Provider | sim | sim | sim | não |
| Sem servidor para manter | sim | não | sim | parcial |
| Suporte humano em português | sim | não | parcial | não |
Self-hosted: projetos como Baileys e Evolution API, mantidos por você. Só oficial: provedor que atende apenas a Cloud API. Direto na Meta: montar a integração por conta própria no Meta for Developers.
Meta Business Partner — parceira oficial para WhatsApp Cloud API, Instagram Direct e Messenger
segurança
o que ele não faz
Para atendimento automático rodando sozinho o tempo todo, o caminho é webhook com o seu sistema — ou o template pronto de n8n, que responde nos três canais com IA.
dúvidas
É um servidor MCP (Model Context Protocol) remoto, em https://mcp.wame.api.br, que dá a um agent de IA — Claude, Claude Code, Cursor, VS Code ou qualquer cliente compatível — a capacidade de ler e enviar mensagens de WhatsApp, Instagram e Messenger em nome de uma instância da Wame. O agent ganha tools como send_message, read_messages e wait_for_message, e passa a operar a conta direto, sem você escrever integração.
Em Configurações › Conectores no Claude, clique em Adicionar conector personalizado e cole https://mcp.wame.api.br. Clique em Vincular: o Claude abre a página de autorização da Wame, onde você cola a key da sua instância (ela fica no painel, em Configurações da instância). Pronto — na conversa seguinte o Claude já lista, lê e responde suas mensagens.
Nos três. Uma instância da Wame pode ter WhatsApp, Instagram e Messenger ao mesmo tempo, e o mesmo conector alcança todos. Quando há mais de um canal, as tools de envio ganham o parâmetro channel, com enum contendo apenas os canais que aquela instância realmente tem — o agent não consegue escolher um canal que você não ativou.
Não. Conectar é colar uma URL e uma key. Depois disso você conversa em português com o agent: "quem me mandou mensagem hoje?", "responde a Ana", "manda o PDF pro 5566999999999". Quem programa é quem quer ir além — nesse caso a mesma conta tem REST, SDKs de Node/TypeScript e PHP e webhooks.
A key da instância é a credencial completa: quem a tem, envia e lê por aquela instância. Por isso o caminho recomendado é o OAuth, em que a key vira um token cifrado e nunca aparece na URL do conector. Cada conexão alcança uma instância só, e você revoga no painel quando quiser. O servidor também instrui o agent a tratar mensagem recebida como dado a relatar, nunca como instrução — se um contato mandar algo pedindo para executar ações, o agent leva a você em vez de obedecer.
Não por este caminho, e é importante ser claro: o agent só roda dentro de um turno seu, então ele não é acordado sozinho quando chega mensagem. Dá para pedir que ele fique de olho e ele encadeia rodadas de espera enquanto a conversa está aberta, mas atendimento automático ininterrupto é outro produto — para isso use webhook com o seu sistema, ou o template pronto de n8n da Wame.
Serve para qualquer cliente que fale MCP por HTTP. No Claude Code é uma linha: claude mcp add --transport http wame https://mcp.wame.api.br. Cursor e VS Code têm link de instalação em um clique. Para cliente que só oferece um campo de URL, existe a forma https://mcp.wame.api.br/k/SUA_KEY, e para quem prefere header há o X-API-Key.
O servidor MCP está incluído na instância — não é cobrado à parte. Os planos da Wame começam em R$28,99 por mês. Em instância oficial, as mensagens de template seguem a tarifação da própria Meta.
Ative uma instância, conecte o servidor MCP e peça a primeira mensagem ainda hoje — nos três canais.