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 Journey Token

PreviousLấy thông tin chi tiết Journey TokenNextLấy danh sách tin nhắn

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/ListJourneys' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer $API_KEY' \
--data '{
  "filter": {
    "date_from": "<dateTime>",
    "date_to": "<dateTime>",
    "journey_id": "<string>",
    "phone": "<string>"
  },
  "paging": {
    "after": "<string>",
    "before": "<string>",
    "limit": "<integer>",
    "sort": "<string>"
  }
}'

Response:

{
  "journeys": [
    {
      "created_at": "2019-08-24T14:15:22Z",
      "error_code": 0,
      "error_message": "string",
      "expired_at": "2019-08-24T14:15:22Z",
      "id": "string",
      "is_charged": true,
      "journey_id": "string",
      "journey_token": "string",
      "phone": "string",
      "status": "Z",
      "updated_at": "2019-08-24T14:15:22Z"
    }
  ],
  "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ả

oa_id

int64

ID của OA

journey_id

int64

ID của journey

phone

string

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

is_charged

bool

Tính phí hay không

status

string

Trạng thái Z: Mới tạo P: Enable N: Disable

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 của journey trên hệ thống eTelecom

journey_id

string

ID của journey

journey_token

string

Mã hành trình được kích hoạt

phone

string

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

status

string

Trạng thái Z: Mới tạo P: Enable N: Disable

is_charged

bool

Tính phí hay không

expires_at

string<date-time>

Thời gian hết hạn

updated_at

string<date-time>

Thời gian cập nhật

created_at

string<date-time>

Thời gian tạo

<api_key>
Shop
<shop_key>
Partner

ListJourneys

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

{
  "filter": {
    "date_from": "2025-06-14T09:47:06.517Z",
    "date_to": "2025-06-14T09:47:06.517Z",
    "is_charged": true,
    "journey_id": "text",
    "oa_id": "text",
    "phone": "text",
    "status": "Z"
  },
  "paging": {
    "after": "text",
    "before": "text",
    "limit": 1,
    "sort": "text"
  }
}
200

A successful response

{
  "journeys": [
    {
      "created_at": "2025-06-14T09:47:06.517Z",
      "error_code": 1,
      "error_message": "text",
      "expired_at": "2025-06-14T09:47:06.517Z",
      "id": "text",
      "is_charged": true,
      "journey_id": "text",
      "journey_token": "text",
      "phone": "text",
      "status": "Z",
      "updated_at": "2025-06-14T09:47:06.517Z"
    }
  ],
  "paging": {
    "after": "text",
    "before": "text",
    "limit": 1,
    "next": "text",
    "prev": "text",
    "sort": "text"
  }
}