Орчин үеийн бизнесүүд суурин утсыг хуучирсан технологи гэж үздэг: үүрэн холбоо нь ажилчдын хөдөлгөөн, байнгын бэлэн байдлыг хангадаг, нийгмийн сүлжээ, шуурхай мессенжерүүд нь илүү хялбар, хурдан харилцааны суваг юм. Өрсөлдөгчдөөсөө хоцрохгүйн тулд оффисын PBX-ууд тэдэнтэй илүү төстэй болж байна: тэд үүлэн рүү шилжиж, вэб интерфэйсээр удирдаж, API-ээр дамжуулан бусад системүүдтэй нэгтгэж байна. Энэ нийтлэлд бид Rostelecom виртуал PBX API нь ямар функцтэй, түүгээр дамжуулан виртуал PBX-ийн үндсэн функцуудтай хэрхэн ажиллах талаар танд хэлэх болно.
Rostelecom виртуал PBX API-ийн гол ажил бол CRM эсвэл компанийн вэбсайтуудтай харилцах явдал юм. Жишээлбэл, API нь WordPress, Bitrix, OpenCart гэсэн үндсэн удирдлагын системд зориулсан "буцааж дуудах" болон "сайтаас дуудлага хийх" виджетүүдийг хэрэгжүүлдэг. API нь дараах боломжийг олгодог:
- Мэдээлэл хүлээн авах, статусаа мэдэгдэх, гадны системээс хүсэлт гаргаснаар дуудлага хийх;
- Харилцан яриаг бичих түр зуурын холбоос авах;
- Хэрэглэгчээс хязгаарлалтын параметрүүдийг удирдах, хүлээн авах;
- Виртуал PBX хэрэглэгчийн тухай мэдээлэл авах;
- Дуудлагын дебит болон төлбөрийн түүхийг хүсэх;
- Дуудлагын бүртгэлийг байршуулах.
API хэрхэн ажилладаг
Интеграцийн API болон гадаад систем нь HTTP хүсэлтийг ашиглан бие биетэйгээ харилцдаг. Хувийн дансанд администратор нь API-д хүсэлт ирэх, API-аас хүсэлт илгээх хаягийг тохируулдаг. Гадны систем нь суулгасан SSL сертификаттай интернетээс хандах боломжтой нийтийн хаягтай байх ёстой.
Мөн хувийн дансанд домэйн администратор нь IP-ээр API руу нэвтрэх үед хүсэлтийн эх үүсвэрийг хязгаарлаж болно.
Бид виртуал PBX хэрэглэгчдийн талаарх мэдээллийг хүлээн авдаг
Хэрэглэгчид эсвэл бүлгүүдийн жагсаалтыг авахын тулд та энэ аргыг ашиглан виртуал PBX руу хүсэлт илгээх хэрэгтэй /хэрэглэгчийн_мэдээлэл.
{
"domain":"example.ru"
}
Үүний хариуд та хадгалах боломжтой жагсаалтыг хүлээн авах болно.
{
"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^_^]
}
]
Энэ арга нь хоёр массивыг дамжуулдаг. Нэг нь домэйн хэрэглэгчидтэй, нэг нь домайн бүлгүүдтэй. Бүлэг нь хүсэлтэд илгээгдэх имэйлийг зааж өгөх боломжтой.
Ирж буй дуудлагын талаарх мэдээллийг боловсруулж байна
Байгууллагын утсыг янз бүрийн CRM системд холбох нь үйлчлүүлэгчидтэй харилцах ажилчдын цагийг хэмнэж, ирж буй дуудлагын боловсруулалтыг хурдасгадаг. Жишээлбэл, одоогийн үйлчлүүлэгчийн дуудлагад CRM нь түүний картыг нээх боломжтой бөгөөд CRM-ээс та үйлчлүүлэгч рүү дуудлага илгээж, түүнийг ажилтантай холбож болно.
API дуудлагын талаар мэдээлэл авахын тулд та энэ аргыг ашиглах хэрэгтэй /тоо_мэдээлэл авах, энэ нь дуудлага түгээж буй бүлгийн талаарх мэдээлэл бүхий дуудлагын жагсаалтыг үүсгэдэг. Виртуал PBX дугаар 1234567890 дугаараас ирж буй дуудлагыг хүлээн авлаа гэж бодъё. Дараа нь PBX дараах хүсэлтийг илгээнэ.
{
"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":""
}
Дараа нь та зохицуулагчийг холбох хэрэгтэй /тоо_мэдээлэл авах. Дуудлага дамжуулахаас өмнө ирж буй шугам дээр ирж буй дуудлага ирэх үед хүсэлтийг гүйцэтгэх ёстой. Хэрэв заасан хугацаанд хүсэлтийн хариу ирээгүй бол дуудлагыг домэйнд тогтоосон дүрмийн дагуу дамжуулна.
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;
Зохицуулагчийн хариу.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Бид статусыг хянаж, дуудлагын бичлэгийг татаж авдаг
Ростелекомын виртуал PBX-д дуудлагын бичлэгийг таны хувийн дансанд идэвхжүүлсэн. API ашиглан та энэ функцийн статусыг хянах боломжтой. Дуудлагын тасалбарыг боловсруулах үед дуудлага_үйл явдал туг харж болно "бичлэг", Энэ нь оруулгын статусын талаар хэрэглэгчдэд мэдэгдэнэ: үнэн хэрэглэгчийн дуудлага бичих функц идэвхжсэн гэсэн үг.
Бичлэг татаж авахын тулд та дуудлагын сесс ID-г ашиглах шаардлагатай session_id хаяг руу хүсэлт илгээнэ үү api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Үүний хариуд та харилцан ярианы бичлэг бүхий файлыг татаж авах түр зуурын холбоосыг хүлээн авах болно.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Файл хадгалах хугацааг таны хувийн дансны тохиргоонд тохируулсан болно. Үүний дараа файл устах болно.
Статистик, тайлан
Тусдаа хуудсан дээрх хувийн дансандаа та бүх дуудлагын статистик, тайланг харж, статус, цаг хугацаагаар шүүлтүүрийг ашиглах боломжтой. API-ээр дамжуулан та эхлээд аргын тусламжтайгаар дуудлагыг боловсруулах ёстой /дуудлагын_үйл явдал:
{
"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"
}
Дараа нь аргыг дууд дуудлагын_мэдээлэл массивыг боловсруулж, дуудлагыг CRM системд харуулах.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Үүний хариуд та 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":""
}
}
Бусад ашигтай виртуал PBX функцууд
API-аас гадна виртуал PBX нь таны ашиглаж болох өөр хэд хэдэн ашигтай функцуудтай. Жишээлбэл, энэ нь интерактив дуут цэс, үүрэн болон суурин холболтыг нэгтгэх явдал юм.
Интерактив дуут хариу (IVR) нь тухайн хүн хариулахаас өмнө гар утсан дээр сонсдог зүйл юм. Үндсэндээ энэ нь дуудлагыг зохих хэлтэс рүү шилжүүлж, зарим асуултанд автоматаар хариулдаг цахим оператор юм. Удалгүй API-ээр дамжуулан IVR-тай ажиллах боломжтой болно: бид одоогоор IVR-ээр дамжуулан дуудлагын явцыг хянах, захиалагч дуут цэсэнд байгаа үед мэдрэгчтэй товчлуурын даралтын талаарх мэдээллийг авах боломжтой програм хангамжийг боловсруулж байна.
Байгууллагын утсыг гар утас руу шилжүүлэхийн тулд та программ хангамж ашиглах эсвэл суурин хөдөлгөөнт холболт (FMC) үйлчилгээг тусад нь идэвхжүүлж болно. Аль ч аргын тусламжтайгаар сүлжээн дэх дуудлага үнэ төлбөргүй, богино дугаартай ажиллах боломжтой болж, дуудлагыг бүртгэж, ерөнхий статистикийг хадгалах боломжтой болно.
Ялгаа нь гэвэл программ утас нь холбогдоход интернет хэрэгтэй ч оператортой холбогддоггүй, харин FMC нь тодорхой оператортой холбоотой байдаг ч хуучин товчлууртай утсанд ч ашиглах боломжтой.
Эх сурвалж: www.habr.com