Zapier・Make連携
ノーコードの自動化から同僚の仕事を始めます。Zapier や Make にインストールする Synthia Agents 専用アプリはありません。両サービスに標準で備わる汎用の HTTP・Webhook モジュールから、下の2種類のどちらかの認証情報を使って、あなたのデプロイメントを直接呼び出します。
6 分で読めます
2つの方法このセクションへのリンクをコピー
| 方法 | リクエスト | 認証情報 | 向いている場面 |
|---|---|---|---|
| A. ルーティンを今すぐ実行 | POST /api/routines/{id}/run | write:routines スコープを持つ API キー | 仕事の内容はルーティン自身の指示で決まっていて、自動化は実行のタイミングだけを決めるとき。 |
| B. Webhookトリガーを呼び出す | POST /api/events/triggers/{id} | そのトリガー専用のキー(Authorization: Bearer として送信) | データも一緒に送りたいとき、または自動化に API キーを渡したくないとき。このキーで開けるのはそのトリガーだけです。 |
どちらも、あなたのデプロイメントのアドレスへの通常の HTTPS POST リクエストで、サインイン済みのブラウザは不要です。トリガーのアドレスは、ワークスペースがサインインなしで受け付ける数少ない受信 Webhook パスの1つです。トリガー自身がキーを検証するためで、それ以外はすべて引き続きサインインが必要です。
A. API キーでルーティンを実行するこのセクションへのリンクをコピー
- ワークスペースで 設定 › API キー を開き、スコープ
read:routinesとwrite:routinesを付けてキーを作成します。表示は一度だけなので、その場でコピーしてください(read:routinesは下でルーティンの id を調べるためだけに使います)。 - ルーティンの
idを調べます。下の呼び出しでルーティンの一覧が返ります。 - 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トリガーを呼び出すこのセクションへのリンクをコピー
- Webhook トリガーを追加します。ルーティンなら ルーティン › トリガー › トリガーを追加、責務なら責務のトリガーから追加します。
- URL をコピーでアドレスをコピーし、キーを表示とヘッダーをコピーを押します。ヘッダーは
Authorization: Bearer whsec_…です。パスワードと同じように扱い、キーをローテーションで差し替えられます。 - そのヘッダーを付けて、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 を超えています。 |
429 | 1つの送信元アドレスからこのパスへのリクエストが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時間以内に返信する」のような責務を作り、Webhook トリガーを追加します。URL とヘッダーをコピーします。
- Zapier で Zap を作成します。トリガーはフォームアプリの新規回答イベントです(例:Google Forms の新しい回答 New Form Response、Typeform の新しい回答 New Entry)。
- アクション:Zapier の Webhook アプリ Webhooks by Zapier、イベントは POST。URL はトリガーの URL、Payload Type は
json。Data にはtype=form.submittedと、フォームの項目から割り当てたname・email・messageを入れます。 - Headers:
Authorization=Bearer whsec_…(キー)、Idempotency-Key= フォーム回答の id。 - ステップをテストします。Zapier に
200と"accepted": trueが表示され、責務に実行が現れます。
2. Make:商談が受注になったらオンボーディングのルーティンを開始このセクションへのリンクをコピー
- ワークスペースで、オンボーディング開始を指示とするルーティンを作り、
write:routinesを持つ API キーを作成します。ルーティンの id を控えます。 - Make でシナリオを作成します。最初のモジュールは CRM の商談監視(または更新レコード監視)モジュールです。
- その後ろにフィルターを置き、商談のステージが受注のときだけ進むようにします。
- 次のモジュール:HTTP › Make a request。URL は
https://<your-deployment>/api/routines/<routine id>/run、Method はPOST、ヘッダーはAuthorization=Bearer <API キー>。ボディは不要です。 - 一度実行します。Make にステータス
202が表示され、ルーティンの履歴に実行が現れます。
3. Make または Zapier:スプレッドシートの新しい行を同僚が仕分けこのセクションへのリンクをコピー
- 「受付シートの新しい依頼を仕分ける」のような責務を作り、Webhook トリガーを付けます。必要ならトリガーに
type=row.addedのフィルターを設定します。 - トリガー:Make なら Google Sheets の行の監視 Watch Rows、Zapier なら新しい行 New Spreadsheet Row。
- アクション: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 キーを失効させます。新しいキーを貼り付けるまで、その自動化は動かなくなります。
最終更新日