Oquira BusinessEnvoyez des notifications en temps réel à vos clients et opérateurs.
Les notifications push d'Oquira permettent d'alerter les clients lorsque leur tour approche et de notifier les opérateurs des événements importants.
| Type | Destinataire | Description |
|---|---|---|
ticket.almost_called | Client | Votre tour approche (3 personnes avant) |
ticket.called | Client | Vous êtes appelé |
ticket.served | Client | Votre ticket a été servi |
ticket.cancelled | Client | Votre ticket a été annulé |
ticket.skipped | Client | Votre ticket a été passé |
ticket.transferred | Client | Votre ticket a été transféré vers une autre file |
ticket.expired | Client | Ticket expiré (non-présentation) |
ticket.auto_skipped | Client | Ticket reporté automatiquement (inactivité) |
review.request | Client | Demande d'évaluation post-service |
queue.status_changed | Opérateur | Statut de file modifié |
appointment.reminder | Client | Rappel de rendez-vous |
system.announcement | Tous | Annonce système |
Lorsqu'un opérateur crée un ticket au nom d'un visiteur (ticket hors-ligne ou ticket VIP), le ticket est marqué avec isGhostMode: true. Les tickets en mode fantôme ne déclenchent aucune notification utilisateur — ni notification push, ni notification in-app, ni demande d'évaluation.
Cela empêche les opérateurs de recevoir des notifications non pertinentes pour les tickets qu'ils créent eux-mêmes lors des opérations quotidiennes. Les notifications ne sont envoyées qu'aux utilisateurs finaux qui rejoignent une file depuis la plateforme publique (application mobile ou web).
Pour recevoir des notifications, l'appareil doit être enregistré avec un token Firebase.
POST /v1/push/register
X-API-Key: votre_cle_api
Content-Type: application/json
{
"platform": "ios",
"fcmToken": "fMC32kL9...",
"deviceId": "device_unique_id"
}| Propriété | Type | Requis | Description |
|---|---|---|---|
platform | string | Oui | ios, android, ou web |
fcmToken | string | Oui | Token Firebase Cloud Messaging |
deviceId | string | Non | Identifiant unique de l'appareil |
DELETE /v1/push/unregister
X-API-Key: votre_cle_api
Content-Type: application/json
{
"fcmToken": "fMC32kL9..."
}Les utilisateurs peuvent personnaliser leurs préférences.
GET /v1/notifications/preferences
X-API-Key: votre_cle_apiPATCH /v1/notifications/preferences
X-API-Key: votre_cle_api
Content-Type: application/json
{
"smsNotifications": true,
"ticketReminders": true
}Récupérez l'historique des notifications d'un utilisateur.
GET /v1/notifications?limit=20&unreadOnly=true
X-API-Key: votre_cle_apiPOST /v1/notifications/{notificationId}/read
X-API-Key: votre_cle_api
---
POST /v1/notifications/read-all
X-API-Key: votre_cle_apiLes opérateurs et administrateurs reçoivent des notifications spécifiques.
| Événement | Description |
|---|---|
queue.capacity_warning | File proche de la capacité max |
queue.long_wait | Temps d'attente anormalement long |
ticket.no_show | Client non présenté |
member.joined | Nouveau membre dans l'organisation |
| Canal | Description | Configuration |
|---|---|---|
| Push | Notifications mobiles | Token FCM requis |
| SMS | Messages texte | Plan Pro requis |
| Courriels | Adresse vérifiée | |
| Messages WhatsApp | Plan Enterprise |
Pour les organisations avec le plan Pro, les notifications SMS sont disponibles.
POST /v1/notifications/sms
X-API-Key: votre_cle_api
Content-Type: application/json
{
"phone": "+33612345678",
"message": "Votre ticket A-045 a été appelé. Guichet 2.",
"purpose": "ticket_called"
}Note : L'envoi de SMS est soumis à des limites d'utilisation selon votre plan.
Oquira utilise des templates localisés pour les notifications :
| Template Key | Description |
|---|---|
ticket.created | Confirmation de création de ticket |
ticket.almost_called | Tour qui approche |
ticket.called | Appel du ticket |
ticket.served | Service terminé |
ticket.cancelled | Ticket annulé |
ticket.skipped | Ticket passé (avec raison optionnelle) |
ticket.transferred | Ticket transféré vers une autre file |
ticket.expired | Ticket expiré |
ticket.recovered | Nouveau ticket créé (récupération) |
ticket.auto_skipped | Ticket reporté automatiquement (inactivité) |
review.request | Demande d'évaluation post-service |
inactivity.warning | Avertissement d'inactivité avant report auto |
appointment.reminder | Rappel de RDV (24h avant) |
appointment.confirmed | Confirmation de RDV |
Les messages sont automatiquement traduits selon la langue préférée de l'utilisateur (français et anglais supportés).