Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

Омниканальность - это свойство сервиса, дающее возможность специалистам работать с пользователями других сервисов (каналов) из 1С-Коннект, используя все доступные возможности 1С-Коннект.

https://vk.com/video-30831962_456239121

Подключение

Telegram

VK-бота к линии 1С-Коннект

  • Подключение/отключение TelegramVK-ботов, управление подключенными ботами осуществляется с помощью специальной линии 1С-Коннект: Управление каналами. Необходимо найти и подключить данную линию.

image-20240212-055348.pngImage Removedimage-20241105-111117.pngImage Added

  • Выберите в цифровом меню “Telegram”“VK”.

image-20240212-055413.pngImage Removedimage-20241105-113837.pngImage Added

  • Выберите в цифровом меню “Подключить TelegramVK-бот”.

image-20240212-055440.pngImage Removedimage-20241105-114412.pngImage Added
  • Выберите линию, к которой необходимо подключить TelegramVK-бот:

    • Подключение возможно к линиям вашей компании с типом доступности “Для клиентов и специалистов”.

    • Предлагаемые линий можно листать с помощью стрелочек.

image-20240212-055504.pngImage Removed
image-20241105-120025.pngImage Added

Для подключения чат-бота вы можете использовать любое своё сообщество ВКонтакте — группу, встречу или публичную страницу.

  • Для подключения TelegramVK-бота необходимо получить его токен используя стандартный https://t.me/BotFather. Для регистрации нового бота:

    • Перейдите в https://t.me/BotFather.

    • Выберите в меню “/newbot”, который запустит мастер регистрации нового бота.

    BotFather попросит вас придумать название для создаваемого ботадля этого необходимо:

    • Дать права на управление сообществом, сообщения сообщества, фотографии, документы.

      • Перейти на экран управления сообществом. Выбрать в Настройках → Работа с API

      • Создать ключ. Для создания ключа необходима двухфакторная аутентификация на VK id

      • Установить галки на следующих пунктах:

        • Разрешить приложению доступ к управлению сообщенством;

        • Разрешить приложению доступ к сообщениям сообщенства;

        • Разрешить приложению доступ к фотографиям сообщенства;

        • Разрешить приложению доступ к документам сообщенства;

Image Addedimage-20241105-130734.pngImage Addedimage-20241105-124145.pngImage Added
  • Созданный ключ скопировать (для дальнейшей привязки его к линии в 1С-Коннект). Если необходимо снова увидеть ключ, нажмите кнопку "Показать" и подтвердите действие в приложении VK.

  • Далее необходимо включить “Long Poll API” - данный параметр находится на вкладке с соответствующим названием.

  • Указать типы событий:

    • Входящее сообщение;

    • Исходящее сообщение.

image-20241105-131106.pngImage AddedImage AddedImage Added
  • Нужно указать, что в вашем сообществе будет работать бот. Для этого необходимо перейти в Управление сообществомСообщения → включить Сообщения сообщества

  • Настройки для бота и включить пункт Возможности ботов.

  • 1С-Коннект при подключении бота зарегистрирует технического клиента с названием

    “Telegram

    “VK: <имя бота>”.

    • При обращении через TelegramVK, в 1С-Коннект будет регистрироваться аккаунт для данного пользователя в рамках технического клиента для данного бота.

  • В завершении регистрации BotFather сформирует ссылку на канал в Telegram и токен. Его нужно будет ввести при подключении бота к линии 1С-Коннект.

image-20240212-055540.pngImage Removed

image-20240212-055608.pngImage Removedimage-20241105-132742.pngImage AddedImage Added

  • Полученный токен введите в диалоге с мастером подключения TelegramVK-бота в линии 1С-Коннект: Управление каналами.

image-20240212-055619.pngImage Removed

image-20241105-134906.pngImage Added

  • Мастер попросит вас перейти по специальной ссылке и ввести учетную запись API, которую будет использовать TelegramVK-бот при взаимодействии с 1С-Коннект.

  • Учетную запись API вы можете зарегистрировать в кабинете администратора 1С-Коннект.

image-20240122-072043.png
  • После авторизации в приложение поступит сообщение о подключении TelegramVK-бота к линии. На этом подключение завершено.

image-20240212-055639.pngImage Removed

image-20241105-135026.pngImage Added

Отключение интеграции

Telegram

VK и линии поддержки

  • По линии поддержки “1С-Коннект: Управление каналами” в цифровом меню выберите “Telegram”“VK”.

image-20240212-055716.pngImage Removed

image-20241105-135119.pngImage Added

  • Выберите “Отключить TelegramVK-бот”.

image-20240212-055759.pngImage Removed

image-20241105-135146.pngImage Added

  • Выберите линию, от которой необходимо отключить TelegramVK-бот.

image-20240212-055827.pngImage Removed

image-20241105-135336.pngImage Added

  • Для подтверждения отключения TelegramVK-бота от линии, пройдите по специальной временной ссылке и введите учетную запись API, которая используется для данного бота.

image-20240212-060041.pngImage Removed

image-20241105-135517.pngImage Added

  • После авторизации в приложение поступит сообщение об отключении Telegram-бота от линии.

image-20240212-060118.pngImage Removed

image-20241105-135638.pngImage Added

Просмотр списка линий, подключенных к

Telegram

VK, и мониторинг их состояния

  • В диалоге по линии 1С-Коннект: Управление каналами выберите TelegramVK.

image-20240212-060232.pngImage Removed

image-20241105-135724.pngImage Added

  • Выберите “Показать линии с TelegramVK-бот”.

image-20240212-060241.pngImage Removed

image-20241105-135753.pngImage Added

  • В чате будет выведен список линий, подключенных к TelegramVK-боту, содержащий в себе название линии, название Telegram-бота, название клиента и состояние подключения.

image-20240212-060300.pngImage Removed

image-20241105-135919.pngImage Added

Рекомендации

Tip

Рекомендации:

  • Для работы с пользователями TelegramVK, зарегистрируйте отдельную линию в 1С-Коннект (по отдельной линии для каждого TelegramVK-бота). Это позволит вам лучше администрировать настройки, мониторинг и управление процессов в будущем.

  • Для каждого TelegramVK-бота также рекомендуем регистрировать отдельную учетную запись API.

Info

Дополнительные сведения:

  • При подключении к линии TelegramVK-бота в сервисе создаётся отдельная техническая компания-клиент с названием “Telegram“VK: <имя бота>”. В рамках нее регистрируются аккаунты пользователей TelegramVK. Просмотр списка пользователей этого клиента доступен в кабинете администратора.

  • Для бана пользователя (принудительного блокирования), достаточно отключить ему линию 1С-Коннект в кабинете администратора. Обращения от таких пользователей перестают доставляться в линию 1С-Коннект.

  • По каждому пользователю из Telegram VK в 1С-Коннект:

    • Передаются: имя пользователя TelegramVK, в рассылках - кнопка перехода по ссылке, в цифровых меню - текстовые значения кнопок меню.

    • Не передаются: статус (онлайн/офлайн), аватар, телефон, информация о прочтении сообщений и рассылок.

  • Для работы через 1С-Коннект с группами в Telegram VK необходимо:

    • Добавить бота TelegramVK, подключенного к линии 1С-Коннект в группу TelegramVK;

    • Назначить бота администратором в группе или предоставить права на управление сообщениями в группе.

Ограничения

Note

Ограничения:

  • Общие:

    • Компания может подключить до 5 Telegram-ботов к своим линиям.

    • К одной линии можно подключить один Telegram-бот. К одному Telegram-боту можно подключить одну линию 1С-Коннект.

    • Из Telegram-бота в 1С-Коннект можно передавать:

      • Изображения размером до 5 Мб. каждое.

      • Файлы - до 20 Мб. каждый.

    • Из 1С-Коннект в Telegram-бот можно передавать:

      • Изображения размером до 10 Мб. каждое.

      • Файлы до 50 Мб. каждый.

    • Сроки хранения файлов на стороне 1С-Коннект определяются тарифом компании, на стороне Telegram-бота - политикой разработчика Telegram.

    • Голосовые сообщения и звонки между сервисами не поддерживаются.

    • Аватар пользователя из Telegram не отображается в 1С-Коннект.

    • Функциональность работает при наличии активной тарифной опции “Подключение внешних каналов”.

  • При добавлении Telegram-бота в чат группы:

    • Telegram-бот воспринимает группу как единого пользователя, обращающегося на линию, с указанием имени участника группы в тексте обращения

    • Изменения имен пользователей и названий групп в Telegram не обновляются в 1С-Коннект в динамике. Новые сообщения будут отображаться с актуальными именами.

    • Удаление и повторное добавление бота в группу создаст нового пользователя в 1С-Коннект.

    • Сообщения из 1С-Коннект не будут отправлены в Telegram, если бот заблокирован пользователем.