---
title: "Zapier"
description: "Collega Quire a Zapier con webhook e API REST."
image: "https://docs.quirelms.com/og.png"
---

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

# Zapier

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

Zapier si collega a Quire tramite le stesse API REST, client OAuth e
webhook usati da ogni integrazione. Non c'è codice specifico di Quire su nessuno
dei due lati, quindi tutto ciò che il [riferimento API](https://docs.quirelms.com/api/) offre, uno Zap può farlo.

## Avviare uno Zap quando accade qualcosa in Quire <!--quire:start-a-zap-when-something-happens-in-quire-->

1. In Zapier, scegli **Webhooks di Zapier** come trigger, con l'evento
   **Catch Raw Hook**. Raw, perché la firma è calcolata sui byte esatti
   inviati da Quire. Copia l'indirizzo fornito da Zapier.
2. In Quire, apri `/admin/webhooks`, scegli **Aggiungi sottoscrizione**, incolla
   l'indirizzo e scegli gli eventi, ad esempio `course_completion.changed`.
   Quire invia prima un evento di prova; la sottoscrizione parte una volta che Zapier lo ha
   ricevuto.
3. Aggiungi un passaggio **Codice di Zapier** che verifica la firma usando il
   segreto della sottoscrizione, come mostrato nella
   [guida per sviluppatori](/it/developer/#webhooks). Interrompi lo Zap quando la verifica
   fallisce.
4. Analizza il corpo e prosegui con i passaggi necessari.

## Agire in Quire da uno Zap <!--quire:act-in-quire-from-a-zap-->

Usa **Webhooks di Zapier** con l'azione **Richiesta personalizzata**, oppure **Richiesta
API** in un passaggio app:

- **URL**: `https://acme.quirelms.com/api/v1/...`, ad esempio
  `/api/v1/enrolments` per iscrivere qualcuno.
- **Intestazioni**: `Authorization: Bearer qk_live_...` con una chiave creata in
  `/admin/integrations/api-keys` solo per questo Zap, e una
  `Idempotency-Key` costruita dall'ID del trigger, così uno Zap che Zapier ripete
  non iscrive due volte la stessa persona.
- **Dati**: JSON, come descritto dal riferimento API.

Per agire come una persona anziché come organizzazione, registra un client OAuth
in `/admin/integrations/oauth-clients` con l'indirizzo di reindirizzamento di Zapier e usalo
da un'integrazione privata di Zapier.

## Esempio: iscrivere un cliente alla chiusura di un affare <!--quire:example-enrol-a-customer-when-a-deal-closes-->

1. Trigger: il "deal vinto" del tuo CRM.
2. Richiesta personalizzata `PUT /api/v1/users/ext:{customer id}` con nome
   ed email della persona: crea l'utente, oppure lo aggiorna se esiste.
3. Richiesta personalizzata `POST /api/v1/enrolments` con utente e corso,
   e `Idempotency-Key: deal-{deal id}`.

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