Oquira BusinessPermettez aux clients de prendre leur place dans la file depuis n'importe où grâce au système de géolocalisation.
La fonctionnalité "Rejoindre à Distance" permet aux clients de prendre leur ticket depuis leur domicile ou en déplacement, puis de rejoindre physiquement le service avant leur tour.
Avant de rejoindre une file à distance, vérifiez si le client remplit les conditions.
POST /v1/queues/{queueId}/eligibility
X-API-Key: votre_cle_api
Content-Type: application/json
{
"latitude": 6.3702,
"longitude": 2.3912
}POST /v1/remote-join/{queueId}/start
X-API-Key: votre_cle_api
Content-Type: application/json
{
"latitude": 6.3702,
"longitude": 2.3912
}| Propriété | Type | Requis | Description |
|---|---|---|---|
latitude | number | Oui | Latitude actuelle |
longitude | number | Oui | Longitude actuelle |
| Statut | Description |
|---|---|
pending | Demande en attente |
travelling | Client en déplacement vers le service |
within_geofence | Client dans le périmètre du service |
arrived | Présence confirmée |
expired | Le client n'est pas arrivé à temps |
cancelled | Demande annulée |
penalty | Pénalité appliquée (abus répétés) |
Le client doit envoyer des mises à jour de position régulières pour suivre sa progression et valider l'entrée dans le périmètre (geofence).
POST /v1/remote-join/{ticketId}/location
X-API-Key: votre_cle_api
Content-Type: application/json
{
"latitude": 6.3680,
"longitude": 2.3925,
"accuracy": 10
}Lorsque le client est arrivé (généralement dans le périmètre geofence), il doit confirmer sa présence pour être éligible à l'appel.
POST /v1/remote-join/{ticketId}/confirm
X-API-Key: votre_cle_api
Content-Type: application/json
{
"method": "geofence"
}| Propriété | Type | Requis | Description |
|---|---|---|---|
method | string | Non | geofence, qr_scan, nfc_scan, manual |
Les services peuvent configurer le rayon maximum de prise de ticket à distance.
| Paramètre | Description |
|---|---|
maxRemoteJoinRadiusKm | Rayon maximum (en km) depuis lequel un client peut prendre un ticket à distance |
geofenceRadius | Rayon du périmètre de présence (défaut: 100m) |
Oquira intègre un système de détection des abus :
Important : Les clients qui abusent du système de remote join peuvent voir leur accès temporairement restreint.