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 platform, enabling users to send various types of WhatsApp messages programmatically within n8n workflows. Specifically, the "Send Audio Message" operation under the "Messages" resource allows sending audio files to a specified phone number using a media ID previously uploaded or obtained from WhatsApp.

Common scenarios for this node include:

  • Sending voice notes or audio announcements to customers.
  • Automating delivery of audio content such as podcasts, alerts, or instructions.
  • Enhancing customer engagement by providing multimedia messages in automated workflows.

Example use case: A business wants to automatically send an audio greeting or promotional message to new subscribers on WhatsApp. Using this node, it can send the audio file by referencing its media ID and the recipient's phone number.

Properties

Name Meaning
Phone Number The recipient's phone number in international format (e.g., 5511999999999).
Media ID The WhatsApp media ID representing the audio file to be sent. This ID must be valid and previously uploaded or available in WhatsApp.

Output

The node outputs JSON data containing the response from the WhatsApp API after attempting to send the audio message. This typically includes message status, IDs, timestamps, or error information if the request failed.

No binary data output is produced by this operation; the output strictly contains JSON metadata about the sent message.

Dependencies

  • Requires an active subscription and valid API key credential for the N8N Tools API service.
  • Requires OAuth2 or API credentials configured for WhatsApp Business API access through the N8N Tools platform.
  • The media file must already exist in WhatsApp's system, referenced by a valid media ID.
  • Network connectivity to the N8N Tools API endpoint.

Troubleshooting

  • Invalid API Key or Subscription: If the node throws errors related to authentication (HTTP 401 or 403), verify that the API key and subscription are valid and correctly configured in n8n credentials.
  • Invalid Media ID: Errors may occur if the provided media ID does not exist or has expired. Ensure the media ID is correct and corresponds to an uploaded audio file.
  • Incorrect Phone Number Format: The phone number must be in international format without spaces or special characters. Invalid formats will cause message sending failures.
  • API Rate Limits or Quotas: Exceeding usage limits on the N8N Tools API or WhatsApp Business API may result in errors. Monitor usage and adjust accordingly.
  • Network Issues: Connectivity problems between n8n and the API endpoints can cause timeouts or failures.

Links and References

Discussion