コメントからDMへAPI

「リンクを送って」というコメントを、非公開メッセージに

自動化をひとつ作成すると、FoPostがInstagramとFacebookアカウントのコメントを監視します。コメントが一致すると、コメントした人のDMに非公開の返信が届きます。特に指定しない限り、最初にあなたの承認で保留されます。

POST /v1/automations

curl -X POST https://api.fopost.com/v1/automations \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspaceId": "9b2f6c1e-...",
    "name": "Price comments to DM",
    "triggerType": "inbox_message",
    "triggerConfig": { "keywords": ["price", "link"], "types": ["comment"], "maxRunsPerDay": 20 },
    "graph": {
      "nodes": [
        { "id": "t1", "kind": "trigger" },
        { "id": "m1", "kind": "send_message", "config": {
          "channel": "private",
          "text": "Hi {{contact.name}}, here is the link you asked for.",
          "buttons": [{ "title": "Shop now", "url": "https://yourbrand.com/shop" }]
        } }
      ],
      "edges": [{ "id": "e1", "source": "t1", "target": "m1" }]
    }
  }'

キーワード一致

最大20個のキーワードのいずれか、またはすべてに一致。コメントのみ、またはすべてのメッセージタイプが対象です。

まず承認

新しい自動化は、各返信を保留し、送信前に担当者の承認を待ちます。

コメントごとに1回

DMを送る前にコメントが確保されるため、同じコメントに二度返信することはありません。

トリガー

どのコメントにメッセージを送るかを決める

inbox_message トリガーは、新しいコメント、メンション、返信、DM、ストーリーへの返信、レビューで発火します。キーワード、メッセージタイプ、特定のアカウント、特定の投稿で絞り込めるほか、フォロワーだけ、または相手の最初のメッセージだけに返信するよう設定できます。各自動化はデフォルトで1日最大3回実行され、maxRunsPerDay で最大20回まで引き上げられます。

トリガーのリファレンスを読む

投稿ごと

postIds を指定すると、自動化を指定した投稿へのコメントだけに限定できます。

フォロワーのみ

followersOnly は、アカウントをフォローしていないコメント投稿者をスキップします。

1日の上限

maxRunsPerDay により、バズった投稿で何百通ものメッセージが送られるのを防ぎます。

メッセージ

あなたらしい言葉で、非公開の返信を

channel を private に設定した send_message ステップは、Metaのプライベート返信を通じて、コメントした人にDMを送ります。本文では {{contact.name}} と {{message.text}} が使え、リンクボタンは最大3個、クイックリプライは最大13個まで追加できます。UTMタグ付きで、リダイレクトがカウントされるリンクも添付できます。Metaがプライベート返信を受け付けるのはコメントから7日以内に限られるため、それより古いコメントはその理由で失敗します。

send_message ステップを見る

POST /v1/automations/:id/dry-run

curl -X POST https://api.fopost.com/v1/automations/f2b7d9a4-.../dry-run \
  -H "X-API-Key: $API_KEY"

{
  "would_defer": false,
  "approval_mode": false,
  "steps": [
    { "node_id": "t1", "action_type": "trigger", "status": "completed", ... },
    { "position": 1, "node_id": "m1", "action_type": "send_message", "status": "completed",
      "handle": "out", "error_message": null,
      "output": { "messagePreview": "Hi Jordan, here is the link you asked for.", "channel": "private" } }
  ],
  "drafts": [],
  "total_delay_ms": 0,
  "credits_charged": 0
}

ドライラン

最近のコメントを使ってメッセージをプレビューします。送信や作成は行われません。

追跡リンク

クリックがカウントされ、URLには utm_medium=dm が付きます。

7日間のウィンドウ

Metaのプライベート返信の制限で、送信前に必ず確認されます。

コントロール

すべての実行を承認、一時停止、監査

ステップで requireApproval を false に設定しない限り、各返信は誰かが承認または却下するまで GET /v1/inbox/approvals で待機します。自動化のオン・オフは1回の呼び出しで切り替えられ、実行履歴から、何が発火し、何が待機中で、何が失敗したかを確認できます。

構築を始める

POST /v1/automations/:id/toggle

curl "https://api.fopost.com/v1/inbox/approvals?workspace_id=9b2f6c1e-..." \
  -H "X-API-Key: $API_KEY"

curl -X POST https://api.fopost.com/v1/inbox/approvals/:id/approve -H "X-API-Key: $API_KEY"

curl -X POST https://api.fopost.com/v1/automations/f2b7d9a4-.../toggle -H "X-API-Key: $API_KEY"

{ "id": "f2b7d9a4-...", "active": false }

実行履歴

GET /v1/automations/:id/runs で、ステータス、開始時刻、エラーを取得できます。

再実行

メッセージやトリガーを修正した後、過去の実行をもう一度実行できます。

バージョン

保存された変更はすべてバージョンとして残り、表示や復元ができます。

コメントからDMへに関するよくある質問

コメントからDMへは、どのネットワークで使えますか?

InstagramとFacebookです。コメントへのプライベート返信はMetaの機能で、他のネットワークに同等の機能はありません。同じ自動化でも、channel を same に設定すれば、他のネットワークでコメントに公開で返信できます。

同じ人に2回メッセージが届くことはありますか?

同じコメントでは起こりません。DMを送る前にコメントにマークが付き、自動化はコメントごとに1回しか発火しないため、リトライや繰り返しの実行で新たに送信されることはありません。

誰も確認せずに送信されますか?

デフォルトではされません。requireApproval なしで作成された send_message ステップは、すべての返信を承認待ちで保留します。自動で送信させる準備ができたら、ステップの requireApproval を false に設定してください。

7日より古いコメントはどうなりますか?

Metaは7日を過ぎたプライベート返信を許可していないため、実行はその理由で失敗し、何も送信されません。

どのAPIキーのスコープが必要ですか?

自動化の作成と管理には automations スコープが必要です。保留中の返信の一覧表示と承認には inbox スコープを使います。

自分のシステムから自動化を開始できますか?

はい、別のトリガーを使います。api_webhook トリガーの自動化は、x-automation-secret ヘッダーにシークレットを付けて /v1/automations/:id/trigger に POST すると実行されます。

今日からコメントからDMへで開発を

無料で始められ、API全体が含まれます。キーを作成すれば、数分で最初の呼び出しができます。

APIキーを取得