Вхід
Ваш Бітрікс24
Авторизуйтеся, щоб увійти
до Бітрікс24 вашої компанії.
Вхід

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

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

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

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

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

  1. всього 4 методи REST
    Новий API для телефонії включає всього 4 методи та одну подію! Можна вивчити за 15 хвилин!
  2. OAuth не потрібен!
    Замість складного механізму аутентифікації можна використовувати вебхукі до призначених для користувача паролями!
  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?

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