Automations API Overview

​

仕組み

​

Triggers

​

Actions

​

アクションごとの重複排除ウィンドウ

• そのアクションで重複排除を完全に無効化するには 0 を設定します(受信者がすべてのイベントを期待する fire_webhook / send_email で一般的)。
• 上限は 525600(1 年)です。

{
  "type": "send_dm",
  "message": "Thanks {{recipient_username}}!",
  "dedupWindowMinutes": 1440
}

​

fire_webhook payload

{
  "automationId":      "auto_9xKp2Lm4nQ",
  "triggerId":         "trg_a1b2c3",
  "trigger":           "comment_keyword",
  "platform":          "instagram",
  "recipientId":       "17841401234567890",
  "recipientUsername": "jane_doe",
  "keyword":           "LINK",
  "timestamp":         "2026-05-12T09:14:22.000Z"
}

​

テンプレート変数

Hey {{recipient_username}}, thanks for the comment "{{comment_text}}" — here is the link you wanted: https://example.com

​

レート制限と上限

​

アクティビティのステータス

​

エラーコード

• ビジネスルールエラー はオートメーション固有の番号付き code を持ちます(例: { "action": "automation", "code": 469, ... })。
• バリデーションエラー — 不正なリクエストボディ全般(必須/無効なフィールド、不明なテンプレート変数、認識されないキー)は、単一の 473 レスポンスとして返され、details オブジェクトに問題のあるフィールドが列挙されます。details はバリデータの出力(formErrors と fieldErrors)です。条件ごとのコードではなく、details で分岐してください。fieldErrors では、キーはトップレベルのリクエストフィールド(triggers、actions)です。特定のエントリ内の問題(例: トリガーで keywords が欠落)は、そのフィールド(例: triggers)配下で報告されます。一方、formErrors にはオブジェクトレベルの問題(認識されないキーなど)が含まれます。

​

Meta が許可していないこと

• 新規フォロワーへの自動 DM。 Instagram はフォロー Webhook を公開していません。
• 見知らぬ相手への初回 DM。 Meta はビジネスアカウントがメッセージを送信する前に、受信者側からのコンタクト開始(コメント、返信、DM、リアクション)を必須としています — これは本機能でサポートしているすべての trigger が満たす条件です。
• 一斉アウトバウンドキャンペーン。 プラットフォームレベルで 1 時間あたりの DM 上限とスパム対策ヒューリスティクスが適用されます。

​

マルチプロファイル利用

​

FAQ

​

エンドポイント

• POST /automations — 新しいオートメーションを作成する
• GET /automations — オートメーションを一覧表示する
• GET /automations/:id — トリガーとアクションを含むオートメーションを 1 件取得する
• PUT /automations/:id — 部分更新。active: false で一時停止する
• DELETE /automations/:id — ソフト削除
• GET /automations/:id/activity — カーソルページネーション付きのディスパッチ監査ログ