Zapier | Quire

Zapier si collega a Quire tramite le stesse API REST, client OAuth e webhook usati da ogni integrazione. Non c’è codice specifico di Quire su nessuno dei due lati, quindi tutto ciò che il riferimento API offre, uno Zap può farlo.

Avviare uno Zap quando accade qualcosa in Quire

In Zapier, scegli Webhooks di Zapier come trigger, con l’evento Catch Raw Hook. Raw, perché la firma è calcolata sui byte esatti inviati da Quire. Copia l’indirizzo fornito da Zapier.
In Quire, apri /admin/webhooks, scegli Aggiungi sottoscrizione, incolla l’indirizzo e scegli gli eventi, ad esempio course_completion.changed. Quire invia prima un evento di prova; la sottoscrizione parte una volta che Zapier lo ha ricevuto.
Aggiungi un passaggio Codice di Zapier che verifica la firma usando il segreto della sottoscrizione, come mostrato nella guida per sviluppatori. Interrompi lo Zap quando la verifica fallisce.
Analizza il corpo e prosegui con i passaggi necessari.

Agire in Quire da uno Zap

Usa Webhooks di Zapier con l’azione Richiesta personalizzata, oppure Richiesta API in un passaggio app:

URL: https://acme.quirelms.com/api/v1/..., ad esempio /api/v1/enrolments per iscrivere qualcuno.
Intestazioni: Authorization: Bearer qk_live_... con una chiave creata in /admin/integrations/api-keys solo per questo Zap, e una Idempotency-Key costruita dall’ID del trigger, così uno Zap che Zapier ripete non iscrive due volte la stessa persona.
Dati: JSON, come descritto dal riferimento API.

Per agire come una persona anziché come organizzazione, registra un client OAuth in /admin/integrations/oauth-clients con l’indirizzo di reindirizzamento di Zapier e usalo da un’integrazione privata di Zapier.

Esempio: iscrivere un cliente alla chiusura di un affare

Trigger: il “deal vinto” del tuo CRM.
Richiesta personalizzata PUT /api/v1/users/ext:{customer id} con nome ed email della persona: crea l’utente, oppure lo aggiorna se esiste.
Richiesta personalizzata POST /api/v1/enrolments con utente e corso, e Idempotency-Key: deal-{deal id}.