クイック返信

クイック返信では、タイトルと画像(任意)付きの最大13個のボタン一式をスレッド内で使用し、作成画面にわかりやすく表示できます。また、クイック返信を使って、利用者の位置情報、メールアドレス、電話番号をリクエストすることもできます。

クイック返信をタップすると、ボタンが閉じ、タップしたボタンのタイトルがメッセージとしてスレッドに投稿されます。ボタンのタイトルと任意指定のペイロードを含んだmessagesイベントが、Webhookに送信されます。

クイック返信を送る

クイック返信を送るには、テキストメッセージにquick_replies配列を追加して、最大13個のクイック返信ボタンを定義するオブジェクトを含めます。

次のクイック返信タイプがサポートされています。

• テキスト
• 携帯電話番号
• メール

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "messaging_type": "RESPONSE",
  "message":{
    "text": "Pick a color:",
    "quick_replies":[
      {
        "content_type":"text",
        "title":"Red",
        "payload":"<POSTBACK_PAYLOAD>",
        "image_url":"http://example.com/img/red.png"
      },{
        "content_type":"text",
        "title":"Green",
        "payload":"<POSTBACK_PAYLOAD>",
        "image_url":"http://example.com/img/green.png"
      }
    ]
  }
}' "https://graph.facebook.com/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"    

テキストのクイック返信

タイトルの横にアイコンとして表示される画像(任意)を付けて、テキストのクイック返信を送ることもできます。クイック返信のcontent_typeがtextとして指定されている場合は、空でないtitleを指定する必要があります。

構文

{
  "content_type":"text",
  "title":"<BUTTON_TEXT>",
  "image_url":"http://example.com/img/red.png",
  "payload":"<DEVELOPER_DEFINED_PAYLOAD>"
}

Webhookイベント

クイック返信をタップすると、テキストメッセージがWebhookのメッセージ受信コールバックに送信されます。

イベントのtextプロパティは、クイック返信のタイトルに対応します。また、メッセージオブジェクトにはquick_replyという名前のフィールドがあり、このフィールドにはクイック返信のpayloadデータが含まれます。

{
  "object": "page",
  "entry": [
    {
      "id": "<PAGE_ID>",
      "time": 1502905976963,
      "messaging": [
        {
          "sender": {
            "id": "1254459154682919"
          },
          "recipient": {
            "id": "682498171943165"
          },
          "timestamp": 1502905976377,
          "message": {
            "quick_reply": {
              "payload": "DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_GREEN"
            },
            "mid": "m_AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P",
            "text": "Green"
          }
        }
      ]
    }
  ]
}

利用者の携帯電話番号のクイック返信

利用者の携帯電話番号のクイック返信では、利用者に携帯電話番号をリクエストできます。携帯電話番号のクイック返信が送信されると、利用者のプロフィール情報にある携帯電話番号が、Messengerプラットフォームによってクイック返信に自動入力されます。

利用者のプロフィールに携帯電話番号が登録されていない場合、クイック返信は表示されません。

利用者がクイック返信をクリックするまで、ボットには携帯電話番号が送信されません。

クイック返信を選択すると情報は1度送信されますが、それ以降もずっとその情報にアクセスできるわけではありません。

構文

{
  "content_type":"user_phone_number"
}

Webhookイベント

利用者がクイック返信をタップすると、携帯電話番号がmessages Webhookイベントのpayload属性に渡されます。

{
  "object": "page",
  "entry": [
    {
      "id": "

利用者のメールアドレスのクイック返信

利用者のメールアドレスのクイック返信では、利用者にメールアドレスをリクエストできます。メールアドレスのクイック返信が送信されると、利用者のプロフィール情報にあるメールアドレスが、Messengerプラットフォームによってクイック返信に自動入力されます。

利用者のプロフィールにメールアドレスが登録されていない場合、クイック返信は表示されません。

利用者がクイック返信をクリックするまで、ボットにはメールアドレスが送信されません。

クイック返信を選択すると情報は1度送信されますが、それ以降もずっとその情報にアクセスできるわけではありません。

構文

{
  "content_type":"user_email"
}

Webhookイベント

利用者がクイック返信をタップすると、メールアドレスがmessages Webhookイベントのpayload属性に渡されます。

{
  "object": "page",
  "entry": [
    {
      "id": "

ベストプラクティス