Doanh nghiệp hiện đại coi điện thoại cố định là một công nghệ lỗi thời: thông tin liên lạc di động đảm bảo tính di động và tính sẵn sàng liên tục của nhân viên, mạng xã hội và tin nhắn tức thời là kênh liên lạc dễ dàng và nhanh hơn. Để theo kịp các đối thủ cạnh tranh, các tổng đài văn phòng ngày càng trở nên giống chúng: chúng chuyển sang đám mây, được quản lý thông qua giao diện web và tích hợp với các hệ thống khác thông qua API. Trong bài đăng này, chúng tôi sẽ cho bạn biết API PBX ảo Rostelecom có những chức năng gì và cách hoạt động với các chức năng chính của PBX ảo thông qua nó.
Nhiệm vụ chính của API PBX ảo Rostelecom là tương tác với các trang web CRM hoặc công ty. Ví dụ: API triển khai các tiện ích “gọi lại” và “gọi từ trang web” cho các hệ thống quản lý chính: WordPress, Bitrix, OpenCart. API cho phép:
- Nhận thông tin, thông báo trạng thái và thực hiện cuộc gọi theo yêu cầu từ hệ thống bên ngoài;
- Nhận liên kết tạm thời để ghi lại cuộc trò chuyện;
- Quản lý và nhận các thông số hạn chế từ người dùng;
- Lấy thông tin về người dùng PBX ảo;
- Yêu cầu lịch sử ghi nợ và cước cuộc gọi;
- Tải lên nhật ký cuộc gọi.
API hoạt động như thế nào
API tích hợp và hệ thống bên ngoài tương tác với nhau bằng các yêu cầu HTTP. Trong tài khoản cá nhân, quản trị viên đặt địa chỉ nơi các yêu cầu tới API sẽ đến và nơi sẽ gửi yêu cầu từ API. Hệ thống bên ngoài phải có địa chỉ công cộng có thể truy cập được từ Internet với chứng chỉ SSL được cài đặt.
Ngoài ra trong tài khoản cá nhân, quản trị viên miền có thể giới hạn nguồn yêu cầu khi truy cập API bằng IP.
Chúng tôi nhận được thông tin về người dùng PBX ảo
Để có được danh sách người dùng hoặc nhóm, bạn cần gửi yêu cầu đến tổng đài ảo bằng phương thức /users_info.
{
"domain":"example.ru"
}
Đáp lại, bạn sẽ nhận được một danh sách mà bạn có thể lưu.
{
"result":0,
"resultMessage":"",
"users":[
{
"display_name":"test_user_1",
"name":"admin",
"pin":^_^quotʚquot^_^,
"is_supervisor":true,
"is_operator":false,
"email":"[email protected]","recording":1
},
{
"display_name":"test_user_2",
"name":"test",
"pin":^_^quotʿquot^_^,
"is_supervisor":true,
"is_operator":false,
"email":"",
"recording":1
}
],
"groups":
[
{
"name":"testAPI",
"pin":^_^quotǴquot^_^,
"email":"[email protected]",
"distribution":1,
"users_list":[^_^quotʚquot^_^,^_^quotʿquot^_^]
}
]
Phương thức này truyền hai mảng. Một với người dùng miền, một với nhóm miền. Nhóm cũng có cơ hội chỉ định email sẽ được gửi trong yêu cầu.
Xử lý thông tin về cuộc gọi đến
Kết nối điện thoại của công ty với các hệ thống CRM khác nhau giúp tiết kiệm thời gian cho nhân viên tương tác với khách hàng và tăng tốc quá trình xử lý các cuộc gọi đến. Ví dụ: khi có cuộc gọi từ khách hàng hiện tại, CRM có thể mở thẻ của khách hàng đó và từ CRM, bạn có thể gửi cuộc gọi đến khách hàng và kết nối họ với nhân viên.
Để nhận thông tin về lệnh gọi API, bạn cần sử dụng phương thức /get_number_info, tạo danh sách cuộc gọi có thông tin về nhóm mà cuộc gọi được phân phối. Giả sử rằng số PBX ảo nhận được cuộc gọi đến từ số 1234567890. Sau đó, PBX sẽ gửi yêu cầu sau:
{
"session_id":"SDsnZugDFmTW7Sec",
"timestamp":"2019-12-27 15:34:44.461",
"type":"incoming",
"state":"new",
"from_number":"sip:</i^_^gt�lt&i;gt^_^@192.168.0.1",
"from_pin":"",
"request_number":"sip:</i^_^gt�lt&i;gt^_^@1192.168.0.1",
"request_pin":^_^quotɟquot^_^,
"disconnect_reason":"",
"is_record":""
}
Tiếp theo bạn cần kết nối trình xử lý /get_number_info. Yêu cầu phải được thực hiện khi có cuộc gọi đến trên đường dây đến trước khi cuộc gọi được định tuyến. Nếu không nhận được phản hồi cho yêu cầu trong thời gian quy định thì cuộc gọi sẽ được định tuyến theo các quy tắc được thiết lập trong miền.
Ví dụ về trình xử lý ở phía CRM.
if ($account) {
$data = [
'result' => 0,
'resultMessage' => 'Абонент найден',
'displayName' => $account->name,
//'PIN' => $crm_users,
];
}
else
{
$data = [
'result' => 0,
'resultMessage' => 'Абонент не найден',
'displayName' => 'Неизвестный абонент '.$contact,
//'PIN' => crm_users,
];
}
return $data;
Phản hồi từ người xử lý.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Chúng tôi theo dõi trạng thái và tải xuống bản ghi cuộc gọi
Trong tổng đài ảo của Rostelecom, ghi âm cuộc gọi được kích hoạt trong tài khoản cá nhân của bạn. Sử dụng API, bạn có thể theo dõi trạng thái của chức năng này. Khi xử lý việc chấm dứt cuộc gọi trong cuộc gọi_sự kiện bạn có thể thấy lá cờ 'là_bản ghi', thông báo cho người dùng về trạng thái của mục nhập: đúng có nghĩa là chức năng ghi âm cuộc gọi của người dùng đã được bật.
Để tải xuống bản ghi, bạn cần sử dụng ID phiên cuộc gọi phiên_id gửi yêu cầu đến api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Đáp lại, bạn sẽ nhận được một liên kết tạm thời để tải xuống tệp có bản ghi cuộc trò chuyện.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Thời gian lưu trữ file được cài đặt trong cài đặt tài khoản cá nhân của bạn. Sau đó tập tin sẽ bị xóa.
Thống kê và báo cáo
Trong tài khoản cá nhân của bạn trên một trang riêng, bạn có thể xem số liệu thống kê và báo cáo về tất cả các cuộc gọi cũng như áp dụng các bộ lọc theo trạng thái và thời gian. Thông qua API, trước tiên bạn phải xử lý cuộc gọi bằng phương thức /call_events:
{
"session_id":"SDsnZugDFmTW7Sec",
"timestamp":"2019-12-27 15:34:59.349",
"type":"incoming",
"state":"end",
"from_number":"sip:</i^_^gt�lt&i;gt^_^@192.168.0.1",
"from_pin":"",
"request_number":"sip:</i^_^gt�lt&i;gt^_^@192.168.0.1",
"request_pin":^_^quotʚquot^_^,
"disconnect_reason":"",
"is_record":"true"
}
Sau đó gọi phương thức cuộc gọi_thông tin để xử lý mảng và hiển thị cuộc gọi trong hệ thống CRM.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Đáp lại, bạn sẽ nhận được một mảng dữ liệu có thể được xử lý để lưu trữ dữ liệu trong nhật ký CRM.
{
"result":0,
"resultMessage":"",
"info":
{
"call_type":1,
"direction":1,
"state":1,
"orig_number":"sip:</i^_^gt�lt&i;gt^_^@192.168.0.1",
"orig_pin":null,
"dest_number":"sip:</i^_^gt�lt&i;gt^_^@192.168.0.1",
"answering_sipuri":"[email protected]",
"answering_pin":^_^quotɟquot^_^,
"start_call_date":^_^quot�quot^_^,
"duration":14,
"session_log":"0:el:123456789;0:ru:admin;7:ct:admin;9:cc:admin;14:cd:admin;",
"is_voicemail":false,
"is_record":true,
"is_fax":false,
"status_code":^_^quot�quot^_^,
"status_string":""
}
}
Các tính năng PBX ảo hữu ích khác
Ngoài API, PBX ảo còn có một số tính năng hữu ích khác mà bạn có thể sử dụng. Ví dụ: đây là menu thoại tương tác và tích hợp liên lạc di động và cố định.
Phản hồi bằng giọng nói tương tác (IVR) là những gì chúng ta nghe thấy trên thiết bị cầm tay trước khi người đó trả lời. Về cơ bản, đây là một nhà điều hành điện tử chuyển hướng cuộc gọi đến các bộ phận thích hợp và tự động trả lời một số câu hỏi. Sẽ sớm có thể hoạt động với IVR thông qua API: chúng tôi hiện đang phát triển phần mềm cho phép bạn theo dõi tiến trình cuộc gọi thông qua IVR và nhận thông tin về các lần nhấn phím cảm ứng khi người đăng ký ở trong menu thoại.
Để chuyển điện thoại công ty sang điện thoại di động, bạn có thể sử dụng ứng dụng điện thoại mềm hoặc kích hoạt riêng dịch vụ Hội tụ Di động Cố định (FMC). Với bất kỳ phương pháp nào, các cuộc gọi trong mạng đều miễn phí, có thể hoạt động với các số ngắn và các cuộc gọi có thể được ghi lại và số liệu thống kê chung có thể được lưu giữ trên chúng.
Sự khác biệt là softphone cần Internet để liên lạc nhưng chúng không bị ràng buộc với một nhà điều hành, trong khi FMC được gắn với một nhà điều hành cụ thể nhưng có thể được sử dụng ngay cả trên điện thoại nút bấm cũ.
Nguồn: www.habr.com