Oquira BusinessGérez le cycle de vie d'un ticket client.
Un ticket représente la place d'un client dans une file d'attente. La gestion du cycle de vie des tickets est le cœur de vos opérations quotidiennes.
Un ticket passe généralement par les statuts suivants :
waiting (en attente) → called (appelé) → serving (au guichet) → completed (terminé) (ou absent/cancelled).
Enregistrez un client et émettez un ticket.
curl -X POST "https://api.oquira.com/v1/business/queues/clsh7z8m1000008l2bh3z6p9k/join" \
-H "X-API-Key: votre_cle_api" \
-H "Content-Type: application/json" \
-d '{
"customerName": "Jean Dupont",
"phoneNumber": "+33600000000"
}'Réponse :
{
"success": true,
"data": {
"id": "clsh8a2b3000208l2bh3z6p9k",
"queueId": "clsh7z8m1000008l2bh3z6p9k",
"userId": "clsh8b4c5000308l2bh3z6p9k",
"number": 45,
"sequenceNumber": 45,
"displayCode": "A-045",
"status": "waiting",
"visitorName": "Jean Dupont",
"estimatedWaitTime": 15,
"createdAt": "2024-03-15T11:00:00.000Z"
}
}Nous recommandons vivement l'utilisation des événements WebSocket ou des Webhooks pour recevoir des notifications instantanées lors d'un changement de statut de ticket. Cela garantit que votre tableau de bord reste synchronisé avec l'activité réelle des guichets.
Mettez toujours à jour le statut immédiatement (ex: marquez comme présent dès que le client arrive). Cela garantit que les calculs de temps d'attente restent exacts pour les autres clients.
Lors de la clôture d'un ticket, vous pouvez inclure des retours clients ou des notes internes pour améliorer la qualité du service.
Utilisez l'option requeue (remettre en file) pour les clients absents si votre politique permet qu'ils soient rappelés plus tard sans perdre totalement leur place.