Skip to main content
WH

WhatsApp Cloud

v0.2.1API Key

WhatsApp Cloud API direto da Meta. Distinto dos nossos wrappers Z-API/Evolution/Take Blip/Zenvia — essa é a integração oficial com a Graph API (sem taxas de intermediário, exige WABA aprovada). 11 ferramentas entre mensagens, mídia e templates.

22 ferramentas4 env vars🌐 GLOBALestável no npm

O que seu agente faz

O WhatsApp Cloud dá ao seu agente 22 tools que ele chama direto — escolha as que precisar, no Claude, Cursor ou qualquer cliente MCP.

  • send_text_messageSend a plain text message. For business-initiated conversations outside the 24h customer-service window, use send_template_message instead.
  • send_template_messageSend an approved message template. Required for business-initiated conversations. Templates must be pre-approved by Meta via create_template.
  • send_media_messageSend an image, video, document, or audio. Supply either `link` (public URL) or `id` (media_id from upload_media).
Exemplo de chamada
// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("send_text_message", { /* ... */ });

Instalar

terminal
$ npm install @codespar/mcp-whatsapp-cloud

Quickstart

Adicione esta entrada ao seu claude_desktop_config.json (ou a config de qualquer cliente compatível com MCP).

claude_desktop_config.json
{
  "mcpServers": {
    "whatsapp-cloud": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-whatsapp-cloud"
      ],
      "env": {
        "WHATSAPP_ACCESS_TOKEN": "<your_whatsapp_access_token>",
        "WHATSAPP_PHONE_NUMBER_ID": "<your_whatsapp_phone_number_id>",
        "WHATSAPP_BUSINESS_ACCOUNT_ID": "<your_whatsapp_business_account_id>"
      }
    }
  }
}

Depois de reiniciar, seu agente pode chamar qualquer uma das 22 ferramentas abaixo — teste send_text_message primeiro.

Variáveis de ambiente · 4

Necessárias pra autenticar o server. Armazenadas criptografadas ao usar a hospedagem gerenciada da CodeSpar.

WHATSAPP_ACCESS_TOKEN
obrigatóriosecret

Meta system-user access token (permanent). Used as Bearer token for Graph API.

WHATSAPP_PHONE_NUMBER_ID
obrigatório

WhatsApp Business phone number ID registered with Meta.

WHATSAPP_BUSINESS_ACCOUNT_ID
obrigatório

WhatsApp Business Account (WABA) ID. Used for template management.

WHATSAPP_GRAPH_VERSION
opcional

Graph API version. Defaults to v21.0. Meta bumps quarterly.

Ferramentas disponíveis · 22

Cada ferramenta é independente — seu agente carrega só o que precisa pra reduzir contexto e tempo de resposta.

WRITEsend_text_message
Send a plain text message. For business-initiated conversations outside the 24h customer-service window, use send_template_message instead.
WRITEsend_template_message
Send an approved message template. Required for business-initiated conversations. Templates must be pre-approved by Meta via create_template.
WRITEsend_media_message
Send an image, video, document, or audio. Supply either `link` (public URL) or `id` (media_id from upload_media).
WRITEsend_interactive_message
Send an interactive message (reply buttons or list). Supply a fully-formed `interactive` object per Cloud API spec.
WRITEsend_interactive_cta_url
Send an interactive message with a single CTA URL button. Opens the URL when the recipient taps it. Available without template approval inside the 24h window.
WRITEsend_interactive_flow
Send a WhatsApp Flow message. Flows are Meta's structured UI experiences (forms, appointment booking, etc.) rendered inside WhatsApp.
WRITEsend_location_message
Send a location pin with latitude/longitude and optional name/address.
WRITEsend_contacts_message
Send one or more contact cards (vCard-like). Each contact includes name and at least one of phones, emails, addresses, urls, or org.

Frameworks compatíveis

MCP é um protocolo — qualquer framework que o fale pode montar este server.

Claude Agent SDKAnthropic
OpenAI AgentsOpenAI
Vercel AI SDKVercel
LangChainLangChain
LlamaIndexLlamaIndex
CrewAICrewAI
MastraMastra
Qualquer cliente MCPProtocolo

Perguntas frequentes

Rode `npx -y @codespar/mcp-whatsapp-cloud` e adicione o bloco de config acima ao seu cliente MCP — Claude, Cursor, VS Code ou qualquer cliente compatível com MCP. Sem build, sem SDK. Prefere hospedado? O tier gerenciado da CodeSpar roda pra você, com a auth resolvida.
WhatsApp Cloud — MCP server · 22 tools | CodeSpar