---
title: "Zapier"
description: "Cunnette Quire à Zapier cù webhooks è l’API REST."
image: "https://docs.quirelms.com/og.png"
---

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

# Zapier

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

Zapier si cunnessa à Quire per mezu di a listessa API REST, di i clienti OAuth
è di i webhooks aduprati da tutte l’integrazioni. Ùn ci hè codice specificu à
Quire da nisuna parte, dunque una Zap pò fà tuttu ciò chì offre u
[riferimentu API](https://docs.quirelms.com/api/).

## Cumincià una Zap quandu accade qualcosa in Quire <!--quire:start-a-zap-when-something-happens-in-quire-->

1. In Zapier, sceglite **Webhooks by Zapier** cum’è attivazione cù
   l’avvenimentu **Catch Raw Hook**. Ci vole Raw perchè a firma hè calculata
   nantu à i byte esatti mandati da Quire. Copiate l’indirizzu datu da Zapier.
2. In Quire, aprite `/admin/webhooks`, sceglite **Aghjunghje abbonamentu**,
   incollate l’indirizzu è sceglite l’avvenimenti, per esempiu
   `course_completion.changed`. Quire manda prima un avvenimentu di prova;
   l’abbonamentu principia quandu Zapier l’hà ricevutu.
3. Aghjunghjite un passu **Code by Zapier** chì verifica a firma cù u secretu
   di l’abbonamentu, cum’è indicatu in a
   [guida di sviluppu](/co/developer/#webhooks). Ferma a Zap s’ella ùn hè
   valida.
4. Analizate u corpu è cuntinuate cù i passi necessarii.

## Agisce in Quire da una Zap <!--quire:act-in-quire-from-a-zap-->

Aduprate **Webhooks by Zapier** cù l’azzione **Custom Request**, o **API
Request** in un passu d’app.

- **URL**: `https://acme.quirelms.com/api/v1/...`, per esempiu
  `/api/v1/enrolments` per iscrive una persona.
- **Intestazioni**: `Authorization: Bearer qk_live_...` cù una chjave creata
  à `/admin/integrations/api-keys` solu per sta Zap, è una `Idempotency-Key`
  custruita cù l’ID di l’attivazione, per impedisce à Zapier di iscrive duie
  volte a stessa persona s’ellu ripete a Zap.
- **Dati**: JSON, cum’è descrittu in u riferimentu API.

Per agisce cum’è una persona invece di cum’è l’urganizazione, registrate un
client OAuth à `/admin/integrations/oauth-clients` cù l’indirizzu di
redirezzione di Zapier è adupratelu da un’integrazione privata di Zapier.

## Esempiu: iscrive un cliente quandu si chjude una vendita <!--quire:example-enrol-a-customer-when-a-deal-closes-->

1. Attivazione: a tappa «affare vintu» di u vostru CRM.
2. Richiesta persunalizata `PUT /api/v1/users/ext:{customer id}` cù u nome è
   l’email di a persona: crea l’utilizatore o l’aggiorna s’ellu esiste dighjà.
3. Richiesta persunalizata `POST /api/v1/enrolments` cù l’utilizatore è u
   cursu, è `Idempotency-Key: deal-{deal id}`.

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