Abonnements Webhook

Les webhooks permettent à Oquira d'envoyer des notifications en temps réel à votre serveur lorsque certains événements se produisent dans votre organisation.

Événements Disponibles

Configuration des Webhooks

1. Connectez-vous à votre Oquira Business.
2. Allez dans Paramètres > Webhooks.
3. Cliquez sur Ajouter un Point de Terminaison.
4. Entrez l'URL de votre endpoint (doit être HTTPS) et sélectionnez les événements souhaités.
5. Copiez votre Secret Webhook pour vérifier les signatures.

Sécurité : Vérification des Signatures

Oquira signe chaque requête webhook avec votre secret pour en garantir l'authenticité. La signature est envoyée dans l'en-tête X-Oquira-Signature.

Exemple d'En-tête

X-Oquira-Signature: t=1710936000,v1=sha256_hash_here

Étapes de Vérification

1. Extrayez le timestamp t et la signature v1.
2. Construisez le payload signé en concaténant le timestamp et le corps JSON de la requête.
3. Calculez un HMAC avec la fonction de hachage SHA256 en utilisant votre Secret Webhook.
4. Comparez votre résultat avec la signature v1.

Garanties de Livraison

• Politique de Rétention : Si votre serveur renvoie un statut non-2xx, Oquira réessaiera la livraison jusqu'à 5 fois avec un intervalle exponentiel.
• Délai d'Attente : Oquira attend une réponse dans les 10 secondes.
• Ordre : Oquira ne garantit pas l'ordre de livraison des événements. Utilisez le champ timestamp dans le payload pour gérer l'ordre si nécessaire.

Exemple de Payload

{
  "id": "evt_abc123",
  "type": "ticket.called",
  "organizationId": "org_xyz789",
  "data": {
    "ticketId": "clsh8a2b3000208l2bh3z6p9k",
    "ticketLabel": "A-045",
    "queueId": "clsh7z8m1000008l2bh3z6p9k",
    "counter": "Guichet 1",
    "status": "called",
    "calledAt": "2024-03-15T11:15:00.000Z"
  },
  "timestamp": "2024-03-15T11:15:00.000Z"
}