Zapier

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.

Iniciar un Zap cando suceda algo en 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. 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

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

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