Instagram Messaging

Quick replies - Instagram Messaging

Updated: Oct 5, 2026
Copy for LLM
Quick replies provide a way to present a set of buttons in-conversation for users to reply with. A maximum of 13 quick replies are supported and each quick reply allows up to 20 characters before being truncated. Quick replies only support plain text.
Phone number and email quick replies are disabled for Instagram. Requests that use user_phone_number or user_email will not create contact-information quick replies. Use a text quick reply or ask the end user to enter their contact information.
Instagram conversation showing tappable Quick Replies buttons: Schedule in-store visit, Live chat now, Call
When a quick reply is tapped, Instagram dismisses the buttons and posts the tapped button’s title to the conversation as a message. Instagram then sends a messages event to your webhook that contains the button title and an optional payload.
This feature is currently not available on desktop.

Sending quick replies

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<IGSID>"
  },
  "messaging_type": "RESPONSE",
  "message":{
    "text": "<SOME_TEXT>",
    "quick_replies":[
      {
        "content_type":"text",
        "title":"<TITLE_1>",
        "payload":"<POSTBACK_PAYLOAD_1>"
      },
      {
        "content_type":"text",
        "title":"<TITLE_2>",
        "payload":"<POSTBACK_PAYLOAD_2>"
      }
    ]
  }
}' "https://graph.facebook.com/<API_VERSON>/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

Webhook event

When a quick reply is tapped, Instagram sends a text message to your webhook.
The text property of the event will correspond to the title of the quick reply. The message object will also contain a field named quick_reply containing the payload data on the quick reply.
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IGID>",
      "time": 1502905976963,
      "messaging": [
        {
          "sender": {
            "id": "<IGSID>"
          },
          "recipient": {
            "id": "<IGID>"
          },
          "timestamp": 1502905976377,
          "message": {
            "quick_reply": {
              "payload": "<PAYLOAD>"
            },
            "mid": "<MID>",
            "text": "<SOME_TEXT>"
          }
        }
      ]
    }
  ]
}

Developer Support