Versions Compared

Key

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

Тут видео-инструкция, как подключить VK к 1С-Коннект.

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

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

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

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

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

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

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

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

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

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

image-20241114-124453.png
  • Выберите в цифровом меню “VK”.

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

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

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

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

image-20241115-055257.png
  • Для подключения VK-бота, вам понадобится его токен. Чтобы создать токен API для бота, перейдите в настройки управления вашим сообществом, выберите раздел "Работа с API" и нажмите "Создать ключ". Обратите внимание, что для

Note

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

image-20241115-055101.png

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

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

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

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

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

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

image-20241115-054652.png

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

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

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

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

image-20241115-054041.png

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

Tip

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

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

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

Info

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

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

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

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

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

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

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

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

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

    Note
    • Основые:

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

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

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

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

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

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

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

      • Файлы

        100 Мб для базовых функций,

        до 1 Гб

        для расширенных

        на платных тарифах.

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

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

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

  • Если у сообщества в VK поменять ключ, то в кабинете администратора будет создана новая компания с тем же именем сообщества.

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

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

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

  • Редактирование или удаление сообщений доступно только на той стороне, где это действие выполняется.

  • Рекомендуется отключить возможность создания чатов в сообществе, чтобы избежать дублирования сообщений в обращениях.

  • image-20241115-074513.pngImage Removedimage-20241115-074527.pngImage Removed