WhatsApp: Start conversation
whatsapp_start_conversationStart a new 1-to-1 WhatsApp chat and send the first message. Resolve/verify recipient first with whatsapp_list_contacts or WhatsApp profile/number lookup. whatsapp_user_id must be provider identity, never a contact display name.
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": {
"whatsapp_user_id": "<whatsapp_user_id>",
"text": "<text>"
},
"name": "whatsapp_start_conversation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | First message text explicitly requested/approved by user. | |
| 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. | |
| whatsapp_user_id | Yes | Exact WhatsApp provider user ID returned by contact/profile/number resolution; not a human name. |