Overview
This node integrates with the WAMM PRO API to manage WhatsApp contacts and messaging. Specifically, the "Remove from Contact List" operation allows users to remove a phone number from a specified contact list or from all contact lists in their WAMM instance.
Common scenarios for this operation include:
- Cleaning up contact lists by removing unsubscribed or inactive contacts.
- Managing segmentation of contacts dynamically based on user actions or campaign results.
- Automating contact list maintenance as part of larger WhatsApp marketing workflows.
For example, after a customer opts out of receiving messages, this node can be used to remove their phone number from all contact lists automatically.
Properties
| Name | Meaning |
|---|---|
| Instance ID | Your WAMM instance identifier, required to specify which WAMM account to operate on. |
| Phone Number | The target phone number in international format (without the leading '+'). |
| List ID | The identifier of the contact list from which to remove the contact. |
| Remove from All Lists | Boolean flag; if true, removes the contact from all contact lists instead of one list. |
Output
The node outputs an array of JSON objects, each representing the result of processing an input item. Each object contains:
success: Boolean indicating if the API call was successful.apiResponse: The full response returned by the WAMM API.operation: The operation performed ("removeFromList").phone: The phone number processed.instanceId: The WAMM instance ID used.timestamp: ISO string timestamp of when the operation was executed.
No binary data is output by this node.
Dependencies
- Requires an API key credential for authenticating with the WAMM PRO API.
- Needs network access to
https://app.wamm.pro/api. - The node uses HTTP GET requests with query parameters to interact with the API.
- Proper configuration of the WAMM instance ID and valid phone numbers is necessary.
Troubleshooting
- Invalid JSON errors: Not applicable for this operation since no JSON parsing is done here.
- API failures: If the API returns a status other than "success" or "ok", the node logs a warning but still marks the execution as successful unless an error is thrown.
- Incorrect phone number format: Ensure the phone number is in international format without the '+' sign; otherwise, the API may reject the request.
- Missing or incorrect instance ID: The operation will fail if the instance ID is invalid or missing.
- Network issues: Connectivity problems to the WAMM API endpoint will cause errors.
- Permission issues: The API token must have rights to modify contact lists.
If the node is set to continue on failure, it will return error details per item instead of stopping execution.
Links and References
- WAMM PRO API Documentation (general reference URL)
- WhatsApp Business API best practices for contact list management (external resource)