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 CRM systems.
Practical examples:
- Automatically notify a team via chat or email when a new friend request is received on Zalo.
- Log friend request data into a database for analytics or record-keeping.
- Trigger follow-up workflows to send welcome messages or gather additional user information.
Properties
Name | Meaning |
---|---|
Event Types | Friend events to listen for. Options: "Friend Requests" (listens for incoming friend requests) |
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 external
zca-js
library to handle Zalo API interactions and event listening. - Needs proper configuration of webhook URL in n8n to receive POST requests from the Zalo event listener.
- Requires valid Zalo credentials including cookie, IMEI, and user agent strings for authentication.
Troubleshooting
Common issues:
- Failure to authenticate due to invalid or expired credentials.
- Webhook URL not reachable or misconfigured, causing event delivery failures.
- Missing required properties like event types leading to no events being captured.
Error messages:
"No credentials found"
: Ensure that the Zalo API credential is properly set up and linked to the node."No API instance found. Please make sure to provide valid credentials."
: Check that the provided credentials are correct and have necessary permissions."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
- zca-js GitHub Repository (for the Zalo API client library)