📡 Referencia de API REST

Todos los endpoints de la API tienen el prefijo /api/ y requieren autenticación vía cookie de sesión. Todas las solicitudes y respuestas usan Content-Type: application/json.

---

Conversaciones

Endpoint	Método	Descripción
/api/conversations	GET	Listar conversaciones (filtros: status, channel_type, tag, search, page)
/api/conversations/{id}	GET	Obtener conversación (resetea unread_count)
/api/conversations	POST	Crear conversación
/api/conversations/{id}/status	POST	Actualizar estado
/api/conversations/{id}/tags	POST	Agregar etiqueta
/api/conversations/{id}/tags/{tag}	DELETE	Eliminar etiqueta
/api/conversations/{id}/assign	POST	Asignar agente

Mensajes

Endpoint	Método	Descripción
/api/conversations/{id}/messages	GET	Listar mensajes
/api/conversations/{id}/messages	POST	Enviar mensaje

Sugerencia de IA

Endpoint	Método	Descripción
/api/ai-suggest?conversation_id={id}	GET	Obtener sugerencia de respuesta con IA

Contactos

Endpoint	Método	Descripción
/api/contacts	GET	Listar contactos
/api/contacts/{id}	GET	Obtener contacto
/api/contacts	POST	Crear contacto
/api/contacts/{id}	PATCH	Actualizar contacto
/api/contacts/{id}	DELETE	Eliminar contacto (admin)

Canales (Solo Admin)

Endpoint	Método	Descripción
/api/channels	GET	Listar canales
/api/channels	POST	Crear canal
/api/channels/{id}	PATCH	Actualizar canal
/api/channels/{id}	DELETE	Eliminar canal

Automatizaciones (Solo Admin)

Endpoint	Método	Descripción
/api/automations	GET	Listar automatizaciones
/api/automations	POST	Crear automatización
/api/automations/{id}/toggle	POST	Alternar activo/inactivo
/api/automations/{id}	DELETE	Eliminar automatización

Analíticas

Endpoint	Método	Descripción
/api/analytics?days=30	GET	Obtener datos de analíticas

Agentes (Solo Admin)

Endpoint	Método	Descripción
/api/agents	GET	Listar agentes
/api/agents	POST	Crear agente
/api/agents/{id}/role	POST	Actualizar rol
/api/agents/{id}	DELETE	Eliminar agente

Configuración

Endpoint	Método	Descripción
/api/settings/workspace	GET	Obtener configuración del espacio de trabajo
/api/settings/workspace	POST	Actualizar espacio de trabajo (admin)
/api/settings/password	POST	Cambiar contraseña

---

Formato de Error

{"error": "Mensaje de error legible"}

Código	Significado
200	Éxito
201	Creado
400	Solicitud Incorrecta
401	No Autenticado
403	Prohibido
404	No Encontrado
409	Conflicto
500	Error Interno