Create campaign
create_campaignCreate a campaign. The kind follows the inbox: a website inbox gets an ongoing campaign (the message is offered in the widget), an SMS inbox gets a one-off campaign sent at scheduled_at to the contacts of the labels in audience. No other inbox type is accepted: a WhatsApp campaign is composed by the administrator at Campaigns -> WhatsApp, because WhatsApp only allows approved templates. Call list_inboxes and list_labels first. This sends messages to real customers.
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": {
"title": "<title>",
"message": "<message>",
"inbox_id": "<inbox_id>"
},
"name": "create_campaign"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | ||
| enabled | No | ||
| message | Yes | ||
| audience | No | One-off campaigns only: the labels whose contacts receive the message. | |
| inbox_id | Yes | ||
| sender_name | No | Website campaigns only: the name the widget card shows as the speaker (for example "Ana"). Null clears it. | |
| scheduled_at | No | ISO8601 time for a one-off campaign. | |
| use_bot_identity | No | Website campaigns only: speak as the inbox's AI agent, with its name and picture. Falls back to sender_name when the inbox has no AI agent. | |
| trigger_only_during_business_hours | No |