Oquira BusinessRecevez des notifications en temps réel sur les événements de votre organisation.
Les webhooks vous permettent de recevoir des notifications HTTP POST lorsque des événements spécifiques se produisent au sein de votre organisation. C'est utile pour synchroniser des données avec vos propres systèmes ou déclencher des workflows externes.
Événements actuellement pris en charge :
| Événement | Description |
|---|---|
ticket.created | Un client rejoint une file d'attente. |
ticket.called | Un opérateur appelle un ticket à un point de service. |
ticket.served | Un opérateur commence à servir un client. |
ticket.completed | La session de service pour un ticket est terminée. |
ticket.cancelled | Un ticket est annulé par le client ou l'opérateur. |
queue.status_changed | Une file d'attente est mise en pause, reprise ou fermée. |
Toutes les requêtes de webhook suivent une structure JSON cohérente.
{
"id": "evt_abc...",
"type": "ticket.called",
"organizationId": "org_123...",
"createdAt": "2024-01-02T10:05:00Z",
"data": {
"ticketId": "clsh8a2b3000208l2bh3z6p9k",
"number": 15,
"displayCode": "A15",
"queueId": "clsh7z8m1000008l2bh3z6p9k",
"operatorId": "clsh8f8g9000508l2bh3z6p9k",
"status": "called",
"calledAt": "2024-03-15T11:15:00.000Z"
}
}Oquira signe tous les payloads de webhook avec un secret partagé. Vous devez vérifier cette signature pour vous assurer que la requête provient bien d'Oquira.
La signature est envoyée dans l'en-tête X-Oquira-Signature.
Actuellement, les webhooks peuvent être configurés via les Paramètres de l'Organisation dans le tableau de bord ou via l'API.
POST /v1/organizations/{organizationId}/webhooks
X-API-Key: votre_cle_api
Content-Type: application/json
{
"url": "https://votre-api.com/webhooks",
"secret": "votre_secret_partage",
"events": ["ticket.called", "ticket.completed"]
}