List picker in Apple Messages for Business

A list picker sends one or more sections of selectable rows. Each row has a title, an optional subtitle, and an optional image. The customer taps the card, picks one row (or several, if you allow it), and taps Send.

Their choice comes back to your webhook with the row identifiers, so your bot knows exactly what was picked without parsing text.

1. 01

   The card in the thread

   A bubble with your title and subtitle, such as Choose a room, and an icon. You set it with received_message.

2. 02

   The opened list

   A full-screen sheet with your sections and rows. Rows can show an icon or photo and a subtitle.

3. 03

   The reply bubble

   After the customer sends, the thread shows what they picked, styled by reply_message.

• Send a short text bubble first to introduce the picker.
• Use sections only when categories really differ. One section is fine.
• Add a relevant image to the card and rows where it helps the customer choose.
• Five or fewer options without images should be a quick reply.

Apple checks these during the Experience Review and after launch. Every rule for every feature is in the Experience Review checklist.

One call to POST /v4/messages from your Apple Messages for Business sender. Full field reference in the List picker in the interactive messages guide.

curl -X POST https://api.blooio.com/v4/messages \
  -H "Authorization: Bearer bl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": "support",
    "to": "opaque-amb-customer-id",
    "interactive": {
      "kind": "list_picker",
      "received_message": { "title": "Choose a room", "subtitle": "Tap to pick one", "style": "icon" },
      "reply_message": { "title": "Room selected", "style": "icon" },
      "sections": [
        {
          "title": "Rooms",
          "multipleSelection": false,
          "items": [
            { "identifier": "living", "title": "Living room", "subtitle": "Sofas, rugs, lighting" },
            { "identifier": "bedroom", "title": "Bedroom", "subtitle": "Beds, linens, storage" },
            { "identifier": "kitchen", "title": "Kitchen & dining", "subtitle": "Tables, stools, tableware" },
            { "identifier": "outdoor", "title": "Outdoor", "subtitle": "Patio sets and planters" }
          ]
        }
      ]
    }
  }'