Documentation Yuno Chat
Tout ce qu’il faut pour ajouter le widget à un site, le piloter en JavaScript et intégrer les conversations, tickets et contacts avec l’API REST.
Ce que vous pouvez créer
Il existe trois façons d’utiliser Yuno Chat, et la plupart des intégrations en combinent plusieurs :
- Le widget s’installe avec une balise script. Il fonctionne sans autre code que l’extrait d’installation. Consultez Installer le widget.
- L’API JavaScript pilote le widget depuis vos pages : ouvrez-le avec un bouton, identifiez les clients connectés, préremplissez un ticket et réagissez aux événements. Consultez API JavaScript.
- L’API REST et les webhooks connectent Yuno Chat à votre backend : synchronisez les contacts, créez des tickets depuis votre système de commandes et transmettez les demandes d’intervention à vos outils. Commencez par le Démarrage rapide.
URL de base
Toutes les requêtes API sont envoyées à :
https://api.yuno.chat/v1L’API accepte uniquement HTTPS. Les requêtes HTTP sont refusées et ne sont pas redirigées, afin qu’aucune clé secrète ne soit transmise sans chiffrement.
Requêtes et réponses
Envoyez les corps des requêtes en JSON avec Content-Type: application/json. Toutes les réponses sont au format JSON, y compris les erreurs. Les horodatages sont des chaînes ISO 8601 en UTC, et chaque objet possède un champ object indiquant sa nature.
| Préfixe | Objet |
|---|---|
conv_ | Conversation |
msg_ | Message |
tkt_ | Ticket |
ctc_ | Contact |
src_ | Source de connaissances |
whe_ | Point de terminaison webhook |
evt_ | Événement webhook |
Requêtes idempotentes
Les requêtes POST acceptent un en-tête Idempotency-Key. Si une requête avec la même clé a déjà été traitée au cours des dernières 24 heures, vous recevez la réponse d’origine sans créer de ticket ou de message supplémentaire. Utilisez un UUID par opération logique.
curl -X POST https://api.yuno.chat/v1/tickets \
-H "Authorization: Bearer $YUNO_SECRET_KEY" \
-H "Idempotency-Key: 5d0c7a4e-41b2-4f0e-9a51-0d6f3b7c2e19" \
-H "Content-Type: application/json" \
-d '{"subject": "Remboursement de la commande n° 1187", "contact": {"email": "[email protected]"}}'Gestion des versions
Les versions de l’API sont identifiées par une date. Votre espace de travail conserve la version en vigueur lors de votre première requête ; les nouvelles versions ne modifient donc pas son comportement. Pour tester une version plus récente sur une seule requête, envoyez l’en-tête Yuno-Version.
-H "Yuno-Version: 2026-10-01"OpenAPI
Une description de toute l’API exploitable par les outils est disponible à l’adresse /openapi.json (OpenAPI 3.1). Importez-la dans Postman ou Insomnia, ou générez un client typé avec un outil comme openapi-typescript.