ログイン無料トライアルを開始
easyCoexistence 公式 API

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 時間のウィンドウ内に返信でき、新着メッセージはエンドポイントへ到着順に転送されます。

10 per 10 min

Messenger Profile API の呼び出し回数は、Page ごとに 10 分間隔で制限されます。

4 questions

API で設定できるアイスブレイカーの上限。両方が設定されている場合は、API のアイスブレイカーが Get Started ボタンより優先されます。

20 items

固定メニューの最上位項目の上限数。各項目のタイトルは 30 文字まで。

24 hours

Page 単位の固定メニュー更新にかかる最長時間。特定の 1 人向けに設定したメニューはリアルタイムで更新されます。

Deprecated

あいさつテキスト。Meta のリファレンスによると、Android と iOS の Messenger では動作しなくなっています。

Messenger プロフィールには何が含まれますか?

Page の Messenger 体験の出発点となる設定です。Meta の Messenger Profile API は以下のプロパティを一覧にしており、いずれも同じエンドポイントで設定と読み取りを行います。開発モードのアプリの場合、設定はアプリにロールを持つユーザーだけに表示されます:

get_startedThe payload sent as a messaging_postbacks event when someone taps Get Started
greetingLocale-specific welcome screen text, which Meta marks deprecated as of November 2026
ice_breakersUp to 4 questions a person can tap to start the conversation
persistent_menuUp to 20 buttons kept in the conversation, per locale
commandsKeywords a person can tap or type, each with a description
whitelisted_domainsUp to 50 HTTPS domains for the Messenger Extensions SDK and the checkbox plugin
account_linking_urlThe HTTPS callback for linking a person's account with the business
subject_to_new_eu_privacy_rulesRead-only flag for Pages affected by Meta's Messenger API updates for Europe

プロパティはどのように読み取り、設定、削除しますか?

1 つのエンドポイントで 3 つのメソッドを使い、Page のトークンで呼び出します。POST は JSON 形式のプロパティを受け取り、指定したものだけを上書きします。GET は fields をカンマ区切りのリストで受け取ります。DELETE は削除対象を fields 配列で指定した JSON ボディを受け取ります。POST と DELETE は result success を返します。Get Started ボタンと固定メニューを 1 回の呼び出しで設定する例:

Get Started and a persistent menu in one POST
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 時間かかることがあります。
EasyCoexistence で実現する

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 監視

確認日