---
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-419/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 clientes OAuth y los webhooks que usa cualquier integración. Ninguno de los dos lados necesita código específico para Quire, así que un Zap puede hacer cualquier cosa que ofrezca 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 disparador y selecciona el evento **Catch Raw Hook**. Debe recibir el contenido sin procesar, porque la firma se calcula a partir de los bytes exactos que envió Quire. Copia la dirección que te da 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 comienza cuando Zapier lo recibe.
3. Agrega un paso de **Code by Zapier** para verificar la firma con el secreto de la suscripción, como se explica en la [guía para desarrolladores](/es-419/developer/#webhooks). Detén el Zap si no se verifica.
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 app:

- **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 una `Idempotency-Key` construida con el ID del disparador, para que si Zapier repite el Zap no inscriba dos veces a la misma persona.
- **Data**: JSON, como se describe en la referencia de la API.

Para que actúe como una persona en vez de 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. Disparador: «oportunidad ganada» en tu CRM.
2. Solicitud personalizada `PUT /api/v1/users/ext:{customer id}` con el nombre y el correo 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-419/integrations/zapier/index.mdx