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

ВЕБ-ЗАСТОСУНКИ

Мобільний застосунок

Десктоп-застосунок

Меню

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

Розмова з клієнтом
Показ картки дзвінка менеджеру, відповідальному за клієнта
Черга обробки дзвінка
Одночасна і послідовна черга обробки вхідного дзвінка
Групова комунікація
Перенаправлення дзвінка між співробітниками
Записи розмов і звіти
Збереження запису дзвінка в CRM і стандартних звітах

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

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

всього 4 методи REST
Новий API для телефонії включає всього 4 методи та одну подію! Можна вивчити за 15 хвилин!
OAuth не потрібен!
Замість складного механізму аутентифікації можна використовувати вебхукі до призначених для користувача паролями!
Будь-які сценарії
Поступово ускладнюйте сценарії інтеграції від базових до найскладніших!

Як зв'язати вхідний дзвінок з Бітрікс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?

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