Messaging: Start chat
messaging_start_chatStart a new personal WhatsApp, Instagram, Facebook or Telegram one-to-one/group chat (Facebook Pages cannot start chats) by sending its first message. Resolve users_ids first. A string starts 1-to-1; an array requests a group. LinkedIn requires the inbox-specific start tool.
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>",
"users_ids": "<users_ids>",
"text": "<text>"
},
"name": "messaging_start_chat"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| text | Yes | ||
| provider | Yes | ||
| specifics | No | ||
| users_ids | Yes | One exact provider user ID for a direct chat, or exact provider user IDs for a group; resolve every recipient first. | |
| 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. | |
| attachments | No |