Ice breakers and menus - HookMyApp

Ice breakers

Up to 4 tap-to-ask questions shown when someone opens a new chat with your account.
When a person taps one, your webhook receives a postback event (under the messaging_postbacks subscription) with the payload you set.

curl -X POST "https://gateway.hookmyapp.com/meta/v25.0/${INSTAGRAM_ACCOUNT_ID}/messenger_profile" \
  -H "Authorization: Bearer ${INSTAGRAM_ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
  "platform": "instagram",
  "ice_breakers": [
    {
      "call_to_actions": [
        { "question": "What are your prices?", "payload": "PRICING" },
        { "question": "Where do you ship?", "payload": "SHIPPING" }
      ],
      "locale": "default"
    }
  ]
}'

Read what is currently set:

curl "https://gateway.hookmyapp.com/meta/v25.0/me/messenger_profile?platform=instagram&fields=ice_breakers" \
  -H "Authorization: Bearer ${INSTAGRAM_ACCESS_TOKEN}"

Remove them:

curl -X DELETE "https://gateway.hookmyapp.com/meta/v25.0/me/messenger_profile" \
  -H "Authorization: Bearer ${INSTAGRAM_ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{ "platform": "instagram", "fields": ["ice_breakers"] }'

Add a call_to_actions array per locale to translate the questions. The default locale is required.
Ice breakers show on mobile only. A menu that stays available in the chat. Items either send your webhook a postback or open a URL.

curl -X POST "https://gateway.hookmyapp.com/meta/v25.0/${INSTAGRAM_ACCOUNT_ID}/messenger_profile" \
  -H "Authorization: Bearer ${INSTAGRAM_ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
  "platform": "instagram",
  "persistent_menu": [
    {
      "locale": "default",
      "call_to_actions": [
        { "type": "postback", "title": "Talk to a human", "payload": "HUMAN" },
        { "type": "web_url", "title": "Visit our shop", "url": "https://example.com/shop" }
      ]
    }
  ]
}'

Read it with ?platform=instagram&fields=persistent_menu, remove it with "platform": "instagram", "fields": ["persistent_menu"], same as ice breakers.

Next steps

Receive webhooks: Handle the postback events these send.
Quick replies: Offer tap-to-answer choices inside a conversation.