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

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

# Zapier

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

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](https://docs.quirelms.com/api/), sebuah Zap boleh
melakukannya.

## Memulakan Zap apabila sesuatu berlaku dalam Quire <!--quire:start-a-zap-when-something-happens-in-quire-->

1. 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.
2. 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.
3. Tambah langkah **Code by Zapier** yang menyahkan tandatangan menggunakan
   rahsia langganan, seperti yang ditunjukkan dalam
   [panduan pembangun](/ms/developer/#webhooks). Hentikan Zap sekiranya ia
   tidak sah.
4. Huraikan badan tersebut dan teruskan dengan langkah yang anda perlukan.

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

1. Pemicu: "deal won" dalam CRM anda.
2. 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.
3. Permintaan kustom `POST /api/v1/enrolments` dengan pengguna dan kursus
   tersebut, serta `Idempotency-Key: deal-{deal id}`.

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