Referencia de API

Construye integraciones personalizadas, automatiza flujos de trabajo y gestiona asistentes programáticamente.

Nota: La API de aplicación de CollowAI se ejecuta en Railway. Hay endpoints REST disponibles para el chat del widget, webhooks y acceso programático. Consulta las secciones siguientes para más detalles.

Endpoints HTTP

Estos endpoints HTTP están disponibles para incrustación de widgets y manejo de webhooks:

POST/api/chat

Envía un mensaje a un asistente y recibe una respuesta generada por IA. Usado por el widget incrustable. Acepta ID del asistente, mensaje del usuario y contexto de conversación opcional.

POST/api/webhooks/polar

Receptor de webhooks para eventos de pago de Polar.sh (suscripciones, facturas, etc.). Configura esto en la configuración de organización de tu Polar.sh.

API Backend

La API de aplicación de CollowAI se ejecuta en Railway. Todos los endpoints son accesibles a través de la API REST. Los grupos de recursos comunes incluyen:

Asistentes

Crear, actualizar, eliminar y consultar asistentes. Gestiona sus configuraciones, modelos y estado.

Conversaciones

Listar conversaciones, enviar mensajes y recuperar el historial de mensajes de cualquier asistente.

Fuentes de Conocimiento

Subir documentos, gestionar conexiones de base de datos y configurar bases de conocimiento para cada asistente.

Integraciones

Conectar y gestionar integraciones de terceros, ver estado de sincronización y disparar sincronizaciones manuales.

Configuración del Widget

Configurar y recuperar ajustes del widget incluyendo marca, posicionamiento y CSS personalizado para chat incrustado.

Segundo Cerebro

Consultar conocimiento estructurado: entidades, hechos, temas, relaciones y conflictos extraídos de tus documentos.

Facturación y Suscripciones

Consultar estado de suscripción, listar facturas y gestionar información de facturación.

Uso del SDK Cliente

Para integraciones personalizadas, usa la API REST directamente:

# List assistants
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants

# Create an assistant
curl -X POST \
  -H "Authorization: Bearer assai_*" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Assistant"}' \
  https://api.collowai.com/api/v1/assistants

# Get Second Brain stats
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/stats

# List brain entities
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/entities

# List brain facts
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/facts

# List brain topics
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/topics

# List brain relationships
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/relationships

# List brain conflicts
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/conflicts

# Get brain extractions history
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/extractions

Autenticación

Las solicitudes de API se autentican usando claves API generadas desde tu panel (Configuración → Claves API). Incluye tu clave en el encabezado Authorization:

Authorization: Bearer YOUR_API_KEY