Primeiros passos

Servidor MCP

Conecte Claude, Cursor e outros assistentes de IA à sua caixa de entrada do WhatsApp.

O BatZap expõe um servidor remoto de Model Context Protocol, para que um assistente de IA leia conversas, responda clientes, etiquete, atribua e resolva conversas, e convide pessoas para grupos. Ele usa a mesma chave de API, os mesmos escopos e os mesmos limites de uso da API REST.

Endpoint

https://api.batzap.com/v1/mcp

Conecte um cliente

Qualquer cliente que fale Streamable HTTP conecta direto. Clientes que só falam stdio podem passar pelo proxy mcp-remote.

mcp.json

{
  "mcpServers": {
    "batzap": {
      "type": "http",
      "url": "https://api.batzap.com/v1/mcp",
      "headers": { "Authorization": "bzp_live_SUA_CHAVE_DE_API" }
    }
  }
}

Claude Code

claude mcp add --transport http batzap https://api.batzap.com/v1/mcp \
  --header "Authorization: bzp_live_SUA_CHAVE_DE_API"

Tools

A lista de tools é filtrada pelos escopos da chave: uma tool que a chave não pode usar nem é anunciada. Comece com uma chave somente leitura para testar sem risco.

Tool	Escopo	O que faz
`batzap_list_numbers`	qualquer	Números conectados e o `integration_id` de cada um.
`batzap_list_chats`	`chats:read`	Conversas, com filtro por status, etiqueta, atendente, número ou busca.
`batzap_get_chat`	`chats:read`	Detalhes de uma conversa.
`batzap_read_messages`	`chats:read`	Histórico de mensagens de um contato ou grupo.
`batzap_search_contacts`	`chats:read`	Nome ou telefone para contato.
`batzap_list_tags`	`chats:read`	As etiquetas da organização.
`batzap_create_tag`	`tags:write`	Criar uma etiqueta.
`batzap_tag_chat` / `batzap_untag_chat`	`chats:write`	Colocar ou tirar uma etiqueta de uma conversa.
`batzap_assign_chat`	`chats:write`	Atribuir uma conversa a um atendente.
`batzap_resolve_chat`	`chats:write`	Marcar uma conversa como resolvida.
`batzap_add_note`	`chats:write`	Anotação privada, visível só para o time.
`batzap_reply` / `batzap_send_message`	`messages:send`	Enviar uma mensagem no WhatsApp. Exige `confirm: true`.
`batzap_create_group`	`groups:write`	Criar um grupo no WhatsApp. Exige `confirm: true`.
`batzap_invite_to_group`	`groups:write`	Adicionar pessoas a um grupo, ou mandar o link de convite. Exige `confirm: true`.
`batzap_get_group_invite_link`	`groups:read`	O link de convite do grupo.

Proteções

Confirmação. Tudo que chega numa pessoa exige confirm: true. Sem isso o servidor devolve o texto e o destinatário exatos, para um humano aprovar antes do envio.
Teto de destinatários. No máximo 5 destinatários por chamada: um assistente não transforma um pedido em disparo em massa.
Sem mídia no contexto. Imagens e áudios voltam como um marcador, não em base64.
Sem apagar mensagens. É irreversível, então não é exposto.

Essas regras rodam no servidor, então não dá para afrouxá-las pelo cliente. O transporte é stateless: sem id de sessão e sem push do servidor; GET responde 405.

AnteriorErros Próximo Verificar status