Zalo User Interact

Overview

This node operation "Add User To Group With Phone Number" is designed to add a user to a specific group in the Zalo platform by using the user's phone number. It facilitates managing group memberships dynamically without needing the user's internal ID, which can be useful when only the phone number is known.

Common scenarios where this node would be beneficial include:

• Automating group membership management based on contact lists.
• Adding new users to groups during onboarding or marketing campaigns.
• Integrating with CRM systems where phone numbers are primary identifiers.

Practical example:

• A company wants to add customers who opt-in via phone number to a promotional Zalo group automatically.
• An event organizer adds participants to a discussion group by their phone numbers collected from registration forms.

Properties

Output

The node outputs JSON data representing the result of the add-user-to-group operation. This typically includes success status and any relevant metadata returned by the Zalo API about the updated group or user addition.

If the operation involves binary data (e.g., attachments), it would be included accordingly, but for this operation, the output is primarily JSON indicating the action's outcome.

Dependencies

• Requires an active connection to the Zalo API.
• Needs an API key or authentication token configured in n8n credentials to authorize requests.
• Uses internal helper classes and methods to interact with the Zalo service.
• May depend on file system access if attachments or files are involved in other operations (not specifically for this one).

Troubleshooting

Common Issues

• Invalid or missing Group Id: The node requires a valid group identifier; ensure the Group Id is correct.
• Incorrect phone number format: The phone number must be in the expected format recognized by Zalo.
• Authentication errors: Ensure that the API key or authentication token is correctly set up and has permissions to modify group memberships.
• Network or API downtime: Temporary issues with the Zalo API may cause failures.

Error Messages

• "Group not found" or similar: Verify the Group Id exists and is accessible.
• "User not found" or "Invalid phone number": Confirm the phone number corresponds to a registered Zalo user.
• Authentication failed: Check API credentials and permissions.
• Rate limit exceeded: Wait and retry later or adjust usage patterns.

Resolving these usually involves verifying input parameters, checking credential configurations, and ensuring network connectivity.

Links and References

• Zalo Official API Documentation
• n8n Documentation - Creating Custom Nodes
• Zalo Group Management API Reference

Note: The above summary is based solely on static analysis of the provided source code and property definitions, without runtime execution or access to internal credential names.