ZuckZapGo AI icon

ZuckZapGo AI

Send WhatsApp messages using ZuckZapGo - optimized for AI workflows
Join our community

Actions21

Overview

The "Send Text" operation of the ZuckZapGo AI node allows sending plain text messages via WhatsApp to individual users, groups, newsletters, or LIDs. It supports advanced messaging features such as forwarding, replying to specific messages, and mentioning users or all group members. This node is particularly useful for automating WhatsApp communications in business workflows, customer support, marketing campaigns, or AI-driven chatbots.

Practical examples include:

  • Sending personalized notifications or alerts to customers.
  • Replying automatically to user queries with contextual references.
  • Broadcasting announcements to groups or newsletters with mentions.
  • Simulating typing presence to enhance user experience.

Properties

Name Meaning
Recipient Phone number, Group ID (@g.us), Newsletter ID (@newsletter), or LID (@lid) to which the message will be sent.
Message The text content of the message to send.
Additional Options Collection of optional settings:
- Message ID Custom identifier for the message; if not provided, it is auto-generated.
- Presence Simulation Duration in milliseconds (0-30000) to simulate typing or recording presence indicator before sending the message.
- Message Duration Duration in seconds for WhatsApp disappearing message feature. Options: No Expiration, 24 Hours, 7 Days, 90 Days.
- Link Preview Whether to generate an automatic preview for URLs included in the text message (true/false).
- Context Information Context for replies, forwards, and mentions including:
• Mark message as forwarded
• Mention all group members
• List of mentioned user JIDs
• Participant JID for replies
• Reply-to message ID

Output

The node outputs a JSON object representing the API response from the WhatsApp service after sending the text message. This includes details such as message status, IDs, timestamps, and any error information if applicable.

No binary data is output for this operation.

Example structure of the json output field:

{
  "data": {
    "messageId": "string",
    "status": "sent",
    "timestamp": "ISO8601 string",
    ...
  },
  "_aiOptimized": true,
  "_truncated": {
    "originalCount": 100,
    "returnedCount": 10,
    "reason": "Optimized for AI processing"
  }
}

(Note: The _aiOptimized and _truncated fields appear when AI optimization is enabled.)

Dependencies

  • Requires an active connection to the ZuckZapGo API service.
  • Needs an API key credential configured in n8n for authentication.
  • The node uses HTTP requests to communicate with the WhatsApp backend via ZuckZapGo endpoints.
  • Optional: To save avatars or media, the node may perform additional HTTP GET requests.

Troubleshooting

  • Binary Property Not Found: If using binary data sources for media (not applicable for Send Text), ensure the specified binary property exists in the input data.
  • Invalid Recipient Format: The recipient must be a valid phone number or ID with correct suffixes (@s.whatsapp.net, @g.us, etc.). Incorrect formats may cause errors.
  • API Errors: Network issues or invalid credentials will result in API request failures. Verify API key validity and network connectivity.
  • Context Info Misconfiguration: When using reply or mention features, ensure participant JIDs and message IDs are correctly set to avoid message delivery issues.
  • Presence Simulation Limits: Values above 30000 ms for presence simulation will be rejected.

Links and References

  • ZuckZapGo GitHub Repository
  • WhatsApp Business API documentation (general reference for message types and context)
  • n8n Documentation on custom nodes and credentials configuration

Discussion