Actions12
Overview
This node manages Zalo user interactions, specifically allowing you to change the "alias name" (a nickname or friendly name) of a Zalo user in your contacts. This is useful when you want to personalize how contacts appear in your Zalo app or system by assigning memorable or meaningful names.
A practical example: You have a list of Zalo users identified by their user IDs, and you want to update their alias names to something more recognizable for easier identification in your workflows or CRM integrations.
Properties
| Name | Meaning |
|---|---|
| User ID | The unique identifier of the Zalo user whose alias name you want to change. |
| Alias Name | The new alias (friendly name) you want to assign to the specified user. |
Output
The output JSON contains:
status: A string indicating the operation result, typically"Thành công"meaning "Success".response: The raw response from the Zalo API after attempting to change the alias name, which may include details about the updated contact or confirmation data.
Example output JSON:
{
"status": "Thành công",
"response": {
/* API response details */
}
}
No binary data output is involved in this operation.
Dependencies
- Requires an API key credential to authenticate with the Zalo platform.
- Uses stored credentials including cookie, device IMEI, and user agent strings to establish a session.
- Depends on the external
zca-jslibrary for interacting with the Zalo API.
Troubleshooting
Common issues:
- Invalid or expired credentials can cause authentication failures.
- Incorrect user IDs or alias names might lead to API errors or no changes applied.
- Network connectivity problems can interrupt communication with the Zalo API.
Error messages:
"No API instance found. Please make sure to provide valid credentials."
Means the node could not authenticate with Zalo. Verify that the API key and related credentials are correctly configured.- Errors returned from the API (e.g., invalid user ID) will be shown in the error message. Check the user ID and alias name inputs for correctness.
To continue processing other items even if one fails, enable the "Continue On Fail" option in the node settings.
Links and References
- Zalo Official Developer Documentation
- n8n Documentation on Credentials
- zca-js GitHub Repository (for the underlying Zalo API client)