OneSender icon

OneSender

Send WhatsApp messages via OneSender API

Actions7

Overview

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

Common scenarios include:

  • Sending promotional or informational images directly to customers' WhatsApp numbers.
  • Broadcasting images such as event flyers or announcements to WhatsApp groups.
  • Automating image delivery workflows in customer support or marketing automation.

For example, you can send a product photo with a caption to a single customer or share an event poster image with a caption to a group chat.

Properties

Name Meaning
Recipient Type Choose whether the recipient is an "Individual" (single phone number) or a "Group".
Recipient Phone Number The phone number of the individual recipient including country code (e.g., 6281000001). Required if Recipient Type is Individual.
Group ID The WhatsApp group ID (e.g., [email protected]). Required if Recipient Type is Group.
Image URL The URL of the image to be sent.
Caption Optional text caption to accompany the image.

Output

The node outputs JSON data representing the response from the OneSender API after attempting to send the image message. This typically includes details about the message status, IDs, or any errors returned by the API.

No binary data output is produced by this operation.

Dependencies

  • Requires an active OneSender API account with a valid API key credential.
  • The node uses the OneSender API base URL and API key for authentication.
  • Proper network access to the OneSender API endpoint and the image URL must be ensured.

Troubleshooting

  • Invalid recipient format: Ensure phone numbers include the correct country code without extra characters or spaces. For groups, verify the group ID format matches WhatsApp's expected pattern.
  • Image URL issues: The image URL must be publicly accessible and direct to an image file. Private URLs or unsupported formats may cause failures.
  • API authentication errors: Verify that the API key credential is correctly configured and has not expired.
  • Caption length limits: Some platforms may limit caption length; keep captions concise.
  • Network errors: Check connectivity to both the OneSender API and the image hosting server.

If the node throws errors related to HTTP requests, inspect the error message for clues such as unauthorized access, invalid parameters, or rate limiting.

Links and References

Discussion