Как подключить бота к KWIGA

В KWIGA можно подключить ботов и каналы связи через Telegram, WhatsApp, Facebook Messenger, Instagram Direct и Viber.

Чтобы подключить бота, откройте соответствующий раздел настроек в кабинете KWIGA, выберите нужный мессенджер, заполните обязательные поля и нажмите «Сохранить бота».

1. Telegram

Для подключения Telegram-бота нужно указать:

• Название — название бота в KWIGA.

• Token — токен, полученный в Telegram через @BotFather после создания бота.

Важно:

• Не передавайте токен посторонним лицам. Он дает доступ к управлению ботом.

• Если токен был скомпрометирован, его нужно отозвать и создать новый через BotFather.

2. WhatsApp

Для подключения WhatsApp нужно указать:

• Название — название подключения в KWIGA.

• Токен доступа — постоянный токен системного пользователя.

• Phone Number ID — идентификатор номера телефона.

• WhatsApp Business Account ID (WABA ID) — идентификатор аккаунта WhatsApp Business.

• App Secret приложения Meta — секретный ключ приложения Meta.

Важно перед подключением

• Номер телефона не должен оставаться подключенным к обычному приложению WhatsApp или WhatsApp Business. Перед подключением его нужно отключить в соответствии с инструкцией по интеграции.

• Если номер используется другим провайдером, проверьте требования к переносу номера и двухфакторной проверке.

• Приложение Meta должно быть в режиме Live и содержать ссылку на политику конфиденциальности.

• До завершения проверки бизнеса Meta в интерфейсе KWIGA указано ограничение на отправку сообщений не более чем 250 новым клиентам в сутки. Перед публикацией нужно подтвердить актуальность и точную область применения этого лимита.

• По истечении 24-часового окна с момента последнего сообщения клиента можно отправлять только шаблоны сообщений, одобренные Meta.

• Для первого контакта с клиентом необходимо соблюдать правила WhatsApp в отношении согласия получателя на получение сообщений.

Также учитывайте, что Meta устанавливает тарифы на сообщения и может применять ограничения в зависимости от статуса и качества аккаунта.

3. Facebook Messenger

Для подключения Facebook Messenger нужно указать:

• Название — название подключения в KWIGA.

• Токен доступа к странице (Page Access Token) — токен доступа к странице Facebook.

• Page ID — идентификатор страницы Facebook.

• App Secret приложения Meta — секретный ключ приложения Meta.

Важно перед подключением

• Приложение Meta должно быть в режиме Live и содержать ссылку на политику конфиденциальности.

• Отвечать клиенту обычным сообщением можно в течение 24 часов после его последнего сообщения.

• По истечении этого периода отправка обычных сообщений ограничивается правилами Meta. Специальные механизмы отправки доступны только при соблюдении условий Meta.

• Для работы интеграции необходимы соответствующие разрешения для приложения и доступ к странице Facebook.

4. Instagram Direct

Для подключения Instagram Direct необходимо указать:

• Название — название подключения в KWIGA.

• Токен доступа Instagram (долгосрочный) — токен доступа.

• Instagram User ID — идентификатор профессионального аккаунта Instagram.

• Instagram App Secret приложения Meta — секретный ключ приложения Meta.

Важно перед подключением

• Для интеграции необходим профессиональный аккаунт Instagram — Business или Creator. Личные аккаунты не поддерживают этот сценарий работы с API.

• Приложение Meta должно быть в режиме Live и содержать ссылку на политику конфиденциальности.

• Отвечать клиенту обычным сообщением можно в течение 24 часов после его последнего сообщения.

• Возможность начать диалог, отправить сообщение или продолжить общение зависит от правил Instagram Messaging API.

• Для работы интеграции необходимо предоставить приложению необходимые разрешения для работы с сообщениями.

5. Viber

Для подключения Viber необходимо указать:

• Название — название бота в KWIGA.

• Токен бота Viber — токен, полученный в Viber Admin Panel.

Важно перед подключением

• Для создания чат-бота необходимы регистрация и согласование в соответствии с действующими коммерческими условиями Rakuten Viber.

• Согласно действующей коммерческой модели Viber, стандартная плата за обслуживание нового бота составляет 115 € в месяц. Дополнительно оплачиваются доставленные сообщения, инициированные ботом. Окончательную стоимость необходимо уточнить в Viber перед подключением.

• В рамках описанной модели сообщения во время активной 24-часовой сессии не оплачиваются отдельно за каждое сообщение.

• Сессия начинается, когда подписчик отправляет сообщение боту или отвечает на сообщение, инициированное ботом.

• На отправку сообщений вне активной сессии распространяются коммерческие условия Viber.

Настройка бота в KWIGA

После подключения бота к KWIGA можно настроить его работу, автоматические сообщения, команды, кнопки и другие параметры взаимодействия с подписчиками.

Доступные настройки зависят от подключённого мессенджера.

Входящие

Настройки обработки входящих диалогов и рабочего времени бота.

• Автоназначение диалогов — автоматическое распределение диалогов между сотрудниками по очереди.

• Рабочие часы — настройка часового пояса и графика работы.

• Автоответ вне рабочих часов — автоматическое сообщение подписчику, обратившемуся вне установленного графика.

Сообщения

Настройка автоматических сообщений, которые бот отправляет в разных ситуациях.

В зависимости от доступных функций можно настроить приветствие при первом контакте, ответы на типичные обращения и сообщения, связанные с доступом к закрытым группам.

Команды

В этом разделе можно создавать команды бота и настраивать ответы, которые подписчики будут получать после их ввода.

Команды отображаются в меню бота и помогают пользователям быстро получить нужную информацию или запустить определённое действие. Например, можно создать команды «Помощь», «Мои курсы», «Контакты» или «Поддержка».

Для каждой команды можно настроить название и ответ бота. Если нужно реализовать более сложное взаимодействие — например, задать пользователю несколько вопросов, собрать информацию или выполнить определённые действия, — можно связать команду со сценарием автоматизации.

Также доступны системные команды, в частности //help, //menu, //stop, //unsubscribe и //subscribe, которые используются для стандартных действий бота.

Кнопки

Настройка кнопок, с помощью которых подписчик взаимодействует с ботом.

В зависимости от доступных возможностей можно настроить клавиатуру под полем ввода и кнопки под сообщениями.

Ссылки

В этом разделе можно создавать отдельные ссылки на бота с метками источника, чтобы отслеживать, откуда приходят новые подписчики.

Например, если вы размещаете ссылку на бота на сайте, в Instagram и рекламных объявлениях, создайте для каждого источника отдельную ссылку с соответствующим названием: «Сайт», «Instagram», «Facebook Ads» и т. д.

Чтобы создать ссылку:

1. Введите название источника.

2. Нажмите «Создать ссылку».

3. Скопируйте сгенерированную ссылку или скачайте QR-код.

4. Разместите её в соответствующем месте.

Когда человек переходит по ссылке, открывает бота и нажимает «Начать», KWIGA фиксирует источник перехода. Количество новых подписчиков по каждой ссылке отображается непосредственно в её настройках, а также в аналитике блока «Откуда пришли подписчики».

Учитываются только новые подписчики: если человек уже общался с ботом раньше, повторный переход по другой ссылке не засчитывается.

Диагностика

Проверка связи между ботом и KWIGA, просмотр статуса подключения и использование доступных инструментов диагностики.

Набор инструментов зависит от интеграции.