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.

​
Conexões personalizadas

Ao configurar uma conexão personalizada em uma plataforma de agentes, use: Valide primeiro a conexão em GET /me. O organization.id retornado é a identidade estável da conexão.

​
Claude Code e Codex

Para Claude Code e Codex, o caminho recomendado é o servidor MCP da Bevits: a conexão é feita por OAuth, sem API key na configuração, e o agente ganha 20 tools de leitura prontas. Se preferir usar a API REST diretamente, Claude Code e Codex também conseguem chamá-la pelas ferramentas de terminal. 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.