ガイド

Zapier・Make連携

ノーコードの自動化から同僚の仕事を始めます。Zapier や Make にインストールする Synthia Agents 専用アプリはありません。両サービスに標準で備わる汎用の HTTP・Webhook モジュールから、下の2種類のどちらかの認証情報を使って、あなたのデプロイメントを直接呼び出します。

6 分で読めます

2つの方法このセクションへのリンクをコピー

方法リクエスト認証情報向いている場面
A. ルーティンを今すぐ実行POST /api/routines/{id}/runwrite:routines スコープを持つ API キー仕事の内容はルーティン自身の指示で決まっていて、自動化は実行のタイミングだけを決めるとき。
B. Webhookトリガーを呼び出すPOST /api/events/triggers/{id}そのトリガー専用のキー(Authorization: Bearer として送信)データも一緒に送りたいとき、または自動化に API キーを渡したくないとき。このキーで開けるのはそのトリガーだけです。

どちらも、あなたのデプロイメントのアドレスへの通常の HTTPS POST リクエストで、サインイン済みのブラウザは不要です。トリガーのアドレスは、ワークスペースがサインインなしで受け付ける数少ない受信 Webhook パスの1つです。トリガー自身がキーを検証するためで、それ以外はすべて引き続きサインインが必要です。

A. API キーでルーティンを実行するこのセクションへのリンクをコピー

  1. ワークスペースで 設定 › API キー を開き、スコープ read:routines と write:routines を付けてキーを作成します。表示は一度だけなので、その場でコピーしてください(read:routines は下でルーティンの id を調べるためだけに使います)。
  2. ルーティンの id を調べます。下の呼び出しでルーティンの一覧が返ります。
  3. Zapier または Make に HTTP ステップを追加し、実行アドレスへ POST を送ります。ヘッダーは Authorization: Bearer とキーです。ボディは不要です。
read -rs api_key && export api_key
export workspace="https://<your-deployment>"

curl -sS -H "Authorization: Bearer $api_key" \
  "$workspace/api/routines"

export routine_id="<the routine id>"
curl -sS -X POST -H "Authorization: Bearer $api_key" \
  "$workspace/api/routines/$routine_id/run"

応答は 202 と {"accepted": true, "runId": "…"} です。実行が始まったという意味で、完了ではありません。進み具合はアプリのルーティン履歴か GET /api/routines/{id}/runs で確認できます。401 はキーがない・誤っている・失効・期限切れ、403 はキーに write:routines がないことを示します。

同じリクエストを、HTTP モジュールの入力項目の形で示します。

{
  "method": "POST",
  "url": "https://<your-deployment>/api/routines/<routine id>/run",
  "headers": {
    "Authorization": "Bearer <your API key>"
  }
}

B. Webhookトリガーを呼び出すこのセクションへのリンクをコピー

  1. Webhook トリガーを追加します。ルーティンなら ルーティン › トリガー › トリガーを追加、責務なら責務のトリガーから追加します。
  2. URL をコピーでアドレスをコピーし、キーを表示とヘッダーをコピーを押します。ヘッダーは Authorization: Bearer whsec_… です。パスワードと同じように扱い、キーをローテーションで差し替えられます。
  3. そのヘッダーを付けて、JSON オブジェクト(または空のボディ)をアドレスへ送ります。
export trigger_url="https://<your-deployment>/api/events/triggers/<trigger id>"
read -rs trigger_key && export trigger_key

curl -sS -X POST \
  -H "Authorization: Bearer $trigger_key" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: form-response-1042" \
  -d '{"type":"form.submitted","name":"Aiko Tanaka","email":"aiko@example.com","message":"Can we book a demo next week?"}' \
  "$trigger_url"

ボディだけを、HTTP モジュールのリクエスト内容に貼り付ける形で示します。

{
  "type": "form.submitted",
  "name": "Aiko Tanaka",
  "email": "aiko@example.com",
  "message": "Can we book a demo next week?"
}
応答意味
200"accepted": true。"queued": true なら実行がキューに入りました(完了ではありません)。"queued": false なら、何も実行されなかった理由が reason にあります(例:フィルターに一致しなかった)。"duplicate": true は同じイベントが以前に届いていたことを示します。
401キーがないか、誤っています。
409トリガー、そのルーティン、またはその責務が一時停止中です。
413ボディが 256 KB を超えています。
4291つの送信元アドレスからこのパスへのリクエストが1分間に120件を超えました。1分待ってください。
503トリガーにまだキーがないか、デプロイメントが起動中です。少し待ってから再試行してください。

type(または event)はイベント名で、トリガーのフィルターはこれに一致させます。省略すると received になります。Idempotency-Key(200文字まで)で再送が安全になります。同じキーが2回届いても1つのイベントとして扱うので、自動化のきっかけになったレコードの id を設定してください。

データの扱い:ルーティンの場合、トリガーはルーティンを起動するだけで、ボディの内容にかかわらずルーティン自身の指示どおりに動きます。責務の場合は実行にイベントが渡されるので、同僚は送ったフィールドを使って仕事ができます。

自動化側で HMAC を計算できるなら、キーを送る代わりに署名もできます。トリガーのキーで署名した Standard Webhooks のヘッダー webhook-id・webhook-timestamp・webhook-signature を、タイムスタンプから5分以内なら受け付けます。

すぐ使えるレシピこのセクションへのリンクをコピー

手順どおりに組み立てられる3つの自動化です。モジュール名は現在の Zapier・Make の表示に合わせていますが、メニュー内の位置は変わることがあります。

1. Zapier:新しいフォーム回答に同僚がフォローアップこのセクションへのリンクをコピー

  1. ワークスペースで「新しい問い合わせには1時間以内に返信する」のような責務を作り、Webhook トリガーを追加します。URL とヘッダーをコピーします。
  2. Zapier で Zap を作成します。トリガーはフォームアプリの新規回答イベントです(例:Google Forms の新しい回答 New Form Response、Typeform の新しい回答 New Entry)。
  3. アクション:Zapier の Webhook アプリ Webhooks by Zapier、イベントは POST。URL はトリガーの URL、Payload Type は json。Data には type = form.submitted と、フォームの項目から割り当てた name・email・message を入れます。
  4. Headers:Authorization = Bearer whsec_…(キー)、Idempotency-Key = フォーム回答の id。
  5. ステップをテストします。Zapier に 200 と "accepted": true が表示され、責務に実行が現れます。

2. Make:商談が受注になったらオンボーディングのルーティンを開始このセクションへのリンクをコピー

  1. ワークスペースで、オンボーディング開始を指示とするルーティンを作り、write:routines を持つ API キーを作成します。ルーティンの id を控えます。
  2. Make でシナリオを作成します。最初のモジュールは CRM の商談監視(または更新レコード監視)モジュールです。
  3. その後ろにフィルターを置き、商談のステージが受注のときだけ進むようにします。
  4. 次のモジュール:HTTP › Make a request。URL は https://<your-deployment>/api/routines/<routine id>/run、Method は POST、ヘッダーは Authorization = Bearer <API キー>。ボディは不要です。
  5. 一度実行します。Make にステータス 202 が表示され、ルーティンの履歴に実行が現れます。

3. Make または Zapier:スプレッドシートの新しい行を同僚が仕分けこのセクションへのリンクをコピー

  1. 「受付シートの新しい依頼を仕分ける」のような責務を作り、Webhook トリガーを付けます。必要ならトリガーに type = row.added のフィルターを設定します。
  2. トリガー:Make なら Google Sheets の行の監視 Watch Rows、Zapier なら新しい行 New Spreadsheet Row。
  3. アクション:Make の HTTP リクエスト HTTP › Make a request(ボディタイプは raw、コンテンツタイプは JSON)または Zapier のカスタムリクエスト Webhooks by Zapier › Custom Request。メソッド POST でトリガーの URL へ、Authorization ヘッダーを付け、行の列を割り当てた次のボディを送ります。
{
  "type": "row.added",
  "sheet": "Intake",
  "row": 57,
  "request": "Laptop for the new designer",
  "requested_by": "kenji@example.com"
}

Idempotency-Key にはシート名と行番号(例:Intake-57)を設定します。シナリオを再実行しても同じ行を二重に仕分けしません。

認証情報の管理このセクションへのリンクをコピー

キーは Zapier・Make の保存済み接続やヘッダー欄に置き、ステップの見える本文には書かないでください。自動化が1つのものを起動するだけなら、API キーよりトリガーのキーを選んでください。トリガーのキーはほかに何も開けません。漏れた場合はトリガーのキーをローテーションするか、設定 › API キーで API キーを失効させます。新しいキーを貼り付けるまで、その自動化は動かなくなります。

← 開発者ドキュメント

最終更新日