Zalo OA

Overview

This node integrates with the Zalo Official Account (OA) API, enabling users to interact programmatically with various features of a Zalo OA. Specifically, the "Lấy Thông Tin Đơn Hàng" (Get Order Information) operation retrieves detailed information about a specific order by its ID.

Common scenarios for this node include:

• Fetching order details to display or process within an automation workflow.
• Integrating Zalo OA order data into CRM or ERP systems.
• Automating customer support processes by retrieving order status and details.

Practical example:

• A business receives an order via Zalo OA and wants to automatically fetch the order details to update their internal system or notify relevant teams.

Properties

Output

The node outputs a JSON object containing the response from the Zalo OA API for the requested order. The structure typically includes order details such as order ID, user information, shipping details, items ordered, pricing, status, and other metadata provided by the Zalo OA API.

If the API call fails, the output JSON will contain error information including an error flag, message, and possibly additional response data and suggestions for troubleshooting.

No binary data output is produced by this operation.

Dependencies

• Requires an active Zalo Official Account API access token credential configured in n8n.
• Uses the Zalo OA API endpoint at https://openapi.zalo.me/v2.0/oa.
• The node depends on the axios HTTP client library for making API requests.

Troubleshooting

Common Issues

• Invalid or expired access token: The API call will fail if the access token is missing, invalid, or expired.
• Incorrect order ID: Providing a non-existent or malformed order ID will result in an error response.
• Insufficient permissions: The connected Zalo OA may lack the necessary permissions to access order information.

Error Messages and Resolutions

• Error fetching order info: [message]
  Indicates failure in retrieving order details. Check that the order ID is correct and that the access token has proper permissions.
• API response errors with status codes
  Review the HTTP status code and response body for clues. Common issues include rate limiting, authentication failures, or malformed requests.
• No data returned or empty response
  Verify that the order exists and that the API endpoint is reachable.

Links and References

• Zalo Official Account API Documentation
• Zalo OA API Reference - Orders (Note: link is illustrative; check official docs for exact URLs)