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.

​
Conexiones personalizadas

Al configurar una conexión personalizada en una plataforma de agentes, 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

Para Claude Code y Codex, el camino recomendado es el servidor MCP de Bevits: la conexión usa OAuth, ninguna clave API queda en la configuración y el agente obtiene 20 tools de solo lectura listas para usar. Si prefieres usar la API REST directamente, Claude Code y Codex también pueden llamarla mediante sus herramientas de terminal. 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.