Skip to main content
Agentes podem usar a API REST da Bevits para responder perguntas sobre clientes, segmentos, compras, flows e campanhas. Cada API key acessa somente os dados da organização à qual pertence.
Dê ao agente uma chave exclusiva com escopo read. Não cole a chave no prompt, em arquivos versionados ou em logs; disponibilize-a por uma variável de ambiente ou pelo gerenciador de segredos da plataforma.

​
Leme

Ao criar uma conexão personalizada na Leme, use: Valide primeiro a conexão em GET /me. O organization.id retornado é a identidade estável da conexão.

​
Claude Code e Codex

Claude Code e Codex conseguem testar a API usando suas ferramentas de terminal. A API da Bevits é REST; ela não se apresenta diretamente como um servidor MCP. Inicie a ferramenta com a variável disponível no ambiente:
Em seguida, use uma instrução como:

​
Fluxo recomendado para CRM

Para responder “quem são os melhores clientes do segmento VIP e o que eles compraram?”, o agente pode usar apenas três etapas:
  1. GET /segments?q=VIP para localizar o segmento.
  2. GET /segments/{segment_id}/customers?sort=total_spent para ordenar seus clientes.
  3. GET /customers/{customer_id}/purchases para consultar as compras do cliente escolhido.
Oriente o agente a conservar IDs exatamente como foram retornados e a pedir confirmação humana antes de qualquer ação fora dos endpoints de leitura.