Zalo User Interact

Overview

This node operation "Add User To Group With Phone Number" is designed to add a user to a specific group on the Zalo platform using their phone number. It facilitates managing group memberships by allowing users to be added based on their phone contact information rather than internal user IDs.

Common scenarios where this node is beneficial:

• Automating group membership management in Zalo for marketing or community engagement.
• Adding new customers or contacts to a group automatically after they register or provide their phone number.
• Integrating with CRM systems to sync contacts into Zalo groups.

Practical example:

• When a new lead submits their phone number via a web form, this node can add them to a designated Zalo group for targeted communication.

Properties

Output

The node outputs an array of JSON objects representing the result of the add-user-to-group operation for each input item. Each output object typically contains:

• A success flag indicating whether the user was successfully added.
• Any relevant metadata or response data from the Zalo API confirming the addition.
• Error details if the operation failed for a particular user.

The node does not output binary data.

Dependencies

• Requires access to the Zalo API with appropriate authentication credentials (e.g., an API key or token).
• The node depends on network connectivity to communicate with Zalo's services.
• Proper configuration of API credentials within n8n is necessary for successful execution.

Troubleshooting

Common issues:

• Invalid Group Id: If the provided group ID does not exist or is incorrect, the operation will fail.
• Invalid Phone Number: The phone number must correspond to a valid Zalo user; otherwise, the addition will not succeed.
• Authentication Errors: Missing or invalid API credentials will prevent the node from communicating with Zalo.
• API Rate Limits: Excessive requests may trigger rate limiting by Zalo, causing temporary failures.

Common error messages and resolutions:

• "Group not found": Verify that the Group Id is correct and that the authenticated user has permission to modify the group.
• "User not found" or "Invalid phone number": Confirm the phone number is registered on Zalo and formatted correctly.
• "Unauthorized" or "Authentication failed": Check that the API credentials are set up properly in n8n.
• Timeout or network errors: Ensure stable internet connection and that Zalo API endpoints are reachable.

Links and References

• Zalo Official API Documentation
• n8n Documentation - Creating Custom Nodes
• Zalo Developer Portal

Note: This summary is based solely on static analysis of the provided source code and property definitions without runtime execution or dynamic import resolution.