Wasenderapi icon

Wasenderapi

Custom operations
Join our community

Actions2

Overview

This node enables sending WhatsApp messages via a custom API service. Specifically, it supports sending text messages and images with optional accompanying text to specified WhatsApp numbers. It is useful for automating WhatsApp communications such as notifications, alerts, marketing messages, or customer support interactions.

For the Send Image operation, the node sends an image located at a given URL to a WhatsApp recipient, optionally including a text message alongside the image.

Practical Example

  • Sending a promotional image with a caption to a customer list.
  • Delivering an image-based alert (e.g., a screenshot or photo) to a support team member.
  • Sharing product images automatically in response to user requests.

Properties

Name Meaning
API Key API key for authenticating requests to the external WhatsApp messaging service.
Wasender API Key Secondary API key required by the Wasender service for authentication.
To The recipient's WhatsApp number, including country code and prefixed with "+".
Image URL The URL of the image to be sent via WhatsApp (required for Send Image operation).
Text Optional text message content to send along with the image or as a standalone text message.

Output

The node outputs a JSON array where each element corresponds to the response from the external API for each input item processed. The structure of each response depends on the external API but generally includes confirmation or status details about the message sent.

No binary data output is produced by this node.

Dependencies

  • Requires access to the external API endpoints:
    • https://api.customje.com/wsa-send-text.php for sending text messages.
    • https://api.customje.com/wsa-send-image.php for sending images.
  • Requires two API keys for authentication: a general API key and a Wasender-specific API key.
  • Network connectivity to the external API service.
  • Proper configuration of these API keys within the node parameters.

Troubleshooting

  • Common Issues:

    • Invalid or missing API keys will cause authentication failures.
    • Incorrectly formatted WhatsApp numbers (missing "+" or country code) may result in delivery errors.
    • Invalid or inaccessible image URLs will prevent image sending.
    • Network issues or downtime of the external API will cause request failures.

  • Error Messages:

    • "The operation \"send-image\" is not implemented yet!" — indicates an unsupported operation was requested; ensure the operation name matches exactly.
    • "The resource \"actions\" is not known!" — indicates an invalid resource parameter; only "actions" is supported.
    • Errors returned from the external API are passed through; check the API documentation for specific error codes and messages.

  • Resolution Tips:

    • Verify API keys are correct and active.
    • Ensure phone numbers include the "+" and country code.
    • Confirm image URLs are publicly accessible and valid.
    • Use the node’s "Continue On Fail" option to handle individual item errors gracefully.

Links and References

Discussion