---
title: "Zapier"
description: "Propojte Quire se Zapierem pomocí webhooků a REST API."
image: "https://docs.quirelms.com/og.png"
---

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

# Zapier

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

Zapier se připojuje k Quire přes stejné REST API, klienty OAuth a webhooky jako ostatní integrace. Ani jedna strana nepotřebuje kód specifický pro Quire, takže Zap dokáže vše, co nabízí [referenční dokumentace API](https://docs.quirelms.com/api/).

## Spuštění Zapu při události v Quire <!--quire:start-a-zap-when-something-happens-in-quire-->

1. V Zapieru zvolte jako spouštěč **Webhooks by Zapier** s událostí **Catch Raw Hook**. Zvolte Raw, protože podpis se počítá z přesných bajtů odeslaných Quire. Zkopírujte adresu, kterou vám Zapier poskytne.
2. V Quire otevřete `/admin/webhooks`, zvolte **Add subscription**, vložte adresu a vyberte události, například `course_completion.changed`. Quire nejprve odešle testovací událost; předplatné začne po jejím přijetí Zapierem.
3. Přidejte krok **Code by Zapier**, který ověří podpis pomocí tajného klíče předplatného podle [příručky pro vývojáře](/cs/developer/#webhooks). Pokud ověření selže, Zap zastavte.
4. Zpracujte tělo požadavku a pokračujte potřebnými kroky.

## Provedení akce v Quire ze Zapu <!--quire:act-in-quire-from-a-zap-->

Použijte **Webhooks by Zapier** s akcí **Custom Request** nebo **API Request** v kroku aplikace:

- **URL**: `https://acme.quirelms.com/api/v1/...`, například `/api/v1/enrolments` pro zápis uživatele.
- **Headers**: `Authorization: Bearer qk_live_...` s klíčem vytvořeným na `/admin/integrations/api-keys` pouze pro tento Zap a `Idempotency-Key` vytvořeným z ID spouštěcí události. Pokud Zapier Zap zopakuje, stejný člověk se tak nezapíše dvakrát.
- **Data**: JSON podle popisu v referenční dokumentaci API.

Chcete-li jednat jménem uživatele, nikoli organizace, zaregistrujte klienta OAuth na `/admin/integrations/oauth-clients` s přesměrovací adresou Zapieru a použijte ho v soukromé integraci Zapieru.

## Příklad: zápis zákazníka po uzavření obchodu <!--quire:example-enrol-a-customer-when-a-deal-closes-->

1. Spouštěč: „deal won“ v CRM.
2. Vlastní požadavek `PUT /api/v1/users/ext:{customer id}` se jménem a e-mailem: uživatele vytvoří, nebo aktualizuje, pokud už existuje.
3. Vlastní požadavek `POST /api/v1/enrolments` s uživatelem a kurzem a `Idempotency-Key: deal-{deal id}`.

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