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 webhooks, usando sus propios módulos HTTP y de webhook. Está disponible todo lo que ofrece la referencia de la API.

Iniciar un escenario desde un evento de Quire

  1. Agrega 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 realizar una acción. En la configuración avanzada del webhook, permite que pasen las cabeceras y luego compara webhook-signature con {webhook-id}.{webhook-timestamp}.{body} usando el secreto de la suscripción, como se explica en la guía para desarrolladores. Agrega un filtro que detenga el escenario si falla la verificación.

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 Como indica 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 solo para Make en /admin/integrations/api-keys, con los permisos que necesita el escenario. Para las listas, repite mientras page.has_more sea true y pasa page.next_cursor como cursor: puedes hacerlo con Repeater y una Set variable de Make que guarde el cursor.

Para 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: cada lunes.
  2. HTTP: GET /api/v1/course_completions?updated_since=<a week ago>.
  3. Iterator sobre data y Aggregator para formar una tabla.
  4. Envía la tabla por correo o publícala.
Navegación

Escribe para buscar…

↑↓ navegar↵ seleccionarEsc cerrar