Tổng đài

Quản lý cấu hình tổng đài , số nội bộ

Danh sách SỐ NỘI BỘ

GET [URL]/api/call_center/internal_phone/list

- Lấy danh sách cấu hình số nội bộ - Cấu hình > Tổng đài > Số nội bộ

Query Parameters

Name
Type
Description

keyword

string

Số nội bộ, email, full_name

page

number

Trang, bắt đầu từ 1 (Mặc định 1)

size

number

Kích thước trang, mặc định là 50

Headers

Name
Type
Description

Authorization*

string

Access Token : Bearer 'token'

Content-type*

string

application/json

{
    "status_code": 9999,
    "instance_id": "stg",
    "instance_name": "DESKTOP-3I0NHO0",
    "payload": {
        "items": [
            {
                "domain": "omiteam", // Domain tổng đài
                "outbound_proxy": "wss://wssvn.omicrm.com", // Outboud Proxy
                "sip_user": "147", // Số nội bộ
                "password": "XXXXXX", // Mật khẩu truy cập
                "full_name": "Đỗ Thị Hồng Vy", // Họ và tên
                "agent_id" : "xxx", // Id nhân viên
                "email": "dohongvyzyt@gmail.com", // Email
                "public_number":"84256336xxxx", // Đầu số đang sử dụng
                "last_updated_date": 1575269373331, //Cập nhật lần cuối
                "created_date": 1575251355778 // Ngày tạo
            },
            {
                "domain": "omiteam", // Domain tổng đài
                "outbound_proxy": "wss://wssvn.omicrm.com", // Outboud Proxy
                "sip_user": "145",
                "password": "kiyyzsefxx",
                "full_name": "Hồng Ngọc",
                "agent_id" : "xxx", // Id nhân viên
                "email": "vykh252tn1998@gmail.com",
                "public_number":"84256336xxxx",
                "last_updated_date": 1574999296765,
                "created_date": 1574133910912
            }
        ],
        "page_number": 1,
        "page_size": 2,
        "total_items": 30,
        "total_pages": 15,
        "has_next": true,
        "next_page": 2,
        "has_previous": false,
        "previous_page": 1
    },
    "key_enabled": false
}

Cập nhật trạng thái số máy lẻ

PUT [URL]/api/call_center/internal_phone/status?enabled=&sip_user=

Thay đổi trạng thái số máy lẻ : Hoạt đồng hoặc / Ngưng hoạt động

Query Parameters

Name
Type
Description

sip_user*

string

Số máy lẻ nhân viên

enabled*

string

true : Hoạt động false : Ngưng hoạt động

Headers

Name
Type
Description

Authorization*

string

Bearer token

Danh sách đầu số đang hoạt động và cho phép gọi ra

GET [URL]/api/call_center/hotline/list?extension=

Lấy danh sách đầu số đang hoạt động và cho phép gọi ra của một số nội bộ

Query Parameters

Name
Type
Description

extension

string

Số máy lẻ nhân viên

Headers

Name
Type
Description

Authorization*

string

Bearer token

{
    "status_code": 9999,
    "instance_id": "stg",
    "instance_version": "1.2.163",
    "payload": [
        "024********",
        "842*********"
    ],
    "key_enabled": false
}

Thông tin số hotline

GET [URL]/api/call_center/hotline/by-phone

Thông tin cấu hình của số hotline

Headers

Name
Value

Content-Type

application/json

Authorization

Bearer <token>

Query Parameters

Name
Type
Description

hotline

string

Số hotline

Response

{
    "instance_id": "stg",
    "payload": {
        "number": "842871002283",
        "status": "active",
        "expire_date": 1743440340000,
        "created_date": 1730172218174,
        "last_updated_date": 1736270113875,
        "configs": {
            "allow_call_in": true, // Cho phép gọi vào
            "allow_call_out": true, // Cho phép gọi ra
            "default_script": "677d6052f762e43be043ac35", // Kịch bản mặc định
            "working_days": [
                {
                    "weekday": 2,
                    "type": "full_day",
                    "script": "677d6052f762e43be043ac35",
                    "time_frames": [
                        {
                            "from": "",
                            "to": "",
                            "script": ""
                        }
                    ]
                },
                {
                    "weekday": 3,
                    "type": "full_day",
                    "script": "677d6052f762e43be043ac35",
                    "time_frames": [
                        {
                            "from": "",
                            "to": "",
                            "script": ""
                        }
                    ]
                },
                {
                    "weekday": 4,
                    "type": "full_day",
                    "script": "677d6052f762e43be043ac35",
                    "time_frames": [
                        {
                            "from": "",
                            "to": "",
                            "script": ""
                        }
                    ]
                },
                {
                    "weekday": 5,
                    "type": "full_day",
                    "script": "677d6052f762e43be043ac35",
                    "time_frames": [
                        {
                            "from": "",
                            "to": "",
                            "script": ""
                        }
                    ]
                },
                {
                    "weekday": 6,
                    "type": "full_day",
                    "script": "677d6052f762e43be043ac35",
                    "time_frames": [
                        {
                            "from": "",
                            "to": "",
                            "script": ""
                        }
                    ]
                },
                {
                    "weekday": 7,
                    "type": "full_day",
                    "script": "677d6052f762e43be043ac35",
                    "time_frames": [
                        {
                            "from": "",
                            "to": "",
                            "script": ""
                        }
                    ]
                },
                {
                    "weekday": 1,
                    "type": "full_day",
                    "script": "677d6052f762e43be043ac35",
                    "time_frames": [
                        {
                            "from": "",
                            "to": "",
                            "script": ""
                        }
                    ]
                }
            ],
            "special_days": [],
            "call_configs": null
        },
        "access_type": "applies_to_all_employees",
        "number_type": "fixed",
        "accesses": [], // Phân quyền gọi ra
        "disable_by_time_frame": false,
        "outbound_config": null
    },
    "instance_version": "1.2.164",
    "key_enabled": false,
    "status_code": 9999
}

Cập nhật đầu số hotline

POST [URL]/api/call_center/holtine/update

Cập nhật thông tin cấu hình GỌI RA, GỌI VÀO cơ bản của đầu số hotline

Headers

Name
Value

Content-Type

application/json

Authorization

Bearer <token>

Body

Name
Type
Description

hotline

string

Số hotline của doanh nghiệp

extensions

Array String

["101","200","301"]

Phân quyền được dùng đầu số để gọi ra cho những

extensions trong danh sách

group_ids

Array String

["6333d3d3f4bfc27c57841093","XXXX"]

Phân quyền được dùng đầu số này gọi ra theo danh sách Id nhóm nội bộ trong danh sách (Tham khảo API danh sách nhóm nội bộ)

call_script

String

ID Kịch bản gọi vào, tiếp nhận cuộc gọi (Tham khảo API danh sách kịch bản cuộc gọi)

Kịch bản sẽ chạy 1 kịch bản mặc định cho các ngày trong tuần

Response


{
    "instance_id": "stg",
    "payload": true,
    "instance_version": "1.2.164",
    "key_enabled": false,
    "status_code": 9999
}

Cài đặt 1 đầu số, chỉ dùng cho 1 máy nhánh (Extension)

POST [URL]/api/call_center/hotline/extension/update

Request Body

Name
Type
Description

hotline*

String

Số hotline

user_email*

String

Email nhân viên dùng tổng đài

directions*

Array

outbound : Cài đặt cho chiều gọi ra

inbound : Cài đặt cho chiều gọi vào

Lấy thông tin tổng đài của 1 user theo loại

GET [URL]/api/call_center/extensions/detail?type=&keyword=

Query Parameters

Name
Type
Description

type*

String

Gồm các giá trị sau tương ứng với keyword được search

usr_uuid : Username từ bên thứ 3

sip_user : Số máy lẻ tổng đài

user_email: Email nhân viên

keyword*

String

Giá trị tìm kiếm tương ứng với type ở trên 

{
    "instance_id": "stg",
    "payload": {
        "extension": "6349",
        "full_name": "Nguyen Tien",
        "mail": "contact18_usr_1685433772610@omicallpbx.com",
        "pbx_account": {
            "display_name": "6349",
            "sip_user": "6349",
            "sip_password": "rvld582289",
            "sip_web_socket_server": "wss://vh.omicrm.com:7443",
            "sip_realm": "contact18",
            "sip_proxy": "<sip:171.244.138.14;transport=udp>",
            "sip_proxy_port": "",
            "stun_servers": [],
            "transport": [
                "tcp",
                "udp",
                "ws",
                "wss"
            ],
            "use_opus": true,
            "opus_quality": 1
        },
        "uuid": "tientv11"
    },
    "instance_version": "1.2.164",
    "key_enabled": false,
    "status_code": 9999
}

Danh sách nhóm nội bộ

GET [URL]/api/call_center/internal_group/list

Query Parameters

Name
Type
Description

keyword

String

Từ khoá tìm kiếm

page

Integer

Trang (Bắt đầu từ 1). Mặc định là 1

size

Integer

Kích thước trang (mặc định là 10)

Headers

Name
Type
Description

Authorization

String

Bearer Token

{
    "status_code": 9999,
    "instance_id": "stg",
    "instance_version": "1.2.163",
    "payload": {
        "items": [
            {
                "_id": "62ff11b208d4bf3ea694a6f3",
                "tenant_id": "6209c98461c1cb163ded25f7",
                "group_name": "Nhóm Tech",
                "group_name_unsigned": "Nhom Tech",
                "group_number": "38011",
                "created_date": 1660883378087,
                "last_updated_date": 1661221667904,
                "create_by": {
                    "id": "6209c98561c1cb163ded25fa",
                    "name": "OMI Hotline"
                },
                "last_update_by": {
                    "id": "6209c98561c1cb163ded25fa",
                    "name": "OMI Hotline"
                },
                "is_deleted": false,
                "note": null,
                "members": [
                    {
                        "agent_id": "62d563113127de2eac6b8cbf",
                        "contact_id": "62d563113127de2eac6b8cbe",
                        "order": 0,
                        "view": null,
                        "timeout": 30,
                        "sip_user": null,
                        "hold_music_id": null
                    },
                    {
                        "agent_id": "6209c98561c1cb163ded25fa",
                        "contact_id": "6209c98c067f745da47367d1",
                        "order": 0,
                        "view": null,
                        "timeout": 30,
                        "sip_user": null,
                        "hold_music_id": null
                    }
                ],
                "is_forward_to_user_owner": null,
                "is_forward_to_outer_group": false,
                "outer_group_id": null,
                "strategy": "enterprise",
                "ring_back_id": "",
                "ring_back_name": null,
                "is_answer": "false",
                "target_timeout_type": "",
                "target_timeout": "",
                "target_timeout_name": null,
                "ring_group_type": 0,
                "ring_group_wait_time": 0,
                "ring_group_wait_time_sequence": 2,
                "ring_group_type_result": null,
                "enable_criteria": false,
                "criterias": []
            },
            {
                "_id": "62ff11a208d4bf3ea694a539",
                "tenant_id": "6209c98461c1cb163ded25f7",
                "group_name": "Nhóm Sales",
                "group_name_unsigned": "Nhom Sales",
                "group_number": "62714",
                "created_date": 1660883362155,
                "last_updated_date": 1667615822209,
                "create_by": {
                    "id": "6209c98561c1cb163ded25fa",
                    "name": "OMI Hotline"
                },
                "last_update_by": {
                    "id": "6209c98561c1cb163ded25fa",
                    "name": "OMI Hotline"
                },
                "is_deleted": false,
                "note": null,
                "members": [
                    {
                        "agent_id": "62d563113127de2eac6b8cbf",
                        "contact_id": "62d563113127de2eac6b8cbe",
                        "order": 0,
                        "view": null,
                        "timeout": 30,
                        "sip_user": null,
                        "hold_music_id": null
                    },
                    {
                        "agent_id": "6209c98561c1cb163ded25fa",
                        "contact_id": "6209c98c067f745da47367d1",
                        "order": 0,
                        "view": null,
                        "timeout": 30,
                        "sip_user": null,
                        "hold_music_id": null
                    }
                ],
                "is_forward_to_user_owner": null,
                "is_forward_to_outer_group": false,
                "outer_group_id": null,
                "strategy": "enterprise",
                "ring_back_id": "",
                "ring_back_name": null,
                "is_answer": "false",
                "target_timeout_type": "",
                "target_timeout": "",
                "target_timeout_name": null,
                "ring_group_type": 0,
                "ring_group_wait_time": 0,
                "ring_group_wait_time_sequence": 0,
                "ring_group_type_result": null,
                "enable_criteria": false,
                "criterias": []
            },
            {
                "_id": "62ff119508d4bf3ea694a44a",
                "tenant_id": "6209c98461c1cb163ded25f7",
                "group_name": "Nhóm CSKH",
                "group_name_unsigned": "Nhom CSKH",
                "group_number": "54807",
                "created_date": 1660883349783,
                "last_updated_date": 1660883349783,
                "create_by": {
                    "id": "6209c98561c1cb163ded25fa",
                    "name": "OMI Hotline"
                },
                "last_update_by": null,
                "is_deleted": false,
                "note": null,
                "members": [
                    {
                        "agent_id": "6209c98561c1cb163ded25fa",
                        "contact_id": "6209c98c067f745da47367d1",
                        "order": 0,
                        "view": null,
                        "timeout": 30,
                        "sip_user": null,
                        "hold_music_id": null
                    }
                ],
                "is_forward_to_user_owner": null,
                "is_forward_to_outer_group": false,
                "outer_group_id": null,
                "strategy": "enterprise",
                "ring_back_id": "",
                "ring_back_name": null,
                "is_answer": "false",
                "target_timeout_type": "",
                "target_timeout": "",
                "target_timeout_name": null,
                "ring_group_type": 0,
                "ring_group_wait_time": 0,
                "ring_group_wait_time_sequence": 2,
                "ring_group_type_result": null,
                "enable_criteria": false,
                "criterias": []
            },
            {
                "_id": "6209c99b067f745da47367f4",
                "tenant_id": "6209c98461c1cb163ded25f7",
                "group_name": "Nhóm nhân viên mặc định",
                "group_name_unsigned": "Nhom nhan vien mac dinh",
                "group_number": "54919",
                "created_date": 1644808603212,
                "last_updated_date": 1662705652281,
                "create_by": {
                    "id": "6209c98561c1cb163ded25fa",
                    "name": "OMI Hotline"
                },
                "last_update_by": {
                    "id": "6209c98561c1cb163ded25fa",
                    "name": "OMI Hotline"
                },
                "is_deleted": false,
                "note": null,
                "members": [
                    {
                        "agent_id": "6209c98561c1cb163ded25fa",
                        "contact_id": "6209c98c067f745da47367d1",
                        "order": 0,
                        "view": null,
                        "timeout": 30,
                        "sip_user": null,
                        "hold_music_id": null
                    }
                ],
                "is_forward_to_user_owner": null,
                "is_forward_to_outer_group": false,
                "outer_group_id": null,
                "strategy": "enterprise",
                "ring_back_id": "",
                "ring_back_name": null,
                "is_answer": "false",
                "target_timeout_type": "Voice_mail",
                "target_timeout": "62da34652a310904dfbbf13b",
                "target_timeout_name": null,
                "ring_group_type": 0,
                "ring_group_wait_time": 0,
                "ring_group_wait_time_sequence": 0,
                "ring_group_type_result": null,
                "enable_criteria": false,
                "criterias": []
            }
        ],
        "page_number": 1,
        "page_size": 10,
        "total_items": 4,
        "total_pages": 1,
        "has_next": false,
        "next_page": 1,
        "has_previous": false,
        "previous_page": 1,
        "extension": null
    },
    "key_enabled": false
}

Tạo nhóm nội bộ

POST [URL]/api/call_center/internal_group/add

Request Body

Name
Type
Description

group_name*

String

Tên nhóm

strategy*

String

Hình thức đổ chuông của nhóm, Một trong các giá trị dưới

enterprise : Đồng thời

rollover : Tuần tự

random : Ngẫu nhiên

sip_members*

Array

Danh sách số máy lẻ nhân viên cần thêm vào nhóm

timeout*

Integer

Thời gian chờ từng nhân viên

ring_group_type

Integer

Loại tiêu chí trong nhóm, áp dụng cho kịch bản tuần tự

1: Ưu tiên NV rảnh cao nhất

4: Ưu tiên nhân viên có tổng cuộc gọi trả lời trong ngày ít nhất

0: Không tiêu chí

target_timeout_type

String

Loại kịch bản sẽ chuyển tiếp khi kết thúc nhóm

Recording : Lời chào

Ivr_menu : Tương tác phím

Ring_group : Nhóm

target_timeout

String

Id theo từng loại dữ liệu của target_timeout_type

```json
{
    "status_code": 9999,
    "instance_id": "stg",
    "instance_version": "1.2.163",
    "payload": {
        "_id": "6391f5be232ce4664531e0cc",
        "tenant_id": "6209c98461c1cb163ded25f7",
        "group_name": "tientv11",
        "group_name_unsigned": "tientv11",
        "group_number": "22412",
        "created_date": 1670510011881,
        "last_updated_date": 1670510011881,
        "create_by": {
            "id": "6209c98561c1cb163ded25fa",
            "name": "OMI Hotline"
        },
        "last_update_by": null,
        "is_deleted": false,
        "note": null,
        "members": [
            {
                "agent_id": "6209c98561c1cb163ded25fa",
                "contact_id": "6209c98c067f745da47367d1",
                "order": 0,
                "view": null,
                "timeout": 30,
                "sip_user": null,
                "hold_music_id": null
            }
        ],
        "is_forward_to_user_owner": null,
        "is_forward_to_outer_group": false,
        "outer_group_id": null,
        "strategy": "random",
        "ring_back_id": null,
        "ring_back_name": null,
        "is_answer": null,
        "target_timeout_type": null,
        "target_timeout": null,
        "target_timeout_name": null,
        "ring_group_type": null,
        "ring_group_wait_time": null,
        "ring_group_wait_time_sequence": null,
        "ring_group_type_result": null,
        "enable_criteria": null,
        "criterias": null,
        "sip_members": [
            "100"
        ],
        "timeout": 30
    },
    "key_enabled": false
}
```

Cập nhật nhóm nội bộ

POST [URL]/api/call_center/internal_group/update/:id

Path Parameters

Name
Type
Description

id*

String

Id của NHÓM NỘI BỘ

Request Body

Name
Type
Description

group_name*

String

Tên nhóm

strategy*

String

Hình thức đổ chuông của nhóm, Một trong các giá trị dưới

enterprise : Đồng thời

rollover : Tuần tự

random : Ngẫu nhiên

sip_members*

String

Danh sách số máy lẻ nhân viên cần thêm vào nhóm

timeout*

Integer

Thời gian chờ từng nhân viên

target_timeout_type

String

Loại kịch bản sẽ chuyển tiếp khi kết thúc nhóm

Recording : Lời chào

Ivr_menu : Tương tác phím

Ring_group : Nhóm

target_timeout

String

Id theo từng loại dữ liệu của target_timeout_type

ring_group_type

Integer

Loại tiêu chí trong nhóm, áp dụng cho kịch bản tuần tự

1: Ưu tiên NV rảnh cao nhất

4: Ưu tiên nhân viên có tổng cuộc gọi trả lời trong ngày ít nhất

0: Không tiêu chí

```json
{
    "status_code": 9999,
    "instance_id": "stg",
    "instance_version": "1.2.163",
    "payload": {
        "_id": "6391f5be232ce4664531e0cc",
        "tenant_id": "6209c98461c1cb163ded25f7",
        "group_name": "tientv11",
        "group_name_unsigned": "tientv11",
        "group_number": "22412",
        "created_date": 1670510011881,
        "last_updated_date": 1670510241349,
        "create_by": {
            "id": "6209c98561c1cb163ded25fa",
            "name": "OMI Hotline"
        },
        "last_update_by": {
            "id": "6209c98561c1cb163ded25fa",
            "name": "OMI Hotline"
        },
        "is_deleted": false,
        "note": null,
        "members": [
            {
                "agent_id": "6209c98561c1cb163ded25fa",
                "contact_id": "6209c98c067f745da47367d1",
                "order": 0,
                "view": null,
                "timeout": 30,
                "sip_user": null,
                "hold_music_id": null
            }
        ],
        "is_forward_to_user_owner": null,
        "is_forward_to_outer_group": false,
        "outer_group_id": null,
        "strategy": "enterprise",
        "ring_back_id": "",
        "ring_back_name": null,
        "is_answer": "false",
        "target_timeout_type": "",
        "target_timeout": "",
        "target_timeout_name": null,
        "ring_group_type": 0,
        "ring_group_wait_time": 0,
        "ring_group_wait_time_sequence": 0,
        "ring_group_type_result": null,
        "enable_criteria": false,
        "criterias": [],
        "sip_members": [
            "100"
        ],
        "timeout": 30
    },
    "key_enabled": false
}
```

Thêm nhân viên vào nhóm nội bộ

POST [URL]/api/call_center/internal_group/add-members

Request Body

Name
Type
Description

group_id*

String

Id của nhóm nội bộ

sip_users*

Array

Danh sách các số máy lẻ , thêm vào nhóm

Xoá nhân viên khỏi nhóm nội bộ

POST [URL]/api/call_center/internal_group/remove-members

Request Body

Name
Type
Description

group_id*

String

Id của nhóm nội bộ

sip_users*

Array

Danh sách số máy lẻ nhân viên cần xoá

Xoá nhóm nội bộ

DELETE [URL]/api/call_center/internal_group/delete/:id

Path Parameters

Name
Type
Description

id*

String

Id của nhóm

Danh sách kịch bản bấm phím

GET [URL]/api/call_center/key-interaction/list

Query Parameters

Name
Type
Description

keyword

String

Từ khoá tìm kiếm

page*

Integer

Trang

size*

Integer

Kích thước trang

{
   "status_code":9999,
   "instance_id":"stg",
   "instance_version":"1.2.163",
   "payload":{
      "items":[
         {
            "_id":"632969ce7534d97b0933d51d",
            "tenant_id":"6209c98461c1cb163ded25f7",
            "script_name":"KỊCH BẢN BẤM PHÍM",
            "script_name_unsigned":"KICH BAN BAM PHIM",
            "script_number":"166780",
            "greeting_id":"6209c99b067f745da47367f3",
            "greeting_name":null,
            "greeting_short_id":"",
            "greeting_short_name":null,
            "note":null,
            "created_date":1663658446348,
            "created_by":{
               "id":"6209c98561c1cb163ded25fa",
               "name":"OMI Hotline"
            },
            "last_updated_date":1663658542212,
            "last_updated_by":{
               "id":"6209c98561c1cb163ded25fa",
               "name":"OMI Hotline"
            },
            "is_deleted":false,
            "scripts":[
               {
                  "key":null,
                  "action_type":"Ring_group",
                  "action":"62ff119508d4bf3ea694a44a",
                  "action_name":null,
                  "ivr":"1"
               },
               {
                  "key":null,
                  "action_type":"Ring_group",
                  "action":"62ff119508d4bf3ea694a44a",
                  "action_name":null,
                  "ivr":"2"
               },
               {
                  "key":null,
                  "action_type":"",
                  "action":"",
                  "action_name":null,
                  "ivr":"3"
               },
               {
                  "key":null,
                  "action_type":"",
                  "action":"",
                  "action_name":null,
                  "ivr":"4"
               },
               {
                  "key":null,
                  "action_type":"",
                  "action":"",
                  "action_name":null,
                  "ivr":"5"
               }
            ],
            "time_out":3,
            "action_type":"",
            "action":"",
            "action_name":null,
            "invalid_sound_id":"",
            "invalid_sound_name":null,
            "max_failure":1,
            "ivr_direct_menu_dial":null
         }
      ],
      "page_number":1,
      "page_size":10,
      "total_items":1,
      "total_pages":1,
      "has_next":false,
      "next_page":1,
      "has_previous":false,
      "previous_page":1,
      "extension":null
   },
   "key_enabled":false
}

Tạo mới kịch bản bấm phím

POST [URL]/api/call_center/key-interaction/add

Request Body

Name
Type
Description

script_name*

String

Tên kịch bản bấm phím (Chú ý không được trùng)

max_failure*

Integer

Số lần nhấn sai phím

time_out*

Integer

Thời gian chờ KH bấm phím, hoặc Khi kết thúc file ghi âm

scripts*

Array

Danh sách mảng đối tượng phím

Cách loại kịch bản đi kèm với phím bấm. Thành phần là nhóm nội bộ

{

"ivr" : "", //Tên phím 1,2,3..

"action": "xxxxxxxx" // Id của nhóm nội bộ

"action_type":"Ring_group"

}

Thành phần là kịch bản bấm phím

{

"ivr" : "", //Tên phím 1,2,3..

"action": "xxxxxxxx" // Id Kịch bản bấm phím.

"action_type":"Ivr_menu"

}

greeting_id*

String

Id của file ghi âm (API upload file ghi âm)

greeting_short_id

String

Id của file ghi âm( Nhạc chờ khi trở lại tương tác bấm phím)

invalid_sound_id

String

Id của file ghi âm (Nhạc chờ khi nhấn sai phím)

action

String

Id của hành động action_type theo các loại tương ứng

action_type

String

Loại hành động khi không nhấn phím, hoặc nhấn sai phím quá số lần cho phép

Ring_group : Nhóm nội bộ

Ivr_menu : Kịch bản bấm phím

Recording : Lời chào

{
   "status_code":9999,
   "instance_id":"stg",
   "instance_version":"1.2.163",
   "payload":{
      "_id":"632969ce7534d97b0933d51d",
      "tenant_id":"6209c98461c1cb163ded25f7",
      "script_name":"KỊCH BẢN BẤM PHÍM",
      "script_name_unsigned":"KICH BAN BAM PHIM",
      "script_number":"166780",
      "greeting_id":"62da34652a310904dfbbf13b",
      "greeting_name":null,
      "greeting_short_id":"",
      "greeting_short_name":null,
      "note":null,
      "created_date":1663658446348,
      "created_by":{
         "id":"6209c98561c1cb163ded25fa",
         "name":"OMI Hotline"
      },
      "last_updated_date":1670644627322,
      "last_updated_by":{
         "id":"6209c98561c1cb163ded25fa",
         "name":"OMI Hotline"
      },
      "is_deleted":false,
      "scripts":[
         {
            "key":null,
            "action_type":"Ivr_menu",
            "action":"6391fa5f44b0fb4429b580c0",
            "action_name":null,
            "ivr":"1"
         },
         {
            "key":null,
            "action_type":"",
            "action":"",
            "action_name":null,
            "ivr":"5"
         }
      ],
      "time_out":3,
      "action_type":"",
      "action":"",
      "action_name":null,
      "invalid_sound_id":"6209c99b067f745da47367f3",
      "invalid_sound_name":null,
      "max_failure":1,
      "ivr_direct_menu_dial":"false"
   },
   "key_enabled":false
}

Cập nhật kịch bản bấm phím

POST [URL]/api/call_center/key-interaction/update/:id

Path Parameters

Name
Type
Description

id

String

Id kịch bản

Request Body

Name
Type
Description

script_name*

String

Tên kịch bản bấm phím

greeting_id*

String

Id file ghi âm

max_failure*

Integer

Số lần nhấn sai phím

time_out*

Integer

Thời gian chờ KH nhấn phím hoặc lời chào kết thúc

scripts*

Array

Danh sách mảng đối tượng phím

Cách loại kịch bản đi kèm với phím bấm. Thành phần là nhóm nội bộ

{

"ivr" : "", //Tên phím 1,2,3..

"action": "xxxxxxxx" // Id của nhóm nội bộ

"action_type":"Ring_group"

}

Thành phần là kịch bản bấm phím

{

"ivr" : "", //Tên phím 1,2,3..

"action": "xxxxxxxx" // Id Kịch bản bấm phím.

"action_type":"Ivr_menu"

}

action_type

String

Loại hành động khi không nhấn phím, hoặc nhấn sai phím quá số lần cho phép

Ring_group : Nhóm nội bộ

Ivr_menu : Kịch bản bấm phím

Recording : Lời chào

action

String

Id của hành động action_type theo các loại tương ứng

invalid_sound_id

String

Id của file ghi âm (Nhạc chờ khi nhấn sai phím)

greeting_short_id

String

Id của file ghi âm( Nhạc chờ khi trở lại tương tác bấm phím)

{
   "status_code":9999,
   "instance_id":"stg",
   "instance_version":"1.2.163",
   "payload":{
      "_id":"632969ce7534d97b0933d51d",
      "tenant_id":"6209c98461c1cb163ded25f7",
      "script_name":"KỊCH BẢN BẤM PHÍM",
      "script_name_unsigned":"KICH BAN BAM PHIM",
      "script_number":"166780",
      "greeting_id":"62da34652a310904dfbbf13b",
      "greeting_name":null,
      "greeting_short_id":"",
      "greeting_short_name":null,
      "note":null,
      "created_date":1663658446348,
      "created_by":{
         "id":"6209c98561c1cb163ded25fa",
         "name":"OMI Hotline"
      },
      "last_updated_date":1670644627322,
      "last_updated_by":{
         "id":"6209c98561c1cb163ded25fa",
         "name":"OMI Hotline"
      },
      "is_deleted":false,
      "scripts":[
         {
            "key":null,
            "action_type":"Ivr_menu",
            "action":"6391fa5f44b0fb4429b580c0",
            "action_name":null,
            "ivr":"1"
         },
         {
            "key":null,
            "action_type":"",
            "action":"",
            "action_name":null,
            "ivr":"5"
         }
      ],
      "time_out":3,
      "action_type":"",
      "action":"",
      "action_name":null,
      "invalid_sound_id":"6209c99b067f745da47367f3",
      "invalid_sound_name":null,
      "max_failure":1,
      "ivr_direct_menu_dial":"false"
   },
   "key_enabled":false
}

XOÁ kịch bản bấm phím

DELETE [URL]/api/call_center/key-interaction/delete/:id

Path Parameters

Name
Type
Description

id*

String

Id của kịch bản

Danh sách file ghi âm

GET [URL]/api/call_center/greeting/list

Query Parameters

Name
Type
Description

page*

Integer

Trang (bắt đầu từ 1)

size*

Integer

Kích thước trang (mặc định 10)


{
    "status_code": 9999,
    "instance_id": "stg",
    "instance_version": "1.2.163",
    "payload": {
        "items": [
            {
                "_id": "6391f975b4c5c92743725fa3",
                "created_date": 1670510965969,
                "last_updated_date": 1670510965977,
                "create_by": null,
                "last_update_by": null,
                "tenant_id": "6209c98461c1cb163ded25f7",
                "greeting_name": "Name 1",
                "greeting_name_unsigned": "name 1",
                "formality": "Robot đọc",
                "recording_file": "6c0d4c55-d837-4ae5-835e-c16180b09e51.mp3",
                "content": "Name 1",
                "voice": "banmai",
                "speed": 0,
                "is_deleted": false,
                "is_hidden_in_list": null
            },
            {
                "_id": "634944c8df71333e7787e03d",
                "created_date": 1665746120033,
                "last_updated_date": 1665746120033,
                "create_by": null,
                "last_update_by": null,
                "tenant_id": "6209c98461c1cb163ded25f7",
                "greeting_name": "Thêm mới thành công",
                "greeting_name_unsigned": "them moi thanh cong",
                "formality": "Robot đọc",
                "recording_file": "d1969275-e403-438f-935c-6425d1550692.mp3",
                "content": "Thêm mới thành công",
                "voice": "banmai",
                "speed": 0,
                "is_deleted": false,
                "is_hidden_in_list": null
            },
            {
                "_id": "634944a5823f5332401ec9c3",
                "created_date": 1665746085884,
                "last_updated_date": 1665746085884,
                "create_by": null,
                "last_update_by": null,
                "tenant_id": "6209c98461c1cb163ded25f7",
                "greeting_name": "Thêm mới",
                "greeting_name_unsigned": "them moi",
                "formality": "Robot đọc",
                "recording_file": "d8bc922b-cabf-4e28-8198-6021f5b82c14.mp3",
                "content": "Thêm mới thành công hay thất bại",
                "voice": "banmai",
                "speed": 0,
                "is_deleted": false,
                "is_hidden_in_list": null
            }
        ],
        "page_number": 1,
        "page_size": 3,
        "total_items": 13,
        "total_pages": 5,
        "has_next": true,
        "next_page": 2,
        "has_previous": false,
        "previous_page": 1,
        "extension": null
    },
    "key_enabled": false
}
```

Upload file ghi âm

POST [URL]/api/call_center/greeting/upload

Chú ý : Request là form-data và chỉ hỗ trợ mp3

Query Parameters

Name
Type
Description

greeting_name

String

Tên file

Request Body

Name
Type
Description

file*

Binary

Dữ liệu của file

Upload file ghi âm : Robot đọc (Text To Speech)

POST [URL]/api/call_center/greeting/upload-text-to-speech

Query Parameters

Name
Type
Description

greeting_name*

String

Tên file ghi âm

Request Body

Name
Type
Description

text*

String

Nội dung cần đọc <= 300 ký tự

speed*

String

Tốc độ đọc, Giá trị từ -3 - 3 - 3 : Cực kì chậm -2 : Rất chậm -1 : Chậm 0 : Bình thường 1 : Nhanh ...

voice*

String

Giọng đọc, có thể một trong các giá trị sau banmai : Giọng nữ miền Bắc leminh : Giọng nam miền Bắc lannhi : Giọng nữ miền Nam

{
    "status_code": 9999,
    "instance_id": "stg",
    "instance_version": "1.2.163",
    "payload": {
        "file": {
            "_id": "639981151ee2ed6f5bbeea90",
            "created_date": 1671004437213,
            "last_updated_date": 1671004437213,
            "create_by": null,
            "last_update_by": null,
            "tenant_id": "6209c98461c1cb163ded25f7",
            "greeting_name": "Nhắc lịch đào tạo",
            "greeting_name_unsigned": "Nhac lich dao tao",
            "formality": "Robot đọc",
            "recording_file": "a6c2edd9-9af1-4e71-98a7-657c3c1e0466.mp3",
            "content": "Bạn có một lịch họp sắp đến giờ, bạn vui lòng chú ý thời gian để đến đúng giờ",
            "voice": "banmai",
            "speed": 0,
            "is_deleted": false,
            "is_hidden_in_list": null
        }
    },
    "key_enabled": false
}
```

Xoá file ghi âm

DELETE [URL]/api/call_center/greeting/delete/:id

Path Parameters

Name
Type
Description

id*

String

Id file ghi âm

Danh sách kịch bản

GET [URL]/api/call_center/call_script/list?page=&size=

Danh sách kịch bản cuộc gọi

Headers

Name
Value

Content-Type

application/json

Authorization

Bearer <token>

Request Params

Name
Type
Description

page

Integer

Trang

size

Integer

Kích thước trang

Response

{
    "instance_id": "stg",
    "payload": {
        "items": [
            {
                "_id": "6333d3d3f4bfc27c57841093",
                "extension": "3638325",
                "created_date": 1664340947781,
                "last_updated_date": 1736159391976,
                "create_by": {
                    "id": "6209c98561c1cb163ded25fa",
                    "name": "Trần Văn Tiến"
                },
                "last_update_by": {
                    "id": "6209c98561c1cb163ded25fa",
                    "name": "Trần Văn Tiến"
                },
                "tenant_id": "6209c98461c1cb163ded25f7",
                "script_name": "Nhóm CSKH",
                "script_name_unsigned": "Nhom CSKH",
                "note": "",
                "is_deleted": false,
                "callscript_type": 0,
                "callscript_wait_time": 5,
                "scripts": [
                    {
                        "action_type": "Ring_group",
                        "action_id": "62ff119508d4bf3ea694a44a",
                        "order": 0,
                        "action_name": null,
                        "voice": null,
                        "callbot_script_uuid": null
                    }
                ],
                "enable_criteria": true,
                "criterias": [
                    {
                        "type": "2",
                        "wait_time": "10",
                        "timeout_time": "10"
                    }
                ]
            }
        ],
        "page_number": 1,
        "page_size": 10,
        "total_items": 1,
        "total_pages": 1,
        "has_next": false,
        "next_page": 1,
        "has_previous": false,
        "previous_page": 1,
        "extension": null
    },
    "instance_version": "1.2.164",
    "key_enabled": false,
    "status_code": 9999
}

Tạo mới kịch bản cuộc gọi

POST [URL]/api/call_center/call_script/add

Tạo mới kịch bản cuộc gọi

Headers

Name
Value

Content-Type

application/json

Authorization

Bearer <token>

Body

Name
Type
Description

name *

string

Tên kịch bản

note

string

Mô tả về kịch bản

scripts *

Array Object

[{
    "action_id":"",
    "action_type":""
 }]

Là thành phần bên trong kịch bản. Ví dụ khi cần chuyển tiếp tới nhân viên, nhóm , hoặc tương tác phím. Chúng được quy định bởi :

action_id : Là id của thành phần

action_type : Là loại thành phần : 

Extension : Tới nhân viên
Ivr_menu : Tương tác phím
Ring_group : Nhóm nội bộ
Recording : Lời chào

Response

{
    "instance_id": "stg",
    "payload": {
        "_id": "677cc34c7af28d0abf247aff",
        "extension": "4187167",
        "created_date": 1736229708336,
        "last_updated_date": 1736229708336,
        "create_by": {
            "id": "6209c98561c1cb163ded25fa",
            "name": "Trần Văn Tiến"
        },
        "last_update_by": null,
        "tenant_id": "6209c98461c1cb163ded25f7",
        "script_name": "KB demo Api",
        "script_name_unsigned": "KB demo Api",
        "note": "",
        "is_deleted": false,
        "callscript_type": 0,
        "callscript_wait_time": 5,
        "scripts": [
            {
                "action_type": "Ring_group",
                "action_id": "62ff119508d4bf3ea694a44a",
                "order": 0,
                "action_name": null,
                "voice": null,
                "callbot_script_uuid": null
            }
        ],
        "enable_criteria": false,
        "criterias": []
    },
    "instance_version": "1.2.164",
    "key_enabled": false,
    "status_code": 9999
}

Cập nhật kịch bản

PUT [URL]/api/call_center/call_script/update/:id

<Description of the endpoint>

Headers

Name
Value

Content-Type

application/json

Authorization

Bearer <token>

Path Parameters

id

string

Id của kịch bản cần cập nhật

Body

Name
Type
Description

name *

string

Tên kịch bản

note

string

Ghi chú về kịch bản

scripts *

Array Object

[{
    "action_id":"",
    "action_type":""
 }]

Là thành phần bên trong kịch bản. Ví dụ khi cần chuyển tiếp tới nhân viên, nhóm , hoặc tương tác phím. Chúng được quy định bởi :

action_id : Là id của thành phần

action_type : Là loại thành phần : 

Extension : Tới nhân viên
Ivr_menu : Tương tác phím
Ring_group : Nhóm nội bộ
Recording : Lời chào

Response

{
    "instance_id": "stg",
    "payload": {
        "_id": "677cc34c7af28d0abf247aff",
        "extension": "4187167",
        "created_date": 1736229708336,
        "last_updated_date": 1736229708336,
        "create_by": {
            "id": "6209c98561c1cb163ded25fa",
            "name": "Trần Văn Tiến"
        },
        "last_update_by": null,
        "tenant_id": "6209c98461c1cb163ded25f7",
        "script_name": "KB demo Api",
        "script_name_unsigned": "KB demo Api",
        "note": "",
        "is_deleted": false,
        "callscript_type": 0,
        "callscript_wait_time": 5,
        "scripts": [
            {
                "action_type": "Ring_group",
                "action_id": "62ff119508d4bf3ea694a44a",
                "order": 0,
                "action_name": null,
                "voice": null,
                "callbot_script_uuid": null
            }
        ],
        "enable_criteria": false,
        "criterias": []
    },
    "instance_version": "1.2.164",
    "key_enabled": false,
    "status_code": 9999
}

Xoá kịch bản cuộc gọi

DELETE [URL]/api/call_center/call_script/delete/:id

Xoá kịch bản cuộc gọi

Headers

Name
Value

Content-Type

application/json

Authorization

Bearer <token>

Path Parameters

Name
Type
Description

id

string

Name of the user

Response


{
    "instance_id": "stg",
    "payload": true,
    "instance_version": "1.2.164",
    "key_enabled": false,
    "status_code": 9999
}
Previousv2NextLịch sử cuộc gọi

Last updated