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 messages, specifically supporting sending video messages in this context. It allows users to send videos to individual chats or groups on WhatsApp by providing the chat ID and the video file URL or base64 data. This is useful for automating multimedia communication workflows such as marketing campaigns, customer support with rich media, or broadcasting video updates.

For the "Send Video" operation under the "Message" resource, the node sends a video file along with an optional caption to a specified WhatsApp chat.

Practical Examples:

  • Sending product demo videos to customers automatically after a purchase.
  • Broadcasting event highlight videos to a group of participants.
  • Sharing tutorial videos in customer support conversations.

Properties

Name Meaning
Session Name The name of the WhatsApp session to use for sending the message. Defaults to a stored session.
Chat ID The WhatsApp chat identifier (phone number with @c.us or group ID with @g.us) where the video will be sent.
File URL/Path URL or base64 encoded data of the video file to send.
Caption Optional text caption to accompany the video message.
Additional Fields Collection of optional fields:
- Filename: Custom filename for the video file.
- Mimetype: MIME type of the video file.
- Link Description, Link Title: For link previews (not used in video).
- Contact Name, Contact Number: For contact vCards (not used here).
- Reaction: Emoji reaction (not used here).
- Limit: Limits number of results (not used here).
- Download Media: Whether to download media files in messages (not used here).

Output

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

If the operation fails and "Continue On Fail" is enabled, the output JSON will contain an error field describing the failure reason.

No binary data output is produced by this node for the "Send Video" operation.

Dependencies

  • Requires a valid WAHA API credential with an API key and base URL configured in n8n.
  • Optionally uses another API credential for subscription validation via the "N8N Tools API".
  • The node requires internet access to reach the WAHA API endpoints.
  • The user must provide a valid WhatsApp session name that corresponds to an active WhatsApp session managed by WAHA.
  • The video file must be accessible via the provided URL or be supplied as base64 data.

Troubleshooting

  • Invalid Subscription or API Key: If the N8N Tools API validation fails with 401 or 403 errors, check that the API keys and subscriptions are correctly set up and active.
  • Unknown Operation or Resource Errors: These occur if unsupported operations or resources are selected; ensure the correct operation "sendVideo" under resource "message" is chosen.
  • File Access Issues: If the video URL is invalid or inaccessible, the API call will fail. Verify the URL or base64 data correctness.
  • Session Not Found or Inactive: Ensure the session name corresponds to an active WhatsApp session.
  • API Request Failures: Network issues or incorrect API keys can cause failures; verify connectivity and credentials.
  • Enable "Continue On Fail" to handle errors gracefully within workflows.

Links and References

Discussion