Moderne Unternehmen empfinden Festnetztelefone als veraltete Technologie: Mobilkommunikation sorgt für Mobilität und ständige Verfügbarkeit der Mitarbeiter, soziale Netzwerke und Instant Messenger sind ein einfacher und schnellerer Kommunikationskanal. Um mit den Mitbewerbern Schritt zu halten, werden Office-PBX-Anlagen immer ähnlicher: Sie gehen in die Cloud, werden über das Webinterface verwaltet und über die API in andere Systeme integriert. In diesem Beitrag erfahren Sie, über welche Funktionen die virtuelle PBX-API von Rostelecom verfügt und wie Sie mit den Grundfunktionen einer virtuellen PBX arbeiten.
Die Hauptaufgabe der virtuellen PBX-API von Rostelecom besteht in der Interaktion mit CRM- oder Unternehmensstandorten. Beispielsweise enthält die API Widgets "Rückruf" und "Aufruf von der Site" für die wichtigsten Steuerungssysteme: WordPress, Bitrix, OpenCart. Mit der API können Sie:
- Erhalten Sie Informationen, informieren Sie sich über den Status und tätigen Sie Anrufe auf Anfrage von einem externen System.
- Erhalten Sie einen temporären Link zur Gesprächsaufzeichnung.
- Verwalten und Empfangen von Einschränkungseinstellungen von Benutzern.
- Informationen über den Benutzer einer virtuellen TK-Anlage abrufen;
- Fordern Sie eine Liste der Gebühren und Gebühren bei Anrufen an.
- Anrufliste herunterladen.
Wie die API funktioniert
Die Integrations-API und das externe System interagieren über HTTP-Anforderungen miteinander. In Ihrem persönlichen Konto legt der Administrator die Adressen fest, an die Anforderungen an die API gesendet werden sollen. Das externe System muss über eine öffentliche Adresse verfügen, auf die über das Internet zugegriffen werden kann, und ein SSL-Zertifikat muss installiert sein.
Außerdem kann der Domänenadministrator in Ihrem persönlichen Konto die IP-Quellen von Anforderungen beim Zugriff auf die API einschränken.
Wir erhalten Informationen über die Benutzer der virtuellen TK-Anlage
Um eine Liste der Benutzer oder Gruppen zu erhalten, müssen Sie mit der Methode
/ users_info eine Anforderung an die virtuelle
TK-Anlage senden .
{ "domain":"example.ru" }
Es wird eine Liste zurückgegeben, die Sie speichern können.
{ "result":0, "resultMessage":"", "users":[ { "display_name":"test_user_1", "name":"admin", "pin":^_^quotʚquot^_^, "is_supervisor":true, "is_operator":false, "email":"test_user_1@mail.gov","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":"Ivanov@mail.gov", "distribution":1, "users_list":[^_^quotʚquot^_^,^_^quotʿquot^_^] } ]
Bei dieser Methode werden zwei Arrays übergeben. Einer mit Domänenbenutzern, einer mit Domänengruppen. Die Gruppe kann auch die E-Mail angeben, die in der Anforderung gesendet wird.
Wir verarbeiten Informationen über einen eingehenden Anruf
Durch die Anbindung der Unternehmenstelefonie an verschiedene CRM-Systeme sparen Mitarbeiter Zeit bei der Interaktion mit Kunden und beschleunigen die Verarbeitung eingehender Anrufe. Beispielsweise kann CRM bei einem Anruf vom aktuellen Kunden seine Karte öffnen, und Sie können von CRM aus einen Anruf an den Kunden senden und ihn mit dem Mitarbeiter verbinden.
Um Informationen zu Aufrufen über die API
abzurufen , müssen Sie die Methode
/ get_number_info verwenden, mit der eine Anrufliste mit Informationen zu der Gruppe erstellt wird, an die der Anruf verteilt wird. Angenommen, ein eingehender Anruf von der Nummer 1234567890 ist bei der virtuellen PBX-Nummer angekommen, dann wird eine Anfrage von der PBX gesendet:
{ "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":"" }
Als Nächstes müssen Sie den Handler
/ get_number_info verbinden. Die Anforderung muss ausgeführt werden, wenn ein eingehender Anruf auf einer eingehenden Leitung eingeht, bevor Anrufe weitergeleitet werden. Wenn die Antwort auf die Anforderung nicht innerhalb der festgelegten Zeit eingeht, wird der Anruf gemäß den in der Domäne festgelegten Regeln weitergeleitet.
Beispielhandler auf der CRM-Seite.
if ($account) { $data = [ 'result' => 0, 'resultMessage' => ' ', 'displayName' => $account->name, //'PIN' => $crm_users, ]; } else { $data = [ 'result' => 0, 'resultMessage' => ' ', 'displayName' => ' '.$contact, //'PIN' => crm_users, ]; } return $data;
Die Antwort des Handlers.
{ "result":0, "resultMessage":" ", "displayName":" +1</i> 234-56-78-90<i>" }
Wir überwachen den Status und laden Gesprächsaufzeichnungen herunter
In der virtuellen Telefonzentrale von Rostelecom ist die Aufzeichnung von Gesprächen in Ihrem persönlichen Konto aktiviert. Mit der API können Sie den Status dieser Funktion verfolgen. Wenn Sie die
Anrufbeendigung in
call_events verarbeiten, sehen Sie das Flag
'is_record', das den Benutzer über den Aufzeichnungsstatus
informiert :
true bedeutet, dass der Benutzer die Gesprächsaufzeichnungsfunktion
aktiviert hat .
Um einen Datensatz herunterzuladen, müssen Sie eine Anforderung an
api.cloudpbx.rt.ru/get_record senden,
wobei Sie die Sitzungs-ID des Aufrufs
session_id verwenden .
{ "session_id":"SDsnZugDFmTW7Sec" }
Die Antwort ist ein temporärer Link zum Herunterladen der Gesprächsaufzeichnungsdatei.
{ "result": ^_^quot�quot^_^, "resultMessage": " ", "url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036" }
Die Dateispeicherzeit wird in den Einstellungen Ihres persönlichen Kontos festgelegt. Nachdem die Datei gelöscht wurde.
Statistik und Berichterstattung
In Ihrem Konto auf einer separaten Seite können Sie Statistiken und Berichte für alle Anrufe anzeigen und Filter nach Status und Uhrzeit anwenden. Über die API müssen Sie den Aufruf zunächst mit der Methode
/ call_events verarbeiten :
{ "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" }
Rufen Sie dann die Methode
call_info auf, um das Array zu verarbeiten und den Aufruf im CRM-System anzuzeigen.
{ "session_id":"SDsnZugDFmTW7Sec" }
Die Antwort besteht aus einem Array von Daten, die zum Speichern von Daten im CRM-Protokoll verarbeitet werden können.
{ "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":"admin@example.ru", "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":"" } }
Weitere nützliche Funktionen der virtuellen Telefonanlage
Neben der API verfügt die virtuelle TK-Anlage über einige weitere nützliche Funktionen, die Sie verwenden können. Dies ist beispielsweise ein interaktives Sprachmenü und eine Kombination aus Mobilfunk- und Festnetzkommunikation.
Interactive Voice Response (IVR) ist das, was wir im Empfänger hören, bevor eine Person antwortet. Tatsächlich ist dies ein elektronischer Operator, der Anrufe an die entsprechenden Abteilungen umleitet und einige der Fragen automatisch beantwortet. In Kürze wird es möglich sein, mit IVR über die API zu arbeiten: Jetzt entwickeln wir eine Software, mit der Sie den Fortschritt eines Anrufs über IVR verfolgen und Informationen zu Tastenanschlägen erhalten können, wenn sich der Anrufer im Sprachmenü befindet.
Um Unternehmenstelefonie auf Mobiltelefone zu übertragen, können Sie entweder Softphone-Anwendungen verwenden oder den FMC-Dienst (Fixed Mobile Convergence) separat verbinden. Mit jeder der Methoden sind Anrufe innerhalb des Netzes kostenlos, es ist möglich, mit Kurznummern zu arbeiten, und Anrufe können aufgezeichnet und allgemeine Statistiken darüber geführt werden.
Der Unterschied besteht darin, dass Softphones für die Kommunikation das Internet benötigen, jedoch nicht an einen Operator gebunden sind. FMC ist an einen bestimmten Operator gebunden, kann jedoch auch auf älteren Tastentelefonen verwendet werden.