Kết nối OA
API này dùng để kết nối OA
POST /ConnectOA HTTP/1.1
Host: $BASE_URL.Zalo
Content-Type: application/json
Accept: */*
Content-Length: 40
{
"code": "text",
"oa_id": "text",
"state": 1
}A successful response
{
"app_id": "text",
"avatar": "text",
"connection_id": "text",
"connection_method": "unknown",
"cover": "text",
"created_at": "2025-07-10T00:15:00.520Z",
"current_quality": "unknown",
"daily_quota": 1,
"description": "text",
"expires_at": "2025-07-10T00:15:00.520Z",
"is_verified": true,
"last_week_quality": "unknown",
"name": "text",
"oa_id": "text",
"onwer_id": "text",
"remaining_quota": 1,
"shop_id": "text",
"status": "Z",
"updated_at": "2025-07-10T00:15:00.520Z"
}Request:
curl --location '$BASE_URL.Zalo/ConnectOA' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer $API_KEY' \
--data '{
"code": "string",
"oa_id": "int64",
"state": "integer"
}'Response:
{
"app_id": "string",
"avatar": "string",
"connection_id": "string",
"connection_method": "unknown",
"cover": "string",
"created_at": "2019-08-24T14:15:22Z",
"current_quality": "unknown",
"daily_quota": 0,
"description": "string",
"expires_at": "2019-08-24T14:15:22Z",
"is_verified": true,
"last_week_quality": "unknown",
"name": "string",
"oa_id": "string",
"onwer_id": "string",
"remaining_quota": 0,
"shop_id": "string",
"status": "Z",
"updated_at": "2019-08-24T14:15:22Z"
}Cấu trúc body của request
code
string
Code được trả về ở redirect_url khi thực hiện ủy quyền OA cho app
oa_id
int64
ID của OA
state
integer
State được trả về ở redirect_url khi thực hiện ủy quyền OA cho app
Cấu trúc thuộc tính dữ liệu trả về
app_id
int64
ID của ứng dụng
avatar
string
Đường dẫn đến ảnh bìa của OA
connection_id
int64
ID kết nối
connection_method
string
Phương thức kết nối
direct
description
string
Mô tả
is_verified
boolean
True: OA được verify
False: OA chưa được verify
name
string
Tên OA
oa_id
int64
ID của OA
owner_id
int64
ID của chủ shop trên hệ thống eTelecom
shop_id
int64
ID của shop trên hệ thống eTelecom
status
string
Trạng thái
P: Đang kết nối
N: Ngắt kết nối
current_quality
string
Chất lượng gửi thông báo ZNS trong 48 giờ gần nhất của OA.
HIGH - Mức độ chất lượng tốt
MEDIUM - Mức độ chất lượng trung bình
LOW - Mức độ chất lượng kém
UNDEFINED - Mức độ chất lượng OA chưa được xác định (trường hợp OA không gửi thông báo ZNS nào trong khung thời gian đánh giá)
last_week_quality
string
Chất lượng gửi thông báo ZNS trong 7 ngày gần nhất của OA.
Các giá trị trả về:
HIGH - Mức độ chất lượng tốt
MEDIUM - Mức độ chất lượng trung bình
LOW - Mức độ chất lượng kém
UNDEFINED - Mức độ chất lượng OA chưa được xác định (trường hợp OA không gửi thông báo ZNS nào trong khung thời gian đánh giá)
daily_quota
int
Số thông báo ZNS OA được gửi trong 1 ngày.
remaining_quota
int
Số thông báo ZNS OA được gửi trong ngày còn lại.
expires_at
string<date-time>
Thời gian hết hạn của refresh token
updated_at
string<date-time>
Ngày cập nhật
created_at
string<date-time>
Ngày tạo
Last updated