Facebook プライベートリプライ API: Facebook ページでコメントした人にメッセージを送る
Facebook プライベートリプライは、POST /{page-id}/messages に recipient.comment_id としてコメントの ID を指定して送信します。訪問者投稿の場合は recipient.post_id を指定します。送信には MESSAGING タスクの権限を持つユーザーの Page トークンを使います。Meta は、コメントまたは訪問者投稿 1 件につきメッセージを 1 通まで、7 日以内に許可しています。コメントの can_reply_privately フィールドで、まだ送信できるかどうかを確認できます。メッセージは Messenger に届き、返信先のコメントまたは投稿にリンクされます。
easyCoexistence は、Claude、ChatGPT、またはお使いのコードから、reply_to_comment に private を true に設定してプライベートリプライを送れます。
Facebook ページがコメントまたは投稿をした人に、プライベートリプライとして送信できる内容。
コメントまたは訪問者投稿が作成されてから、プライベートリプライを送信できる期間。
Facebook ページがそのコメントにプライベートリプライを送れるかどうかを示す、コメントのフィールド。
コード 100 の下にある、プライベートリプライには無効なコメントを示すエラーサブコード。
プライベートリプライとは何ですか?
Facebook ページの投稿にコメントした人、そこでコメントに返信した人、または Facebook ページに訪問者投稿をした人に、ページから送る Messenger メッセージは 1 件のみです。Meta は、メッセージにコメントまたは投稿へのリンクを付けるため、相手は何に対する返信かを確認できます。プライベートリプライを別の Facebook ページに送ることはできません。
送信するにはどうしますか?
POST /{page-id}/messages に、recipient を comment_id(訪問者投稿の場合は post_id)、message を内容として指定します。トークンは、Facebook ページで MESSAGING タスクを実行できる人のものでなければならず、pages_messaging 権限が必要です。Meta はプライベートリプライで Send API のすべてのメッセージタイプを利用できるようにしており、Meta 自身の例もボタンを送るものです。
POST /{page-id}/messages
{
"recipient": { "comment_id": "<COMMENT_ID>" },
"message": { "text": "<YOUR_MESSAGE>" }
}制限はどうなっていますか?
Meta はプライベートリプライのガイドで次の制限を定めています。
- コメントまたは訪問者投稿 1 件につきメッセージは 1 通です。
- コメントまたは訪問者投稿が作成されてから 7 日以内に送信します。
- 別の Facebook ページには送信できません。
- それ以上のメッセージは、相手が返信し、その返信によって開かれる 24 時間のウィンドウ内でのみ送れます。
返信の後はどうなりますか?
会話は相手の返信を待ちます。相手が返信すると標準のメッセージングウィンドウが開き、ページは相手のメッセージから 24 時間以内に返信できます。それまでは、そのコメントは 1 回の返信を使っています。コメントのフィールド private_reply_conversation は、プライベートリプライが開始した会話を返すため、返信を、そのきっかけとなったコメントと照合できます。
プライベートリプライはどのエラーを返す可能性がありますか?
Meta のリファレンスには 3 つ記載されています。まずコメントの can_reply_privately フィールドを読むと、ページがそのコメントにプライベートリプライをまだ送れるかどうかが分かります。
- エラー 10900(Activity already replied to): コメントまたは訪問者投稿は、Page messages のリファレンスによると、プライベートリプライを 1 回使用済みです。
- コード 100、サブコード 2534025: コメントはプライベートリプライには無効です。Meta の対処法は、返信のデータの種類が許可されているか確認することです。
- コード 10、サブコード 2534022: メッセージが許可されたウィンドウの外に送られました。これは、相手の返信から 24 時間が過ぎた後に送られるメッセージすべてに当てはまります。
Claude、ChatGPT、またはお使いのコードからどう送りますか?
reply_to_comment に private を true に設定して実行します。comment_id には list_social_comments または転送されたフィードのイベントから取得したコメントの ID を、本文には text を指定すると、コメントした人に Messenger で届きます。private を指定しなければ、同じツールがコメントの下に公開で返信します。訪問者投稿へのプライベート返信や、ボタン付きの返信は、ツールにはありません。
よくある間違い
- 1 つのコメントに 2 通目のプライベートリプライを送ること。Meta は 1 通のみ許可しているため、相手が返信するまで待ってください。
- 7 日を過ぎたコメントにプライベートリプライを送ること。プライベートリプライのウィンドウは閉じています。代わりに、コメントの下で公開返信してください。
- フィードのエンドポイントをポーリングしてコメント ID を取得すること。Meta はレート制限を避けるため、代わりにフィードの Webhook から取得することを推奨しています。
- ユーザーアクセストークンで送信すること。プライベートリプライには Page アクセストークンを使います。これは /me/accounts が Facebook ページに対して返すトークンで、サインインしている人のトークンではありません。
コメントから DM へのルールでは、ページごとに最大 50 件まで、24 時間いつでも送信でき、コメントの下に任意で公開返信を付けられます。料金は接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
1 件の Facebook コメントに何通のプライベートリプライを送れますか?
1 通です。2 通目以降は、相手が返信するまで待機し、その返信から 24 時間以内に送られます。
Facebook のプライベートリプライはどこに届きますか?
相手の Messenger に、ページからのメッセージとして届きます。そのメッセージは、返信先のコメントまたは投稿にリンクされています。
Facebook ページは訪問者投稿にプライベートリプライを送れますか?
はい。Meta はコメントだけでなく訪問者投稿も対象としており、recipient.post_id に訪問者投稿の ID を指定して、公開から 7 日以内に送れます。
easyCoexistence はコードなしでプライベートリプライを送れますか?
はい。コメントから DM へのルールは、ページのコメントに選択したキーワードが含まれると、1 件のプライベートリプライを 24 時間いつでも送ります。オートメーションでは、お使いの AI に文面を書かせることもできます。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日