> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hookmyapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Inbox

> Read past Messenger conversations with your Page.

## Conversation history

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

```bash theme={null}
# List conversations, most recently updated first
curl "https://gateway.hookmyapp.com/meta/v25.0/${PAGE_ID}/conversations?platform=messenger&fields=id,participants,updated_time,unread_count,snippet" \
  -H "Authorization: Bearer ${PAGE_ACCESS_TOKEN}"

# One thread. Messages are a field expansion on the thread node
curl --globoff "https://gateway.hookmyapp.com/meta/v25.0/${CONVERSATION_ID}?fields=messages{id,message,from,to,created_time}" \
  -H "Authorization: Bearer ${PAGE_ACCESS_TOKEN}"
# Messages come back nested under messages.data
```

Thread ids start with `t_`. `participants` lists the person and the Page; the person's `id` is the PSID to reply to.<br />
Both lists are paginated: follow the top-level `paging` cursors for more conversations, and each thread's `messages.paging` cursors for older messages.

`platform=messenger` keeps the list to Messenger threads. A Page with a linked Instagram account also has Instagram threads; those belong to the Instagram channel.

## Read the inbox with the CLI

```bash theme={null}
# Threads, most recently updated first
hookmyapp facebook threads --channel ch_xxxxxxxx

# The messages in one thread
hookmyapp facebook threads --channel ch_xxxxxxxx --thread <thread-id>
```

## Read the inbox with MCP

`list_facebook_conversations` lists the threads with the person's name, the last update, the unread count and a snippet. Read the thread before `send_message` so a reply is written with the history in view.

```text theme={null}
Use HookMyApp MCP to catch me up on the Messenger conversations on Facebook channel ch_xxxxxxxx and draft replies to the unread ones.
```

## Next steps

* [Send messages](/facebook/send-messages): Reply within the 24-hour window.
* [Receive webhooks](/facebook/receive-webhooks): Handle new messages as they arrive.