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.
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) |