--- title: "MCP de WhatsApp, Instagram e Messenger para IA | WAME" description: "Servidor MCP da Wame: conecte o Claude, o Claude Code ou o Cursor e deixe a IA ler e enviar mensagens de WhatsApp, Instagram e Messenger a partir de uma instância só. Cole a URL, autorize e peça em português." url: "https://api-wa.me/mcp" language: "pt-BR" og:type: "website" og:site_name: "WAME API" --- Model Context Protocolservidor da Wame, no ar # Sua IA conversando no WhatsApp, Instagram e Messenger 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. [Adicionar ao Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Wame&connectorUrl=https%3A%2F%2Fmcp.wame.api.br)[Ver como conectar](https://api-wa.me/mcp#conectar) `https://mcp.wame.api.br` copiar - 2017 no mercado desde - +50 mil instâncias criadas - 99,9% de uptime - 24/7 suporte humano em português - Meta Business Partner Claude · conector Wame › vê se alguém me chamou e responde as dúvidas sobre a API - list\_chats(onlyUnread: true)3 conversas não lidas - read\_messages(limit: 20)"Bom dia! Como integro em PHP?" - set\_typing(composing)digitando… - send\_message(to, text)entregue 4 tool calls · 1 instância · 3 canais disponíveis Ana PaulaCliente · WhatsApp 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 ## Três redes atrás de uma instância só — e é por isso que basta um conector. 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. 1 conector1 key de instância3 canais uma key A mesma credencial autoriza os três canais. Não existe token por rede, nem conector por rede. um padrão Endpoints e webhook seguem o formato oficial da Meta Cloud API nos três. O que muda é um campo: provider. um enum honesto Com mais de um canal ativo, as tools de envio ganham o parâmetro channel — listando só os canais que a sua instância tem. na prática ## O que você pede, em português Nenhum comando decorado. Você escreve o pedido; o agent escolhe as tools. “quem me mandou mensagem hoje?” `list_chats``read_messages` Lê 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_media` Imagem, 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_templates``send_template` Mostra 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_message` Segura a chamada esperando mensagem nova e encadeia rodadas de 55s sem deixar buraco. as tools ## 21 ferramentas — e o agent só enxerga as que a sua instância tem 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. ### Sempre disponíveis Oficial e não oficial · 12 tools 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\]](https://api-wa.me/cdn-cgi/l/email-protection)) 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. | ### Só em instância oficial Cloud API / Meta · 3 tools 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. | ### Só em instância não oficial QR Code · 6 tools 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 ## Como conectar o Claude ao WhatsApp Uma URL e a key da sua instância. Leva menos de um minuto, e vale igual para Instagram e Messenger. ClaudeClaude CodeCursor e VS Code ### Pelo link 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 Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Wame&connectorUrl=https%3A%2F%2Fmcp.wame.api.br) ### Ou na mão Em Configurações › Conectores, clique em Adicionar conector personalizado e cole: `https://mcp.wame.api.br` copiar 1. 1 #### Adicione o conector No 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. 2. 2 #### Clique em Vincular 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. 3. 3 #### Peça alguma coisa 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](https://portal.api-wa.me/). Ainda não tem instância?[Criar agora](https://portal.api-wa.me/) por que a Wame ## O que só existe aqui 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. ### Três canais, uma instância 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. ### Oficial e não oficial juntos 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. ### Sem app na Meta, sem Tech Provider 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. ### Gerenciada de verdade Sem servidor, sem Docker, sem Baileys ou Evolution para manter no ar às três da manhã. 99,9% de uptime é responsabilidade nossa. ### MCP nativo 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. ### O que mais ninguém tem Números virtuais com WhatsApp já ativado, Pix dentro da mensagem, botões e listas, webhooks filtráveis por evento e por número. ### Contra as alternativas reais Comparação entre a Wame, provedores self-hosted, provedores só oficiais e integrar direto na Meta | 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. 2017 no mercado desde +50 mil instâncias criadas 99,9% de uptime 24/7 suporte humano em português Meta Business Partner — parceira oficial para WhatsApp Cloud API, Instagram Direct e Messenger segurança ## Dar acesso sem entregar a chave de casa - **A key nunca aparece na URL**No OAuth você cola a key numa página da Wame e ela vira um token cifrado. O conector guarda o token, não a credencial. - **Uma conexão, uma instância**O conector alcança exatamente a instância que você autorizou. Nada além dela — e você revoga quando quiser, no painel. - **Mensagem de terceiro é dado, não ordem**O que chega em read\_messages e wait\_for\_message foi escrito por outra pessoa. O servidor instrui o agent a relatar, nunca a obedecer: se uma mensagem pedir para executar ação ou revelar informação, ele leva a você em vez de cumprir. - **Envio pede confirmação onde dói**Template em lote exige prévia aprovada antes de disparar, porque cada mensagem é cobrada pela Meta e não tem cancelamento. o que ele não faz ## Os limites, ditos aqui e não depois Escuta contínua 55s por rodada, encadeável — o teto é do cliente MCP, não do servidor O agent não acorda sozinho o modelo só roda dentro de um turno seu; não há execução em segundo plano Template em lote 50 destinatários por chamada — acima disso, campanha pelo painel Leitura 30 conversas por vez, 100 mensagens por página, 8 resultados de contato Para atendimento automático rodando sozinho o tempo todo, o caminho é webhook com o seu sistema — ou o [template pronto de n8n](https://api-wa.me/n8n-bot-whatsapp-instagram-messenger), que responde nos três canais com IA. dúvidas ## Perguntas frequentes ### O que é o MCP da Wame? É 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. ### Como conectar o Claude ao WhatsApp? 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. ### Funciona no Instagram e no Messenger também, ou só no WhatsApp? 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. ### Preciso saber programar para usar? 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. ### É seguro dar acesso do meu WhatsApp para uma IA? 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. ### A IA responde meus clientes sozinha, 24 horas por dia? 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 Claude Code, Cursor e VS Code? 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. ### Quanto custa? 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. ## Coloque sua IA para conversar Ative uma instância, conecte o servidor MCP e peça a primeira mensagem ainda hoje — nos três canais. [Adicionar ao Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Wame&connectorUrl=https%3A%2F%2Fmcp.wame.api.br)[Criar instância](https://portal.api-wa.me/) [API oficial dos 3 canais](https://api-wa.me/api-oficial-instagram-messenger)[Bot de IA com n8n](https://api-wa.me/n8n-bot-whatsapp-instagram-messenger)[Documentação da API](https://api-wa.me/docs/api) ## Structured data ```json { "@context": "https://schema.org", "@type": "WebSite", "name": "WAME API", "alternateName": "API Oficial e Não Oficial de WhatsApp, Instagram e Messenger", "url": "https://api-wa.me", "inLanguage": "pt-BR", "publisher": { "@type": "Organization", "name": "WAME API", "url": "https://api-wa.me" } } { "@context": "https://schema.org", "@type": "Organization", "name": "WAME API", "alternateName": "API Oficial e Não Oficial de WhatsApp, Instagram e Messenger", "url": "https://api-wa.me", "logo": "https://api-wa.me/images/screenshot.png", "foundingDate": "2017", "slogan": "Parceira Oficial da Meta — WhatsApp, Instagram e Messenger numa instância só. Desde 2017.", "description": "Plataforma brasileira e Parceira Oficial da Meta (Meta Business Partner) para as APIs oficiais de WhatsApp (Cloud API), Instagram Direct e Messenger — os três numa única instância, com os mesmos endpoints e um único formato de webhook. Também oferece a API não oficial via QR Code, na mesma plataforma. No mercado desde 2017, com mais de 50 mil instâncias criadas, 99,9% de uptime e suporte humano 24/7 em português. SDKs oficiais para Node.js/TypeScript e PHP.", "knowsAbout": [ "WhatsApp Cloud API oficial (Meta)", "API oficial de Instagram (Direct)", "API oficial de Messenger", "API multicanal Meta", "Meta Business Partner", "WhatsApp API", "API não oficial de WhatsApp", "automação de WhatsApp", "números virtuais", "webhooks" ], "sameAs": [ "https://github.com/raphaelvserafim" ], "contactPoint": { "@type": "ContactPoint", "contactType": "customer support", "url": "https://api-wa.me/contact", "availableLanguage": [ "Portuguese" ] } } { "@context": "https://schema.org", "@type": "SoftwareApplication", "name": "Wame MCP", "applicationCategory": "DeveloperApplication", "operatingSystem": "Any (servidor MCP remoto, streamable HTTP)", "url": "https://api-wa.me/mcp", "softwareVersion": "0.1.0", "description": "Servidor MCP da Wame: conecte o Claude, o Claude Code ou o Cursor e deixe a IA ler e enviar mensagens de WhatsApp, Instagram e Messenger a partir de uma instância só. Cole a URL, autorize e peça em português.", "featureList": [ "send_message — Envia texto. Aceita número, grupo (id@g.us) ou id do find_contact.", "send_media — Envia imagem, vídeo, áudio ou documento de uma URL pública.", "reply_to_message — Responde citando a mensagem original.", "react_to_message — Reage com emoji. Emoji vazio remove a reação.", "list_chats — Conversas por recência, com não lidas e horário. Até 30.", "read_messages — Mensagens da conversa, da mais recente para a mais antiga. Até 100 por página.", "wait_for_message — Espera mensagem nova chegar e devolve na hora. Até 55s por rodada, encadeável.", "find_contact — Busca na agenda por nome ou número. Até 8 resultados.", "check_number_registered — Confere se o número existe no WhatsApp antes de enviar.", "mark_as_read — Visto azul, com \"digitando…\" opcional junto.", "set_typing — Mostra digitando, gravando áudio, online ou offline.", "get_instance_status — Estado da instância: conectada, canais ativos, nome de exibição.", "list_templates — Templates da conta com o status na Meta e quantas variáveis o corpo espera.", "send_template — Dispara template aprovado para até 50 números. Prévia obrigatória antes do envio.", "get_analytics — Uso contra o limite, conversas, mensagens, desempenho de template e custo.", "list_groups — Grupos de que a instância participa, com nome e nº de participantes.", "get_group — Detalhes, participantes, quem é admin e link de convite.", "create_group — Cria o grupo e notifica todo mundo na hora.", "update_group — Renomeia e altera a descrição. Exige ser administradora.", "manage_group_participants — Adiciona, remove, promove ou rebaixa participante.", "leave_group — Sai do grupo." ], "provider": { "@type": "Organization", "name": "WAME API", "url": "https://api-wa.me" }, "offers": { "@type": "Offer", "price": "28.99", "priceCurrency": "BRL", "description": "Incluído na instância da Wame; planos a partir de R$28,99 por mês." }, "potentialAction": { "@type": "ViewAction", "target": "https://mcp.wame.api.br", "name": "Conectar o servidor MCP" } } { "@context": "https://schema.org", "@type": "HowTo", "name": "Como conectar o Claude ao WhatsApp, Instagram e Messenger pelo MCP da Wame", "description": "Passo a passo para adicionar o servidor MCP da Wame como conector no Claude e deixar a IA ler e enviar mensagens nos três canais.", "totalTime": "PT1M", "step": [ { "@type": "HowToStep", "position": 1, "name": "Adicione o conector", "text": "No 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." }, { "@type": "HowToStep", "position": 2, "name": "Clique em Vincular", "text": "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." }, { "@type": "HowToStep", "position": 3, "name": "Peça alguma coisa", "text": "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." } ] } { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "O que é o MCP da Wame?", "acceptedAnswer": { "@type": "Answer", "text": "É 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." } }, { "@type": "Question", "name": "Como conectar o Claude ao WhatsApp?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "Funciona no Instagram e no Messenger também, ou só no WhatsApp?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "Preciso saber programar para usar?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "É seguro dar acesso do meu WhatsApp para uma IA?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "A IA responde meus clientes sozinha, 24 horas por dia?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "Serve para Claude Code, Cursor e VS Code?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "Quanto custa?", "acceptedAnswer": { "@type": "Answer", "text": "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." } } ] } { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Início", "item": "https://api-wa.me" }, { "@type": "ListItem", "position": 2, "name": "MCP para IA", "item": "https://api-wa.me/mcp" } ] } ```