Zapier

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.

Iniciar un Zap cuando ocurre algo en 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. 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

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

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}.