N8N Tools - WhatsApp Enhanced icon

N8N Tools - WhatsApp Enhanced

Comprehensive WhatsApp Business API integration for N8N workflows
Join our community

Actions28

Overview

This node integrates with the WhatsApp Business API via the N8N Tools service, enabling sending various types of WhatsApp messages within an n8n workflow. Specifically, for the Messages resource and the Send List Message operation, it allows sending interactive list messages to a specified phone number. These list messages contain sections with multiple selectable options, providing a rich user interaction experience.

Common scenarios where this node is beneficial include:

  • Customer support bots that offer users a menu of options to choose from.
  • Marketing campaigns where users can select from product categories or services.
  • Interactive surveys or feedback forms delivered through WhatsApp.

Example use case: A business sends a list message to a customer with sections like "Product Categories" containing items such as "Electronics", "Clothing", and "Home Appliances". The customer can then select an option directly from the WhatsApp interface.

Properties

Name Meaning
Phone Number The recipient's phone number in international format (e.g., 5511999999999).
Button Text The text displayed on the button that triggers the list message.
List Sections JSON-formatted array defining the sections and items of the list message.

The List Sections property expects a JSON structure representing the sections of the list message. Each section typically contains a title and an array of rows/items that the user can select.

Output

The node outputs an array of JSON objects corresponding to each input item processed. For the Send List Message operation, the json output field contains the response from the WhatsApp API after sending the list message. This usually includes message metadata such as message ID, status, timestamps, or any error information if the send failed.

No binary data output is produced by this operation.

Dependencies

  • Requires valid credentials for the N8N Tools API, including an API URL and an API key credential.
  • The node internally uses a helper class to interact with the WhatsApp Business API through the N8N Tools service.
  • Proper configuration of these credentials in n8n is necessary for successful execution.

Troubleshooting

  • Invalid subscription or API key: If the node throws an error indicating invalid subscription or API key, verify that the API key credential is correctly configured and active.
  • Malformed JSON in List Sections: Since the list sections are provided as JSON, ensure the JSON syntax is correct. Invalid JSON will cause parsing errors.
  • Phone number format issues: The phone number must be in international format without symbols or spaces. Incorrect formatting may lead to message delivery failure.
  • API rate limits or service downtime: Temporary failures might occur due to API rate limits or service unavailability. Retrying after some time or checking service status is recommended.

Links and References

Discussion