API REST

Todo lo que hace la plataforma desde la UI lo podés hacer también vía API. Auth con JWT, rate limit por tenant, eventos en tiempo real vía WebSocket.

Autenticación

Todas las requests llevan un header Authorization: Bearer <token>. El token es un JWT firmado que obtenés desde el panel del workspace, scoped a un tenant específico.

curl https://api.botsapper.com/v1/conversations \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5..."

Endpoints principales

GET	/v1/conversations	Listar conversaciones con filtros y paginación
GET	/v1/conversations/{id}/messages	Historial de mensajes con cursor-based pagination
POST	/v1/conversations/{id}/messages	Enviar un mensaje (texto, imagen, documento o template)
PATCH	/v1/conversations/{id}/status	Cambiar estado: open, bot, staff, resolved, spam
PUT	/v1/conversations/{id}/tags	Reemplazar el array de etiquetas de la conversación
GET	/v1/messages/search	Búsqueda full-text sobre todos los mensajes
POST	/v1/quick-replies	Crear una respuesta rápida reutilizable
GET	/v1/agent/config	Obtener la configuración actual del agente IA
PUT	/v1/agent/config	Actualizar prompt, modelo, horario activo y reglas

WebSocket de eventos

Conectate a wss://api.botsapper.com/ws?token=... para recibir eventos en vivo: nuevos mensajes, cambios de estado, actualizaciones de delivery e indicador de typing del bot.