Zender icon

Zender

Interact with Zender WhatsApp API

Overview

The node integrates with the Zender WhatsApp API to send bulk WhatsApp messages as part of a campaign. It allows users to specify a campaign name, message content, and recipients either by direct phone numbers or contact groups. This operation is useful for marketing campaigns, notifications, or any scenario where the same message needs to be sent to multiple recipients efficiently.

For example, a business can use this node to send promotional messages to a list of customers or to specific customer groups in one go, saving time compared to sending individual messages.

Properties

Name Meaning
Campaign Name The name identifier for the bulk messaging campaign.
Recipients Comma-separated list of phone numbers to receive the message (optional if groups specified).
Message The text content of the message to send to all recipients.
Additional Fields Optional extra parameters:
- Groups Comma-separated list of contact group IDs to target (optional if recipients specified).
- Shortener ID Numeric ID for link shortening service to shorten URLs in the message (optional).
Account ID Unique identifier of the WhatsApp account used to send the messages.

Output

The output is an array of JSON objects representing the response from the Zender API after attempting to send the bulk message. Each item corresponds to an input item processed and contains the API's response data, which typically includes status information about the bulk send request.

Example structure of output JSON:

{
  "status": "success",
  "campaign": "CampaignName",
  "message": "Bulk message queued for sending",
  "details": {
    // Additional details returned by the API
  }
}

No binary data output is produced by this operation.

Dependencies

  • Requires an active Zender WhatsApp API account.
  • Needs an API key credential (referred generically) with apiSecret and baseUrl configured in n8n credentials.
  • The node uses HTTP POST requests with URL-encoded form data to communicate with the Zender API endpoints.

Troubleshooting

  • Missing or invalid Account ID: Ensure the correct WhatsApp Account ID is provided; otherwise, the API will reject the request.
  • Empty recipients and groups: At least one of recipients or groups must be specified; otherwise, no targets exist for the bulk message.
  • API authentication errors: Verify that the API key credential is valid and has not expired.
  • Message length or content issues: Some APIs may limit message size or disallow certain characters; check API documentation for restrictions.
  • Network or connectivity problems: Ensure the n8n instance can reach the Zender API base URL.

If the node throws errors, enabling "Continue On Fail" can help process other items while logging errors per item.

Links and References

Discussion