Messaging: List recent messages
messaging_list_recent_messagesDigest of the messages RECEIVED across every WhatsApp/Instagram/Facebook/Telegram chat in a time window: 'what did I get on WhatsApp since yesterday noon?', 'summarize my Telegram messages of the last 2 hours', scheduled inbound digests. Enumerates chats without a creation-date filter, reads each one with message-level after/before and returns inbound messages grouped by chat, newest first. For Facebook, inbox_id selects one personal or Page inbox. When complete is false (enumeration or read limits, or unknown message direction), say so instead of presenting the digest as exhaustive. Returns chat_id + message id pairs usable with message_get / messaging_send_message.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"provider": "<provider>",
"after": "<after>",
"include_sent": "<include_sent>",
"chat_type": "<chat_type>",
"max_chats": "<max_chats>"
},
"name": "messaging_list_recent_messages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| after | Yes | Start of the window, ISO 8601 with Z or offset (exclusive). Convert 'since yesterday noon' with the user's timezone. | |
| before | No | End of the window (exclusive); omit for 'until now'. | |
| inbox_id | No | Required for Facebook: exact personal or PAGE_<id>_INBOX inbox.id from facebook_list_inboxes. Preserves the sending identity. Omit for other providers. | |
| provider | Yes | Messaging provider named by the user. LinkedIn recipients use linkedin_resolve_person + linkedin_start_conversation instead. | |
| chat_type | Yes | Restrict to direct chats or groups. | all |
| max_chats | Yes | Maximum number of chats read for messages (most recently active first). | |
| account_id | No | Optional Nilyo connection ID (unipile_account_id from list_connected_accounts). Required when the user has several accounts for the provider: pick the one the user named. | |
| include_sent | Yes | Also return messages sent by the user (default: inbound only). |