Mae busnesau modern yn gweld ffonau llinell dir fel technoleg hen ffasiwn: mae cyfathrebu cellog yn sicrhau symudedd ac argaeledd cyson gweithwyr, mae rhwydweithiau cymdeithasol a negeswyr gwib yn sianel gyfathrebu haws a chyflymach. Er mwyn cadw i fyny â'u cystadleuwyr, mae PBXs swyddfa yn dod yn fwy a mwy tebyg iddynt: maent yn symud i'r cwmwl, yn cael eu rheoli trwy ryngwyneb gwe ac wedi'u hintegreiddio â systemau eraill trwy API. Yn y swydd hon byddwn yn dweud wrthych pa swyddogaethau sydd gan API PBX rhithwir Rostelecom a sut i weithio gyda phrif swyddogaethau'r PBX rhithwir drwyddo.
Prif dasg API PBX rhithwir Rostelecom yw rhyngweithio â gwefannau CRM neu gwmnïau. Er enghraifft, mae'r API yn gweithredu teclynnau “galw yn ôl” a “galwad o'r safle” ar gyfer y prif systemau rheoli: WordPress, Bitrix, OpenCart. Mae'r API yn caniatáu:
- Derbyn gwybodaeth, hysbysu statws a gwneud galwadau ar gais gan system allanol;
- Cael dolen dros dro i recordio'r sgwrs;
- Rheoli a derbyn paramedrau cyfyngu gan ddefnyddwyr;
- Cael gwybodaeth am y defnyddiwr PBX rhithwir;
- Gofyn am hanes debydau galwadau a thaliadau;
- Llwythwch i fyny log galwadau.
Sut mae'r API yn gweithio
Mae'r API integreiddio a'r system allanol yn rhyngweithio â'i gilydd gan ddefnyddio ceisiadau HTTP. Yn y cyfrif personol, mae'r gweinyddwr yn gosod y cyfeiriadau lle dylai ceisiadau i'r API gyrraedd a lle dylid anfon ceisiadau gan yr API. Rhaid i'r system allanol gael cyfeiriad cyhoeddus sy'n hygyrch o'r Rhyngrwyd gyda thystysgrif SSL wedi'i gosod.
Hefyd yn y cyfrif personol, gall gweinyddwr y parth gyfyngu ar ffynonellau ceisiadau wrth gyrchu'r API trwy IP.
Rydym yn derbyn gwybodaeth am ddefnyddwyr PBX rhithwir
I gael rhestr o ddefnyddwyr neu grwpiau, mae angen i chi anfon cais at y PBX rhithwir gan ddefnyddio'r dull /defnyddwyr_gwybodaeth.
{
"domain":"example.ru"
}
Mewn ymateb, byddwch yn derbyn rhestr y gallwch ei chadw.
{
"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^_^]
}
]
Mae'r dull hwn yn pasio dwy arae. Un gyda defnyddwyr parth, un gyda grwpiau parth. Mae gan y grŵp hefyd y cyfle i nodi e-bost a fydd yn cael ei anfon yn y cais.
Prosesu gwybodaeth am alwad sy'n dod i mewn
Mae cysylltu teleffoni corfforaethol â systemau CRM amrywiol yn arbed amser i weithwyr sy'n rhyngweithio â chleientiaid ac yn cyflymu prosesu galwadau sy'n dod i mewn. Er enghraifft, ar alwad gan gleient presennol, gall CRM agor ei gerdyn, ac o CRM gallwch anfon galwad at y cleient a'i gysylltu â gweithiwr.
I gael gwybodaeth am alwadau API, mae angen i chi ddefnyddio'r dull /cael_rhif_gwybodaeth, sy'n cynhyrchu rhestr o alwadau gyda gwybodaeth am y grŵp y dosberthir yr alwad iddo. Gadewch i ni dybio bod y rhif PBX rhithwir yn derbyn galwad gan y rhif 1234567890. Yna bydd y PBX yn anfon y cais canlynol:
{
"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":""
}
Nesaf mae angen i chi gysylltu'r triniwr /cael_rhif_gwybodaeth. Rhaid gweithredu'r cais pan fydd galwad sy'n dod i mewn yn cyrraedd y llinell sy'n dod i mewn cyn i'r galwadau gael eu cyfeirio. Os na dderbynnir ymateb i gais o fewn yr amser penodedig, yna caiff yr alwad ei chyfeirio yn unol â'r rheolau a sefydlwyd yn y parth.
Enghraifft o driniwr ar yr ochr 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;
Ymateb gan y triniwr.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Rydym yn olrhain y statws ac yn lawrlwytho recordiadau galwadau
Yn PBX rhithwir Rostelecom, mae recordio galwadau yn cael ei actifadu yn eich cyfrif personol. Gan ddefnyddio'r API, gallwch olrhain statws y swyddogaeth hon. Wrth brosesu terfyniad galwad i mewn digwyddiadau_galwad gallwch weld y faner 'yn_record', sy'n hysbysu'r defnyddiwr am statws y cofnod: yn wir yn golygu bod swyddogaeth recordio galwadau'r defnyddiwr wedi'i alluogi.
I lawrlwytho recordiad, mae angen i chi ddefnyddio ID y sesiwn alwad sesiwn_id anfon cais i api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Mewn ymateb, byddwch yn derbyn dolen dros dro i lawrlwytho ffeil gyda recordiad o'r sgwrs.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
Mae'r amser storio ffeiliau wedi'i osod yn eich gosodiadau cyfrif personol. Wedi hynny bydd y ffeil yn cael ei dileu.
Ystadegau ac adrodd
Yn eich cyfrif personol ar dudalen ar wahân gallwch weld ystadegau ac adroddiadau ar bob galwad a chymhwyso hidlwyr yn ôl statws ac amser. Trwy'r API, yn gyntaf rhaid i chi brosesu'r alwad gyda'r dull /digwyddiadau_galwad:
{
"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"
}
Yna ffoniwch y dull galwad_gwybodaeth i brosesu'r arae ac arddangos yr alwad yn y system CRM.
{
"session_id":"SDsnZugDFmTW7Sec"
}
Mewn ymateb, byddwch yn derbyn amrywiaeth o ddata y gellir eu prosesu i storio data yn y log 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":""
}
}
Nodweddion rhithwir PBX defnyddiol eraill
Heblaw am yr API, mae gan PBX rhithwir nifer o nodweddion defnyddiol eraill y gallwch eu defnyddio. Er enghraifft, mae hwn yn ddewislen llais rhyngweithiol ac integreiddio cyfathrebu cellog a sefydlog.
Ymateb Llais Rhyngweithiol (IVR) yw'r hyn a glywn ar y ffôn cyn i'r person ateb. Yn y bôn, gweithredwr electronig yw hwn sy'n ailgyfeirio galwadau i'r adrannau priodol ac yn ateb rhai cwestiynau yn awtomatig. Cyn bo hir bydd yn bosibl gweithio gydag IVR trwy'r API: rydym ar hyn o bryd yn datblygu meddalwedd a fydd yn eich galluogi i olrhain cynnydd galwad trwy'r IVR a derbyn gwybodaeth am drawiadau tôn cyffwrdd pan fydd y tanysgrifiwr yn y ddewislen llais.
I drosglwyddo teleffoni corfforaethol i ffonau symudol, gallwch naill ai ddefnyddio cymwysiadau ffonau meddal neu actifadu'r gwasanaeth Cydgyfeirio Symudol Sefydlog (FMC) ar wahân. Gydag unrhyw un o'r dulliau, mae galwadau o fewn y rhwydwaith yn rhad ac am ddim, daw'n bosibl gweithio gyda rhifau byr, a gellir recordio galwadau a chadw ystadegau cyffredinol arnynt.
Y gwahaniaeth yw bod angen y Rhyngrwyd ar ffonau meddal i gyfathrebu, ond nid ydynt yn gysylltiedig â gweithredwr, tra bod FMC wedi'i glymu i weithredwr penodol, ond gellir ei ddefnyddio hyd yn oed ar hen ffonau botwm gwthio.
Ffynhonnell: hab.com