Zapier | Quire

Zapier se connecte à Quire par la même API REST, les mêmes clients OAuth et les mêmes webhooks que toutes les intégrations. Il n’y a pas de code propre à Quire de part et d’autre; un Zap peut donc faire tout ce que propose la référence de l’API.

Lancer un Zap lorsqu’un événement se produit dans Quire

Dans Zapier, choisissez Webhooks by Zapier comme déclencheur et l’événement Catch Raw Hook. Choisissez Raw, car la signature est calculée sur les octets exacts envoyés par Quire. Copiez l’adresse fournie par Zapier.
Dans Quire, ouvrez /admin/webhooks, choisissez Add subscription, collez l’adresse et sélectionnez les événements, par exemple course_completion.changed. Quire envoie d’abord un événement de test; l’abonnement commence dès que Zapier l’a reçu.
Ajoutez une étape Code by Zapier qui vérifie la signature avec le secret de l’abonnement, comme le décrit le guide du développeur. Arrêtez le Zap si la vérification échoue.
Analysez le corps et poursuivez avec les étapes nécessaires.

Agir dans Quire depuis un Zap

Utilisez l’action Custom Request de Webhooks by Zapier, ou API Request dans une étape d’application :

URL : https://acme.quirelms.com/api/v1/..., par exemple /api/v1/enrolments pour inscrire une personne.
Headers : Authorization: Bearer qk_live_... avec une clé créée dans /admin/integrations/api-keys pour ce Zap seulement, et Idempotency-Key construit à partir de l’ID du déclencheur afin qu’un Zap rejoué par Zapier n’inscrive pas deux fois la même personne.
Data : JSON, comme le décrit la référence de l’API.

Pour agir au nom d’une personne plutôt que de l’organisation, enregistrez un client OAuth dans /admin/integrations/oauth-clients avec l’adresse de redirection de Zapier, puis utilisez-le dans une intégration Zapier privée.

Exemple : inscrire un client à la clôture d’une transaction

Déclencheur : la transaction « gagnée » dans votre CRM.
Requête personnalisée PUT /api/v1/users/ext:{customer id} avec le nom et le courriel de la personne : crée l’utilisateur ou le met à jour s’il existe déjà.
Requête personnalisée POST /api/v1/enrolments avec l’utilisateur et le cours, et Idempotency-Key: deal-{deal id}.