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 to send various types of WhatsApp messages, including video messages. Specifically, the Send Video Message operation allows users to send a video file to a specified phone number on WhatsApp.

Common scenarios for this node include:

  • Sending promotional or informational videos directly to customers.
  • Sharing product demos or tutorials via WhatsApp.
  • Delivering personalized video messages in customer support workflows.

For example, a marketing team could automate sending a new product launch video to a list of customers by specifying their phone numbers and the media ID of the uploaded video.

Properties

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

Output

The node outputs JSON data representing the response from the WhatsApp API after attempting to send the video 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 where each element corresponds to the result of sending a video message for that item.

The node does not output binary data for this operation; it only returns JSON metadata about the sent message.

Dependencies

  • Requires an active subscription and valid API key for the N8N Tools API service.
  • Needs credentials configured in n8n for accessing the N8N Tools API and WhatsApp API.
  • The media (video) must already be uploaded to WhatsApp, and its Media ID must be known and provided.
  • The node internally uses the WhatsApp Business API through the N8N Tools service endpoints.

Troubleshooting

  • Invalid API Key or Subscription: If the node throws errors related to authentication (HTTP 401 or 403), verify that the API key credential is correct and the subscription is active.
  • Missing or Invalid Media ID: Ensure the Media ID corresponds to a valid uploaded video in WhatsApp. Using an incorrect or expired Media ID will cause the message sending to fail.
  • Incorrect Phone Number Format: Phone numbers must be in international format without symbols or spaces (e.g., 5511999999999). Invalid formats may lead to message delivery failure.
  • API Rate Limits or Quotas: Sending large volumes of messages might hit rate limits imposed by the WhatsApp Business API or N8N Tools service. Monitor usage and adjust accordingly.
  • Error Messages: The node surfaces error messages from the underlying API. Review these messages carefully to identify issues like invalid parameters or service outages.

Links and References

Discussion