---
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/bg/llms.txt
> Use this file to discover all available pages before exploring further.

# Zapier

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

Zapier се свързва с Quire чрез същите REST API, OAuth клиенти и уебкуки, които използва всяка интеграция. Няма специфичен за Quire код от нито една страна, затова Zap може да прави всичко от [справочника за API](https://docs.quirelms.com/api/).

## Стартиране на Zap при събитие в Quire <!--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**, която проверява подписа с тайната на абонамента, както е показано в [ръководството за разработчици](/bg/developer/#webhooks). Спрете Zap, ако проверката не мине.
4. Анализирайте тялото и продължете с нужните стъпки.

## Действие в Quire от Zap <!--quire:act-in-quire-from-a-zap-->

Използвайте **Webhooks by Zapier** с действието **Custom Request** или **API Request** в стъпка на приложение:

- **URL**: `https://acme.quirelms.com/api/v1/...`, например `/api/v1/enrolments`, за да запишете човек.
- **Headers**: `Authorization: Bearer qk_live_...` с ключ, създаден на `/admin/integrations/api-keys` само за този Zap, и `Idempotency-Key`, съставен от ID на тригера, за да не запише повторно същия човек при преизпълнение от Zapier.
- **Data**: JSON, както е описано в справочника за API.

За действия от името на човек, а не на организацията, регистрирайте OAuth клиент на `/admin/integrations/oauth-clients` с адреса за пренасочване на Zapier и го използвайте от частна интеграция със 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/bg/integrations/zapier/index.mdx