Zapier | Quire

Zapier verbindet sich über dieselbe REST-API, OAuth-Clients und Webhooks mit Quire, die jede Integration verwendet. Auf keiner Seite gibt es Quire-spezifischen Code. Daher kann ein Zap alles ausführen, was die API-Referenz anbietet.

Einen Zap starten, wenn in Quire etwas geschieht

Wählen Sie in Zapier Webhooks by Zapier als Trigger und das Ereignis Catch Raw Hook. Raw, weil die Signatur über genau die Bytes berechnet wird, die Quire gesendet hat. Kopieren Sie die von Zapier angegebene Adresse.
Öffnen Sie in Quire /admin/webhooks, wählen Sie Add subscription, fügen Sie die Adresse ein und wählen Sie die Ereignisse, zum Beispiel course_completion.changed. Quire sendet zuerst ein Testereignis; das Abonnement beginnt, sobald Zapier es empfangen hat.
Fügen Sie einen Schritt Code by Zapier hinzu, der die Signatur anhand des Abonnement-Secrets prüft, wie im Entwicklerhandbuch beschrieben. Beenden Sie den Zap, wenn die Prüfung fehlschlägt.
Parsen Sie den Body und fahren Sie mit den benötigten Schritten fort.

Von einem Zap aus in Quire handeln

Verwenden Sie Webhooks by Zapier mit der Aktion Custom Request oder in einem App-Schritt API Request:

URL: https://acme.quirelms.com/api/v1/..., zum Beispiel /api/v1/enrolments, um jemanden einzuschreiben.
Headers: Authorization: Bearer qk_live_... mit einem Schlüssel, der ausschließlich für diesen Zap unter /admin/integrations/api-keys erstellt wurde, und ein Idempotency-Key, der aus der ID des Triggers gebildet wird. So wird dieselbe Person nicht zweimal eingeschrieben, wenn Zapier den Zap erneut ausführt.
Data: JSON, wie in der API-Referenz beschrieben.

Wenn Sie als Person statt als Organisation handeln möchten, registrieren Sie unter /admin/integrations/oauth-clients einen OAuth-Client mit der Weiterleitungsadresse von Zapier und verwenden ihn in einer privaten Zapier-Integration.

Beispiel: Einen Kunden nach Abschluss eines Deals einschreiben

Trigger: „Deal gewonnen“ in Ihrem CRM.
Custom Request PUT /api/v1/users/ext:{customer id} mit Name und E-Mail-Adresse der Person: Erstellt den Benutzer oder aktualisiert ihn, falls er bereits existiert.
Custom Request POST /api/v1/enrolments mit Benutzer und Kurs sowie Idempotency-Key: deal-{deal id}.