Интеграция с IP телефонией посредством API

  • API-телефония.pdf

Интеграция с IP телефонией, посредством API. Данный метод зависит от возможностей телефонного решения (популярные решения, например Asterisk поддерживают данные возможности). Суть метода следующая - на телефонной станции прописываются агенты HelpDesk системы. В момент, когда оператор поднимает телефонную трубку (физически), телефонная станция отправляет в HelpDeskEddy информацию об этом, и у агента, который поднял трубку, появляется окно-карточка звонка. С данного интерфейса есть возможность создать заявку, посмотреть информацию по клиенту. При создании заявки, телефонная станция приложит записанный телефонный звонок.

 

 С необходимыми методами и параметрами API для работы можно ознакомиться в прикреплённом файле.

 

Популярные вопросы:

1. Где взять переменную call_id?

  •  в данном методе GET | /api/v2/telephony/show_call/{phone_number}/users/{?user_ids} будет отдан call id.

 

2. Какого формата должен быть номер телефона {phone_number} при передаче?

  • Привязка звонка к пользователю осуществляется при помощи вхождения номера в эту строку. Указывать номер необходимо в полном формате используемом в системе, например 7XXXXXXXXX0 либо XXXXXXXXX0.

 

Пример для Asterisk 13:

 

exten => s,n,AGI(tech_support.agi,${id_number},${call_number})

Содержание /var/lib/asterisk/agi-bin/tech_support.agi

#!/usr/bin/env php
<?php

include("phpagi.php");

/**********************************************************************************************************************/
$agi = new AGI();
$id_number = $argv[2];
//$id_number = 1; // На этапе отладки можно выставлять id принудительно
$call_number = $argv[1];
$agi->verbose("Номер id сотрудника $id_number");
$agi->verbose("Номер телефона входящий клиента $call_number");

if( $curl = curl_init() ) {
	$url = 'https://*.helpdeskeddy.com/api/v2/telephony/show_call/call_number/users/id_number';
	//* - название вашей системы

	$url=str_replace("call_number",$call_number,$url);
	$url=str_replace("id_number",$id_number,$url);
	$headers = array(
    	'Authorization: Basic dHJldHl*********************************************',
	);
	curl_setopt($curl,CURLOPT_HTTPHEADER,$headers);
	curl_setopt($curl,CURLOPT_URL,$url);
	curl_setopt($curl,CURLOPT_RETURNTRANSFER,true);
	$out = curl_exec($curl);
	echo $out;
	curl_close($curl);
}
exit(0);
?>

 

IP телефония