Zapier

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.

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

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

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