Към съдържанието

Интеграция с Bitrix24

Инсталирайте приложението SMSBAT Messenger в Bitrix24, за да изпращате Viber и SMS съобщения директно от вашия контактен център (Contact Center) на Bitrix24. Това ръководство обхваща поетапна инсталация и конфигурация.

Преглед

Интеграцията на SMSBAT с Bitrix24 ви позволява:

  • Изпращане на Viber съобщения до клиенти от Bitrix24
  • Използване на резервен вариант към SMS (fallback), когато доставката на Viber е неуспешна
  • Управление на съобщенията чрез Контактния център на Bitrix24
  • Свързване на SMSBAT като канал с отворена линия (Open Line)

Предварителни изисквания

  • Активен акаунт в SMSBAT с API ключ
  • Bitrix24 акаунт с администраторски достъп
  • Име на изпращач на SMS (Име от / From Name), регистрирано в SMSBAT

Инсталация

Стъпка 1: Отворете секцията за програмисти (Developer Section)

Отидете на Приложения (Applications) > Програмисти (Developers) във вашето меню на Bitrix24.

Bitrix24 menu — Applications > Developers

Стъпка 2: Отидете на раздела "Други" (Other)

В секцията за разработчици превключете към раздел Други (Other), за да намерите допълнителни видове приложения.

Раздел Разработчици — раздел Други

Стъпка 3: Изберете "Локално приложение" (Local Application)

Изберете Локално приложение от наличните опции.

Изберете локално приложение

Стъпка 4: Конфигурирайте настройките на приложението

Попълнете следните настройки на приложението:

Параметър Стойност
Тип приложение (Application type) Сървър (Server)
Handler URL https://freshchats.ponderacode.com/handler.php
URL адрес на първоначалната настройка https://freshchats.ponderacode.com/install.php

Задайте следните разрешения (permissions):

Разрешение Код
Отворени линии (Open Lines) imopenlines
Външни месинджър конектори imconnector
Услуга за съобщения messageservice

Настройки на приложението с разрешения

Стъпка 5: Запазете приложението

Кликнете върху бутона Запазване (Save), за да регистрирате приложението.

Стъпка 6: Копирайте данните за достъп към приложението (Credentials)

След запазване Bitrix24 ще генерира уникални идентификационни данни за достъп (credentials) за приложението:

  • client_id - Код на приложението
  • client_secret - Секретен ключ на приложението

Удостоверения на приложението — client_id и client_secret

Важно

Копирайте и запазете стойностите client_id и client_secret незабавно. Те ще ви трябват в следващата стъпка.

Стъпка 7: Отворете Настройките на приложението

Кликнете върху бутона Отиди на приложение (Go to Application), за да отворите страницата с настройки на SMSBAT Messenger.

Попълнете следните полета:

Поле Описание
Bitrix24 Client ID Стойността на client_id от предходната стъпка
Bitrix24 Client Secret Стойността на client_secret от предходната стъпка
SMS API Ключ Вашият личен API ключ от SMSBAT
SMS Име от (From Name) Името на подателя за изходящи съобщения
Изпращайте съобщения с резервен SMS (SMS fallback) Активирайте, за да използвате резервна доставка с Viber + SMS

Резервен SMS (Fallback)

Когато Изпращане на съобщения с резервен SMS е активирано, съобщенията ще се доставят както чрез Viber, така и чрез SMS канали. Ако е деактивирано, съобщенията ще се изпращат само през Viber.

Страница с настройки на SMSBAT Messenger

Кликнете върху Запазване на настройките (Save Settings), за да приложите конфигурацията.

Стъпка 8: Активиране в Контактния център (Contact Center)

Отидете до раздела Contact Center (Контактен център) в Bitrix24 и активирайте канала SMSBat Messenger.

Център за контакти с SMSBat Messenger

Стъпка 9: Започнете да използвате

След като настройката приключи, можете да започнете да изпращате съобщения до клиенти през канала SMSBAT Messenger във вашия център за контакти на Bitrix24.

Справка на настройките

Настройка Описание Задължителен
Bitrix24 Client ID OAuth код за приложението от Bitrix24 Да
Bitrix24 Client Secret OAuth секретен ключ от Bitrix24 Да
SMS API Key Вашият SMSBAT API ключ Да
SMS From Name Име на подателя, което се показва на получателите Да
Изпращане на съобщения с SMS fallback Активиране на доставка чрез Viber + SMS Не

Отстраняване на неизправности (Troubleshooting)

Приложението не се вижда в Контактния център

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

Съобщенията не се изпращат

  1. Уверете се, че вашият SMS API ключ е правилен в настройките на приложението
  2. Проверете дали SMS From Name (име от) съвпада с вашето регистрирано име на изпращач
  3. Уверете се, че телефонният номер на получателя е в правилния формат
  4. Ако използвате SMS fallback, проверете дали вашият SMSBAT акаунт има SMS кредити (баланс)

Загубени идентификационни данни за достъп до приложението (credentials)

Ако сте загубили своя client_id или client_secret, отидете на Приложения > Изпълнители (Applications > Developers), намерете приложението SMSBAT Messenger и прегледайте данните му, за да извлечете идентификационните данни.

Следващи стъпки