Tạo máy nhánh

Bước 1: Bạn cần liên hệ với SenCloud để tạo tổng đài trước khi thực hiện các bước này.

Bước 2: Đăng nhập SenCloud

API tạo máy nhánh

CreateExtension

post

Body

application/json

extension_numberintegerOptional

hotline_idstring · int64Optional

user_idstring · int64Optional

Responses

200

A successful response

application/json

account_idstring · int64Optional

created_atstring · date-timeOptional

expires_atstring · date-timeOptional

extension_numberstringOptional

extension_passwordstringOptional

hotline_idstring · int64Optional

idstring · int64Optional

statestring · enumOptionalPossible values:

subscription_idstring · int64Optional

tenant_domainstringOptional

tenant_idstring · int64Optional

updated_atstring · date-timeOptional

user_idstring · int64Optional

post

/v1/shop.Sencloud/CreateExtension

HTTPcURLJavaScriptPython

POST /v1/shop.Sencloud/CreateExtension HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "extension_number": 1,
  "hotline_id": "text",
  "user_id": "text"
}

200

A successful response

{
  "account_id": "text",
  "created_at": "2026-03-07T17:01:13.229Z",
  "expires_at": "2026-03-07T17:01:13.229Z",
  "extension_number": "text",
  "extension_password": "text",
  "hotline_id": "text",
  "id": "text",
  "state": "Z",
  "subscription_id": "text",
  "tenant_domain": "text",
  "tenant_id": "text",
  "updated_at": "2026-03-07T17:01:13.229Z",
  "user_id": "text"
}

Request:

curl --location 'https://api.sencloud.vn/v1/shop.Sencloud/CreateExtension' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer $API_KEY' \
--data '{
  "extension_number": 101,
  "hotline_id": "1296121461794938793"
}'

Response Sample:

{
    "id": "string",
    "user_id": "0",
    "account_id": "string",
    "extension_number": "string",
    "extension_password": "string",
    "tenant_id": "string",
    "tenant_domain": "string",
    "hotline_id": "string",
    "created_at": "2023-08-15T14:42:20.175908+07:00",
    "updated_at": "2023-08-15T14:42:20.326398+07:00",
    "expires_at": "0001-01-01T00:00:00Z",
    "subscription_id": "string",
    "state": "Z"
}

Tên trường	Kiểu dữ liệu	Mô tả
id	string	ID máy nhánh
extension_number	string	Số máy nhánh
extension_password	string	Mật khẩu máy nhánh
tenant_id	string	ID tenant
tenant_domain	string	Domain tenant
hotline_id	string	ID của hotline
created_at	string	Thời gian tạo máy nhánh
updated_at	string	Thời gian cập nhật
expires_at	string	Thời gian hết hạn
state	string	Trạng thái Z: Mới tạo P: Còn hạn N: Hết hạn