ボタン

ほとんどのメッセージテンプレート、および固定メニューは、さまざまなタイプのアクションを呼び出すボタンをサポートします。これらのボタンを使用すると、Messengerウェブビューで開く、支払いフローを開始する、Webhookにポストバックメッセージを送るなど、テンプレートへの応答方法をメッセージの受信者に提示できます。

メッセージテンプレートの場合、ボタンはbuttons配列内のオブジェクトによって定義されます。固定メニューの場合、ボタンはcall_to_actions配列内のオブジェクトによって定義されます。

URLボタン

URLボタンは、Messengerウェブビューでウェブページを開きます。これにより、スレッドにウェブベースのエクスペリエンスを与えることができ、開発の際の柔軟性も増します。例えば、スレッドに製品概要を表示した後、URLボタンを使用すると、ウェブサイトで実際の製品ページを開くことができます。

App Links

サイトにアプリリンクが含まれている場合、ボタンは指定されたネイティブアプリを起動します。

Facebookクローラーは、リダイレクトを実行するためにアプリリンクメタタグを読み取る必要があります。ウェブサイトにタグを実装しただけなら、シェアデバッガーツールで新しいスクレイピングをリクエストすることができます。クローラーがサイトをスクレイピングした後、送信された新しいURLボタンはリダイレクト動作に従うはずです。

サポートされる用途

URLボタンは、以下で使用できます。

• 固定メニュー
• 一般テンプレート
• リストテンプレート
• ボタンテンプレート
• メディアテンプレート

MessengerエクステンションSDK - 必須ドメインのホワイトリスト登録

ボタンフォーマット

ボタンプロパティの一覧は、URLボタンのリファレンスで参照してください。

{
  "type": "web_url",
  "url": "

ポストバックボタン

postbackボタンは、payloadプロパティに文字列設定して、messaging_postbacksイベントをWebhookに送信します。これにより、ボタンがタップされたときに任意のアクションを実行できます。例えば、製品リストを表示した後に、ポストバックで製品IDをWebhookに送信すると、それを使用してデータベースにクエリし、製品の詳細が構造化メッセージとして返されます。

サポートされる用途

ポストバックボタンは、以下で使用できます。

• 固定メニュー
• 一般テンプレート
• リストテンプレート
• ボタンテンプレート
• メディアテンプレート

ボタンフォーマット

ボタンプロパティの一覧は、ポストバックボタンのリファレンスで参照してください。

{
  "type": "postback",
  "title": "

通話ボタン

通話ボタンをタップすると、設定した電話番号に電話をかけられます。電話番号は+<COUNTRY_CODE><PHONE_NUMBER>のフォーマット(例: +15105559999)にします。

サポートされる用途

通話ボタンは、以下で使用できます。

• 一般テンプレート
• リストテンプレート
• ボタンテンプレート
• メディアテンプレート

ボタンフォーマット

ボタンプロパティの一覧は、通話ボタンのリファレンスで参照してください。

{
  "type":"phone_number",
  "title":"

ログインボタン

ログインボタンは、アカウントのリンクフローで使用され、メッセージ受信者を認証のためのウェブベースのログインフローに誘導し、Messenger上のIDをサイト上のアカウントとリンクします。

アカウントのリンクのためのログインボタンの使用に関する詳細は、アカウントのリンクをご覧ください。

サポートされる用途

ログインボタンは、以下で使用できます。

• 一般テンプレート
• リストテンプレート
• ボタンテンプレート
• メディアテンプレート

ボタンフォーマット

ボタンプロパティの一覧は、ログインボタンのリファレンスで参照してください。

{
  "type": "account_link",
  "url": "

ログアウトボタン

ログアウトボタンは、アカウントのリンクフローで使用され、メッセージ受信者のMessenger上のIDをサイトのアカウントからリンク解除します。

アカウントのリンクを解除するためのログアウトボタンの使用に関する詳細は、アカウントのリンクをご覧ください。

サポートされる用途

ログアウトボタンは、以下で使用できます。

• 一般テンプレート
• リストテンプレート
• ボタンテンプレート
• メディアテンプレート

ボタンフォーマット

ボタンプロパティの一覧は、ログアウトボタンのリファレンスで参照してください。

{
  "type": "account_unlink"
}

ゲームプレイボタン

ゲームプレイボタンでは、Facebookページにリンクされているインスタントゲームを開きます。ゲームの開き方は、起動時にゲームに送信されるリクエスト内のpayloadプロパティや、ボットが単一のプレイヤーまたは既存のグループに対して特定のコンテキストでゲームをスタートできるようにするオプションのgame_metadata.player_idプロパティまたはgame_metadata.context_idプロパティを設定することでカスタマイズできます。

ボタンフォーマット

payloadプロパティは、シリアライズされたJSONでなければなりません。これは、Instant Game SDKで逆シリアル化されます。

ボタンプロパティの一覧は、ゲームプレイボタンのリファレンスで参照してください。

{
  "type":"game_play",
  "title":"Play",
  "payload":"{<SERIALIZED_JSON_PAYLOAD>}",
  "game_metadata": { // Only one of the below
    "player_id": "<PLAYER_ID>",
    "context_id": "<CONTEXT_ID>"
  }
}

ユーザーがゲームのラウンドを終えたときにボットに送信されるイベントについては、ゲームプレイWebhooksイベントを参照してください。

ベストプラクティス