Make se conecta a Quire mediante la API REST y los webhooks, usando sus propios módulos HTTP y de webhook. Todo lo que aparece en la referencia de la API está disponible.
Iniciar un escenario desde un evento de Quire
- Añade el módulo Custom webhook de Webhooks como primer módulo y copia su dirección.
- En Quire, abre
/admin/webhooks, elige Add subscription, pega la dirección y selecciona los eventos. El evento de prueba de Quire permite que Make detecte la estructura del cuerpo: ejecuta el módulo una vez mientras se envía. - Verifica la firma antes de actuar. En la configuración avanzada del webhook, permite que pasen las cabeceras y luego comprueba
webhook-signaturefrente a{webhook-id}.{webhook-timestamp}.{body}con el secreto de la suscripción, tal como se describe en la guía para desarrolladores. Añade un filtro que detenga el escenario si la comprobación falla.
Llamar a Quire desde un escenario
Usa el módulo HTTP, opción Make a request:
| Campo | Valor |
|---|---|
| URL | https://acme.quirelms.com/api/v1/<resource> |
| Método | Según lo indicado en la referencia de la API |
| Headers | Authorization: Bearer qk_live_... e Idempotency-Key para escrituras |
| Tipo de cuerpo | Raw, JSON |
| Analizar respuesta | Sí |
Crea una clave exclusiva para Make en /admin/integrations/api-keys, con solo los ámbitos que necesite el escenario. Para las listas, repite mientras page.has_more sea true y pasa page.next_cursor como cursor: la combinación Repeater y Set variable de Make, que conserva el cursor, lo hace posible.
Para los escenarios que deban actuar como una persona, registra un cliente OAuth en /admin/integrations/oauth-clients y úsalo con el módulo HTTP, opción Make an OAuth 2.0 request, de Make.
Ejemplo: resumen semanal de finalizaciones
- Schedule: todos los lunes.
- HTTP:
GET /api/v1/course_completions?updated_since=<a week ago>. - Iterator sobre
datay Aggregator para crear una tabla. - Envía la tabla por correo electrónico o publícala.