Help Center Інтеграція з Bitrix24

Інтеграція з Bitrix24

Встановіть додаток SMSBAT Messenger у вашому Bitrix24, щоб надсилати Viber та SMS повідомлення безпосередньо з Контакт-центру Bitrix24. Цей посібник охоплює покрокове встановлення та налаштування.

Огляд

Інтеграція SMSBAT з Bitrix24 дозволяє:

  • Надсилати повідомлення Viber клієнтам прямо з інтерфейсу Bitrix24.
  • Використовувати резервне SMS (SMS Fallback), якщо повідомлення у Viber не доставлено (напр. у клієнта немає інтернету або вимкнений Viber).
  • Керувати розсилками через офіційний Контакт-центр Bitrix24.
  • Підключати SMSBAT як канал Відкритих Ліній (Open Line).

Передумови

  • Активний обліковий запис у SMSBAT (разом із вашим API ключем).
  • Акаунт Bitrix24 із правами адміністратора.
  • Зареєстроване ім’я відправника (From Name) (Альфа-ім’я) в системі SMSBAT.

Встановлення

Крок 1: Відкрийте розділ Розробникам (Developers)

У своєму боковому меню Bitrix24 перейдіть до Застосунки > Розробникам.

Меню Bitrix24 — Застосунки > Розробникам

Крок 2: Перейдіть на вкладку “Інше” (Other)

У розділі для розробників перейдіть на вкладку Інше (Other), щоб знайти додаткові типи застосунків.

Розділ для розробників — вкладка Інше

Крок 3: Оберіть “Локальний застосунок” (Local Application)

Виберіть Локальний застосунок із запропонованих варіантів.

Вибір локального застосунку

Крок 4: Налаштуйте параметри застосунку

Заповніть наступні параметри застосунку:

ПараметрЗначення
Тип застосункуСерверний (Server)
URL обробника (Handler URL)https://freshchats.ponderacode.com/handler.php
URL початкового налаштування (Initial setup URL)https://freshchats.ponderacode.com/install.php

Встановіть наступні дозволи (права доступу):

ДозвілКод (Code)
Відкриті Лінії (Open Lines)imopenlines
Зовнішні коннектори месенджерівimconnector
Служба повідомленьmessageservice

Налаштування застосунку разом з дозволами

Крок 5: Збережіть Застосунок

Натисніть кнопку Зберегти (Save), щоб зареєструвати додаток.

Крок 6: Скопіюйте Облікові Дані Застосунку

Після збереження Bitrix24 згенерує унікальні облікові дані для цього інтегрованого додатка:

  • client_id - Код застосунку
  • client_secret - Секретний ключ застосунку

Дані застосунку — client_id і client_secret

!!! warning “Важливо” Обов’язково скопіюйте і збережіть значення client_id та client_secret у себе в блокноті. Ви використаєте їх у наступному кроці.

Крок 7: Відкрийте Налаштування Застосунку

Натисніть кнопку Перейти до застосунку (Go to Application), щоб відкрити сторінку налаштувань SMSBAT Messenger.

Заповніть наступні поля:

ПолеОпис
Bitrix24 Client IDВаш client_id з попереднього кроку
Bitrix24 Client SecretВаш client_secret з попереднього кроку
SMS API KeyВаш особистий API ключ з кабінету SMSBAT
SMS From NameІм’я відправника, від чийого імені надсилатимуться повідомлення (Альфа-ім’я)
Send messages with SMS fallbackУвімкніть, щоб використовувати резервну доставку SMS.

!!! info “Резервне SMS (SMS Fallback)” Коли опція Send messages with SMS fallback увімкнена, повідомлення спочатку йтимуть у Viber, а в разі недоставки — автоматично досилатимуться через SMS. Якщо опція вимкнена, повідомлення доставлятимуться виключно у Viber.

Сторінка налаштувань SMSBAT Messenger

Натисніть Зберегти Налаштування (Save Settings), щоб застосувати конфігурацію.

Крок 8: Активація в Контакт-центрі

Перейдіть до розділу Контакт Центр (Contact Center) у вашому Bitrix24 і активуйте щойно створений канал SMSBat Messenger.

Контакт Центр з SMSBat Messenger

Крок 9: Почніть Користуватися

Після завершення налаштування ви можете починати розсилку клієнтам прямо з інтерфейсу каналу SMSBAT Messenger вашого Контакт-центру Bitrix24.

Довідник з Налаштувань

НалаштуванняОписОбов’язково
Bitrix24 Client IDOAuth код додатка з Bitrix24Так
Bitrix24 Client SecretСекретний OAuth ключ додатка з Bitrix24Так
SMS API KeyВаш ключ API від SMSBATТак
SMS From NameВідображуване Альфа-ім’я відправникаТак
Send messages with SMS fallbackУвімкнути резервну доставку SMSНі

Вирішення Проблем

Застосунку не видно у Контакт Центрі

  1. Переконайтеся, що додаток дійсно був успішно збережений на Кроці 5.
  2. Перевірте, чи ви дали йому всі необхідні дозволи (imopenlines, imconnector, messageservice).
  3. Спробуйте оновити (перезавантажити) сторінку браузера.

Повідомлення не надсилаються

  1. Перевірте, чи правильно ви ввели ваш SMS API Key в налаштуваннях.
  2. Упевніться, що ім’я SMS From Name повністю збігається із зареєстрованим у нас вашим Альфа-іменем.
  3. Переконайтеся, що телефон отримувача має правильний формат.
  4. Якщо ви використовуєте SMS Fallback, перевірте, чи у вас на рахунку в кабінеті SMSBAT достатньо кредитів (коштів) для звичайних SMS.

Ви втратили облікові дані додатка

Якщо ви згубили свої client_id або client_secret, перейдіть назад у Застосунки > Розробникам, знайдіть додаток “SMSBAT Messenger”, та подивіться його деталі, щоб заново скопіювати ці ключі.

Наступні Кроки