Інтеграція з Binotel
Binotel — віртуальна АТС для бізнесу. Після підключення до Skynum ви отримуєте журнал дзвінків із записами розмов, картку вхідного дзвінка з інформацією про клієнта ще до підняття слухавки, дзвінок в один клік, автоматичні завдання на пропущені дзвінки, розумну маршрутизацію на відповідального менеджера і аналітику дзвінків.
Тут — тільки підключення Binotel. Що телефонія дає в щоденній роботі (картка виклику, журнал, завдання за пропущеними, аналітика), описано в розділі Телефонія.
Підключення складається з трьох частин: отримати ключі доступу від підтримки Binotel, створити інтеграцію і зіставити співробітників у Skynum, надіслати підтримці Binotel адресу вебхука.
Що потрібно підготувати
- активний кабінет Binotel з підключеним номером;
- внутрішні лінії співробітників (901, 902 і далі), які вже налаштовані в Binotel і приймають дзвінки;
- доступ до поштової скриньки, на яку зареєстровано кабінет Binotel — підтримка Binotel приймає запити щодо інтеграції тільки з неї.
Ключі доступу від Binotel
Ключі для інтеграції видає підтримка Binotel. Надішліть листа на [email protected] з пошти, на яку зареєстровано кабінет:
Тема: Отримання авторизаційних даних для REST API
Добрий день!
Надайте, будь ласка, дані для інтеграції з CRM: API Key, API Secret і Company ID.
Дякую.
У відповідь підтримка надішле три значення. У Skynum вони вставляються так:
- API Key — у поле API ключ;
- API Secret — у поле Токен;
- Company ID — у поле ID проєкту.
Не пересилайте API Key і API Secret у листуванні з третіми особами і не публікуйте на скриншотах — вони дають програмний доступ до вашої АТС.
Що зробити в Skynum
- Відкрийте Налаштування → Інтеграції → Телефонія.
- Натисніть Додати інтеграцію.
- Виберіть Binotel.
- Заповніть Назва інтеграції.
- Увімкніть Інтеграція активна.
- За потреби виберіть Філія, юридична особа.
- У полі API ключ вставте API Key з листа Binotel.
- У полі Токен вставте API Secret.
- У полі ID проєкту вставте Company ID.
- Натисніть Перевірити підключення.
- Якщо перевірка успішна, збережіть інтеграцію.
Збережена інтеграція показує внизу сторінки поле Webhook URL (вставте у кабінет телефонії). Для Binotel ця адреса йде в лист до підтримки, а не в кабінет — скопіюйте її.
Автоматичне завдання для пропущеного дзвінка увімкнене від початку: на кожен пропущений вхідний дзвінок Skynum створюватиме завдання передзвонити. Якщо такий сценарій вам не потрібен, вимкніть перемикач.
Коли телефоній кілька, дзвінок в один клік іде через ту, що позначена За замовчуванням, — поставте позначку на потрібній.
Співробітники телефонії у Skynum
Щоб Skynum розумів, хто зі співробітників прийняв або здійснив дзвінок, зіставте користувачів Skynum зі співробітниками Binotel:
- В інтеграції відкрийте вкладку API мапінг.
- У секції Співробітники телефонії навпроти кожного користувача виберіть його запис з довідника Binotel. Якщо список порожній, натисніть Завантажити з Binotel.
- Збережіть мапінг.
У довіднику є ті співробітники Binotel, у яких налаштована внутрішня лінія. Якщо співробітника в списку немає, додайте йому внутрішню лінію в кабінеті Binotel і натисніть Завантажити з Binotel ще раз.
Що зробити в Binotel
Вебхук подій дзвінків
Вебхук повідомляє Skynum про початок, відповідь і завершення кожного дзвінка — завдяки йому картка дзвінка з'являється в момент виклику, а розмова потрапляє в журнал одразу після завершення. У кабінеті Binotel вебхук не налаштовується — його встановлює підтримка Binotel за листом.
Надішліть листа на [email protected] з пошти, на яку зареєстровано кабінет, і вставте в нього Webhook URL з інтеграції:
Тема: Підключення вебхука для інтеграції з CRM
Добрий день!
Поміняйте, будь ласка, webhook для методів API CALL SETTINGS, API CALL COMPLETED і API PUSH на:
<Webhook URL з інтеграції Skynum>Також встановіть у сценарії наших номерів першим кроком дзвінок на відповідального по методу API CALL SETTINGS.
Дякую.
Адреса одна для всіх трьох методів. Другий абзац листа вмикає розумну маршрутизацію — про неї нижче. Підтримка відповість, коли все встановлено — після цього переходьте до перевірки.
Розумна маршрутизація на відповідального менеджера
Skynum підказує Binotel, кому направити вхідний дзвінок: якщо клієнт закріплений за відповідальним менеджером, дзвінок піде спочатку саме йому. Докладніше про логіку — у статті Розумна маршрутизація.
У кабінеті Binotel для цього нічого не налаштовується: крок «дзвінок на відповідального по методу API CALL SETTINGS» додає в сценарій номера підтримка Binotel — саме про нього другий абзац листа про вебхук. Якщо вебхук уже встановлений, надішліть підтримці окремий лист лише з цим проханням.
Коли підказки немає — номер невідомий, у клієнта немає відповідального або він не зіставлений у API мапінгу, — дзвінок іде далі звичайним сценарієм номера. Окремих запасних кроків додавати не потрібно. Щоб дзвінок дійшов до відповідального, його внутрішня лінія має бути в мережі.
Дзвінок в один клік
Працює одразу після зіставлення співробітників, без налаштувань у кабінеті Binotel: першою дзвонить внутрішня лінія менеджера, і щойно він підняв слухавку, Binotel набирає клієнта. Як користуватися — у статті Дзвінок в один клік.
Записи розмов
Записи розмов зберігаються в Binotel. Skynum отримує запис у момент, коли співробітник натискає відтворення в журналі або в картці клієнта, — окремо нічого налаштовувати не потрібно.
Перевірка після підключення
Починайте після листа від підтримки Binotel про встановлений вебхук.
- Зателефонуйте з мобільного на номер компанії і прийміть виклик. Під час дзвінка у Skynum має відкритися картка з вашим номером, після завершення — рядок у журналі Телефонія → Журнал дзвінків зі співробітником, який відповів, і записом, що відтворюється.
- Зателефонуйте ще раз і не відповідайте. У завданнях має з'явитися «Передзвонити» з вашим номером (якщо перемикач Автоматичне завдання для пропущеного дзвінка не вимкнений).
- Відкрийте картку будь-якого контрагента з телефоном, натисніть номер і виберіть Дзвінок. Першою має задзвонити ваша внутрішня лінія, потім — клієнт.
- Призначте контрагенту з вашим мобільним номером відповідального менеджера і зателефонуйте ще раз: першою має задзвонити лінія саме цього менеджера, а не перший крок звичайного сценарію.
Типові проблеми
Дзвінки з'являються в журналі із затримкою, а картка дзвінка не показується
Підтримка Binotel ще не встановила вебхук або встановила іншу адресу. Skynum регулярно синхронізує журнал дзвінків з Binotel, тому розмови потрапляють у журнал і без вебхука, але картка дзвінка в момент виклику з'являється лише після його встановлення. Напишіть підтримці Binotel ще раз і вставте в лист Webhook URL саме з цієї інтеграції.
Дзвінок від клієнта з відповідальним іде за звичайним сценарієм
Підтримка Binotel ще не додала в сценарій номера крок дзвінка на відповідального — надішліть їй лист із цим проханням. Якщо крок додано, перевірте, що відповідальний менеджер зіставлений на вкладці API мапінг і його внутрішня лінія в мережі.
У дзвінку не визначається співробітник
Відкрийте вкладку API мапінг і перевірте, що користувачу вибрано його запис з довідника Binotel. Якщо запису немає в списку, натисніть Завантажити з Binotel.
Перевірка підключення не проходить
Перевірте, що API Key вставлено в поле API ключ, API Secret — у поле Токен, а Company ID — у поле ID проєкту, без зайвих пробілів. Усі три значення мають бути з одного листа підтримки Binotel.