Zalo OAInstall

Overview

This node integrates with the Zalo Official Account (OA) API to send text messages to users. Specifically, the "Gửi Tin Nhắn Văn Bản" (Send Text Message) operation allows sending plain text messages to individual Zalo users identified by their user ID. This is useful for customer service, transactional notifications, or personal promotional messages.

Common scenarios include:

• Sending customer support messages to followers.
• Delivering transaction alerts or confirmations.
• Broadcasting personalized promotional content.

For example, a business can use this node to notify a user about their order status or send a promotional offer directly via Zalo chat.

Properties

Output

The node outputs a JSON object containing the response from the Zalo OA API after attempting to send the message. This typically includes information such as success status, message ID, or error details if the request failed.

No binary data output is produced by this operation.

Example output JSON structure (simplified):

{
  "message_id": "1234567890",
  "error": 0,
  "message": "Success"
}

If an error occurs, the output JSON will contain error details and suggestions.

Dependencies

• Requires a valid Zalo Official Account API access token with appropriate permissions to send messages.
• The node expects the access token to be provided either via credentials configured in n8n or stored tokens accessible through environment variables or database.
• Uses the Zalo OpenAPI endpoint https://openapi.zalo.me/v3.0/oa/message/{messageType} for sending messages.
• Requires internet connectivity to reach Zalo's API servers.

Troubleshooting

Common Issues

• Invalid or expired access token: The API call will fail if the access token is missing, invalid, or expired. Ensure that the token is correctly configured and refreshed as needed.
• Incorrect user ID: If the user ID does not correspond to a valid follower of the OA, the message will not be delivered.
• Insufficient permissions: The OA must have granted permissions to manage and send messages to followers.
• Message content issues: Empty or malformed text content may cause errors.

Error Messages and Resolutions

• "Error sending message: <details>": Check the access token validity and user ID correctness.
• "Please check the parameters and OA access permissions.": Verify that the OA has the required permissions and that all input parameters are correct.
• Network or timeout errors: Confirm network connectivity and retry.

Links and References

• Zalo Official Account API Documentation
• Zalo Messaging API Guide
• n8n Documentation on Credentials

This summary is based on static analysis of the node's source code and provided property definitions. It focuses on the "Zalo OA" resource and the "Gửi Tin Nhắn Văn Bản" operation only.