クイック返信のリファレンス

クイック返信を使うと、メッセージ内の送信ボタンによって受信者の入力内容を受け取ることができます。クイック返信がタップされると、スレッド内でボタンの値が送信され、MessengerプラットフォームからWebhookにmessagesイベントが送信されます。クイック返信は、送信APIで送信されるメッセージタイプです。メッセージの送信について詳しくは、メッセージをご覧ください。

詳しい使い方については、クイック返信をご覧ください。

リクエストの例

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/v19.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

応答の例

{
  "recipient_id": "1254477777772919",
  "message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}

プロパティ

プロパティ	型	説明
`text`	文字列	クイック返信で送信する、空でないメッセージテキスト。`text`または`attachment`を設定する必要があります。
`attachment`	オブジェクト	クイック返信で送信する添付ファイル。`text`または`attachment`を設定する必要があります。
`quick_replies`	配列<`quick_reply`>	送信するクイック返信ボタンについて記述するオブジェクトの配列。最大13件のクイック返信がサポートされています。

`quick_reply`

プロパティ	型	説明
`content_type`	文字列	次のいずれかである必要があります。 `text`: テキストボタンを送信します。 `user_phone_number`: 受信者が自分のアカウントに関連付けられている電話番号を送信できるボタンを送信します。 `user_email`: 受信者が自分のアカウントに関連付けられているメールアドレスを送信できるボタンを送信します。
`title`	文字列	`content_type`が「text」の場合は必須。クイック返信ボタンに表示するテキスト。20文字以内。
`payload`	文字列、数値	`content_type`が「text」の場合は必須。`messaging_postbacks` Webhookイベント経由で返信されるカスタムデータ。最大1,000文字です。 `image_url`が設定されている場合は、空の文字列を設定できます。
`image_url`	文字列	*任意。*テキストをクイック返信するクイック返信ボタンに表示される画像のURL。画像は24px x 24px以上にしてください。大きな画像は自動でトリミングされてサイズ変更されます。 `title`が空の文字列の場合は必須。