WhatsApp Sender

Send WhatsApp messages using the WhatsApp API

Actions3

Overview

This node, named "WhatsApp Sender," enables sending WhatsApp messages through a third-party WhatsApp API service. It supports sending plain text messages, files with optional messages, and pre-approved message templates with variable substitution. This node is useful for automating communication workflows such as customer notifications, alerts, or marketing messages via WhatsApp.

Practical examples include:

  • Sending order confirmation messages to customers.
  • Delivering invoices or documents as file attachments.
  • Using approved message templates for consistent customer engagement.

Properties

Name Meaning
WhatsApp Number Recipient's WhatsApp number including country code (e.g., +1234567890).
Message The text content of the message to send (up to 1000 words). Used in "Send Text Message" and "Send File with Message" operations.

Output

The node outputs an array with one object per input item. Each output object contains a json field with the following structure:

  • success: Boolean indicating if the message was sent successfully.
  • operation: The operation performed (e.g., "sendText").
  • to: The recipient's WhatsApp number.
  • Additional fields from the API response under data, which may include message IDs or status details.

If the message fails to send, the output includes:

  • success: false
  • error: Error message describing the failure.
  • operation and to for context.

The node does not output binary data.

Dependencies

  • Requires an API key credential for authenticating with the WhatsApp API service.
  • Makes HTTP POST requests to https://wsp.multist.net/api/create-message.
  • The user must configure the node with valid credentials containing necessary keys (appkey and authkey).

Troubleshooting

  • Invalid phone number format: The node validates that the WhatsApp number matches the E.164 format (e.g., +1234567890). Ensure the number includes the country code and no invalid characters.
  • Message length exceeded: Messages longer than 1000 words will cause an error. Shorten the message accordingly.
  • Unsupported file type: When sending files, only these formats are supported: jpg, jpeg, png, webp, pdf, docx, xlsx, csv, txt. Use a supported file URL.
  • API errors: If the API returns a failure message, it will be included in the error output. Check API credentials and network connectivity.
  • Continue on Fail: If enabled, the node will continue processing subsequent items even if some fail, reporting errors in the output JSON.

Links and References

Discussion