Inbox and sender profiles - HookMyApp

Conversation history

Webhooks deliver messages as they arrive. The conversations list gives you everything that came before.

# List conversations
curl "https://gateway.hookmyapp.com/meta/v25.0/me/conversations?platform=instagram" \
  -H "Authorization: Bearer ${INSTAGRAM_ACCESS_TOKEN}"

# List conversations with the messages in each thread
curl --globoff "https://gateway.hookmyapp.com/meta/v25.0/me/conversations?platform=instagram&fields=participants,messages{id,created_time,from,message}" \
  -H "Authorization: Bearer ${INSTAGRAM_ACCESS_TOKEN}"

Each conversation returns its participants and messages, newest first.
Both lists are paginated: follow the top-level paging.next URL for more conversations, and each conversation’s messages.paging cursors for older messages.

Who you are talking to

Look up the profile behind an IGSID from a webhook, so replies can use their name or adapt to whether they follow you.

curl "https://gateway.hookmyapp.com/meta/v25.0/${IGSID}?fields=name,username,profile_pic,follower_count,is_user_follow_business,is_business_follow_user" \
  -H "Authorization: Bearer ${INSTAGRAM_ACCESS_TOKEN}"

Field	What you get
`name`, `username`	Display name and handle. `name` can be null
`profile_pic`	Profile picture URL. Expires after a few days
`follower_count`	Their follower count
`is_user_follow_business`	Whether they follow you
`is_business_follow_user`	Whether you follow them

The profile is only available after the person messages you, or taps an ice breaker or menu item.
Someone who only commented on a post returns a consent error until they send a DM.

Next steps

Ice breakers and menus: Set the questions and menu people see when a chat opens.
Receive webhooks: Handle new messages as they arrive.