Skip to main content
Un administrateur abonne une adresse aux événements de son agence. À chaque événement, Arquos envoie un POST JSON à cette adresse. Les événements partent quel que soit l’endroit du changement : l’écran, l’application myArquos ou l’API.

S’abonner

La réponse donne l’identifiant de l’abonnement et son secret de signature, qui n’est montré qu’à cet instant. POST /webhooks/{id}/test envoie tout de suite un événement ping ; GET /webhooks/{id}/deliveries montre les dernières livraisons ; POST /webhooks/{id}/revoke retire l’abonnement.

Ce que vous recevez

Lisez l’objet par l’API (GET /calls/{id}, GET /surveys/{id}, GET /quotes/{id}) pour en avoir le détail.

Vérifier la signature

Chaque envoi porte l’en-tête X-Arquos-Signature: t=<secondes>,v1=<signature>. La signature est un HMAC-SHA256, en hexadécimal, du texte <secondes>.<corps> avec votre secret. Recalculez-la sur le corps tel que reçu, et refusez un horodatage de plus de cinq minutes.

Réponses et relances

Répondez 2xx en moins de 10 secondes. Sinon, Arquos relance après 1 min, 5 min, 30 min, 2 h et 12 h, puis abandonne. Une même livraison peut arriver deux fois : l’en-tête X-Arquos-Livraison porte son identifiant, pour l’ignorer la seconde fois.