Zum Inhalt springen

Make

Verbinden Sie Quire mit Make über Webhooks und die REST-API.

Als Markdown anzeigen

Make verbindet sich über die REST-API und Webhooks mit Quire und verwendet dafür die HTTP- und Webhook-Module von Make. Alles aus der API-Referenz ist verfügbar.

Ein Szenario durch ein Quire-Ereignis starten

  1. Fügen Sie als erstes Modul Webhooks mit Custom webhook hinzu und kopieren Sie dessen Adresse.
  2. Öffnen Sie in Quire /admin/webhooks, wählen Sie Add subscription, fügen Sie die Adresse ein und wählen Sie die Ereignisse. Mit Quire’s Testereignis kann Make die Form des Bodys ermitteln: Führen Sie das Modul während des Versands einmal aus.
  3. Prüfen Sie die Signatur, bevor Sie weitere Aktionen ausführen. Leiten Sie in den erweiterten Einstellungen des Webhooks die Header weiter und prüfen Sie webhook-signature anhand von {webhook-id}.{webhook-timestamp}.{body} und dem Abonnement-Secret, wie im Entwicklerhandbuch beschrieben. Fügen Sie einen Filter hinzu, der das Szenario bei fehlgeschlagener Prüfung stoppt.

Quire aus einem Szenario aufrufen

Verwenden Sie im Modul HTTP die Aktion Make a request:

Feld Wert
URL https://acme.quirelms.com/api/v1/<resource>
Methode Wie in der API-Referenz angegeben
Header Authorization: Bearer qk_live_... und bei Schreibvorgängen Idempotency-Key
Body-Typ Raw, JSON
Antwort parsen Yes

Erstellen Sie unter /admin/integrations/api-keys einen Schlüssel ausschließlich für Make und vergeben Sie nur die Berechtigungsbereiche, die das Szenario benötigt. Durchlaufen Sie Listen, solange page.has_more den Wert true hat, und übergeben Sie page.next_cursor als cursor: Das gelingt mit Make’s Repeater und einer Set variable, die den Cursor speichert.

Für Szenarien, die als Person handeln sollen, registrieren Sie unter /admin/integrations/oauth-clients einen OAuth-Client und verwenden das Modul HTTP von Make mit der Aktion Make an OAuth 2.0 request.

Beispiel: Wöchentliche Übersicht der Abschlüsse

  1. Schedule: jeden Montag.
  2. HTTP: GET /api/v1/course_completions?updated_since=<a week ago>.
  3. Iterator über data, Aggregator zu einer Tabelle.
  4. Senden Sie die Tabelle per E-Mail oder veröffentlichen Sie sie.
Navigation

Suchbegriff eingeben…

↑↓ navigieren↵ auswählenEsc schließen