Showing results for 
Show  only  | Search instead for 
Did you mean: 

Messages sent to your business connected Instagram account (including messages that initiate a conversation), create a POST to the MESSAGE_INBOUND webhook or, in some cases, the EVENT_INBOUND webhook of your Conversation API app. In some cases, the POST includes a populated metadata field that can identify the feature used to send the original Instagram message.


If the Mobile Originated (MO) message is an attachment message, like a media message, media share message, or story mention message, the metadata field specifies the type of the original Instagram message. For example, this is the corresponding payload when a story mention message is sent to your business' connected Instagram account. Note that the metadata field indicates that the type of the message is story_mention.


If the MO message is not an attachment message, you may still be able to identify the feature used to send the message. The table below details the Instagram features that can be identified using the metadata field and the corresponding property that identifies them:


Message Type Identifying Metadata Property
Media type (set to image, video, audio, or file)
Icebreaker payload
Story reply story_id
Story mention type (set to story_mention)
Media share type (set to share)
Shop product referral product_id


Learn more about the Sinch Messenger API for Instagram.

Version history
Last update:
‎04-19-2022 02:11 AM
Updated by: