Zapier

Zapier koppel aan Quire deur dieselfde REST API, OAuth-kliënte en webhooks wat elke integrasie gebruik. Daar is geen Quire-spesifieke kode aan weerskante nie, dus kan ’n Zap alles doen wat die API-verwysing bied.

Begin ’n Zap wanneer iets in Quire gebeur

1. Kies in Zapier Webhooks by Zapier as sneller, met die gebeurtenis Catch Raw Hook. Rou data, omdat die handtekening bereken word oor die presiese grepe wat Quire gestuur het. Kopieer die adres wat Zapier gee.
2. Maak in Quire /admin/webhooks oop, kies Add subscription, plak die adres en kies gebeurtenisse, byvoorbeeld course_completion.changed. Quire stuur eers ’n toetsgebeurtenis; die intekening begin sodra Zapier dit ontvang het.
3. Voeg ’n Code by Zapier-stap by wat die handtekening met die intekeninggeheim nagaan, soos in die ontwikkelaarsgids gewys. Stop die Zap as dit nie bekragtig nie.
4. Ontleed die inhoud en gaan voort met die stappe wat jy nodig het.

Tree vanuit ’n Zap in Quire op

Gebruik Webhooks by Zapier met die Custom Request-aksie, of API Request in ’n toepassingstap:

• URL: https://acme.quirelms.com/api/v1/..., byvoorbeeld /api/v1/enrolments om iemand in te skryf.
• Headers: Authorization: Bearer qk_live_... met ’n sleutel wat net vir hierdie Zap by /admin/integrations/api-keys gemaak is, en ’n Idempotency-Key wat uit die sneller se ID gebou is, sodat ’n herhaling deur Zapier nie dieselfde persoon twee keer inskryf nie.
• Data: JSON, soos die API-verwysing beskryf.

Om as ’n persoon eerder as die organisasie op te tree, registreer ’n OAuth-kliënt by /admin/integrations/oauth-clients met Zapier se herleidingsadres en gebruik dit vanuit ’n private Zapier-integrasie.

Voorbeeld: skryf ’n kliënt in wanneer ’n transaksie sluit

1. Sneller: jou CRM se “transaksie gewen”.
2. Pasgemaakte versoek PUT /api/v1/users/ext:{customer id} met die persoon se naam en e-pos: skep die gebruiker of werk hulle by as hulle reeds bestaan.
3. Pasgemaakte versoek POST /api/v1/enrolments met die gebruiker en kursus, en Idempotency-Key: deal-{deal id}.