Saltar al contenido

Make

Conecta Quire con Make mediante webhooks y la API REST.

Ver como Markdown

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

  1. Añade el módulo Custom webhook de Webhooks como primer módulo y copia su dirección.
  2. 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.
  3. Verifica la firma antes de actuar. En la configuración avanzada del webhook, permite que pasen las cabeceras y luego comprueba webhook-signature frente 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

  1. Schedule: todos los lunes.
  2. HTTP: GET /api/v1/course_completions?updated_since=<a week ago>.
  3. Iterator sobre data y Aggregator para crear una tabla.
  4. Envía la tabla por correo electrónico o publícala.
Navegación

Escribe para buscar…

↑↓ navegar↵ seleccionarEsc cerrar