Zapier | Quire

Zapier bersambung ke Quire melalui REST API, pelanggan OAuth dan webhook yang sama digunakan oleh setiap integrasi. Tiada kod khusus Quire di kedua-dua pihak, jadi apa sahaja yang ditawarkan oleh rujukan API, sebuah Zap boleh melakukannya.

Memulakan Zap apabila sesuatu berlaku dalam Quire

Dalam Zapier, pilih Webhooks by Zapier sebagai pemicu, dengan peristiwa Catch Raw Hook. Raw, kerana tandatangan dikira ke atas bait tepat yang dihantar oleh Quire. Salin alamat yang diberikan Zapier kepada anda.
Dalam Quire, buka /admin/webhooks, pilih Tambah langganan, tampal alamat tersebut, dan pilih peristiwa, contohnya course_completion.changed. Quire menghantar peristiwa ujian terlebih dahulu; langganan bermula sebaik sahaja Zapier menerimanya.
Tambah langkah Code by Zapier yang menyahkan tandatangan menggunakan rahsia langganan, seperti yang ditunjukkan dalam panduan pembangun. Hentikan Zap sekiranya ia tidak sah.
Huraikan badan tersebut dan teruskan dengan langkah yang anda perlukan.

Bertindak dalam Quire daripada Zap

Gunakan Webhooks by Zapier dengan tindakan Custom Request, atau API Request dalam langkah aplikasi:

URL: https://acme.quirelms.com/api/v1/..., contohnya /api/v1/enrolments untuk mendaftar seseorang.
Tajuk: Authorization: Bearer qk_live_... dengan kunci yang dibuat di /admin/integrations/api-keys khusus untuk Zap ini sahaja, dan satu Idempotency-Key dibina daripada ID pemicu, supaya Zap yang dimainkan semula oleh Zapier tidak mendaftar orang yang sama dua kali.
Data: JSON, seperti yang diterangkan oleh rujukan API.

Untuk bertindak sebagai seseorang dan bukan sebagai organisasi, daftarkan pelanggan OAuth di /admin/integrations/oauth-clients dengan alamat pengalihan Zapier dan gunakannya daripada integrasi Zapier peribadi.

Contoh: mendaftar pelanggan apabila suatu urus niaga selesai

Pemicu: “deal won” dalam CRM anda.
Permintaan kustom PUT /api/v1/users/ext:{customer id} dengan nama dan e-mel orang tersebut: mencipta pengguna, atau mengemas kini mereka jika mereka sudah wujud.
Permintaan kustom POST /api/v1/enrolments dengan pengguna dan kursus tersebut, serta Idempotency-Key: deal-{deal id}.