Як просто інтегрувати свою телефонію?

За допомогою нового REST API для телефонії ви зможете реалізувати будь-які сценарії користувача

  • Розмова з клієнтом
    Показ картки дзвінка менеджеру, відповідальному за клієнта

  • Черга обробки дзвінка
    Одночасна і послідовна черга обробки вхідного дзвінка

  • Групова комунікація
    Перенаправлення дзвінка між співробітниками

  • Записи розмов і звіти
    Збереження запису дзвінка в CRM і стандартних звітах


Інтеграція в 3 кроки!

Ми максимально спростили створення інтеграцій з вашою телефонією

  1. 1. всього 4 методи REST
    Новий API для телефонії включає всього 4 методи та одну подію! Можна вивчити за 15 хвилин!

  2. 2. OAuth не потрібен!
    Замість складного механізму аутентифікації можна використовувати вебхукі до призначених для користувача паролями!

  3. 3. Будь-які сценарії
    Поступово ускладнюйте сценарії інтеграції від базових до найскладніших!

Як зв'язати вхідний дзвінок з Бітрікс24?

Базовий сценарій інтеграції

  • Всього один метод REST API
    Додайте вхідний вебхук для методу telephony.externalcall.register

  • Автодовідка для розробника
    При додаванні вебхука, Бітрік24 підкаже параметри і дасть уже готовий URL для виклику з боку вашої телефонії. Більше нічого не потрібно!

  • Автоматичне створення ліда
    Якщо вхідний номер не записаний в CRM, то Бітрікс24 автоматично створить лід і метод поверне його ідентифікатор!

  • Автоматичний пошук клієнтів у CRM
    Якщо відповідний лід, контакт або компанія є в CRM, то метод повідомить про це вам!

<?php

$queryUrl = 'https://xxx.bitrix24.ua/rest/1/yyyyxxx000111/telephony.externalcall.register.json';
$queryData = http_build_query(array(
'USER_ID' => 1,
'PHONE_NUMBER' => '555666777',
'TYPE' => 2,
'CALL_START_DATE' => '2016-16-11 10:10',
'CRM_CREATE' => true
));

$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_SSL_VERIFYPEER => 0,
CURLOPT_POST => 1,
CURLOPT_HEADER => 0,
CURLOPT_RETURNTRANSFER => 1,
CURLOPT_URL => $queryUrl,
CURLOPT_POSTFIELDS => $queryData,
));

$result = curl_exec($curl);
curl_close($curl);

$result = json_decode($result, 1);

Як поєднати вашу чергу обробки дзвінка з Бітрікс24?

Будь-яка логіка черги!

  • Всього два методи REST API
    Додайте вхідні вебхуки для методів telephony.externalcall.show и telephony.externalcall.hide

  • Будь-який принцип обробки черги
    Показуйте картку дзвінка за потрібне користувачам одночасно або по черзі, викликаючи вебхук telephony.externalcall.show, і сховайте картки в потрібний момент за допомогою telephony.externalcall.hide

<?php

$queryUrl = 'https://xxx.bitrix24.ua/rest/1/yyyyxxx000111/telephony.externalcall.hide.json';
$queryData = http_build_query(array(
'CALL_ID' => 'externalCall.a2fc40b56aa869141cc6aa2d2a965ba6.1478527542', //береться з telephony.externalcall.register
'USER_ID' => 1 // прибираємо картку у користувача 1
));

$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_SSL_VERIFYPEER => 0,
CURLOPT_POST => 1,
CURLOPT_HEADER => 0,
CURLOPT_RETURNTRANSFER => 1,
CURLOPT_URL => $queryUrl,
CURLOPT_POSTFIELDS => $queryData,
));

$result = curl_exec($curl);
curl_close($curl);

$queryUrl = 'https://xxx.bitrix24.ua/rest/1/yyyyxxx000111/telephony.externalcall.show.json';
$queryData = http_build_query(array(
'CALL_ID' => 'externalCall.a2fc40b56aa869141cc6aa2d2a965ba6.1478527542', //береться з telephony.externalcall.register,
'USER_ID' => 6 //показуємо картку користувачу 6
));

$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_SSL_VERIFYPEER => 0,
CURLOPT_POST => 1,
CURLOPT_HEADER => 0,
CURLOPT_RETURNTRANSFER => 1,
CURLOPT_URL => $queryUrl,
CURLOPT_POSTFIELDS => $queryData,
));

$result = curl_exec($curl);
curl_close($curl);

Як користувач зможе зателефонувати з Бітрікс24?

Дзвінки прямо з CRM!

  • Всього одна подія REST API
    Додайте вихідний вебхук для події OnExternalCallStart 

  • Користувач натискає на дзвінок прямо в Бітрікс24
    Коли користувач натисне на телефонний номер клієнта прямо в інтерфейсі Бітрікс24, вебхук повідомить номер вихідного дзвінка вашої АТС

  • Запускайте дзвінок!
    Вам залишиться тільки запустити вихідний дзвінок на стороні вашої телефонії!

вкажіть url вашого обробника в налаштуваннях вихідного webhook
https://your_server/your_webhook_script.php


код обробника
<?php

/*

Бітрікс24 передає в обробник $ _REQUEST з даними:

array(
'PHONE_NUMBER' => '555666777', //номер, на який телефонує користувач Бітрікс24
'USER_ID' => '1', //користувач, який телефонує з інтерфейсу Бітрікс24
'CRM_ENTITY_TYPE' => 'LEAD', //тип об'єкту CRM, з картки якого телефонує користувач Бітрікс24
'CRM_ENTITY_ID' => '248' //ID об'єкта CRM, з картки якого телефонує користувач Бітрікс24
)
*/

// реєструємо вихідний дзвінок
$queryUrl = 'https://xxx.bitrix24.ru/rest/1/yyyyxxx000111/telephony.externalcall.register.json';
$queryData = http_build_query(array(
'USER_ID' => $_REQUEST['USER_ID'],
'PHONE_NUMBER' => $_REQUEST['USER_ID'],
'TYPE' => 1, // вихідний дзвінок
'CALL_START_DATE' => '2016-16-11 10:10',
'CRM_CREATE' => false,
'CRM_ENTITY_TYPE' => $_REQUEST['CRM_ENTITY_TYPE'],
'CRM_ENTITY_ID' => $_REQUEST['CRM_ENTITY_ID']
));

$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_SSL_VERIFYPEER => 0,
CURLOPT_POST => 1,
CURLOPT_HEADER => 0,
CURLOPT_RETURNTRANSFER => 1,
CURLOPT_URL => $queryUrl,
CURLOPT_POSTFIELDS => $queryData,
));

$result = curl_exec($curl);
curl_close($curl);

$result = json_decode($result, 1);

Як зберегти дзвінок у Бітрікс24?

Дані про дзвінки прямо в інтерфейсі CRM!

  • Всього один метод REST API
    Додайте вхідний вебхук для методу telephony.externalcall.finish

  • Просте додавання дзвінка
    Коли розмова завершена, викличте вебхук, вказавши дані досконалого дзвінка - тривалість і статус

  • Зберігання та прослуховування записів у Бітрікс24
    Ви можете дати посилання на запис дзвінка і Бітрікс24 автоматично завантажить його в CRM!

  • Стандартні звіти з телефонії
    Можна навіть вказати вартість дзвінка, щоб користувачі могли оптимізувати свою роботу!

<?php

$queryUrl = 'https://xxx.bitrix24.ua/rest/1/yyyyxxx000111/telephony.externalcall.finish.json';
$queryData = http_build_query(array(
'CALL_ID' => 'externalCall.733e885003cbac98d92b811806caeaea.1478528885', //береться з telephony.externalcall.register
'DURATION' => '120', //тривалість дзвінка в секундах
'STATUS_CODE' => 200, //успішний дзвінок
'RECORD_URL' => 'http://your_server/call_record.mp3', //url на запис дзвінка для збереження у Бітрікс24
));

$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_SSL_VERIFYPEER => 0,
CURLOPT_POST => 1,
CURLOPT_HEADER => 0,
CURLOPT_RETURNTRANSFER => 1,
CURLOPT_URL => $queryUrl,
CURLOPT_POSTFIELDS => $queryData,
));

$result = curl_exec($curl);
curl_close($curl);

$result = json_decode($result, 1);

Недостатньо можливостей webhooks?

Прочитайте документацію та подивіться готовий приклад створення локального застосунку