OneSender icon

OneSender

Send WhatsApp messages via OneSender API

Actions7

Overview

This node allows sending WhatsApp media messages specifically documents via the OneSender API. It supports sending a document either to an individual recipient or to a WhatsApp group by specifying the appropriate recipient type and destination identifier.

Common scenarios include:

  • Sending invoices, contracts, or PDFs to customers individually.
  • Sharing important documents with a WhatsApp group for team collaboration or announcements.

Practical example:

  • A business wants to automatically send a PDF brochure to a customer after they fill out a form.
  • A manager sends a meeting agenda document to a project group on WhatsApp.

Properties

Name Meaning
Recipient Type Choose whether the document is sent to an "Individual" or a "Group".
Recipient Phone Number The phone number of the individual recipient including country code (e.g., 6281000001).
Group ID The WhatsApp group ID to which the document will be sent (e.g., 60123456789-1473638645@g.us).
Document URL The URL link of the document file to send.
Caption Optional text caption to accompany the document message.
Filename Optional filename to display for the document when received.

Output

The node outputs JSON data representing the response from the OneSender API after attempting to send the document message. This typically includes message status details such as message IDs, delivery status, timestamps, or error information if the request failed.

No binary data output is produced by this operation.

Dependencies

  • Requires an active OneSender API account with valid API credentials (API key and base URL).
  • The node must be configured with these credentials in n8n to authenticate requests.
  • Internet access is needed to reach the OneSender API endpoint and to fetch the document from the provided URL.

Troubleshooting

  • Invalid recipient format: Ensure phone numbers include the correct country code without extra characters or spaces.
  • Incorrect group ID: Verify the WhatsApp group ID is accurate and that the API user has permission to send messages to that group.
  • Document URL inaccessible: Confirm the document URL is publicly accessible and points directly to a downloadable file.
  • API authentication errors: Check that the API key credential is correctly set up and has not expired or been revoked.
  • Error responses from API: Review the returned error message in the node output for clues; common issues include rate limits, invalid parameters, or unsupported file types.

Links and References

Discussion