manage_whatsapp_campaign_contacts
Universal WhatsApp campaign contacts management tool that handles all campaign recipient operations through action-based parameters. Supports add, remove, and search operations for campaign recipients: phone numbers and groups. Essential for WhatsApp campaign recipient management.
add keeps the recipients already on the campaign. On a campaign that sends a template (WhatsApp Cloud API numbers), give every variable its component exactly as on manage_whatsapp_campaigns create: body, header, header_location, button_url_N or button_copy_code_N, with N the buttonIndex that list_whatsapp_templates reports. Such a campaign only reaches phone numbers, not groups. On a campaign from a number linked by QR, each variable key fills the {{ key }} placeholder of the campaign message.
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": {
"campaignId": "<campaignId>",
"action": "<action>"
},
"name": "manage_whatsapp_campaign_contacts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Filter by contact type (for search action) | |
| page | No | Results page number (for search action) | |
| size | No | Results page size (for search action) | |
| wids | No | WhatsApp message IDs to remove (for remove action) | |
| action | Yes | Action to perform on campaign contacts | |
| groups | No | Group IDs to remove (for remove action) | |
| phones | No | Phone numbers to remove (for remove action) | |
| search | No | Search contacts by phone number, name, or group ID (for search action) | |
| status | No | Filter by delivery status (for search action) | |
| target | No | Filter by contact target: phone number or group WhatsApp ID (for search action) | |
| channels | No | Channel IDs to remove (for remove action) | |
| contacts | No | Contacts to add to campaign (for add action) | |
| campaignId | Yes | WhatsApp campaign ID |