Actions38
- Zalo OA Actions
- Gửi Tin Nhắn Văn Bản Vào Nhóm
- Gửi Tin Nhắn Văn Bản
- Gửi Tin Nhắn Hình Ảnh
- Gửi Tin Nhắn File
- Gửi Tin Nhắn Danh Sách
- Lấy Thông Tin Người Theo Dõi
- Lấy Danh Sách Người Theo Dõi
- Cập Nhật Thông Tin Người Theo Dõi
- Lấy Danh Sách Cuộc Trò Chuyện Gần Đây
- Lấy Lịch Sử Hội Thoại
- Kiểm Tra Trạng Thái Tin Nhắn
- Upload Hình Ảnh
- Gửi Tin Tư Vấn Kèm Ảnh
- Upload Hình Ảnh GIF
- Upload File
- Lấy Danh Sách Tag
- Gán Tag Cho Người Theo Dõi
- Xóa Tag
- Xóa Người Theo Dõi Khỏi Tag
- Cập Nhật Menu OA
- Tạo Bài Viết
- Cập Nhật Bài Viết
- Xóa Bài Viết
- Lấy Danh Sách Bài Viết
- Lấy Chi Tiết Bài Viết
- Chuẩn Bị Upload Video
- Xác Thực Video
- Tạo Sản Phẩm
- Cập Nhật Sản Phẩm
- Lấy Thông Tin Sản Phẩm
- Lấy Danh Sách Sản Phẩm
- Tạo Danh Mục
- Cập Nhật Danh Mục
- Lấy Danh Sách Danh Mục
- Tạo Đơn Hàng
- Cập Nhật Đơn Hàng
- Lấy Thông Tin Đơn Hàng
- Lấy Danh Sách Đơn Hàng
Overview
This node interacts with the Zalo Official Account (OA) API to retrieve a list of orders associated with the OA. It allows users to fetch order data by specifying pagination parameters and filtering by order status. This functionality is useful for businesses managing their sales and order processing through Zalo OA, enabling automation workflows that monitor, analyze, or process order information.
Practical examples:
- Automatically fetching recent orders to update an internal CRM or inventory system.
- Filtering orders by status (e.g., only "pending" or "delivered") to trigger specific follow-up actions.
- Integrating order data into reporting dashboards or notification systems.
Properties
| Name | Meaning |
|---|---|
| Vị Trí Bắt Đầu (offset) | The starting position (offset) in the list of orders from which to begin fetching data. |
| Số Lượng (count) | The number of orders to retrieve in one request. |
| Trạng Thái Đơn Hàng (status) | Filter orders by their status. Options include: Tất Cả (all), Chờ Xác Nhận (pending), Đã Xác Nhận (confirmed), Đang Giao Hàng (shipping), Đã Giao Hàng (delivered), Đã Hủy (canceled). |
Output
The node outputs JSON data containing the response from the Zalo OA API's order list endpoint. The structure typically includes:
- An array of order objects under a property (commonly
dataor similar). - Each order object contains details such as order ID, user info, items, status, timestamps, and other relevant metadata.
- Additional metadata about the response like total count or paging info may also be included.
No binary data output is produced by this operation.
Dependencies
- Requires a valid access token credential for Zalo OA API authentication.
- The node uses the official Zalo OA API endpoints (
https://openapi.zalo.me/v3.0/oa/store/order/getlist) to fetch order data. - Proper permissions must be granted to the access token to read order information.
- No additional external services are required beyond the Zalo OA API.
Troubleshooting
Common issues:
- Invalid or expired access token leading to authentication errors.
- Insufficient permissions on the OA app to access order data.
- Incorrect parameter values (e.g., negative offset or count exceeding API limits).
- Network connectivity problems affecting API calls.
Error messages and resolutions:
- Errors indicating token expiration: Refresh or reauthenticate the API credentials.
- Permission denied errors: Verify that the OA app has the necessary scopes enabled.
- Parameter validation errors: Ensure
offsetandcountare non-negative integers and within allowed ranges. - API rate limiting or server errors: Implement retry logic or check Zalo OA API status.