Make | Quire

Make 独自の HTTP モジュールと webhook モジュールを使って、REST API と webhook 経由で Quire に接続します。API リファレンスのすべての機能を利用できます。

Quire のイベントからシナリオを開始

最初のモジュールとして Webhooks の Custom webhook を追加し、アドレスをコピーします。
Quire で /admin/webhooks を開き、Add subscription を選択してアドレスを貼り付け、イベントを選びます。Quire のテストイベントを送る間にモジュールを 1 回実行し、Make に本文の形を読み込ませます。
操作前に署名を確認します。webhook の詳細設定でヘッダーを渡し、開発者ガイドのとおり、サブスクリプションのシークレットを使って webhook-signature を {webhook-id}.{webhook-timestamp}.{body} と照合します。検証に失敗したらシナリオを止めるフィルターを追加します。

シナリオから Quire を呼び出す

HTTP モジュールの Make a request を使います。

項目	値
URL	`https://acme.quirelms.com/api/v1/<resource>`
Method	API リファレンスに記載されたもの
Headers	`Authorization: Bearer qk_live_...`、書き込み時は `Idempotency-Key`
Body type	Raw、JSON
Parse response	はい

シナリオ専用のキーを /admin/integrations/api-keys で作り、必要なスコープだけを付与します。一覧では page.has_more が true の間ループし、page.next_cursor を cursor に渡します。カーソルを保存する Set variable と Repeater で実現できます。

個人として動作するシナリオでは、/admin/integrations/oauth-clients で OAuth クライアントを登録し、Make の HTTP モジュール Make an OAuth 2.0 request から使います。

例: 毎週の完了状況まとめ

Schedule: 毎週月曜日。
HTTP: GET /api/v1/course_completions?updated_since=<a week ago>。
data を Iterator で処理し、Aggregator で表にまとめます。
表をメールで送信するか投稿します。