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

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

# Zapier

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

Zapier se conecta a Quire mediante la misma API REST, los mismos clientes OAuth y los mismos webhooks que usan todas las integraciones. Ninguno de los dos lados necesita código específico de Quire, así que un Zap puede hacer todo lo que ofrece la [referencia de la API](https://docs.quirelms.com/api/).

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

1. En Zapier, elige **Webhooks by Zapier** como activador y selecciona el evento **Catch Raw Hook**. Debe ser sin procesar porque la firma se calcula sobre los bytes exactos que envió Quire. Copia la dirección que te proporciona Zapier.
2. En Quire, abre `/admin/webhooks`, elige **Add subscription**, pega la dirección y selecciona los eventos; por ejemplo, `course_completion.changed`. Quire envía primero un evento de prueba; la suscripción empieza cuando Zapier lo recibe.
3. Añade un paso **Code by Zapier** que verifique la firma usando el secreto de la suscripción, como se muestra en la [guía para desarrolladores](/es/developer/#webhooks). Detén el Zap si la verificación falla.
4. Analiza el cuerpo y continúa con los pasos que necesites.

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

Usa **Webhooks by Zapier** con la acción **Custom Request**, o **API Request** en un paso de aplicación:

- **URL**: `https://acme.quirelms.com/api/v1/...`, por ejemplo, `/api/v1/enrolments` para inscribir a alguien.
- **Headers**: `Authorization: Bearer qk_live_...` con una clave creada en `/admin/integrations/api-keys` solo para este Zap, y un `Idempotency-Key` construido a partir del ID del activador, para que si Zapier vuelve a ejecutar el Zap no inscriba dos veces a la misma persona.
- **Data**: JSON, tal como se describe en la referencia de la API.

Para actuar como una persona y no como la organización, registra un cliente OAuth en `/admin/integrations/oauth-clients` con la dirección de redirección de Zapier y úsalo desde una integración privada de Zapier.

## Ejemplo: inscribir a un cliente al cerrar una oportunidad <!--quire:example-enrol-a-customer-when-a-deal-closes-->

1. Activador: «oportunidad ganada» en tu CRM.
2. Solicitud personalizada `PUT /api/v1/users/ext:{customer id}` con el nombre y correo electrónico de la persona: crea el usuario o lo actualiza si ya existe.
3. Solicitud personalizada `POST /api/v1/enrolments` con el usuario y el curso, y `Idempotency-Key: deal-{deal id}`.

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