---
title: "Zapier"
description: "Hubungkan Quire ke Zapier menggunakan webhook dan REST API."
image: "https://docs.quirelms.com/og.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.quirelms.com/id/llms.txt
> Use this file to discover all available pages before exploring further.

# Zapier

<span id="zapier"></span>

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](https://docs.quirelms.com/api/).

## Mulai Zap saat terjadi sesuatu di Quire <!--quire:start-a-zap-when-something-happens-in-quire-->

1. 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.
2. 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.
3. Tambahkan langkah **Code by Zapier** untuk memverifikasi tanda tangan dengan rahasia langganan, seperti ditunjukkan dalam [panduan pengembang](/id/developer/#webhooks). Hentikan Zap jika verifikasi gagal.
4. Uraikan isi permintaan lalu lanjutkan dengan langkah yang diperlukan.

## Bertindak di Quire dari Zap <!--quire:act-in-quire-from-a-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 <!--quire:example-enrol-a-customer-when-a-deal-closes-->

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

Source: https://docs.quirelms.com/id/integrations/zapier/index.mdx