Zapier | Quire

Zapier se connecte à Quire via la même API REST, les mêmes clients OAuth et les mêmes webhooks que toutes les intégrations. Aucun code propre à Quire n’est nécessaire d’un côté ou de l’autre ; un Zap peut donc utiliser tout ce que propose la référence de l’API.

Lancer un Zap lors d’un événement Quire

Dans Zapier, choisissez Webhooks by Zapier comme déclencheur, avec l’événement Catch Raw Hook. Le format brut est nécessaire, 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 Ajouter un abonnement, 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 démarre dès que Zapier l’a reçu.
Ajoutez une étape Code by Zapier pour vérifier la signature à l’aide du secret de l’abonnement, comme expliqué dans le guide du développeur. Arrêtez le Zap si la vérification échoue.
Analysez le corps de la requête et ajoutez les étapes nécessaires.

Agir dans Quire depuis un Zap

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

URL : https://acme.quirelms.com/api/v1/..., par exemple /api/v1/enrolments pour inscrire une personne.
En-têtes : Authorization: Bearer qk_live_... avec une clé créée pour ce Zap uniquement dans /admin/integrations/api-keys, et un Idempotency-Key construit à partir de l’identifiant du déclencheur afin qu’une relecture par Zapier ne réinscrive pas la personne.
Données : JSON, selon les indications de la référence de l’API.

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

Exemple : inscrire un client à la conclusion d’une vente

Déclencheur : « vente conclue » dans votre CRM.
Requête personnalisée PUT /api/v1/users/ext:{customer id} avec le nom et l’adresse e-mail 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}.