Actions7
- Zalo Send Message Actions
- Zalo Text To Speech Actions
Overview
This node enables sending message status updates through the Zalo messaging platform using its API. Specifically, the "Gửi trạng thái tin nhắn" (Send message status) operation allows users to send typing indicators or similar status events to a specified conversation thread on Zalo. This is useful in scenarios where you want to simulate or indicate that a user is actively typing or interacting within a chat, enhancing real-time communication experiences.
Practical examples include:
- Indicating to a recipient that a message is being composed.
- Sending typing notifications in personal or group chats to improve engagement.
- Integrating with automated chatbots to show activity status during response generation.
Properties
| Name | Meaning |
|---|---|
| ID cuộc trò chuyện / Thread ID | The unique identifier of the conversation thread where the message status will be sent. |
| Loại cuộc trò chuyện | The type of conversation: either "Cá nhân" (Personal/User) or "Nhóm" (Group). |
Output
The output JSON object for this operation contains:
success: A boolean indicating whether the status update was successfully sent.message: A string confirmation message, typically"OK"when successful.
Example output JSON:
{
"success": true,
"message": "OK"
}
No binary data is produced by this operation.
Dependencies
- Requires valid Zalo API credentials with appropriate authentication cookies and device/user agent information.
- The node uses an internal Zalo API client initialized with these credentials.
- Proper configuration of the Zalo API credential in n8n is necessary before use.
Troubleshooting
Common issues:
- Failure to initialize the Zalo API client due to invalid or missing credentials.
- Errors sending typing events if the thread ID or type is incorrect.
- Network or API errors from Zalo service interruptions.
Error messages and resolutions:
"Failed to initialize Zalo API. Check your credentials."
Ensure that the Zalo API credentials are correctly set up with valid cookie, IMEI, and user agent values."Zalo login error: <error message>"
Indicates problems authenticating with Zalo; verify credentials and network connectivity."Cannot send typing event"(logged as an error but does not stop execution)
May occur if the thread ID is invalid or the API rejects the typing event; double-check thread details.- If the node throws a generic error related to sending the status, check that the thread ID exists and the conversation type matches the actual chat type (user vs group).
Links and References
- Zalo Official Developer Documentation
- Zalo Messaging API Overview
- n8n Documentation on Creating Custom Nodes