Skip to main content
Los agentes pueden usar la API REST de Bevits para responder preguntas sobre clientes, segmentos, compras, flows y campañas. Cada clave API solo puede acceder a la organización a la que pertenece.
Proporciona al agente una clave exclusiva con el permiso read. No pegues la clave en prompts, archivos versionados o logs; entrégala mediante una variable de entorno o el gestor de secretos de la plataforma.

​
Leme

Al crear una conexión personalizada en Leme, usa: Primero valida la conexión con GET /me. El organization.id retornado es la identidad estable de la conexión.

​
Claude Code y Codex

Claude Code y Codex pueden probar la API mediante sus herramientas de terminal. La API de Bevits es REST; no se presenta directamente como un servidor MCP. Inicia la herramienta con la variable disponible en el entorno:
Luego utiliza una instrucción como:

​
Flujo recomendado para CRM

Para responder “¿quiénes son los mejores clientes del segmento VIP y qué compraron?”, el agente puede usar solo tres pasos:
  1. GET /segments?q=VIP para encontrar el segmento.
  2. GET /segments/{segment_id}/customers?sort=total_spent para ordenar sus clientes.
  3. GET /customers/{customer_id}/purchases para consultar las compras del cliente elegido.
Indica al agente que conserve los IDs exactamente como fueron retornados y que solicite confirmación humana antes de cualquier acción fuera de los endpoints de solo lectura.