WAHA API icon

WAHA API

Complete WhatsApp automation with WAHA API - Multi-engine support
Join our community

Actions55

Overview

This node integrates with the WAHA API to send WhatsApp voice messages as part of a broader WhatsApp automation suite. Specifically, the "Send Voice" operation under the "Message" resource allows users to send voice note files to individual or group chats on WhatsApp.

Common scenarios where this node is beneficial include:

  • Automating customer support by sending pre-recorded voice responses.
  • Broadcasting voice announcements or alerts to groups or contacts.
  • Enhancing engagement in marketing campaigns with personalized voice messages.

For example, a user can configure the node to send a voice message file (via URL or base64 data) to a specific chat ID representing a customer or group.

Properties

Name Meaning
Session Name The name of the WhatsApp session to use for sending the message. Defaults to a configured default session.
Chat ID The WhatsApp chat identifier to send the voice message to. This can be a phone number with @c.us suffix or a group ID with @g.us.
File URL/Path The URL or base64 encoded data of the voice file to send.
Additional Fields Optional extra parameters:
- Filename: Custom filename for the voice file.
- Mimetype: MIME type of the voice file.

Output

The node outputs a JSON object containing the response from the WAHA API after attempting to send the voice message. This typically includes details about the sent message such as message ID, status, and any metadata returned by the API.

If an error occurs, the output JSON will contain an error field describing the issue.

The node does not output binary data directly; it only sends voice media via the API using provided URLs or base64 data.

Dependencies

  • Requires a valid WAHA API credential with an API key and base URL configured in n8n.
  • Optionally uses another API credential ("N8N Tools API") for subscription validation before making requests.
  • The node makes HTTP POST requests to the WAHA API endpoints to perform actions.
  • Requires proper WhatsApp session management (session must be active and connected).

Troubleshooting

  • Invalid Subscription or API Key: If the N8N Tools API validation fails with 401 or 403 errors, check that your API keys and subscription status are correct.
  • Unknown Operation or Resource Errors: Ensure the selected operation and resource match supported values; otherwise, the node throws descriptive errors.
  • Session Issues: If the WhatsApp session is not started or disconnected, sending messages will fail. Verify the session is active.
  • File URL/Data Problems: The voice file URL or base64 data must be accessible and correctly formatted. Invalid or inaccessible files will cause errors.
  • Chat ID Format: The chat ID must be correctly formatted with the appropriate suffix (@c.us for contacts, @g.us for groups).

Links and References

Discussion