manage_whatsapp_contacts
Comprehensive WhatsApp contacts management with action-based operations. Supports listing, searching, creating, updating, deleting contacts, bulk operations, and metadata management. All contact operations including CRUD, filtering, pagination, and metadata handling in one unified tool.
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": {
"action": "<action>",
"device": "<device>"
},
"name": "manage_whatsapp_contacts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| crm | No | CRM system name (for create, update actions) | |
| wid | No | Filter contacts by WhatsApp IDs (for list action) | |
| city | No | Contact city (for create, update actions) | |
| kind | No | Contact category (for create, update actions) | |
| name | No | Contact first name (for create, update actions) | |
| page | No | Page number for pagination (0-based, for list action) | |
| sort | No | Sort field and order (e.g., "-createdAt", "name", for list action) | |
| type | No | Filter contacts by type (for list action) | |
| after | No | Filter contacts created after this date (for list action) | |
| No | Contact email address (for create, update actions) | ||
| limit | No | Number of contacts to retrieve (max 200, for list action) | |
| notes | No | Private notes about the contact (for create, update actions) | |
| owner | No | Filter contacts assigned to specific agents (for list action) | |
| phone | No | Phone number for create action, or array of phone numbers for list filtering | |
| title | No | Contact title (Mr., Mrs., Dr., etc., for create, update actions) | |
| action | Yes | Action to perform on WhatsApp contacts | |
| assign | No | Assign contact to specific agent (for create action) | |
| before | No | Filter contacts created before this date (for list action) | |
| crmRef | No | CRM reference ID or URL (for create, update actions) | |
| device | Yes | WhatsApp device ID connected to Wassenger (24 character hexadecimal string) | |
| fields | No | Explicit dot-path allowlist, e.g. ['wid','phone','info.email']. Overrides verbosity when set. | |
| gender | No | Contact gender (for create, update actions) | |
| search | No | Search contacts by name, surname, phone, email, company, address, or notes (for list action) | |
| status | No | Filter contacts by status (for list action) | |
| upsert | No | Update the contact if it already exists instead of failing with 409 (for create and bulk_create actions) | |
| address | No | Contact address (for create, update actions) | |
| country | No | Contact country 2-letter ISO code (for create, update actions) | |
| include | No | Include related entities in response | |
| surname | No | Contact surname/last name (for create, update actions) | |
| altPhone | No | Alternative phone number (for create, update actions) | |
| birthday | No | Contact birthday in YYYY-MM-DD format (for create, update actions) | |
| contacts | No | Array of contacts to create (max 1000, for bulk_create action) | |
| currency | No | Contact currency 3-letter ISO code (for create, update actions) | |
| metadata | No | Contact metadata key-value pairs (for create, update, update_metadata, upsert_metadata actions) | |
| timezone | No | Contact timezone (for create, update actions) | |
| verbosity | No | Response detail level for list/get: summary = curated high-signal fields (default, token-lean); standard = broader set; full = complete contact objects (escape hatch). | summary |
| contactWid | No | WhatsApp contact ID (required for get, update, delete, update_metadata, upsert_metadata actions) | |
| postalCode | No | Contact postal code (for create, update actions) | |
| companyCode | No | Company code (for create, update actions) | |
| companyName | No | Company name (for create, update actions) | |
| companyRole | No | Contact role in company (for create, update actions) | |
| description | No | Contact description (for create, update actions) | |
| metadataKey | No | Filter contacts with specific metadata keys (for list action) | |
| companyEmail | No | Company email (for create, update actions) | |
| companyPhone | No | Company phone number (for create, update actions) | |
| companyTaxId | No | Company tax ID (for create, update actions) | |
| removeFields | No | Fields to remove/clear from contact (for update action) | |
| updatedAfter | No | Filter contacts updated after this date (for list action) | |
| metadataValue | No | Filter contacts with specific metadata values (for list action) | |
| updatedBefore | No | Filter contacts updated before this date (for list action) | |
| companyCountry | No | Company country 2-letter ISO code (for create, update actions) | |
| companyWebsite | No | Company website (for create, update actions) |