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ê.

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.O Cue, app de agente pessoal da Manus, usa o mesmo servidor: adicione um servidor MCP personalizado com a URL https://api.izap.ai/mcp.

grok.com: vá em grok.com/connectors, clique em New Connector → Custom, cole https://api.izap.ai/mcp e conclua o login.Grok Bot: vá em Settings → Plugins, adicione um conector personalizado e cole 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_message_stats`	Contagens de chats / mensagens / pessoas únicas para uma data ou, com `end_date`, um intervalo (totais e detalhamento por dia em uma chamada, até 92 dias) (o nome legado `get_today_message_stats` ainda é aceito, mas não aparece mais na listagem)
`get_assistant_ratio`	Proporção de mensagens IA-vs-humano para uma data (o nome legado `get_today_assistant_ratio` ainda é aceito, mas não aparece mais na listagem)
`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_messages`	Busca por palavra-chave em uma data ou intervalo (o nome legado `search_today_messages` ainda é aceito, mas não aparece mais na listagem)

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)
`update_assistant_settings`	Atualiza as configurações de um assistente — ativo/pausado, nome, modelo, idioma, tom, saudações, mensagem fora do horário (escrita)

Contatos e mensagens no WhatsApp

Ferramenta	Finalidade
`list_contacts`	Lista os contatos da conta
`list_chats`	Lista as conversas de WhatsApp do negócio
`get_chat_messages`	Lê as mensagens de uma conversa, incluindo os metadados de mídia
`download_media`	Baixa uma foto, áudio ou documento que um cliente enviou
`get_whatsapp_message_status`	Verifica o status de entrega de uma mensagem enviada e o código de erro da Meta
`connect_whatsapp_number`	Gera um link, válido por uma hora, para o fluxo oficial da Meta de conexão de um número de WhatsApp (escrita)
`get_whatsapp_connection_status`	Diagnostica a conexão do WhatsApp: número, WABA id, registro, saúde dos webhooks, sincronização de histórico e o último erro da Meta em linguagem simples
`list_whatsapp_templates`	Lista os templates de mensagem do WhatsApp aprovados
`create_whatsapp_template`	Cria um template e o envia à Meta para aprovação (escrita)
`get_whatsapp_template_status`	Verifica o status de aprovação e o motivo de rejeição de um template
`send_whatsapp_message`	Envia uma mensagem de texto no WhatsApp (escrita)
`send_whatsapp_template_message`	Envia uma mensagem de template aprovado no WhatsApp (escrita)

Biblioteca de mídia

Ferramenta	Finalidade
`list_library_images`	Lista a biblioteca de imagens curadas do negócio
`upload_library_image`	Adiciona uma imagem codificada em base64 à biblioteca (escrita)
`delete_library_image`	Remove permanentemente uma imagem da biblioteca (escrita)
`list_library_documents`	Lista os documentos e vídeos do negócio (PDF, DOCX, MP4)
`upload_library_document`	Adiciona um documento ou vídeo em base64 (escrita)
`delete_library_document`	Remove permanentemente um documento da biblioteca (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_messages (e search_today_messages) tem limite de taxa por usuário, por dia.
create_whatsapp_template retorna assim que a Meta aceita o template para revisão; a aprovação é assíncrona, então consulte get_whatsapp_template_status para o veredito. Um template só aparece em list_whatsapp_templates depois que a Meta o tem — aquela ferramenta lê o catálogo da Meta, não os rascunhos locais.
send_whatsapp_template_message precisa de um arquivo para um template aprovado com cabeçalho de mídia (documento, imagem ou vídeo), indicado de exatamente uma das três formas:
- header_media_image_id — uma imagem que já está na biblioteca de mídia, vinda de upload_library_image ou list_library_images. Preferível para qualquer arquivo reaproveitado: a iZap lê direto do armazenamento, então nada expira e nenhuma URL entra na jogada.
- header_media_document_id — o mesmo para um documento ou vídeo, vindo de upload_library_document ou list_library_documents. O header_kind (document ou video) diz a qual formato de cabeçalho ele serve.
- header_media_url — uma URL https:// publicamente acessível que a iZap busca.
- header_media_base64 — os próprios bytes, para um arquivo avulso. Não é salvo na biblioteca; chame upload_library_image antes se ele precisar ser reutilizável. O tipo é lido do conteúdo, então JPEG, PNG, PDF, MP4 e 3GPP funcionam e um documento de texto ou Office exige header_media_url.
Use header_media_filename para definir o nome que um documento exibe ao destinatário. O arquivo pode mudar a cada envio — só o formato do cabeçalho é fixado pelo template aprovado. Documentos aceitam PDF, texto simples, Word, Excel e PowerPoint de até 100 MB; imagens aceitam JPEG/PNG de até 5 MB e vídeos MP4/3GPP de até 16 MB. Informar um cabeçalho em um template sem cabeçalho de mídia — ou omiti-lo em um que tem — falha antes de qualquer envio.
A biblioteca de mídia guarda GIF e WebP, que o WhatsApp não aceita como imagem de cabeçalho de template. O list_library_images informa usable_as_template_header para cada imagem, para você escolher uma válida em vez de descobrir isso na hora do envio.
Templates com cabeçalho de mídia precisam ser criados no WhatsApp Manager da Meta; o create_whatsapp_template ainda não consegue submetê-los.
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

Biblioteca de mídia

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

​Biblioteca de mídia

​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

Biblioteca de mídia

Transmissões (broadcast)

Notas