Xamann API v1

Autenticação

curl -H "Authorization: Bearer xam_SUA_CHAVE" \
  https://app.xamann.com.br/api/v1/leads

Escopos: read (consultas), write (criar leads), mcp (agentes via POST /api/mcp).

Copiloto jurídico (API)

Briefing executivo e conversa com o mesmo núcleo do Assessor na home. Escopo mcp ou read; informe operadorId (COD_PESSOA).

curl "https://app.xamann.com.br/api/copilot/briefing?operadorId=123&ia=1" \
  -H "Authorization: Bearer xam_SUA_CHAVE"

curl -X POST https://app.xamann.com.br/api/copilot/chat \
  -H "Authorization: Bearer xam_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"operadorId":123,"mensagem":"Clientes sem retorno há 7 dias?"}'

MCP para agentes

Cursor, Claude Desktop e outros agentes usam JSON-RPC ou REST em /api/mcp. Leitura: escopo mcp. Escrita leve (criar_tarefa, atualizar_status_lead): escopo write, sem confirm. Sensível (enviar_template_whatsapp): write + confirm true.

Tools (15): buscar_pessoa, buscar_processo, listar_leads, buscar_tarefas, buscar_prazos, consultar_andamentos, situacao_cliente, listar_conversas_whatsapp, buscar_historico_whatsapp, criar_tarefa, atualizar_status_lead, listar_templates_whatsapp, enviar_template_whatsapp, copilot_briefing, copilot_perguntar.

Respostas longas: POST /api/copilot/chat/stream (SSE). Bridge npm: packages/xamann-mcp-bridge.

# Cursor — mcp.json (HTTP)
{
  "mcpServers": {
    "xamann": {
      "url": "https://app.xamann.com.br/api/mcp",
      "headers": { "Authorization": "Bearer xam_SUA_CHAVE" }
    }
  }
}

# Claude Desktop — stdio bridge
# node scripts/xamann-mcp-stdio.mjs
# env: XAMANN_MCP_URL, XAMANN_MCP_TOKEN

curl -X POST https://app.xamann.com.br/api/mcp \
  -H "Authorization: Bearer xam_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"buscar_pessoa","arguments":{"q":"Maria"}}}'