ZuckZapGo Newsletter icon

ZuckZapGo Newsletter

Manage WhatsApp newsletters/channels using ZuckZapGo API

Overview

The "ZuckZapGo Newsletter" node enables managing WhatsApp newsletters or channels through the ZuckZapGo API. It supports a variety of operations such as listing newsletters, creating new ones, sending messages to newsletters, subscribing/unsubscribing, muting notifications, retrieving messages, reacting to messages, and more.

This node is beneficial for automating communication with WhatsApp newsletter subscribers, managing newsletter content, and handling subscriber interactions programmatically. For example, a marketing team can use it to send scheduled promotional messages or updates to their WhatsApp newsletter audience without manual intervention.

Specifically, the Send Newsletter Message operation allows sending different types of messages (text, image, video, document, audio) to a specified newsletter.

Properties

Name Meaning
Newsletter JID The unique identifier (JID) of the newsletter to which actions apply.
Message Type Type of message to send. Options: Text, Image, Video, Document, Audio.
Message Text content of the message (required if Message Type is Text).
Media Base64 encoded media data or URL for media messages (required if Message Type is not Text).
Caption Optional caption text for media messages (Image, Video, Document, Audio).
File Name File name for document messages (only applicable if Message Type is Document).

Output

The node outputs JSON data representing the response from the ZuckZapGo API for the selected operation. For the Send Newsletter Message operation, the output typically includes confirmation details about the sent message, such as message IDs or status.

If the message includes media, the node handles sending the media content but does not output binary data itself; instead, it returns metadata about the sent message.

Dependencies

  • Requires an API key credential for authenticating with the ZuckZapGo API.
  • The node makes HTTP requests to the ZuckZapGo API endpoints.
  • Proper configuration of the API credential in n8n is necessary for successful operation.

Troubleshooting

  • Common issues:

    • Invalid or missing Newsletter JID will cause errors when targeting newsletters.
    • Incorrect media encoding or invalid URLs for media fields may result in failed message sending.
    • Missing required parameters depending on message type (e.g., no message text for text messages).
    • API authentication failures due to incorrect or expired API keys.
  • Error messages:

    • Errors returned by the API are passed through; typical messages include authorization errors, validation errors for missing or malformed parameters, or rate limiting notices.
    • To resolve, verify all required inputs, ensure valid API credentials, and confirm media data format.

Links and References

  • ZuckZapGo API Documentation (hypothetical link, replace with actual if available)
  • WhatsApp Newsletter concepts and best practices (external resources)
  • n8n documentation on creating and using custom nodes and credentials

Discussion