WAHA API icon

WAHA API

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

Actions55

Overview

This node enables sending a link preview message via WhatsApp using the WAHA API. It is designed to send a URL along with an optional title and description that will be displayed as a rich preview in the recipient's chat. This functionality is useful for automating the sharing of web links in personal or group chats, such as sharing product pages, news articles, event invitations, or any relevant URLs with enhanced visual context.

Practical examples:

  • Automatically send a promotional link with a custom title and description to customers.
  • Share blog post URLs with previews in team group chats.
  • Distribute event registration links with descriptive previews to contacts.

Properties

Name Meaning
Session Name The name of the WhatsApp session to use for sending the message.
Chat ID The WhatsApp chat identifier where the link preview will be sent (phone number or group).
Additional Fields Collection of optional fields:
- Link Title: Title shown in the link preview.
- Link Description: Description shown in the link preview.
- Filename, Mimetype, Contact Name/Number, Reaction, Limit, Download Media (not used in this operation).

Output

The output JSON contains the response from the WAHA API after attempting to send the link preview message. It typically includes details about the message status, IDs, or error information if the request failed.

Example structure:

{
  "status": "success",
  "messageId": "some-message-id",
  "chatId": "5511999999999@c.us",
  "url": "https://example.com",
  "title": "Custom Link Title",
  "description": "Custom link description"
}

No binary data is output by this operation.

Dependencies

  • Requires a valid WAHA API credential with base URL and API key configured in n8n.
  • Optionally uses an additional API key credential for N8N Tools API validation.
  • The node sends HTTP requests to the WAHA API endpoints.
  • Requires a configured WhatsApp session name that corresponds to an active WhatsApp session managed by WAHA.

Troubleshooting

  • Invalid API Key or Subscription: If the N8N Tools API validation fails with 401 or 403 errors, verify that your API keys and subscription are valid and correctly set in credentials.
  • Unknown Operation or Resource Errors: Ensure the selected resource is "Message" and operation is "Send Link Preview".
  • Invalid Chat ID: The chat ID must be a valid WhatsApp phone number with @c.us suffix or a valid group ID with @g.us.
  • Missing Required Parameters: The URL to send must be provided in the "Text" property.
  • Session Issues: Make sure the specified WhatsApp session is active and connected.
  • API Request Failures: Network issues or incorrect API endpoint configuration can cause failures; check connectivity and API base URL.

Links and References

Discussion