eTelecom docs
Tiếng Việt
Tiếng Việt
  • HƯỚNG DẪN SỬ DỤNG
    • Trang quản trị cs.etelecom.vn
    • Trang quản trị dành cho Partner
    • Google Chrome Extension
    • App eTelecom
  • TÍCH HỢP API
    • Shop
      • Tài khoản
      • Sử dụng
    • Partner
      • Tài khoản
      • Sử dụng
    • Tổng đài
      • VoIP SDK
        • Android
        • iOS
        • Web
        • Flutter
      • API tổng đài
        • Partner lấy danh sách tổng đài
        • Partner tạo hotline
        • Partner lấy danh sách hotline
        • Partner kích hoạt tổng đài
        • Partner gán hotline vào tổng đài
        • Partner gỡ hotline ra khỏi tổng đài
        • Partner xóa hotline ra khỏi hệ thống
        • Tạo tổng đài
        • Lấy thông tin tổng đài
        • Lấy cấu hình tổng đài
        • Lấy danh sách hotline
        • Tạo nhân viên
        • Lấy danh sách nhân viên
        • Tạo máy nhánh
        • Lấy thông tin máy nhánh
        • Lấy danh sách máy nhánh
        • Gán máy nhánh cho nhân viên
        • Thay đổi hotline cho máy nhánh
        • Gỡ máy nhánh khỏi nhân viên
        • Lấy lịch sử cuộc gọi
    • Zalo Cloud
      • Hướng dẫn kết nối Zalo Cloud
      • Zalo Cloud API
        • Tạo liên kết uỷ quyền OA
        • Kết nối OA
        • Lấy refresh token
        • Lấy danh sách OA
        • Lấy thông tin OA
        • Cập nhật Webhook cho OA
        • Lấy danh sách người dùng
        • Gửi tin tư vấn dạng văn bản
        • Gửi tin Tư vấn theo mẫu yêu cầu thông tin người dùng
        • Gửi tin tư vấn dạng sticker
        • Gửi tin tư vấn dạng hình ảnh
        • Gửi tin tư vấn dạng file
        • Gửi tin giao dịch
        • Upload file
        • Gửi yêu cầu cấp quyền gọi
        • Kiểm tra khách hàng đã cấp quyền gọi
        • Lấy danh sách yêu cầu cấp quyền gọi
        • Tạo mẫu tin
        • Lấy thông tin chi tiết mẫu tin
        • Lấy danh sách mẫu tin
        • Khởi tạo Journey Token
        • Lấy thông tin chi tiết Journey Token
        • Lấy danh sách Journey Token
        • Lấy danh sách tin nhắn
        • Lấy thông tin chi tiết tin nhắn
        • Gửi ZNS
        • Gửi ZNS với Journey Token
  • SMS BRANDNAME
    • Hướng dẫn sử dụng
    • SMS API
      • Gửi SMS
      • Lấy trạng thái tin
      • Lấy thông tin chi tiết mẫu tin
Powered by GitBook
On this page
  1. TÍCH HỢP API
  2. Zalo Cloud
  3. Zalo Cloud API

Lấy danh sách yêu cầu cấp quyền gọi

PreviousKiểm tra khách hàng đã cấp quyền gọiNextTạo mẫu tin

Last updated 5 months ago

Lưu ý:

  • Đối với các API sử dụng cho Shop thì API_KEY: .Thông tin base_url của

  • Đối với các API sử dụng cho Partner thì API_KEY: .Thông tin base_url của

Request:

curl --location '$BASE_URL.Zalo/ListRequestConsent' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer $API-KEY' \
--data '{
  "filter": {
    "call_type": "audio",
    "date_from": "<dateTime>",
    "date_to": "<dateTime>",
    "is_charged": "<boolean>",
    "oa_id": "<int64>",
    "phone": "<string>",
    "reason_code": "flight_announcement",
    "reply_status": "S",
    "status": "P",
    "user_id": "<int64>"
  },
  "paging": {
    "after": "<string>",
    "before": "<string>",
    "limit": "<integer>",
    "sort": "<string>"
  }
}'

Response:

{
  "consents": [
    {
      "call_type": "unknown",
      "created_at": "2019-08-24T14:15:22Z",
      "delivery_status": "unknown",
      "delivery_time": "2019-08-24T14:15:22Z",
      "error_code": 0,
      "error_message": "string",
      "expires_at": "2019-08-24T14:15:22Z",
      "id": "string",
      "is_charged": true,
      "oa_id": "string",
      "phone": "string",
      "reason_code": "unknown",
      "reply_status": "Z",
      "shop_id": "string",
      "status": "Z",
      "updated_at": "2019-08-24T14:15:22Z",
      "user_id": "string"
    }
  ],
  "paging": {
    "after": "string",
    "before": "string",
    "limit": 0,
    "next": "string",
    "prev": "string",
    "sort": "string"
  }
}

Cấu trúc body của request

Tham số
Kiểu dữ liệu
Mô tả

call_type

string

  • audio: Cuộc gọi thoại

  • video: Cuộc gọi video

  • audio_and_video: Cả gọi thoại và video

oa_id

int64

ID của OA

phone

string

Số điện thoại người nhận

reason_code

string

  • product_service_consulting: Tư vấn sản phẩm / dịch vụ

  • order_appointment_confirmation: Xác nhận đơn hàng / cuộc hẹn

  • delivery_notification: Thông báo giao hàng

  • flight_announcement: Thông báo chuyến bay

  • update_order: Cập nhật đơn hàng

reply_status

string

Trạng thái

S: Chờ phản hồi

NS: Không phản hồi P: Đồng ý N: Từ chối

is_charged

boolean

True: Tin được tính phí

False: Tin không được tính phí

status

string

Trạng thái P: Thành công N: Thất bại

date_from

string<date-time>

Ngày bắt đầu

date_to

string<date-time>

Ngày kết thúc

Cấu trúc thuộc tính dữ liệu trả về

Tham số
Kiểu dữ liệu
Mô tả

id

int64

ID tin nhắn trên hệ thống của eTelecom

shop_id

int64

ID cửa hàng trên hệ thống của eTelecom

user_id

int64

ID người gửi tin trên hệ thống của eTelecom

oa_id

int64

ID của OA

call_type

string

  • audio: Cuộc gọi thoại

  • video: Cuộc gọi video

  • audio_and_video: Cả gọi thoại và video

error_code

int

Mã lỗi

error_message

string

Thông báo lỗi

is_charged

boolean

True: Tin được tính phí

False: Tin không được tính phí

reply_status

string

Trạng thái

S: Chờ phản hồi

NS: Không phản hồi P: Đồng ý N: Từ chối

status

string

Trạng thái P: Thành công N: Thất bại

phone

string

Số điện thoại người nhận

delivery_status

string

Unkown: Không xác định

Received: Đã nhận Seen: Đã xem

delivery_time

string<date-time>

Thời gian thiết bị của người dùng nhận được thông báo

updated_at

string<date-time>

Ngày cập nhật

created_at

string<date-time>

Ngày tạo

<api_key>
Shop
<shop_key>
Partner

ListRequestConsent

post
Body
Responses
200
A successful response
application/json
post
POST /ListRequestConsent HTTP/1.1
Host: $BASE_URL.Zalo
Content-Type: application/json
Accept: */*
Content-Length: 297

{
  "filter": {
    "call_type": "unknown",
    "date_from": "2025-06-14T09:13:31.916Z",
    "date_to": "2025-06-14T09:13:31.916Z",
    "is_charged": true,
    "oa_id": "text",
    "phone": "text",
    "reason_code": "unknown",
    "reply_status": "Z",
    "status": "Z",
    "user_id": "text"
  },
  "paging": {
    "after": "text",
    "before": "text",
    "limit": 1,
    "sort": "text"
  }
}
200

A successful response

{
  "consents": [
    {
      "call_type": "unknown",
      "created_at": "2025-06-14T09:13:31.916Z",
      "delivery_status": "unknown",
      "delivery_time": "2025-06-14T09:13:31.916Z",
      "error_code": 1,
      "error_message": "text",
      "expires_at": "2025-06-14T09:13:31.916Z",
      "id": "text",
      "is_charged": true,
      "oa_id": "text",
      "phone": "text",
      "reason_code": "unknown",
      "reply_status": "Z",
      "shop_id": "text",
      "status": "Z",
      "updated_at": "2025-06-14T09:13:31.916Z",
      "user_id": "text"
    }
  ],
  "paging": {
    "after": "text",
    "before": "text",
    "limit": 1,
    "next": "text",
    "prev": "text",
    "sort": "text"
  }
}