Zapier

Zapier si cunnessa à Quire per mezu di a listessa API REST, di i clienti OAuth è di i webhooks aduprati da tutte l’integrazioni. Ùn ci hè codice specificu à Quire da nisuna parte, dunque una Zap pò fà tuttu ciò chì offre u riferimentu API.

Cumincià una Zap quandu accade qualcosa in Quire

1. In Zapier, sceglite Webhooks by Zapier cum’è attivazione cù l’avvenimentu Catch Raw Hook. Ci vole Raw perchè a firma hè calculata nantu à i byte esatti mandati da Quire. Copiate l’indirizzu datu da Zapier.
2. In Quire, aprite /admin/webhooks, sceglite Aghjunghje abbonamentu, incollate l’indirizzu è sceglite l’avvenimenti, per esempiu course_completion.changed. Quire manda prima un avvenimentu di prova; l’abbonamentu principia quandu Zapier l’hà ricevutu.
3. Aghjunghjite un passu Code by Zapier chì verifica a firma cù u secretu di l’abbonamentu, cum’è indicatu in a guida di sviluppu. Ferma a Zap s’ella ùn hè valida.
4. Analizate u corpu è cuntinuate cù i passi necessarii.

Agisce in Quire da una Zap

Aduprate Webhooks by Zapier cù l’azzione Custom Request, o API Request in un passu d’app.

• URL: https://acme.quirelms.com/api/v1/..., per esempiu /api/v1/enrolments per iscrive una persona.
• Intestazioni: Authorization: Bearer qk_live_... cù una chjave creata à /admin/integrations/api-keys solu per sta Zap, è una Idempotency-Key custruita cù l’ID di l’attivazione, per impedisce à Zapier di iscrive duie volte a stessa persona s’ellu ripete a Zap.
• Dati: JSON, cum’è descrittu in u riferimentu API.

Per agisce cum’è una persona invece di cum’è l’urganizazione, registrate un client OAuth à /admin/integrations/oauth-clients cù l’indirizzu di redirezzione di Zapier è adupratelu da un’integrazione privata di Zapier.

Esempiu: iscrive un cliente quandu si chjude una vendita

1. Attivazione: a tappa «affare vintu» di u vostru CRM.
2. Richiesta persunalizata PUT /api/v1/users/ext:{customer id} cù u nome è l’email di a persona: crea l’utilizatore o l’aggiorna s’ellu esiste dighjà.
3. Richiesta persunalizata POST /api/v1/enrolments cù l’utilizatore è u cursu, è Idempotency-Key: deal-{deal id}.