Messaging: List chats
messaging_list_chatsList personal chats for WhatsApp, Instagram, Facebook or Telegram. For Facebook Pages use facebook_list_inboxes and facebook_list_inbox_chats; never fall back to the personal inbox. Chats are most recently active first; use it to find a chat_id. LinkedIn requires inbox-specific listing. V2 filters: type, before/after (on the chat's last activity), archived and unread; WhatsApp pages by offset, other providers by cursor. For 'messages received between X and Y' call messaging_list_recent_messages, which also reads the messages.
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>"
},
"name": "messaging_list_chats"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | ||
| after | No | ||
| limit | No | ||
| before | No | ||
| cursor | No | ||
| offset | No | ||
| provider | Yes | ||
| is_unread | No | ||
| account_id | No | Optional Nilyo connection ID (unipile_account_id from list_connected_accounts). Omit when the user has one account for this provider. When several exist, Nilyo never guesses: list them (display name, identifier, provider user ID), choose the one the user named or ask, and pass its ID here. | |
| is_archived | No |