🥇Rostelecom PBX וירטואלי: מה ואיך אפשר לעשות דרך ה-API

עסקים מודרניים תופסים טלפונים קוויים כטכנולוגיה מיושנת: תקשורת סלולרית מבטיחה ניידות וזמינות מתמדת של עובדים, רשתות חברתיות ומשדרים מיידיים הם ערוץ תקשורת קל ומהיר יותר. כדי לעמוד בקצב של המתחרים שלהם, מרכזיות משרדיות הופכות יותר ויותר דומות להן: הן עוברות לענן, מנוהלות באמצעות ממשק אינטרנט ומשולבות במערכות אחרות באמצעות API. בפוסט זה נספר לכם אילו פונקציות יש ל-Rostelecom Virtual PBX API וכיצד לעבוד עם הפונקציות העיקריות של ה- PBX הווירטואלי באמצעותו.

המשימה העיקרית של ה-API של PBX הוירטואלי של Rostelecom היא אינטראקציה עם CRM או אתרי חברה. לדוגמה, ה-API מיישם ווידג'טים של "התקשר בחזרה" ו"התקשר מאתר" עבור מערכות הניהול העיקריות: WordPress, Bitrix, OpenCart. ה-API מאפשר:

קבלת מידע, הודעה על סטטוס וביצוע שיחות לפי בקשה ממערכת חיצונית;
קבל קישור זמני להקלטת השיחה;
נהל וקבל פרמטרי הגבלה ממשתמשים;
השג מידע על משתמש המרכזיה הוירטואלית;
בקש את ההיסטוריה של חיובים וחיובים בשיחות;
העלה יומן שיחות.

איך עובד ה-API

ה-API של האינטגרציה והמערכת החיצונית מקיימים אינטראקציה זה עם זה באמצעות בקשות HTTP. בחשבון האישי, מנהל המערכת מגדיר את הכתובות לאן צריכות להגיע בקשות ל-API ולאן יש לשלוח בקשות מה-API. למערכת החיצונית חייבת להיות כתובת ציבורית הנגישה מהאינטרנט עם אישור SSL מותקן.

גם בחשבון האישי, מנהל הדומיין יכול להגביל את מקורות הבקשות בעת גישה ל-API באמצעות IP.

אנו מקבלים מידע על משתמשי מרכזיות וירטואליות

כדי לקבל רשימה של משתמשים או קבוצות, צריך לשלוח בקשה למרכזייה הוירטואלית בשיטה /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, עליך להשתמש בשיטה /get_number_info, אשר יוצר רשימת שיחות עם מידע על הקבוצה שאליה מופצת השיחה. נניח שמספר המרכזיה הוירטואלית מקבל שיחה נכנסת מהמספר 1234567890. ואז המרכזייה תשלח את הבקשה הבאה:

{
        "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":""
}

לאחר מכן עליך לחבר את המטפל /get_number_info. יש לבצע את הבקשה כאשר שיחה נכנסת מגיעה לקו הנכנס לפני ניתוב השיחות. במידה ולא מתקבלת תגובה לבקשה תוך הזמן הנקוב, השיחה מנותבת לפי הכללים שנקבעו בתחום.

דוגמה למטפל בצד ה-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, הקלטת שיחות מופעלת בחשבון האישי שלך. באמצעות ה-API, אתה יכול לעקוב אחר המצב של פונקציה זו. בעת עיבוד סיום שיחה ב שיחה_אירועים אתה יכול לראות את הדגל 'זה_שיא', אשר מודיע למשתמש על מצב הערך: נָכוֹן פירושו שפונקציית הקלטת השיחות של המשתמש מופעלת.

כדי להוריד הקלטה, עליך להשתמש במזהה הפעלת השיחה 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, תחילה עליך לעבד את הקריאה בשיטה /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"
        }

אז תקרא לשיטה call_info לעיבוד המערך והצגת השיחה במערכת ה-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, למרכזייה וירטואלית יש עוד כמה תכונות שימושיות בהן תוכלו להשתמש. כך למשל, מדובר בתפריט קולי אינטראקטיבי ושילוב תקשורת סלולרית ונייחת.

תגובה קולית אינטראקטיבית (IVR) היא מה שאנו שומעים במכשיר לפני שהאדם עונה. בעיקרו של דבר, מדובר במפעיל אלקטרוני שמפנה שיחות למחלקות המתאימות ועונה על כמה שאלות באופן אוטומטי. בקרוב ניתן יהיה לעבוד עם IVR דרך ה-API: אנו מפתחים כעת תוכנה שתאפשר לכם לעקוב אחר התקדמות השיחה דרך ה-IVR ולקבל מידע על הקשות בטון מגע כאשר המנוי נמצא בתפריט הקולי.

כדי להעביר טלפוניה ארגונית לטלפונים ניידים, אתה יכול להשתמש ביישומי softphone או להפעיל בנפרד את שירות התכנסות ניידת קבועה (FMC). בכל אחת מהשיטות, השיחות בתוך הרשת הן בחינם, מתאפשרת עבודה עם מספרים קצרים, ניתן להקליט שיחות ולשמור עליהן סטטיסטיקות כלליות.

ההבדל הוא שמכשירי softphone זקוקים לאינטרנט כדי לתקשר, אך הם אינם קשורים למפעיל, בעוד FMC קשור למפעיל ספציפי, אלא ניתן להשתמש בהם אפילו בטלפונים ישנים עם כפתור.

מקור: www.habr.com

מרכזיה וירטואלית של Rostelecom: מה ואיך ניתן לעשות באמצעות API