Analytics MCP

O servidor iZap MCP permite que um agente de IA opere seu negócio no WhatsApp de ponta a ponta — não apenas enviar uma mensagem. A iZap é uma BSP oficial do WhatsApp que também é dona da camada de aplicação (CRM, chatbots, pedidos, analytics), e este servidor expõe essa camada para qualquer agente via Streamable HTTP em {origin}/mcp: ler analytics, gerenciar seus assistentes de IA e enviar mensagens e transmissões. Com a mesma lógica de negócio e autenticação da API REST. Cada ferramenta é restrita à sua empresa via OAuth e carrega dicas de somente-leitura / destrutivo, então o agente sabe o que é seguro chamar antes de chamar. Títulos e descrições vêm em inglês e português. Conecte o Claude, o ChatGPT ou o Cursor com um clique.

Escolhendo ferramentas de WhatsApp para agentes de IA?

Como a iZap se compara a APIs só de transporte (Twilio, Cloud API, 360dialog) e caixas de entrada no-code — e quando cada uma é a escolha certa.

Ambiente	URL do MCP
Produção	`https://api.izap.ai/mcp`
Staging	`https://api-staging.izap.ai/mcp`

Conectar

A autenticação é OAuth 2.0 (clientes interativos a inicializam automaticamente) ou um Bearer JWT para código servidor-a-servidor. Registre-o como um servidor MCP HTTP remoto:

{
  "mcpServers": {
    "izap": {
      "type": "http",
      "url": "https://api.izap.ai/mcp",
      "headers": { "Authorization": "Bearer ${IZAP_TOKEN}" }
    }
  }
}

Adicionar ao seu cliente de IA

Aponte qualquer cliente compatível com MCP para a URL acima — clientes interativos fazem o login OAuth para você.

Cursor
Claude
ChatGPT
Codex CLI
Manus

Um clique: abra Adicionar iZap ao Cursor e confirme a instalação — ou cole este link no seu navegador:

cursor://anysphere.cursor-deeplink/mcp/install?name=izap&config=eyJ1cmwiOiJodHRwczovL2FwaS5pemFwLmFpL21jcCJ9

Manual — adicione a ~/.cursor/mcp.json (global) ou .cursor/mcp.json (por projeto):

{ "mcpServers": { "izap": { "url": "https://api.izap.ai/mcp" } } }

No claude.ai, vá em Configurações → Conectores → Adicionar conector personalizado, cole https://api.izap.ai/mcp e conclua o login OAuth. Funciona nos planos Pro, Max, Team e Enterprise.

Ative Configurações → Conectores → Avançado → Modo desenvolvedor, depois Adicionar conector personalizado e cole https://api.izap.ai/mcp.

Contas Plus/Pro individuais recebem apenas ferramentas somente-leitura. As ferramentas de escrita (WhatsApp / transmissões) exigem um workspace Business, Enterprise ou Edu.

codex mcp add izap --url https://api.izap.ai/mcp

Ou adicione a ~/.codex/config.toml:

[mcp_servers.izap]
url = "https://api.izap.ai/mcp"

Verifique com /mcp dentro do Codex.

Vá em Settings → Connectors → + Add Connectors → Custom MCP → Import by JSON e cole:

{ "izap": { "url": "https://api.izap.ai/mcp" } }

Ou use Direct Configuration com transporte Streamable HTTP e URL https://api.izap.ai/mcp.

Troque o host pela URL de staging (https://api-staging.izap.ai/mcp) para testar em staging.

Catálogo de ferramentas

Todas as ferramentas aceitam um business_id (UUID) opcional; omita-o para usar sua primeira empresa. As ferramentas de leitura são seguras para chamar à vontade; as marcadas com escrita criam, alteram ou enviam.

Analytics (somente-leitura)

Ferramenta	Finalidade
`get_today_message_stats`	Contagens de chats / mensagens / pessoas únicas para uma data
`get_today_assistant_ratio`	Proporção de mensagens IA-vs-humano para uma data
`get_conversation_duration`	Duração média/mínima/máxima de conversa para uma data
`get_conversation_breakdown`	Detalhamento por conversa para uma data
`search_today_messages`	Busca por palavra-chave nas mensagens de uma data

Assistentes de IA

Ferramenta	Finalidade
`list_connected_assistants`	Lista os assistentes de IA da conta
`get_assistant_instructions`	Lê o prompt e as instruções de um assistente
`create_ai_assistant`	Cria um novo assistente (escrita)
`update_ai_assistant_instructions`	Atualiza o prompt/instruções de um assistente (escrita)

Contatos e mensagens no WhatsApp

Ferramenta	Finalidade
`list_contacts`	Lista os contatos da conta
`list_whatsapp_templates`	Lista os templates de mensagem do WhatsApp aprovados
`send_whatsapp_message`	Envia uma mensagem de texto no WhatsApp (escrita)
`send_whatsapp_template_message`	Envia uma mensagem de template aprovado no WhatsApp (escrita)

Transmissões (broadcast)

Ferramenta	Finalidade
`create_transmission_preview`	Monta uma prévia de transmissão (público + conteúdo) (escrita)
`confirm_transmission`	Envia uma transmissão pré-visualizada (escrita)
`list_transmissions`	Lista as transmissões (broadcast)
`get_transmission_status`	Verifica o status de entrega de uma transmissão

Notas

Datas são strings ISO-8601 (ex.: 2026-04-15); fuso horário é um nome IANA (ex.: America/Sao_Paulo).
search_today_messages tem limite de taxa por usuário, por dia.
Erros de servidor aparecem como erros de ferramenta MCP (isError: true) com a mensagem Error <status>: <detail>; um 401 significa que o token deve ser renovado.

Construa com o MCP no seu código

Obtenha um token e use o SDK MCP em Python ou TypeScript para chamar essas ferramentas a partir da sua própria aplicação ou agente.

Visão geral

Endpoints

Escolhendo ferramentas de WhatsApp para agentes de IA?

Conectar

Adicionar ao seu cliente de IA

Catálogo de ferramentas

Analytics (somente-leitura)

Assistentes de IA

Contatos e mensagens no WhatsApp

Transmissões (broadcast)

Notas

Construa com o MCP no seu código

Escolhendo ferramentas de WhatsApp para agentes de IA?

​Conectar

​Adicionar ao seu cliente de IA

​Catálogo de ferramentas

​Analytics (somente-leitura)

​Assistentes de IA

​Contatos e mensagens no WhatsApp

​Transmissões (broadcast)

​Notas

Construa com o MCP no seu código

Conectar

Adicionar ao seu cliente de IA

Catálogo de ferramentas

Analytics (somente-leitura)

Assistentes de IA

Contatos e mensagens no WhatsApp

Transmissões (broadcast)

Notas