Overview
This node listens for friend-related events on the Zalo platform, specifically friend requests. It acts as a trigger that activates workflows when such events occur. This is useful for automating responses or actions based on incoming friend requests on Zalo, such as sending notifications, logging events, or updating external systems.
Practical examples:
- Automatically notify a team chat when a new friend request arrives on Zalo.
- Log friend request data into a CRM system for follow-up.
- Trigger custom workflows to welcome new contacts or verify friend requests.
Properties
| Name | Meaning |
|---|---|
| Event Types | Friend events to listen for. Options: "Friend Requests" (listens for friend request events) |
Output
The node outputs JSON data representing the friend event received from Zalo. The output structure includes a friendEvent object containing details about the specific friend event triggered (e.g., a friend request). This data can be used downstream in the workflow for further processing.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential to connect with the Zalo platform.
- Uses the Zalo SDK/library (
zca-js) to handle authentication and event listening. - Needs valid Zalo credentials including cookie, device IMEI, and user agent information.
- The node sets up a webhook URL where Zalo sends friend event notifications via HTTP POST.
Troubleshooting
Common issues:
- Missing or invalid credentials will cause connection failures.
- If the webhook URL is not accessible publicly, Zalo cannot send event notifications.
- Incorrectly configured event types may result in no triggers firing.
Error messages:
"No credentials found": Ensure you have provided valid Zalo API credentials."No API instance found. Please make sure to provide valid credentials.": Check that the credentials include valid cookie, IMEI, and user agent values."Zalo connection failed": Indicates failure during login or event listener setup; verify network connectivity and credential validity.
Links and References
- Zalo Official Developer Documentation
- n8n Webhook Documentation
- Zalo SDK (zca-js) GitHub Repository (if publicly available)