Zapier | Quire

Zapier es connecta a Quire mitjançant la mateixa API REST, els clients OAuth i els webhooks que fan servir totes les integracions. No cal cap codi específic de Quire a cap dels dos costats; per tant, una Zap pot fer tot el que ofereix la referència de l’API.

Iniciar una Zap quan passi alguna cosa a Quire

A Zapier, trieu Webhooks by Zapier com a activador i seleccioneu l’esdeveniment Catch Raw Hook. Ha de ser Raw perquè la signatura es calcula a partir dels bytes exactes que ha enviat Quire. Copieu l’adreça que us dona Zapier.
A Quire, obriu /admin/webhooks, trieu Afegeix una subscripció, enganxeu l’adreça i seleccioneu els esdeveniments, per exemple course_completion.changed. Quire envia primer un esdeveniment de prova; la subscripció comença quan Zapier l’ha rebut.
Afegiu un pas Code by Zapier que verifiqui la signatura amb el secret de la subscripció, tal com s’explica a la guia per a desenvolupadors. Atureu la Zap si la verificació falla.
Analitzeu el cos i continueu amb els passos que necessiteu.

Actuar a Quire des d’una Zap

Feu servir Webhooks by Zapier amb l’acció Custom Request, o bé API Request en un pas de l’aplicació:

URL: https://acme.quirelms.com/api/v1/..., per exemple /api/v1/enrolments per inscriure algú.
Capçaleres: Authorization: Bearer qk_live_... amb una clau creada a /admin/integrations/api-keys només per a aquesta Zap, i una Idempotency-Key basada en l’ID de l’activador, per evitar que una Zap repetida per Zapier inscrigui dues vegades la mateixa persona.
Dades: JSON, tal com descriu la referència de l’API.

Per actuar com una persona i no com l’organització, registreu un client OAuth a /admin/integrations/oauth-clients amb l’adreça de redirecció de Zapier i utilitzeu-lo des d’una integració privada de Zapier.

Exemple: inscriure un client quan es tanca una venda

Activador: «venda guanyada» del CRM.
Petició personalitzada PUT /api/v1/users/ext:{customer id} amb el nom i l’adreça electrònica de la persona: crea l’usuari o l’actualitza si ja existeix.
Petició personalitzada POST /api/v1/enrolments amb l’usuari i el curs, i Idempotency-Key: deal-{deal id}.