Open a WhatsApp dialog by phone number
dosai_open_conversationOpen (or find) the dialog for a phone number in WhatsApp, so send_operator_message can write to someone who has no dialog in the cabinet yet. Sends NOTHING by itself: it only creates the dialog row and returns its id. In a dialog opened this way the bot is OFF (reason: the chat was started by an operator), exactly as when the owner writes first from the phone; use toggle-ai in the cabinet to let the bot take over. If the dialog already exists it is returned untouched (created=false). The person's earlier WhatsApp history is pulled from the owner's phone on the first message in the chat, so a freshly opened dialog is empty until then. Requires editor role and the project's WhatsApp connected.
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": {
"project_id": "<project_id>",
"phone": "<phone>"
},
"name": "dosai_open_conversation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Name for the dialog card, if you know it. | |
| phone | Yes | Phone number in WhatsApp, 10-15 digits, any formatting (+7 705 ... is fine). | |
| project_id | Yes | From dosai_list_projects. |