Oquira BusinessGérez les tickets clients actifs, les appels, le service et les transferts.
Une fois qu'un client est dans une file d'attente, les opérateurs peuvent gérer sa progression tout au long du cycle de vie du service.
| Champ | Type | Description |
|---|---|---|
id | string | Identifiant unique du ticket. |
queueId | string | File d'attente à laquelle appartient le ticket. |
userId | string | Utilisateur propriétaire du ticket (ou ID de l'opérateur pour les tickets fantômes). |
number | number | Numéro séquentiel du ticket dans la file. |
displayCode | string | Code lisible affiché au client (ex: A-015). |
status | string | Statut actuel : waiting, called, serving, served, skipped, expired, cancelled. |
partySize | number | Nombre de personnes dans le groupe. Par défaut 1. |
isPriority | boolean | Indique s'il s'agit d'un ticket prioritaire/VIP. |
isGhostMode | boolean | true pour les tickets créés par l'opérateur (hors-ligne/VIP). Les tickets fantômes ne déclenchent pas de notifications utilisateur. |
visitorName | string | Nom du visiteur (pour les tickets fantômes/hors-ligne). |
assignedToId | string | Opérateur assigné pour servir ce ticket. |
calledAt | string | Horodatage ISO 8601 de l'appel du ticket. |
servedAt | string | Horodatage ISO 8601 du service du ticket. |
createdAt | string | Horodatage ISO 8601 de la création du ticket. |
Appelez automatiquement le prochain client disponible dans une file d'attente spécifique.
POST /v1/queues/{queueId}/call-next
X-API-Key: votre_cle_api
Content-Type: application/json
{
"serviceId": "ser_xyz..."
}Marquez un ticket comme "en cours de service" une fois que le client est arrivé au guichet.
POST /v1/tickets/{ticketId}/serve
X-API-Key: votre_cle_apiConfirmez la présence du client (généralement via un scan QR au bureau).
POST /v1/tickets/{ticketId}/present
X-API-Key: votre_cle_apiMarquez un client comme absent s'il ne se présente pas après avoir été appelé.
POST /v1/tickets/{ticketId}/skip-absent
X-API-Key: votre_cle_api
Content-Type: application/json
{
"reason": "Le client ne s'est pas présenté après 3 appels"
}Déplacez un ticket vers une autre file d'attente ou un autre opérateur.
POST /v1/tickets/{ticketId}/transfer-queue
X-API-Key: votre_cle_api
Content-Type: application/json
{
"targetQueueId": "que_vip...",
"prioritize": true
}POST /v1/tickets/{ticketId}/transfer
X-API-Key: votre_cle_api
Content-Type: application/json
{
"targetOperatorId": "user_456..."
}Restaurez un ticket expiré ou passé à un état actif.
POST /v1/tickets/{ticketId}/recover
X-API-Key: votre_cle_api
Content-Type: application/json
{
"recoveryOption": "rejoin"
}