Messenger プロフィール API:あいさつテキスト、Get Started ボタン、アイスブレイカー、固定メニュー
Facebook Page の Messenger プロフィールは、pages_messaging 権限を持つ Page アクセストークンを使い、/{page-id}/messenger_profile で設定します。POST は get_started、greeting、ice_breakers、persistent_menu、commands などのプロパティを書き込み、GET は fields で読み取り、DELETE は fields 配列で指定したものを削除します。Meta は Page あたり 10 分間に 10 回までの呼び出しを許可しており、送信したプロパティだけが上書きされます。
easyCoexistence は、Claude、ChatGPT、または独自のコードから、Page の Messenger 会話に send_social_dm で 24 時間のウィンドウ内に返信でき、新着メッセージはエンドポイントへ到着順に転送されます。
Messenger Profile API の呼び出し回数は、Page ごとに 10 分間隔で制限されます。
API で設定できるアイスブレイカーの上限。両方が設定されている場合は、API のアイスブレイカーが Get Started ボタンより優先されます。
固定メニューの最上位項目の上限数。各項目のタイトルは 30 文字まで。
Page 単位の固定メニュー更新にかかる最長時間。特定の 1 人向けに設定したメニューはリアルタイムで更新されます。
あいさつテキスト。Meta のリファレンスによると、Android と iOS の Messenger では動作しなくなっています。
Messenger プロフィールには何が含まれますか?
Page の Messenger 体験の出発点となる設定です。Meta の Messenger Profile API は以下のプロパティを一覧にしており、いずれも同じエンドポイントで設定と読み取りを行います。開発モードのアプリの場合、設定はアプリにロールを持つユーザーだけに表示されます:
プロパティはどのように読み取り、設定、削除しますか?
1 つのエンドポイントで 3 つのメソッドを使い、Page のトークンで呼び出します。POST は JSON 形式のプロパティを受け取り、指定したものだけを上書きします。GET は fields をカンマ区切りのリストで受け取ります。DELETE は削除対象を fields 配列で指定した JSON ボディを受け取ります。POST と DELETE は result success を返します。Get Started ボタンと固定メニューを 1 回の呼び出しで設定する例:
POST /{page-id}/messenger_profile
{
"get_started": { "payload": "GET_STARTED" },
"persistent_menu": [
{
"locale": "default",
"composer_input_disabled": false,
"call_to_actions": [
{ "type": "postback", "title": "Talk to an agent", "payload": "AGENT" },
{ "type": "web_url", "title": "Shop now", "url": "https://example.com/shop" }
]
}
]
}
{ "result": "success" }Get Started ボタンはどのように動きますか?
ウェルカム画面に表示され、Page の名前、プロフィール画像、カバー写真、そして企業が通常返信するまでの時間が示されます。タップすると Get Started が会話に投稿され、get_started.payload が messaging_postbacks イベントとしてアプリに送られ、標準のメッセージングウィンドウが開きます。Meta によると、Messenger が Facebook アプリのアプリ内ブラウザで動作している場合、このボタンはサポートされていません。また、固定メニューを使うには先に Get Started を設定しておく必要があります。
あいさつテキストは今も機能しますか?
スマートフォンでは機能しません。Meta のリファレンスは現在「[Deprecated] Greeting Text」と題されており、この機能は Android と iOS の Messenger では動作しなくなりました。API は greeting プロパティを受け付ける場合もありますが、顧客には表示されないため、Meta は開発者に使用を避けるよう求めています。ドキュメントによると、greeting は言語ごとに 1 つのテキストを持ち、default が必須で、最大 160 文字です。{{user_first_name}}、{{user_last_name}}、{{user_full_name}} で個人向けにできます。設定には Page の管理者ロールが必要です。
アイスブレイカーはどのように動きますか?
アイスブレイカーは、会話を始めるために人がタップできる質問を最大 4 件表示します。質問はその人が尋ねたかのようにスレッドに投稿され、そのペイロードは postback イベントとして返されます。2022 年 4 月以降は言語(ロケール)ごとに設定でき、ice_breakers の各オブジェクトは call_to_actions と locale を持ち、default のロケールが必須です。ice_breakers を DELETE すると、すべて削除されます。Meta は、新しい会話をめぐって競合する要素を次の順で優先します:
- 両方が設定されている場合、API のアイスブレイカーが Get Started ボタンより優先されます。
- どちらも、Page の受信トレイで設定したカスタムの質問より前に来ます。カスタムの質問は、API のアイスブレイカーが設定されている間は編集できません。
固定メニューはどのように構成しますか?
メニューの配列として構成し、言語ごとに 1 つ、default が必須です。各メニューには type が web_url または postback の call_to_actions を最大 20 件持たせられます。タイトルは最大 30 文字、postback のペイロードは最大 1,000 文字です。composer_input_disabled を true にすると、メニュー、ボタン、webview だけが操作手段になります。表示されるための Meta の要件は以下のとおりです:
- Get Started ボタンが設定済みであり、
pages_messaging権限があること。 - Page が公開されており、アプリが公開設定になっていること。
- 設定を行うユーザーが、Page の管理者ロールを持っていること。
- iOS または Android の Messenger v106 以降で、Facebook アプリのアプリ内ブラウザ以外であること。
- Page 単位の変更は反映まで最大 24 時間かかることがあります。
custom_user_settingsと PSID で 1 人向けに設定したメニューは、リアルタイムで更新されます。
コマンドとは何ですか?
人がいつでも呼び出せるキーワードです。入力欄の横にあるコマンドメニューから選ぶか、スラッシュまたは @ を入力するか、一致する単語を入力したときに表示されるポップオーバーから呼び出せます。言語ごとに 1 件から 100 件のコマンドを持てます。名前は 1 文字から 32 文字で、先頭にスラッシュを付けません。説明は 1 文字から 64 文字です。コマンドが設定されている場合、固定メニューより優先されます。呼び出されたコマンドは messages イベントの message.commands でアプリに届きます。
whitelisted_domains と account_linking_url は何をしますか?
どちらも会話そのものの外にある体験に関わります。whitelisted_domains は、Messenger の webview が Messenger Extensions SDK とチェックボックスプラグインのために開けるドメインを、最大 50 件まで指定します。各ドメインは HTTPS で、完全修飾名により提供されている必要があり、IP アドレスや localhost は使えません。設定には Page の管理者ロールが必要です。account_linking_url は、人の Messenger アカウントを企業のアカウントと紐付けるための HTTPS コールバックです。
easyCoexistence は Page の Messenger プロフィールをどのように設定しますか?
できません。{page-id}/messenger_profile を呼び出すツールはなく、Page のトークンも渡されないため、プロフィールの設定はこの接続の対象外です。人が呼び出したコマンドは、easyCoexistence が転送し自動化が読み取る messages イベントで届きます。Meta が messaging_postbacks イベントとして報告するタップ(Get Started、postback の固定メニュー項目、アイスブレイカーからのもの)は転送されません。Page は feed、messages、mention を購読しているためです。
よくある間違い
- 固定メニューを Get Started より先に設定すること。Meta の要件には Get Started ボタンが含まれるため、先に get_started を設定してください。
- 既定のロケールを省くこと。アイスブレイカー、メニュー、コマンドにはそれぞれ、フォールバックとして locale を default に設定したオブジェクトが必要です。
- プロフィール API をループで呼び出すこと。Meta は Page あたり 10 分間に 10 回までしか呼び出しを許可していないため、複数のプロパティは 1 回の POST にまとめてください。
- メニューの変更がすぐに反映されると期待すること。Page 単位のメニュー更新が人に届くまでに最大 24 時間かかることがあります。
Messenger プロフィールの設定はツールに含まれていません。接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。
よくある質問
固定メニューは人ごとに変えられますか?
はい。人の PSID を指定した custom_user_settings は、その人に限り Page のメニューを上書きします。リアルタイムで更新され、人ごとに 10 分間に 10 回まで呼び出せます。
Messenger プロフィールはどのロケールに対応していますか?
Meta の対応ロケール一覧にあるもの(en_GB、pt_BR、ja_JP など)と、人の言語に一致するものがない場合のフォールバックである default です。
Page の Messenger プロフィールを変更できるのは誰ですか?
pages_messaging を持つ Page トークンを持つアプリです。固定メニュー、あいさつテキスト、ドメインリストには、さらに Page の管理者ロールが必要です。
Facebook Page の easyCoexistence の料金はいくらですか?
Page は 1 接続として数えられます。接続 1 件あたり月額 US$ 9 から、接続数が増えるほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日