---
title: "Zapier"
description: "Вебхуктар жана REST API аркылуу Quire'ни Zapier'ге туташтырыңыз."
image: "https://docs.quirelms.com/og.png"
---

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

# Zapier

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

Zapier бардык интеграция колдонгон ошол REST API, OAuth клиенттери жана
вебхуктар аркылуу Quire'ге туташат. Эки тарапта да 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` ачып, **Жазылуу кошууну** тандаңыз, даректи
   чаптаңыз жана окуяларды тандаңыз, мисалы `course_completion.changed`.
   Quire алгач сыноо окуясын жөнөтөт; жазылуу Zapier аны алганда башталат.
3. Кол коюуну жазылуунун сыры менен текшерген **Code by Zapier** шагын
   кошуңуз, [иштеп чыгаруучу нускакасында](/ky/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_...` — бул
  `/admin/integrations/api-keys` жеринен ушул Zap үчүн гана жасалган
  килит, жана триггердин 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}`
   custom request: колдонуучуну түзөт же ал бар болсо жаңыртат.
3. Колдонуучу жана курс менен `POST /api/v1/enrolments` custom request,
   жана `Idempotency-Key: deal-{deal id}`.

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