Overview
This node integrates with the WAMM PRO API to manage WhatsApp contacts and send messages. Specifically, the "Add to Contact List" operation allows users to add a phone number as a contact to a specified contact list within their WAMM instance. This is useful for organizing contacts into lists for targeted messaging campaigns or segmentation.
Practical examples include:
- Adding new customers to a marketing list after they sign up on a website.
- Segmenting contacts by interest or region by adding them to different lists.
- Preparing contact lists before sending broadcast WhatsApp messages.
Properties
| Name | Meaning |
|---|---|
| Instance ID | Your unique WAMM instance identifier used to target the correct account in the WAMM system. |
| Phone Number | The contact's phone number in international format without the "+" prefix (e.g., 40712345678). |
| List ID | Identifier of the contact list to which the contact will be added. |
| Contact Parameters | Optional JSON string containing additional parameters for the contact (e.g., {"param1":"value1"}). |
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 operation was successful.apiResponse: The raw response from the WAMM API.operation: The performed operation name ("addToList" in this case).phone: The phone number processed.instanceId: The WAMM instance ID used.timestamp: ISO timestamp when the operation was executed.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating with the WAMM PRO API.
- The node makes HTTP GET requests to the WAMM PRO API endpoint at
https://app.wamm.pro/api. - Proper configuration of the API key credential with token and email is necessary.
- The user must have a valid WAMM instance ID and contact list IDs configured in their WAMM account.
Troubleshooting
- Invalid JSON in Contact Parameters: If the
Contact Parametersfield contains malformed JSON, the node will throw an error indicating invalid JSON format. Ensure the JSON string is correctly formatted. - API Authentication Errors: If the API key credential is missing or invalid, requests will fail. Verify that the API token and associated email are correctly set in the credentials.
- Incorrect Instance ID or List ID: Using wrong or non-existent instance or list IDs will cause the API to return errors or fail silently. Double-check these IDs in your WAMM dashboard.
- Phone Number Format Issues: The phone number must be in international format without the "+" sign. Incorrect formatting may lead to failed additions.
- API Response Indicates Failure: The node logs warnings if the API response status is not
"success"or"ok". Review the API response message for details.
Links and References
- WAMM PRO API Documentation (official API docs)
- WhatsApp Business API Best Practices (for understanding WhatsApp messaging concepts)