N8N Tools - WhatsApp Enhanced icon

N8N Tools - WhatsApp Enhanced

Comprehensive WhatsApp Business API integration for N8N workflows
Join our community

Actions28

Overview

This node operation sends a WhatsApp template message to a specified phone number using the WhatsApp Business API. Template messages are pre-approved message formats that businesses use to communicate with customers, often for notifications, alerts, or customer service interactions.

Common scenarios where this node is beneficial include:

  • Sending appointment reminders or confirmations.
  • Delivering shipping or order status updates.
  • Providing customer support responses using standardized templates.
  • Broadcasting promotional or marketing messages with approved templates.

For example, a business can send a "Your order has shipped" template message in the customer's preferred language, including dynamic components like order details.

Properties

Name Meaning
Phone Number The recipient's phone number in international format (e.g., 5511999999999).
Template Name The name of the WhatsApp message template to send.
Language Code The language code for the template message (default is "en_US").
Template Components JSON-formatted array defining dynamic parts of the template such as text variables, buttons, etc.

Output

The node outputs an array of JSON objects, each representing the response from sending a template message. Each output item corresponds to one input item processed.

The json field contains the API response data related to the sent template message, which typically includes message IDs, status, and any metadata returned by the WhatsApp Business API.

No binary data output is produced by this operation.

Dependencies

  • Requires an active subscription and valid API key credential for the external N8N Tools API service.
  • Uses the WhatsApp Business API via the N8N Tools API wrapper.
  • Properly configured credentials must be set up in n8n for authentication.
  • The template used must be pre-approved and available in the WhatsApp Business account associated with the API credentials.

Troubleshooting

  • Invalid Subscription or API Key: If the node throws an error about invalid subscription or API key, verify that the API key credential is correct and active.
  • Template Not Found or Not Approved: Errors may occur if the specified template name does not exist or is not approved in the WhatsApp Business account.
  • Malformed Template Components: Ensure the Template Components JSON is correctly formatted and matches the expected structure for the template placeholders.
  • Phone Number Format Issues: The phone number must be in international format without spaces or special characters; otherwise, the API may reject the request.
  • API Rate Limits or Quotas: Sending too many messages in a short time may cause rate limiting errors; check your subscription limits.

Links and References

Discussion