Οι σύγχρονες επιχειρήσεις αντιλαμβάνονται τα σταθερά τηλέφωνα ως μια ξεπερασμένη τεχνολογία: οι κυψελοειδείς επικοινωνίες διασφαλίζουν την κινητικότητα και τη συνεχή διαθεσιμότητα των εργαζομένων, τα κοινωνικά δίκτυα και οι άμεσοι αγγελιοφόροι είναι ένα ευκολότερο και ταχύτερο κανάλι επικοινωνίας. Για να συμβαδίζουν με τους ανταγωνιστές τους, τα PBX γραφείου μοιάζουν όλο και περισσότερο με αυτά: μετακινούνται στο cloud, διαχειρίζονται μέσω μιας διεπαφής ιστού και ενσωματώνονται με άλλα συστήματα μέσω API. Σε αυτήν την ανάρτηση θα σας πούμε ποιες λειτουργίες έχει το εικονικό PBX API της Rostelecom και πώς να εργαστείτε με τις κύριες λειτουργίες του εικονικού PBX μέσω αυτού.
Το κύριο καθήκον του εικονικού PBX API της Rostelecom είναι η αλληλεπίδραση με το CRM ή τους ιστότοπους της εταιρείας. Για παράδειγμα, το API εφαρμόζει γραφικά στοιχεία "call back" και "call from site" για τα κύρια συστήματα διαχείρισης: WordPress, Bitrix, OpenCart. Το API επιτρέπει:
- Λήψη πληροφοριών, ειδοποίηση κατάστασης και πραγματοποίηση κλήσεων κατόπιν αιτήματος από εξωτερικό σύστημα.
- Λάβετε έναν προσωρινό σύνδεσμο για να καταγράψετε τη συνομιλία.
- Διαχείριση και λήψη παραμέτρων περιορισμού από χρήστες.
- Λάβετε πληροφορίες σχετικά με τον εικονικό χρήστη PBX.
- Ζητήστε το ιστορικό χρεώσεων και χρεώσεων κλήσεων.
- Μεταφόρτωση αρχείου καταγραφής κλήσεων.
Πώς λειτουργεί το API
Το API ενσωμάτωσης και το εξωτερικό σύστημα αλληλεπιδρούν μεταξύ τους χρησιμοποιώντας αιτήματα HTTP. Στον προσωπικό λογαριασμό, ο διαχειριστής ορίζει τις διευθύνσεις όπου θα πρέπει να φτάνουν τα αιτήματα στο API και όπου θα πρέπει να αποστέλλονται αιτήματα από το API. Το εξωτερικό σύστημα πρέπει να έχει μια δημόσια διεύθυνση προσβάσιμη από το Διαδίκτυο με εγκατεστημένο πιστοποιητικό SSL.
Επίσης στον προσωπικό λογαριασμό, ο διαχειριστής τομέα μπορεί να περιορίσει τις πηγές αιτημάτων κατά την πρόσβαση στο API μέσω IP.
Λαμβάνουμε πληροφορίες για εικονικούς χρήστες 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^_^]
}
]
Αυτή η μέθοδος περνά δύο πίνακες. Ένα με χρήστες τομέα, ένα με ομάδες τομέα. Η ομάδα έχει επίσης τη δυνατότητα να καθορίσει ένα email που θα σταλεί στο αίτημα.
Επεξεργασία πληροφοριών σχετικά με μια εισερχόμενη κλήση
Η σύνδεση της εταιρικής τηλεφωνίας με διάφορα συστήματα CRM εξοικονομεί χρόνο για τους υπαλλήλους που αλληλεπιδρούν με πελάτες και επιταχύνει την επεξεργασία των εισερχόμενων κλήσεων. Για παράδειγμα, σε μια κλήση από έναν τρέχοντα πελάτη, το CRM μπορεί να ανοίξει την κάρτα του και από το CRM μπορείτε να στείλετε μια κλήση στον πελάτη και να τον συνδέσετε με έναν υπάλληλο.
Για να λάβετε πληροφορίες σχετικά με τις κλήσεις API, πρέπει να χρησιμοποιήσετε τη μέθοδο /get_number_info, το οποίο δημιουργεί μια λίστα κλήσεων με πληροφορίες σχετικά με την ομάδα στην οποία διανέμεται η κλήση. Ας υποθέσουμε ότι ο εικονικός αριθμός 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":""
}
Στη συνέχεια, πρέπει να συνδέσετε τον χειριστή /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>"
}
Παρακολουθούμε την κατάσταση και κατεβάζουμε εγγραφές κλήσεων
Στο εικονικό PBX της Rostelecom, η εγγραφή κλήσεων ενεργοποιείται στον προσωπικό σας λογαριασμό. Χρησιμοποιώντας το API, μπορείτε να παρακολουθείτε την κατάσταση αυτής της λειτουργίας. Κατά την επεξεργασία ενός τερματισμού κλήσης σε call_events μπορείτε να δείτε τη σημαία 'is_record', που ειδοποιεί τον χρήστη για την κατάσταση της καταχώρισης: αληθής σημαίνει ότι η λειτουργία εγγραφής κλήσεων του χρήστη είναι ενεργοποιημένη.
Για να πραγματοποιήσετε λήψη μιας εγγραφής, πρέπει να χρησιμοποιήσετε το αναγνωριστικό περιόδου σύνδεσης κλήσης 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, ένα εικονικό PBX έχει πολλές άλλες χρήσιμες λειτουργίες που μπορείτε να χρησιμοποιήσετε. Για παράδειγμα, αυτό είναι ένα διαδραστικό μενού φωνής και η ενσωμάτωση κυψελοειδών και σταθερών επικοινωνιών.
Η διαδραστική φωνητική απόκριση (IVR) είναι αυτό που ακούμε στο ακουστικό πριν απαντήσει το άτομο. Ουσιαστικά πρόκειται για έναν ηλεκτρονικό χειριστή που ανακατευθύνει τις κλήσεις στα αρμόδια τμήματα και απαντά αυτόματα σε κάποιες ερωτήσεις. Σύντομα θα είναι δυνατή η εργασία με IVR μέσω του API: αυτήν τη στιγμή αναπτύσσουμε λογισμικό που θα σας επιτρέπει να παρακολουθείτε την πρόοδο μιας κλήσης μέσω του IVR και να λαμβάνετε πληροφορίες σχετικά με τα πλήκτρα αφής όταν ο συνδρομητής βρίσκεται στο φωνητικό μενού.
Για να μεταφέρετε εταιρική τηλεφωνία σε κινητά τηλέφωνα, μπορείτε είτε να χρησιμοποιήσετε εφαρμογές softphone είτε να ενεργοποιήσετε ξεχωριστά την υπηρεσία Fixed Mobile Convergence (FMC). Με οποιαδήποτε από τις μεθόδους, οι κλήσεις εντός του δικτύου είναι δωρεάν, καθίσταται δυνατή η εργασία με σύντομους αριθμούς και οι κλήσεις μπορούν να καταγράφονται και να τηρούνται γενικά στατιστικά στοιχεία για αυτούς.
Η διαφορά είναι ότι τα softphone χρειάζονται το Διαδίκτυο για να επικοινωνήσουν, αλλά δεν είναι συνδεδεμένα με έναν χειριστή, ενώ το FMC είναι συνδεδεμένο με έναν συγκεκριμένο χειριστή, αλλά μπορεί να χρησιμοποιηθεί ακόμη και σε παλιά τηλέφωνα με κουμπιά.
Πηγή: www.habr.com