Overview
This node integrates with the WAMM PRO API to send WhatsApp messages and manage contacts via WhatsApp. It supports sending text messages, media files, and template messages, as well as adding or removing contacts from contact lists.
Common scenarios where this node is beneficial include:
- Automating customer notifications or alerts via WhatsApp.
- Sending promotional media content or documents directly to customers.
- Using predefined message templates for consistent communication.
- Managing contact lists dynamically based on user interactions or CRM data.
For example, a business can use this node to schedule a WhatsApp message to remind customers of an appointment, send a product brochure as media, or add new leads to a marketing list.
Properties
| Name | Meaning |
|---|---|
| Instance ID | Your WAMM instance identifier used to target your specific WhatsApp account setup. |
| Phone Number | Recipient's phone number in international format without the "+" sign (e.g., 40712345678). |
| Message | The text message content to send. Used in "Send Message" and "Send Media" operations. |
| Schedule Time | Optional scheduling time for sending the message. Format: "YYYY-MM-DD HH:mm" or "now+HH:mm". |
Note: The above properties are relevant for the Send Message operation.
Output
The node outputs an array of JSON objects, each representing the result of processing an input item. Each output object contains:
success: Boolean indicating if the API call was successful.apiResponse: The full response object returned by the WAMM API.operation: The operation performed (e.g., "sendMessage").phone: The phone number the message was sent to.instanceId: The WAMM instance ID used.timestamp: ISO string timestamp when the request was made.
No binary data is output by this node.
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 within n8n is necessary.
- The node expects valid JSON strings for some parameters (e.g., template parameters), which must be correctly formatted.
Troubleshooting
- Invalid JSON format errors: When using template parameters or contact parameters, ensure the JSON string is valid. Malformed JSON will cause the node to throw an error specifying the issue.
- API failures: If the API response status is not "success" or the response indicates failure, the node logs a warning but still returns the response. Check the
apiResponsefield for details. - Authentication issues: Ensure the API key credential is correctly set up and has the required permissions.
- Phone number formatting: The phone number must be in international format without the "+" prefix; otherwise, the API may reject the request.
- Scheduling format: The schedule time must follow the specified formats ("YYYY-MM-DD HH:mm" or "now+HH:mm"). Invalid formats may cause the API to ignore the scheduling or return an error.
Links and References
- WAMM PRO API Documentation (official API endpoint)
- WhatsApp Business API concepts for messaging and templates (general reference)