Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
https://vk.com/video-30831962_456239121

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

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

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

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

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

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

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

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

Подключение VK-бота к линии 1С-Коннект

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

image-20241105-111117.pngImage Removedimage-20241114-124453.pngImage Added
  • Выберите в цифровом меню “VK”.

image-20241105-113837.pngImage Removed

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

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

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

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

image-20241105-120025.pngImage Removedimage-20241115-055257.pngImage Added
  • Для подключения

чат
  • VK-бота

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

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

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

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

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

    , вам понадобится его токен. Чтобы создать токен API для бота, перейдите в настройки управления вашим сообществом, выберите раздел "Работа с API" и нажмите "Создать ключ".

Note

Для выполнения этого действия необходима включенная двухфакторная аутентификация на вашей странице VK.

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

    Созданный ключ скопировать (
    • Разрешить приложению доступ к управлению

      сообщенством

      сообществом;

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

      сообщенства

      сообщества;

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

      сообщенства

      сообщества;

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

      сообщенства;
Image Removedimage-20241105-130734.pngImage Removedimage-20241105-124145.pngImage Removed
    • сообщества.

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

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

  • Указать Перейдите на вкладку "Long Poll API" и активируйте эту функцию.

image-20241115-070002.pngImage Addedimage-20241115-062135.pngImage Added
  • Укажите следующие типы событий:

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

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

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

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

  • 1С-Коннект при подключении бота зарегистрирует технического клиента с названием “VK: <имя бота>”.

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

image-20241105-132742.pngImage RemovedImage Removed

image-20241115-081949.pngImage Added
  • Активируйте "Сообщения сообщества", далее в настройках бота включите "Возможности ботов".

image-20241115-071121.pngImage Addedimage-20241115-070404.pngImage Added
  • Полученный токен введите в диалоге с мастером подключения VK-бота в линии 1С-Коннект: Управление каналами.

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

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

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

image-20241105-135026.pngImage Removedimage-20241115-055101.pngImage Added

Отключение интеграции VK и линии поддержки

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

image-20241105-135119.pngImage Removed
  • Выберите “Отключить VK-бот”.

image-20241105-135146.pngImage Removed
  • Выберите линию, от которой необходимо отключить VK-бот.

image-20241105-135336.pngImage Removedimage-20241115-054832.pngImage Added
  • Для подтверждения отключения VK-бота от линии, пройдите по специальной временной ссылке и введите учетную запись API, которая используется для данного бота.

image-20241105-135517.pngImage Removed

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

image-20241105-135638.pngImage Removedimage-20241115-054652.pngImage Added

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

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

image-20241105-135724.pngImage Removed
  • Выберите “Показать линии с VK-бот”.

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

image-20241105-135919.pngImage Removed

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

Tip

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

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

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

Info

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

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

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

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

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

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

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

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

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

Ограничения

Note

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

Общие:
image-20241115-054041.pngImage Added

Ограничения

Note
  • Компания может подключить до 5

    Telegram

    VK-ботов к своим линиям.

  • К одной линии можно подключить один

    Telegram

    VK-бот. К одному

    Telegram

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

  • Из

    Telegram

    VK-бота в 1С-Коннект можно передавать:

    • Изображения

      размером до 5 Мб. каждое.

      в составе сообщения до 25 МБ, прикрепленые изображений как файл до 100 МБ;

    • Файлы - до

      20

      100 Мб

      .

      каждый.

  • Из 1С-Коннект в

    Telegram

    VK-бот можно передавать:

    • Изображения размером до

      10

      100 Мб

      .

      каждое.

    • Файлы до

      50 Мб. каждый.

      1 Гб на платных тарифах.

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

    Telegram

    VK-бота - политикой разработчика

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

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

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

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

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

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

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

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

    Вконтакте.