---
title: "Zapier"
description: "Qabbad Quire ma' Zapier b'webhooks u r-REST API."
image: "https://docs.quirelms.com/og.png"
---

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

# Zapier

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

Zapier jikkonnettja ma' Quire permezz tal-istess REST API, klijenti OAuth u
webhooks li tuża kull integrazzjoni. M'hemm l-ebda kodiċi speċifiku ta' Quire fuq l-ebda
naħa, għalhekk kull ma r-[referenza tal-API](https://docs.quirelms.com/api/) toffri, Zap jista' jagħmel.

## Ibda Zap meta jiġri xi ħaġa f'Quire <!--quire:start-a-zap-when-something-happens-in-quire-->

1. F'Zapier, agħżel **Webhooks by Zapier** bħala t-trigger, bl-avveniment
   **Catch Raw Hook**. Raw, għax il-firma hija kkalkulata fuq il-bytes
   eżatti li Quire bagħtet. Ikkopja l-indirizz li Zapier tagħtik.
2. F'Quire, iftaħ `/admin/webhooks`, agħżel **Żid abbonament**, waħħal l-
   indirizz, u agħżel l-avvenimenti, pereżempju `course_completion.changed`.
   Quire l-ewwel tibgħat avveniment tat-test; l-abbonament jibda ladarba Zapier ikun
   irċevih.
3. Żid pass **Code by Zapier** li jivverifika l-firma bis-
   sigriet tal-abbonament, kif muri fil-
   [gwida tal-iżviluppatur](/mt/developer/#webhooks). Waqqaf iż-Zap meta ma jivverifikax.
4. Ipparsja l-body u kompli bil-passi li għandek bżonn.

## Aġixxi f'Quire minn Zap <!--quire:act-in-quire-from-a-zap-->

Uża **Webhooks by Zapier** bl-azzjoni **Custom Request**, jew **API
Request** f'pass ta' app:

- **URL**: `https://acme.quirelms.com/api/v1/...`, pereżempju
  `/api/v1/enrolments` biex tirreġistra lil xi ħadd.
- **Headers**: `Authorization: Bearer qk_live_...` b'ċavetta magħmula f'
  `/admin/integrations/api-keys` għal dan iż-Zap waħdu, u
  `Idempotency-Key` mibnija mill-ID tat-trigger, biex Zap li Zapier jerġa' jdoqq
  ma jirreġistrax l-istess persuna darbtejn.
- **Data**: JSON, kif tiddeskrivi r-referenza tal-API.

Biex taġixxi bħala persuna aktar milli bħala l-organizzazzjoni, irreġistra klijent OAuth
f'`/admin/integrations/oauth-clients` bl-indirizz ta' redirect ta' Zapier u użah
minn integrazzjoni privata ta' Zapier.

## Eżempju: irreġistra klijent meta jagħlaq deal <!--quire:example-enrol-a-customer-when-a-deal-closes-->

1. Trigger: "deal won" tas-CRM tiegħek.
2. Talba personalizzata `PUT /api/v1/users/ext:{customer id}` bl-isem u l-email tal-persuna:
   toħloq l-utent, jew taġġornah jekk jeżisti.
3. Talba personalizzata `POST /api/v1/enrolments` bl-utent u l-kors,
   u `Idempotency-Key: deal-{deal id}`.

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