---
title: "Zapier"
description: "Yhdistä Quire Zapieriin webhookien ja REST API:n avulla."
image: "https://docs.quirelms.com/og.png"
---

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

# Zapier

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

Zapier yhdistyy Quireen saman REST API:n, OAuth-asiakkaiden ja webhookien kautta kuin muutkin integraatiot. Kummallakaan puolella ei tarvita Quire-kohtaista koodia, joten Zap voi tehdä kaiken, mitä [API-viite](https://docs.quirelms.com/api/) tarjoaa.

## Käynnistä Zap Quiren tapahtumasta <!--quire:start-a-zap-when-something-happens-in-quire-->

1. Valitse Zapierissa käynnistimeksi **Webhooks by Zapier** ja tapahtumaksi **Catch Raw Hook**. Valitse raakasisältö, koska allekirjoitus lasketaan Quiren lähettämistä täsmällisistä tavuista. Kopioi Zapierin antama osoite.
2. Avaa Quiressa `/admin/webhooks`, valitse **Add subscription**, liitä osoite ja valitse tapahtumat, esimerkiksi `course_completion.changed`. Quire lähettää ensin testitapahtuman. Tilaus alkaa, kun Zapier on vastaanottanut sen.
3. Lisää **Code by Zapier** -vaihe allekirjoituksen tarkistamiseksi tilauksen salaisuudella [kehittäjän oppaan](/fi/developer/#webhooks) mukaisesti. Keskeytä Zap, jos allekirjoitus ei täsmää.
4. Jäsennä runko ja jatka tarvitsemillasi vaiheilla.

## Tee toimintoja Quiressa Zapista <!--quire:act-in-quire-from-a-zap-->

Käytä toimintona **Webhooks by Zapier** -sovelluksen **Custom Request** -vaihtoehtoa tai sovellusvaiheen **API Request** -toimintoa:

- **URL**: `https://acme.quirelms.com/api/v1/...`, esimerkiksi `/api/v1/enrolments` henkilön ilmoittamiseen kurssille.
- **Headers**: `Authorization: Bearer qk_live_...` sekä vain tätä Zapia varten osoitteessa `/admin/integrations/api-keys` luotu avain. Lisää myös käynnistimen tunnisteesta muodostettu `Idempotency-Key`, jotta Zapierin uudelleenajama Zap ei ilmoita samaa henkilöä kurssille kahdesti.
- **Data**: JSON-muodossa API-viitteen mukaisesti.

Jos haluat toimia organisaation sijasta henkilön nimissä, rekisteröi OAuth-asiakas osoitteessa `/admin/integrations/oauth-clients` Zapierin uudelleenohjausosoitteella ja käytä sitä yksityisessä Zapier-integraatiossa.

## Esimerkki: asiakkaan ilmoittaminen kurssille kaupan päätyttyä <!--quire:example-enrol-a-customer-when-a-deal-closes-->

1. Käynnistin: CRM-järjestelmäsi ilmoitus kaupan voittamisesta.
2. Mukautettu pyyntö `PUT /api/v1/users/ext:{customer id}` henkilön nimellä ja sähköpostilla: luo käyttäjän tai päivittää hänet, jos hän on jo olemassa.
3. Mukautettu pyyntö `POST /api/v1/enrolments` käyttäjän ja kurssin tiedoilla sekä otsakkeella `Idempotency-Key: deal-{deal id}`.

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