Oquira BusinessGérez les files d'attente, la capacité et le statut en temps réel de vos services.
Les files d'attente sont le lieu où l'attente réelle se produit. Chaque service peut avoir une ou plusieurs files d'attente avec des configurations différentes (ex: "Standard", "VIP", "Rendez-vous direct").
Ajoutez une nouvelle file d'attente à un service existant.
POST /v1/business/queues
X-API-Key: votre_cle_api
Content-Type: application/json
{
"serviceId": "ser_xyz...",
"name": "File d'attente Standard",
"description": "File générale sans rendez-vous",
"maxCapacity": 50
}| Propriété | Type | Requis | Description |
|---|---|---|---|
serviceId | string | Oui | ID du service parent. |
name | string | Oui | Nom de la file d'attente. |
description | string | Non | Courte description. |
maxCapacity | number | Non | Nombre maximal de personnes autorisées dans la file. |
Ajoutez manuellement un client à la file d'attente (ex: via une borne physique ou par un agent).
POST /v1/queues/{queueId}/operator-join
X-API-Key: votre_cle_api
Content-Type: application/json
{
"visitorName": "Jean Dupont",
"partySize": 2
}Créez un ticket prioritaire qui passe devant une partie de la file d'attente.
POST /v1/queues/{queueId}/vip-ticket
X-API-Key: votre_cle_api
Content-Type: application/json
{
"visitorName": "Client Premium",
"partySize": 1
}Mettez en pause, reprenez ou fermez une file d'attente.
PATCH /v1/business/queues/{queueId}/status
X-API-Key: votre_cle_api
Content-Type: application/json
{
"status": "paused"
}| Valeur | Description |
|---|---|
active | La file est ouverte et accepte les nouveaux tickets. |
paused | La file est ouverte mais n'accepte PAS de NOUVEAUX tickets. Les tickets existants peuvent toujours être appelés. |
closed | La file est fermée. Aucun nouveau ticket n'est accepté et aucun appel n'est autorisé. |
Les opérateurs peuvent créer des tickets au nom de visiteurs sans l'application. Ces tickets sont marqués en mode fantôme (isGhostMode: true), ce qui signifie qu'aucune notification utilisateur n'est envoyée.
POST /v1/queues/{queueId}/operator-join
X-API-Key: votre_cle_api
Content-Type: application/json
{
"visitorName": "Marie Dupont",
"partySize": 2
}| Propriété | Type | Requis | Description |
|---|---|---|---|
visitorName | string | Non | Nom du visiteur sans rendez-vous. |
partySize | number | Non | Nombre de personnes dans le groupe. Par défaut 1. |
Note : Nécessite la permission
QUEUE_OPERATE. LeuserIddu ticket est défini sur l'ID de l'opérateur, etisGhostModeesttrue.
Créez un ticket prioritaire qui est placé en tête de la file. Également marqué en mode fantôme.
POST /v1/queues/{queueId}/vip-ticket
X-API-Key: votre_cle_api
Content-Type: application/json
{
"visitorName": "Client VIP",
"partySize": 1
}Note : Les tickets VIP sont placés devant les tickets en attente réguliers. Nécessite la permission
QUEUE_OPERATE.
POST /v1/queues/{queueId}/clear
X-API-Key: votre_cle_api
---
POST /v1/queues/{queueId}/archive
X-API-Key: votre_cle_api