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, providing enhanced capabilities to interact with WhatsApp messaging and media features. Specifically, the Media - Get Media URL operation retrieves a direct URL for a given media item stored in WhatsApp, identified by its Media ID.

This operation is useful when you need to access or share the actual media file (image, video, audio, document) outside of WhatsApp, such as embedding it in other applications, downloading it, or processing it further in your workflow.

Practical example:
You have received a media message in WhatsApp and want to download or display the media content in a web app. Using this node operation, you provide the Media ID, and it returns a URL that can be used to access the media directly.

Properties

Name Meaning
Media ID The unique identifier of the media item in WhatsApp. This ID is required to fetch the media URL.

Output

The output JSON contains the response from the WhatsApp API via the N8N Tools service for the requested media URL. Typically, it includes a field with the direct URL to access the media file.

Example output structure (simplified):

{
  "url": "https://media.whatsapp.com/your-media-file-url"
}

If the media is accessible, the url field provides a direct link to the media content.

No binary data is output by this operation; it only returns metadata including the media URL.

Dependencies

  • Requires an active subscription and valid API key credential for the N8N Tools API service.
  • Requires WhatsApp Business API credentials configured in n8n.
  • The node uses HTTP requests to communicate with the N8N Tools API endpoint.
  • Proper configuration of credentials in n8n is necessary for authentication and authorization.

Troubleshooting

  • Invalid subscription or API key error:
    If you receive errors indicating invalid subscription or API key, verify that your API key credential is correct and active.

  • Media ID not found or invalid:
    Ensure the Media ID provided exists and is correctly copied from WhatsApp. An incorrect or expired Media ID will cause the request to fail.

  • Network or connectivity issues:
    The node depends on external API calls; network problems may cause timeouts or failures.

  • Permission errors:
    Make sure the WhatsApp Business API account has permissions to access media content.

Links and References

Discussion