Перейти к основному содержимому
Версия: 4.11-refactoring

Telegram-канал: создание и настройка

Доступы​

подсказка

Для управления каналами пользователь должен находиться в группе с правами Администратор или Управление каналами.

Требования​

  • Сервер должен быть доступен из Интернета по доменному имени (не по IP-адресу)
  • Доступ должен осуществляться по HTTPS с валидным, не самоподписанным сертификатом
  • Должен быть создан бот в Telegram, токен которого потребуется на этапе настройки канала

1. Создание Telegram-канала в IQChannels​

  1. Перейдите в нужный сегмент, в котором необходимо создать Telegram-канал

  2. Перейдите во вкладку «Каналы»

  3. Нажмите кнопку «Создать канал» в правом верхнем углу

  4. Заполните форму:

    • Тип канала: Telegram
    • Название: введите отображаемое имя канала
    • На английском: введите англоязычное название
    • Нажмите «Создать канал»

  5. Канал создан. Далее требуется его настройка

2. Настройка бота​

  1. Перейдите во вкладку «Настройки» внутри созданного канала

  2. В поле Ключ доступа введите токен бота, полученный при создании Telegram-бота (подсказка под полем: «Укажите ключ, полученный от Telegram BotFather при создании бота»)

  3. При необходимости включите флаги:

    • Resize keyboard — клавиатура бота сжимается под размер экрана клиента
    • One Time Keyboard — клавиатура скрывается после нажатия клиентом кнопки

  4. «Запрашивать персональные данные при обращении» — запрашивать у клиента персональные данные при первом обращении. При включении появляются:

    • «Введите сопроводительное сообщение:» — текст запроса, который увидит клиент (например, просьба указать данные).
    • «Прикрепить согласие на обработку ПД» — к запросу прикрепляется форма согласия на обработку персональных данных.

  5. «Оператор может запрашивать номер телефона» — оператору в карточке обращения доступна кнопка запроса номера телефона клиента.

  6. Нажмите кнопку «Сохранить» — канал настроен.

Карточка «Настройка бота»: поле «Ключ доступа», флаги Resize keyboard и One Time Keyboard, «Запрашивать персональные данные при обращении» с полем «Введите сопроводительное сообщение:» и флагом «Прикрепить согласие на обработку ПД», «Оператор может запрашивать номер телефона», кнопка «Сохранить»

3. Проверка работоспособности​

Отправьте сообщение вашему боту в Telegram и убедитесь, что оно появилось в интерфейсе IQChannels в виде нового обращения.

4. Диагностика (в случае ошибок)​

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

  • "Fetched a bot info" — получена информация о боте
  • "Set a telegram bot token" — токен установлен
  • "Set a telegram webhook url" — установлен URL вебхука