Start a direct chat
start_chatOpen a direct chat by user ID, phone number, username, or email and return its chat ID for sending messages or files. Reuses an existing chat when available.
Instructions
Open a direct chat with someone, even if you have never messaged them on this account, and return its chatID so you can then send messages or files. Reuses the existing chat when there is one. Identify the person with userID (from search_contacts), phoneNumber, username or email. Some networks need a first message to create the chat: pass it in messageText (it is sent immediately; confirm with the user first).
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": {
"accountID": "<accountID>"
},
"name": "start_chat"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| No | Email address | ||
| userID | No | Contact ID from search_contacts | |
| fullName | No | Display name, only used to rank candidates | |
| username | No | Username / handle | |
| accountID | Yes | Account to start the chat on, e.g. whatsapp.33612345678 | |
| messageText | No | First message, only if the network requires one to create the chat | |
| phoneNumber | No | Phone number, E.164 preferred (+33612345678) |