ZuckZapGo Newsletter icon

ZuckZapGo Newsletter

Manage WhatsApp newsletters/channels using ZuckZapGo API

Overview

This node integrates with the ZuckZapGo API to manage WhatsApp newsletters (channels). It allows users to perform various newsletter-related operations such as creating newsletters, listing them, subscribing/unsubscribing, sending messages, reacting to messages, and managing notifications.

The Create Newsletter operation specifically enables users to create a new WhatsApp newsletter by providing its name, an optional description, and an optional picture. This is useful for businesses or communities that want to broadcast updates, news, or promotional content to subscribers via WhatsApp channels.

Practical examples:

  • A company creates a newsletter to send product updates and promotions.
  • An event organizer creates a channel to share live event announcements.
  • A community group sets up a newsletter to distribute weekly news summaries.

Properties

Name Meaning
Newsletter Name The name of the newsletter to create. Must be a string with a maximum of 25 characters.
Description Optional text describing the newsletter.
Picture Optional image for the newsletter. Can be a base64 encoded image string or a URL.

Output

The node outputs JSON data representing the response from the ZuckZapGo API after attempting to create the newsletter. This typically includes details about the newly created newsletter such as its ID, status, or any error messages if creation failed.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the ZuckZapGo API using an API key credential configured in n8n.
  • The node depends on the zuckzapgoApiRequest function to make HTTP requests to the API endpoints.
  • Proper network access to the ZuckZapGo service is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Providing a newsletter name longer than 25 characters may result in validation errors.
    • Incorrectly formatted picture data (neither valid base64 nor URL) might cause request rejection.
  • Error messages:

    • "error": "Invalid API key" — Check and update your API key credential.
    • "error": "Newsletter name too long" — Ensure the newsletter name does not exceed 25 characters.
    • "error": "Invalid picture format" — Verify the picture input is either a valid base64 string or a proper URL.

To resolve these, verify all inputs meet the API requirements and confirm the API key is correctly set up in n8n credentials.

Links and References

  • ZuckZapGo API Documentation (hypothetical link, replace with actual if available)
  • WhatsApp Business API concepts for newsletters and channels.

Discussion