📡 Référence API REST

Tous les endpoints API sont préfixés par /api/ et nécessitent une authentification via cookie de session. Toutes les requêtes et réponses utilisent Content-Type: application/json.

---

Conversations

Endpoint	Méthode	Description
/api/conversations	GET	Lister les conversations (filtres : status, channel_type, tag, search, page)
/api/conversations/{id}	GET	Obtenir une conversation (remet unread_count à zéro)
/api/conversations	POST	Créer une conversation
/api/conversations/{id}/status	POST	Mettre à jour le statut
/api/conversations/{id}/tags	POST	Ajouter un tag
/api/conversations/{id}/tags/{tag}	DELETE	Supprimer un tag
/api/conversations/{id}/assign	POST	Assigner un agent

Messages

Endpoint	Méthode	Description
/api/conversations/{id}/messages	GET	Lister les messages
/api/conversations/{id}/messages	POST	Envoyer un message

Suggestion IA

Endpoint	Méthode	Description
/api/ai-suggest?conversation_id={id}	GET	Obtenir une suggestion de réponse IA

Contacts

Endpoint	Méthode	Description
/api/contacts	GET	Lister les contacts
/api/contacts/{id}	GET	Obtenir un contact
/api/contacts	POST	Créer un contact
/api/contacts/{id}	PATCH	Mettre à jour un contact
/api/contacts/{id}	DELETE	Supprimer un contact (admin)

Canaux (Admin uniquement)

Endpoint	Méthode	Description
/api/channels	GET	Lister les canaux
/api/channels	POST	Créer un canal
/api/channels/{id}	PATCH	Mettre à jour un canal
/api/channels/{id}	DELETE	Supprimer un canal

Automatisations (Admin uniquement)

Endpoint	Méthode	Description
/api/automations	GET	Lister les automatisations
/api/automations	POST	Créer une automatisation
/api/automations/{id}/toggle	POST	Basculer actif/inactif
/api/automations/{id}	DELETE	Supprimer une automatisation

Analytiques

Endpoint	Méthode	Description
/api/analytics?days=30	GET	Obtenir les données analytiques

Agents (Admin uniquement)

Endpoint	Méthode	Description
/api/agents	GET	Lister les agents
/api/agents	POST	Créer un agent
/api/agents/{id}/role	POST	Mettre à jour le rôle
/api/agents/{id}	DELETE	Supprimer un agent

Paramètres

Endpoint	Méthode	Description
/api/settings/workspace	GET	Obtenir les paramètres de l'espace de travail
/api/settings/workspace	POST	Mettre à jour l'espace de travail (admin)
/api/settings/password	POST	Changer le mot de passe

---

Format d'Erreur

{"error": "Message d'erreur lisible"}

Code	Signification
200	Succès
201	Créé
400	Mauvaise Requête
401	Non Authentifié
403	Interdit
404	Non Trouvé
409	Conflit
500	Erreur Interne