Démarrage rapide

Ajoutez le widget à une page, effectuez votre premier appel API et recevez votre premier webhook. Prévoyez une dizaine de minutes.

Avant de commencer

Vous avez besoin d’un espace de travail Yuno Chat. Si vous n’en avez pas encore, demandez un accès et nous vous enverrons un e-mail lorsqu’il sera prêt. Dans le tableau de bord, vous trouverez deux clés sous Paramètres → Développeurs :

un identifiant de site tel que site_8Kq2mXvR, qui est public et s’ajoute à votre HTML ;
une clé secrète telle que yk_live_…, qui reste sur votre serveur.

Étapes

Collez l’extrait avant la balise de fermeture </body> sur chaque page où le chat doit apparaître, avec votre propre identifiant de site.

index.html

<script src="https://cdn.yuno.chat/widget.js"
  data-site-id="site_8Kq2mXvR" async></script>

Rechargez la page : la bulle apparaît en bas à droite. Vous utilisez WordPress, Shopify ou un framework ? Consultez les guides par plateforme.

Conserver votre clé secrète

Conservez la clé secrète dans une variable d’environnement, jamais dans du code côté client ou dans un dépôt.

.env

export YUNO_SECRET_KEY="yk_test_51Hq8…"

Effectuer votre première requête

Listez les conversations en attente d’une personne :

curl -G https://api.yuno.chat/v1/conversations \
  -H "Authorization: Bearer $YUNO_SECRET_KEY" \
  -d status=waiting

Vous recevez un objet liste. Si la liste est vide, ouvrez le widget sur votre site, demandez à parler à une personne, puis relancez la requête.

Créer un ticket depuis votre backend

Les tickets sont utiles lorsqu’un événement se produit en dehors du chat, comme une demande de retour dans votre boutique :

bash

curl -X POST https://api.yuno.chat/v1/tickets \
  -H "Authorization: Bearer $YUNO_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Demande de retour pour la commande n° 1187",
    "contact": { "email": "[email protected]" },
    "tags": ["return"]
  }'

Le client reçoit un e-mail de confirmation et le ticket apparaît dans votre boîte de réception.

Recevoir les webhooks

Enregistrez une URL pour recevoir les nouveaux tickets et demandes d’intervention en temps réel. Sur votre machine, exposez un serveur local avec un tunnel comme ngrok ou cloudflared.

bash

curl -X POST https://api.yuno.chat/v1/webhook-endpoints \
  -H "Authorization: Bearer $YUNO_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://your-tunnel.example/hooks/yuno", "events": ["ticket.created"] }'

Conservez le secret de la réponse, puis suivez la section Vérifier les signatures pour vérifier que les requêtes proviennent bien de Yuno Chat.

Utilisez une clé yk_test_ pendant le développement. Le mode test possède ses propres conversations, tickets et contacts et n’envoie jamais d’e-mails aux vrais clients. Consultez Authentification.