Start a broadcast
dosai_start_broadcastSend one message to many clients of this project at once. REAL PEOPLE GET IT AND IT CANNOT BE UNSENT: show the owner the exact text and the audience numbers from preview_broadcast_audience, and start only after they say yes. Only people who have written to the project at least once are included; the platform paces the sending (about one message per 30-45 seconds per number), stops at the daily cap, respects working hours and skips anyone who unsubscribed. For WhatsApp the owner must confirm they have consent (consent_confirmed). Give 2-4 variants of the text, or turn on paraphrase, so the same wording does not go out in a fan: identical mass texts are what gets a number banned.
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>",
"body": "<body>"
},
"name": "dosai_start_broadcast"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | ||
| body | Yes | The message, exactly as people will see it. {{name}} is replaced with the client's name. | |
| title | No | Name of the broadcast, for the owner's report only. | |
| channel | No | Default: telegram. | |
| media_url | No | Picture to send with the text (a link from the project media library). | |
| paraphrase | No | Let the AI reword every message (costs tokens, about 11 cents per 220 messages). | |
| project_id | Yes | From dosai_list_projects. | |
| lead_status | No | ||
| window_days | No | ||
| scheduled_at | No | ISO time to start later. Omit to start now. | |
| body_variants | No | Up to 4 more wordings of the SAME message. They rotate between recipients. | |
| wa_template_id | No | Official WhatsApp: approved MARKETING template for people silent over 24 hours; Meta charges the owner for each. | |
| consent_confirmed | No | Required for WhatsApp: the owner confirms these people agreed to receive messages. |