---
title: "Zapier"
description: "Konekti Quire al Zapier per webhooks kaj la REST-API."
image: "https://docs.quirelms.com/og.png"
---

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

# Zapier

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

Zapier konektiĝas al Quire per la samaj REST-API, OAuth-klientoj kaj
webhooks uzataj de ĉiu integriĝo. Neniu Quire-specifa kodo estas bezonata ĉe ambaŭ
flankoj, do ĉion ofertatan de la [API-referenco](https://docs.quirelms.com/api/) Zap povas fari.

## Komenci Zap kiam io okazas en Quire <!--quire:start-a-zap-when-something-happens-in-quire-->

1. En Zapier, elektu **Webhooks by Zapier** kiel ekigilon kun la evento
   **Catch Raw Hook**. Krudan, ĉar la subskribo estas kalkulata super la precizaj
   bajtoj senditaj de Quire. Kopiu la adreson donitan de Zapier.
2. En Quire, malfermu `/admin/webhooks`, elektu **Aldoni abonon**, gluu la
   adreson kaj elektu la eventojn, ekzemple `course_completion.changed`.
   Quire unue sendas testan eventon; la abono komenciĝas kiam Zapier
   ricevas ĝin.
3. Aldonu paŝon **Code by Zapier**, kiu kontrolas la subskribon uzante la
   abonan sekreton, kiel montrite en la [programista gvidilo](/eo/developer/#webhooks).
   Haltigu la Zap se la kontrolo malsukcesas.
4. Analizu la korpon kaj daŭrigu per bezonataj paŝoj.

## Agi en Quire de Zap <!--quire:act-in-quire-from-a-zap-->

Uzu **Webhooks by Zapier** kun la ago **Custom Request**, aŭ **API
Request** en aplikaĵa paŝo:

- **URL**: `https://acme.quirelms.com/api/v1/...`, ekzemple
  `/api/v1/enrolments` por aliĝigi iun.
- **Headers**: `Authorization: Bearer qk_live_...` kun ŝlosilo kreita ĉe
  `/admin/integrations/api-keys` nur por ĉi tiu Zap, kaj
  `Idempotency-Key` konstruita el la ID de la ekigilo, por ke Zap reludita de Zapier
  ne aliĝigu la saman personon dufoje.
- **Data**: JSON, laŭ la priskribo en la API-referenco.

Por agi kiel persono anstataŭ kiel organizaĵo, registru OAuth-klienton
ĉe `/admin/integrations/oauth-clients` kun la alidirekta adreso de Zapier kaj uzu
ĝin de privata Zapier-integriĝo.

## Ekzemplo: aliĝigi klienton kiam interkonsento fermiĝas <!--quire:example-enrol-a-customer-when-a-deal-closes-->

1. Ekigilo: evento "interkonsento gajnita" de via CRM.
2. Propra peto `PUT /api/v1/users/ext:{customer id}` kun la nomo kaj retpoŝto de la persono:
   kreas uzanton aŭ ĝisdatigas ĝin se ĝi jam ekzistas.
3. Propra peto `POST /api/v1/enrolments` kun la uzanto kaj kurso,
   kaj `Idempotency-Key: deal-{deal id}`.

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