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 n8n workflows. Specifically, for the Messages resource and Send Image Message operation, it allows users to send an image message to a specified phone number using a media ID previously uploaded or obtained from WhatsApp.

Common scenarios where this node is beneficial include:

  • Sending promotional images or product photos directly to customers.
  • Sharing event flyers or invitations as images.
  • Delivering visual content such as screenshots or diagrams in customer support workflows.

Example use case: A marketing automation workflow sends a personalized image flyer to a list of customers by specifying their phone numbers and the media ID of the flyer image stored on WhatsApp.

Properties

Name Meaning
Phone Number The recipient's phone number in international format (e.g., 5511999999999).
Media ID The unique identifier of the image media stored on WhatsApp to be sent.
Caption Optional text caption to accompany the image message.

Output

The node outputs JSON data representing the response from the WhatsApp API after attempting to send the image message. This typically includes message status details such as message ID, timestamps, and delivery information.

If multiple input items are processed, the output is an array of such JSON objects corresponding to each item.

No binary data output is produced by this operation.

Dependencies

  • Requires valid credentials for the N8N Tools API service, including an API URL and API key.
  • Requires OAuth2 or API authentication credentials for WhatsApp Business API access.
  • The media referenced by the Media ID must already exist on WhatsApp (uploaded beforehand).
  • Proper configuration of the n8n credentials for these services is necessary.

Troubleshooting

  • Invalid subscription or API key error: If the node throws an error about invalid subscription or API key, verify that the API key credential is correct and active.
  • Media ID not found or invalid: Ensure the Media ID corresponds to an existing media file on WhatsApp; otherwise, the message will fail.
  • Incorrect phone number format: Phone numbers must be in international format without symbols or spaces.
  • API rate limits or quota exceeded: Sending many messages rapidly may hit API limits; consider adding delays or batching.
  • Continue On Fail behavior: If enabled, errors for individual items will be returned in the second output, allowing partial success handling.

Links and References

Discussion