---
title: "Zapier"
description: "Quire-ді Zapier-пен вебхуктер және REST API арқылы байланыстырыңыз."
image: "https://docs.quirelms.com/og.png"
---

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

# Zapier

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

Zapier Quire-ге әр интеграция пайдаланатын сол REST API, OAuth клиенттері мен
вебхуктер арқылы қосылады. Екі жақта да Quire-ге тән код жоқ, сондықтан [API анықтамасы](https://docs.quirelms.com/api/)
ұсынатын кез келген нәрсені Zap жасай алады.

## Quire-де бірдеңе болғанда Zap бастау <!--quire:start-a-zap-when-something-happens-in-quire-->

1. Zapier-де триггер ретінде **Webhooks by Zapier** таңдап, оқиға ретінде
   **Catch Raw Hook** таңдаңыз. Raw, өйткені қолтаңба Quire жіберген дәл
   байттар бойынша есептеледі. Zapier берген мекенжайды көшіріңіз.
2. Quire-де `/admin/webhooks` ашып, **Add subscription** таңдап, мекенжайды
   қойып, оқиғаларды таңдаңыз, мысалы `course_completion.changed`.
   Quire алдымен сынақ оқиғасын жібереді; Zapier оны алғаннан кейін жазылым басталады.
3. Жазылым құпиясымен қолтаңбаны тексеретін **Code by Zapier** қадамын қосыңыз,
   мұны [әзірлеуші нұсқаулығы](/kk/developer/#webhooks) көрсетеді. Ол тексерілмесе
   Zap-ті тоқтатыңыз.
4. Денені талдап, қажетті қадамдармен жалғастырыңыз.

## Zap-тен Quire-де әрекет ету <!--quire:act-in-quire-from-a-zap-->

**Custom Request** әрекетімен **Webhooks by Zapier** пайдаланыңыз немесе қолданба
қадамында **API
Request** пайдаланыңыз:

- **URL**: `https://acme.quirelms.com/api/v1/...`, мысалы біреуді жазу үшін
  `/api/v1/enrolments`.
- **Headers**: `Authorization: Bearer qk_live_...`, кілт осы Zap үшін ғана `/admin/integrations/api-keys` мекенжайында жасалған, және триггер ID-інен құралған
  `Idempotency-Key`, сондықтан Zapier қайта ойнатқан Zap сол адамды екі рет
  жазбайды.
- **Data**: API анықтамасы сипаттағандай JSON.

Ұйым ретінде емес, адам ретінде әрекет ету үшін Zapier-дің қайта бағыттау мекенжайымен
`/admin/integrations/oauth-clients` мекенжайында OAuth клиентін тіркеп, оны
жеке Zapier интеграциясынан пайдаланыңыз.

## Мысал: мәміле жабылғанда тұтынушыны жазу <!--quire:example-enrol-a-customer-when-a-deal-closes-->

1. Триггер: CRM-іңіздің «deal won» оқиғасы.
2. Адамның аты мен поштасымен `PUT /api/v1/users/ext:{customer id}` теңшелетін сұранысы:
   пайдаланушыны жасайды немесе бар болса жаңартады.
3. Пайдаланушы мен курспен `POST /api/v1/enrolments` теңшелетін сұранысы
   және `Idempotency-Key: deal-{deal id}`.

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