ఆధునిక వ్యాపారం ల్యాండ్‌లైన్ ఫోన్‌లను పాత సాంకేతికతగా పరిగణిస్తుంది: సెల్యులార్ కమ్యూనికేషన్‌లు చలనశీలత మరియు ఉద్యోగుల స్థిరమైన లభ్యతను నిర్ధారిస్తాయి, సోషల్ నెట్‌వర్క్‌లు మరియు ఇన్‌స్టంట్ మెసెంజర్‌లు సులభమైన మరియు వేగవంతమైన కమ్యూనికేషన్ ఛానెల్. వారి పోటీదారులతో సన్నిహితంగా ఉండటానికి, ఆఫీసు 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కి అభ్యర్థనను పంపాలి /users_info.
{
"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>"
}
మేము స్థితిని ట్రాక్ చేస్తాము మరియు కాల్ రికార్డింగ్‌లను డౌన్‌లోడ్ చేస్తాము
Rostelecom యొక్క వర్చువల్ PBXలో, మీ వ్యక్తిగత ఖాతాలో కాల్ రికార్డింగ్ సక్రియం చేయబడింది. APIని ఉపయోగించి, మీరు ఈ ఫంక్షన్ స్థితిని ట్రాక్ చేయవచ్చు. కాల్ రద్దును ప్రాసెస్ చేస్తున్నప్పుడు కాల్_ఈవెంట్స్ మీరు జెండాను చూడవచ్చు 'ఇజ్_రికార్డ్', ఇది ఎంట్రీ స్థితి గురించి వినియోగదారుకు తెలియజేస్తుంది: నిజమైన వినియోగదారు కాల్ రికార్డింగ్ ఫంక్షన్ ప్రారంభించబడిందని అర్థం.
రికార్డింగ్‌ను డౌన్‌లోడ్ చేయడానికి, మీరు కాల్ సెషన్ 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 ద్వారా, మీరు ముందుగా కాల్‌ను పద్ధతితో ప్రాసెస్ చేయాలి /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"
}
అప్పుడు పద్ధతి కాల్ కాల్_సమాచారం శ్రేణిని ప్రాసెస్ చేయడానికి మరియు 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