Les entreprises modernes perçoivent les téléphones fixes comme une technologie obsolète : les communications cellulaires assurent la mobilité et la disponibilité constante des employés, les réseaux sociaux et les messageries instantanées constituent un canal de communication plus simple et plus rapide. Pour rivaliser avec leurs concurrents, les PBX de bureau leur ressemblent de plus en plus : ils migrent vers le cloud, gérés via une interface web et intégrés à d'autres systèmes via API. Dans cet article, nous vous expliquerons les fonctions de l'API du PBX virtuel Rostelecom et comment utiliser les principales fonctions du PBX virtuel via celle-ci.
La tâche principale de l'API du PBX virtuel Rostelecom est l'interaction avec le CRM ou les sites Web de l'entreprise. Par exemple, l'API implémente des widgets « rappel » et « appel depuis le site » pour les principaux systèmes de gestion : WordPress, Bitrix, OpenCart. L'API permet :
- Recevoir des informations, notifier l'état et passer des appels sur demande depuis un système externe ;
- Obtenez un lien temporaire pour enregistrer la conversation ;
- Gérer et recevoir les paramètres de restriction des utilisateurs ;
- Obtenir des informations sur l'utilisateur du PBX virtuel ;
- Demander l'historique des débits et frais d'appels ;
- Téléchargez le journal des appels.
Comment fonctionne l'API
L'API d'intégration et le système externe interagissent les uns avec les autres à l'aide de requêtes HTTP. Dans le compte personnel, l'administrateur définit les adresses où les requêtes vers l'API doivent arriver et où les requêtes de l'API doivent être envoyées. Le système externe doit disposer d'une adresse publique accessible depuis Internet avec un certificat SSL installé.
Toujours dans le compte personnel, l'administrateur du domaine peut limiter les sources de requêtes lors de l'accès à l'API par IP.
Nous recevons des informations sur les utilisateurs du PBX virtuel
Pour obtenir une liste d'utilisateurs ou de groupes, vous devez envoyer une requête au PBX virtuel en utilisant la méthode /utilisateurs_info.
{
"domain":"example.ru"
}
En réponse, vous recevrez une liste que vous pourrez sauvegarder.
{
"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^_^]
}
]
Cette méthode transmet deux tableaux. Un avec les utilisateurs du domaine, un avec les groupes de domaine. Le groupe a également la possibilité de préciser un email qui sera envoyé dans la demande.
Traitement des informations sur un appel entrant
La connexion de la téléphonie d'entreprise à divers systèmes CRM fait gagner du temps aux employés qui interagissent avec les clients et accélère le traitement des appels entrants. Par exemple, lors d'un appel d'un client actuel, CRM peut ouvrir sa carte, et depuis CRM, vous pouvez envoyer un appel au client et le mettre en relation avec un employé.
Чтобы получить информацию о вызовах через API, нужно использовать метод /get_number_info, qui génère une liste d'appels avec des informations sur le groupe auquel l'appel est distribué. Supposons que le numéro du PBX virtuel reçoive un appel entrant du numéro 1234567890. Ensuite, le PBX enverra la requête suivante :
{
"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":""
}
Ensuite, vous devez connecter le gestionnaire /get_number_info. La demande doit être exécutée lorsqu'un appel entrant arrive sur la ligne entrante avant que les appels ne soient acheminés. Si une réponse à une demande n'est pas reçue dans le délai imparti, l'appel est alors acheminé selon les règles établies dans le domaine.
Exemple de gestionnaire côté 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;
Réponse du gestionnaire.
{
"result":0,
"resultMessage":"Абонент найден",
"displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}
Nous suivons le statut et téléchargeons les enregistrements d'appels
Dans le PBX virtuel de Rostelecom, l'enregistrement des appels est activé dans votre compte personnel. À l'aide de l'API, vous pouvez suivre l'état de cette fonction. Lors du traitement d'une terminaison d'appel dans call_events tu peux voir le drapeau 'est_enregistrement', qui informe l'utilisateur du statut de l'entrée : oui signifie que la fonction d'enregistrement des appels de l'utilisateur est activée.
Pour télécharger un enregistrement, vous devez utiliser l'ID de session d'appel session_id envoyer une demande à api.cloudpbx.rt.ru/get_record.
{
"session_id":"SDsnZugDFmTW7Sec"
}
En réponse, vous recevrez un lien temporaire pour télécharger un fichier avec un enregistrement de la conversation.
{
"result": ^_^quot�quot^_^,
"resultMessage": "Операция выполнена успешно",
"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}
La durée de stockage des fichiers est définie dans les paramètres de votre compte personnel. Ensuite, le fichier sera supprimé.
Statistiques et reporting
Dans votre compte personnel, sur une page séparée, vous pouvez consulter les statistiques et les rapports sur tous les appels et appliquer des filtres par statut et heure. Via l'API, vous devez d'abord traiter l'appel avec la méthode /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"
}
Puis appelez la méthode appel_info pour traiter le tableau et afficher l'appel dans le système CRM.
{
"session_id":"SDsnZugDFmTW7Sec"
}
En réponse, vous recevrez un ensemble de données pouvant être traitées pour stocker des données dans le journal 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":""
}
}
Autres fonctionnalités utiles du PBX virtuel
Outre l'API, un PBX virtuel possède plusieurs autres fonctionnalités utiles que vous pouvez utiliser. Par exemple, il s'agit d'un menu vocal interactif et de l'intégration des communications cellulaires et fixes.
La réponse vocale interactive (IVR) est ce que nous entendons sur le combiné avant que la personne ne réponde. Il s'agit essentiellement d'un opérateur électronique qui redirige les appels vers les services appropriés et répond automatiquement à certaines questions. Bientôt, il sera possible de travailler avec l'IVR via l'API : nous développons actuellement un logiciel qui vous permettra de suivre la progression d'un appel via l'IVR et de recevoir des informations sur les frappes au clavier lorsque l'abonné est dans le menu vocal.
Pour transférer la téléphonie d'entreprise vers les téléphones mobiles, vous pouvez soit utiliser des applications de téléphonie logicielle, soit activer séparément le service Fixe Mobile Convergence (FMC). Quelle que soit l'une des méthodes, les appels au sein du réseau sont gratuits, il devient possible de travailler avec des numéros courts, les appels peuvent être enregistrés et des statistiques générales peuvent être tenues à leur sujet.
La différence est que les softphones ont besoin d'Internet pour communiquer, mais ils ne sont pas liés à un opérateur, tandis que FMC est lié à un opérateur spécifique, mais peut être utilisé même sur les anciens téléphones à bouton-poussoir.
Source: habr.com