---
title: "Zapier"
description: "Connecteu Quire amb Zapier mitjançant webhooks i l’API REST."
image: "https://docs.quirelms.com/og.png"
---

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

# Zapier

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

Zapier es connecta a Quire mitjançant la mateixa API REST, els clients OAuth i
els webhooks que fan servir totes les integracions. No cal cap codi específic
de Quire a cap dels dos costats; per tant, una Zap pot fer tot el que ofereix
la [referència de l’API](https://docs.quirelms.com/api/).

## Iniciar una Zap quan passi alguna cosa a Quire <!--quire:start-a-zap-when-something-happens-in-quire-->

1. A Zapier, trieu **Webhooks by Zapier** com a activador i seleccioneu
   l’esdeveniment **Catch Raw Hook**. Ha de ser Raw perquè la signatura es
   calcula a partir dels bytes exactes que ha enviat Quire. Copieu l’adreça
   que us dona Zapier.
2. A Quire, obriu `/admin/webhooks`, trieu **Afegeix una subscripció**, enganxeu
   l’adreça i seleccioneu els esdeveniments, per exemple
   `course_completion.changed`. Quire envia primer un esdeveniment de prova; la
   subscripció comença quan Zapier l’ha rebut.
3. Afegiu un pas **Code by Zapier** que verifiqui la signatura amb el secret de
   la subscripció, tal com s’explica a la
   [guia per a desenvolupadors](/ca/developer/#webhooks). Atureu la Zap si la
   verificació falla.
4. Analitzeu el cos i continueu amb els passos que necessiteu.

## Actuar a Quire des d’una Zap <!--quire:act-in-quire-from-a-zap-->

Feu servir **Webhooks by Zapier** amb l’acció **Custom Request**, o bé **API
Request** en un pas de l’aplicació:

- **URL**: `https://acme.quirelms.com/api/v1/...`, per exemple
  `/api/v1/enrolments` per inscriure algú.
- **Capçaleres**: `Authorization: Bearer qk_live_...` amb una clau creada a
  `/admin/integrations/api-keys` només per a aquesta Zap, i una
  `Idempotency-Key` basada en l’ID de l’activador, per evitar que una Zap
  repetida per Zapier inscrigui dues vegades la mateixa persona.
- **Dades**: JSON, tal com descriu la referència de l’API.

Per actuar com una persona i no com l’organització, registreu un client OAuth a
`/admin/integrations/oauth-clients` amb l’adreça de redirecció de Zapier i
utilitzeu-lo des d’una integració privada de Zapier.

## Exemple: inscriure un client quan es tanca una venda <!--quire:example-enrol-a-customer-when-a-deal-closes-->

1. Activador: «venda guanyada» del CRM.
2. Petició personalitzada `PUT /api/v1/users/ext:{customer id}` amb el nom i
   l’adreça electrònica de la persona: crea l’usuari o l’actualitza si ja
   existeix.
3. Petició personalitzada `POST /api/v1/enrolments` amb l’usuari i el curs, i
   `Idempotency-Key: deal-{deal id}`.

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