Zapier | Quire

Zapier terhubung ke Quire melalui REST API, klien OAuth, dan webhook yang digunakan setiap integrasi. Tidak ada kode khusus Quire di kedua sisi, jadi Zap dapat melakukan apa pun yang tersedia di referensi API.

Mulai Zap saat terjadi sesuatu di Quire

Di Zapier, pilih Webhooks by Zapier sebagai pemicu dengan peristiwa Catch Raw Hook. Pilih Raw karena tanda tangan dihitung dari byte persis yang dikirim Quire. Salin alamat yang diberikan Zapier.
Di Quire, buka /admin/webhooks, pilih Add subscription, tempel alamat, lalu pilih peristiwa, misalnya course_completion.changed. Quire mengirim peristiwa uji terlebih dahulu; langganan dimulai setelah Zapier menerimanya.
Tambahkan langkah Code by Zapier untuk memverifikasi tanda tangan dengan rahasia langganan, seperti ditunjukkan dalam panduan pengembang. Hentikan Zap jika verifikasi gagal.
Uraikan isi permintaan lalu lanjutkan dengan langkah yang diperlukan.

Bertindak di Quire dari Zap

Gunakan Webhooks by Zapier dengan aksi Custom Request, atau API Request di langkah aplikasi:

URL: https://acme.quirelms.com/api/v1/..., misalnya /api/v1/enrolments untuk mendaftarkan seseorang.
Headers: Authorization: Bearer qk_live_... dengan kunci yang dibuat khusus untuk Zap ini di /admin/integrations/api-keys, serta Idempotency-Key yang dibuat dari ID pemicu agar Zap yang diulang Zapier tidak mendaftarkan orang yang sama dua kali.
Data: JSON sesuai keterangan referensi API.

Untuk bertindak sebagai seseorang, bukan sebagai organisasi, daftarkan klien OAuth di /admin/integrations/oauth-clients dengan alamat pengalihan Zapier dan gunakan di integrasi Zapier privat.

Contoh: daftarkan pelanggan saat transaksi ditutup

Pemicu: peristiwa “deal won” dari CRM Anda.
Permintaan khusus PUT /api/v1/users/ext:{customer id} dengan nama dan email orang tersebut: membuat pengguna atau memperbarui yang sudah ada.
Permintaan khusus POST /api/v1/enrolments dengan pengguna dan kursus, serta Idempotency-Key: deal-{deal id}.