Evolution API icon

Evolution API

Complete WhatsApp automation with Evolution API
Join our community

Actions48

Overview

The "Send Audio" operation of the Media resource in this node enables sending audio files via WhatsApp using the Evolution API. This operation is useful for automating the delivery of voice notes, music clips, podcasts, or any audio content directly to a specified phone number on WhatsApp.

Practical examples include:

  • Sending automated voice reminders or alerts.
  • Distributing audio newsletters or updates.
  • Sharing recorded customer support responses.
  • Broadcasting audio advertisements or promotions.

This operation requires specifying the recipient's phone number and the audio media URL or base64 data.

Properties

Name Meaning
Phone Number The recipient's phone number including country code (without the "+" sign).
Media URL The URL or base64 encoded data of the audio file to be sent.
Additional Fields Optional extra settings:
- Delay: Time in milliseconds to wait before sending the audio.
- Link Preview: Enable or disable link preview in messages.
- Quoted Message ID: ID of a message to reply/quote.
- Mentions: Comma-separated list of phone numbers to mention in the message.

Output

The node outputs a JSON object containing the response from the Evolution API after attempting to send the audio message. This typically includes details about the message status, IDs, or error information if the request failed.

No binary data output is produced by this operation; it only handles sending media via URLs or base64 strings.

Dependencies

  • Requires an active Evolution API credential with valid API key, base URL, and instance name configured in n8n.
  • Optionally uses an additional API key credential for validation through the N8N Tools API.
  • The node makes HTTP POST requests to the Evolution API endpoints to perform the media sending operations.

Troubleshooting

  • Invalid Credentials: If the API key or subscription is invalid, the node will throw an error indicating invalid subscription or API key. Verify that the credentials are correct and active.
  • Incorrect Phone Number Format: Ensure the phone number includes the country code without the "+" sign and contains only digits.
  • Media URL Issues: The media URL must be accessible and point to a valid audio file. If using base64 data, ensure it is correctly formatted.
  • API Errors: Any errors returned by the Evolution API will be included in the output JSON. Check the error message for details.
  • Delay Misconfiguration: Setting a very high delay might cause unexpected waiting times before the message is sent.
  • Mention Formatting: Mentions should be provided as comma-separated phone numbers without special characters.

Links and References

Discussion