Intégrate con la API REST: agentes y datos en tus propios sistemas

Todo lo que hay en la consola está disponible a través de una API REST, de modo que puedes usar los agentes dentro de tu propio sitio web, app móvil, CRM o centro de contactos, y enviar datos automáticamente.

1. Crea una clave

En la consola, abre API & keys, dale a la clave un nombre que indique dónde se usa (por ejemplo, mobile-app-prod) y haz clic en Create key. Cópiala ahora: solo se guarda una huella, por lo que no se podrá volver a mostrar. Guárdala en los secretos de tu servidor, nunca en un sitio web o app que los clientes puedan descargar.

2. Llama a un agente

curl https://servicebuddy.com/api/v1/agents/auto/runs \
  -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"Where is my order 1004?"}]}'

• auto permite que el router elija el agente; o usa una clave específica como personal-shopper.
• Añade "stream": true para recibir la respuesta token a token (server-sent events), junto con eventos de producto, tienda y devoluciones que puedes mostrar como tarjetas.

3. Envía datos

curl https://servicebuddy.com/api/v1/datasets -H "Authorization: Bearer $API_KEY" \
  -F entity=product -F [email protected]

El archivo se mapea y procesa automáticamente. Consulta el progreso con GET /api/v1/datasets/{id}.

Endpoints

Revoca una clave

Haz clic en Revoke junto a ella. Las llamadas con esa clave se detienen de inmediato.