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 supports a variety of operations such as listing newsletters, creating newsletters, sending messages, subscribing/unsubscribing, muting notifications, reacting to messages, and more. The "Send Admin Invite" operation specifically allows sending an invitation to a phone number to become an admin of a specified newsletter.

Practical scenarios include:

  • Managing communication channels on WhatsApp for marketing or community engagement.
  • Automating newsletter creation and message distribution.
  • Inviting new administrators to help manage newsletters via WhatsApp.

For example, using the "Send Admin Invite" operation, you can programmatically invite a colleague to become an admin of your WhatsApp newsletter by providing their phone number, an invite image, caption, and newsletter details.

Properties

Name Meaning
Newsletter JID The unique identifier (JID) of the newsletter channel to which the admin invite will be sent.
Phone Number The recipient's phone number to send the admin invite to.
Image Base64 encoded image or URL used as the invite image.
Invite Caption Text caption accompanying the admin invite.
Newsletter Name The name of the newsletter shown in the invite.

Output

The node outputs JSON data representing the response from the ZuckZapGo API for the performed operation. For the "Send Admin Invite" operation, this typically includes confirmation details about the invite request status.

No binary data output is produced by this operation.

Dependencies

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

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrect phone number format may result in failed invite delivery.
    • Providing invalid or malformed base64 images or URLs for the invite image can cause errors.
    • Missing required parameters like newsletter JID or phone number will trigger validation errors.
  • Error messages:

    • Errors returned from the API are passed through; typical messages might indicate invalid input or permission issues.
    • To resolve, verify all required fields are correctly filled and that the API key has sufficient permissions.

Links and References

Discussion