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

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

# Zapier

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

Zapier conéctase a Quire mediante a mesma API REST, clientes OAuth e webhooks que usa
calquera integración. Non hai código específico de Quire en ningún dos lados, así que
un Zap pode facer todo o que ofrece a [referencia da API](https://docs.quirelms.com/api/).

## Iniciar un Zap cando suceda algo en Quire <!--quire:start-a-zap-when-something-happens-in-quire-->

1. En Zapier, escolle **Webhooks by Zapier** como disparador co evento **Catch Raw Hook**.
   Raw, porque a sinatura calcúlase sobre os bytes exactos enviados por Quire. Copia o
   enderezo que che proporciona Zapier.
2. En Quire, abre `/admin/webhooks`, escolle **Engadir subscrición**, pega o enderezo e
   selecciona os eventos, por exemplo `course_completion.changed`. Quire envía primeiro
   un evento de proba; a subscrición actívase cando Zapier o recibe.
3. Engade un paso **Code by Zapier** que verifique a sinatura co segredo da subscrición,
   tal como se explica na [guía para desenvolvemento](/gl/developer/#webhooks). Detén o
   Zap se a sinatura non se verifica.
4. Analiza o corpo da petición e continúa cos pasos que precises.

## Actuar en Quire desde un Zap <!--quire:act-in-quire-from-a-zap-->

Usa **Webhooks by Zapier** coa acción **Custom Request** ou **API Request** nun paso da app:

- **URL**: `https://acme.quirelms.com/api/v1/...`, por exemplo `/api/v1/enrolments` para
  matricular alguén.
- **Headers**: `Authorization: Bearer qk_live_...` cunha clave creada en
  `/admin/integrations/api-keys` só para este Zap, e `Idempotency-Key` xerada a partir
  do ID do disparador, para que un Zap repetido por Zapier non matricule dúas veces a mesma persoa.
- **Datos**: JSON, como describe a referencia da API.

Para actuar como unha persoa, non como a organización, rexistra un cliente OAuth en
`/admin/integrations/oauth-clients` co enderezo de redirección de Zapier e úsao nunha
integración privada de Zapier.

## Exemplo: matricular unha persoa cando se pecha unha venda <!--quire:example-enrol-a-customer-when-a-deal-closes-->

1. Disparador: o evento «deal won» do teu CRM.
2. Petición personalizada `PUT /api/v1/users/ext:{customer id}` co nome e correo da persoa:
   crea a persoa usuaria ou actualízaa se xa existe.
3. Petición personalizada `POST /api/v1/enrolments` coa persoa e o curso,
   e `Idempotency-Key: deal-{deal id}`.

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