VK Teams

VK Teams — корпоративный суперапп для коммуникаций и совместной работы команд.

Подключение

1. Конфигурация на стороне VK Teams

Создание Бота на стороне VK Teams описано в статье: https://teams.vk.com/botapi/tutorial/?lang=ru.

1. Откройте VK Teams и авторизуйтесь.

2. Найдите в поиске бота “metabot”.

3. 

4. 1. Отправьте Боту команду/newbot

   2. В ответ на сообщение бота введите желаемое имя вашего Бота.

5. Скопируйте полученный токен.

2. Конфигурация канала агента в Платформе

Агенту необходимо создать и настроить Канал Проекта с Коннектором “VK Teams”.

1. Кликните по кнопке настроек Агента.

2. Нажмите кнопку Add channel.

3. Откроется панель выбора Конечный канал.

4. Выберите VK Teams.

5. Откроется панель создания Канал Проекта.

6. По необходимости пропишите заголовок для данного Канал Проекта в поле названия с плейсхолдером New channel.

7. Вставьте скопированный ранее токен в поле VK Teams token.

8. По необходимости переключите тумблер Receive service messages, чтобы получать Сервисные сообщения канала.

9. Для сохранения Канал Проекта без его активации, нажмите кнопку CREATE.

10. Для сохранения и активации Канал Проекта, нажмите кнопку CREATE & ACTIVATE.

11. 1. Канал Проекта будет сохранен и активирован, если:

    2. 1. Агент обучен;

       2. токен в поле VK Teams token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);

       3. будет доступен адрес Канал Проекта;

       4. удастся зарегистрировать вебхук канала.

    3. Канал Проекта будет сохранен, но не активирован, если одно или больше условий не будут выполнены.

12. Для отмены создания Канал Проекта нажмите кнопку CANCEL.

Редактирование и удаление Канала Агента

Для редактирования Канал Проекта, необходимо кликнуть по его иконке на карточке Агента.

1. Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение.

2. Чтобы применить изменения к активированному Канал Проекта, нажмите кнопку APPLY.
3. 1. Изменения будут применены, если:

   2. 1. Агент обучен;
      2. токен в поле VK Teams token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
      3. будет доступен адрес Канал Проекта;
      4. удастся зарегистрировать вебхук канала.

   3. Изменения не будут применены, если одно или больше условий не будут выполнены.

4. Чтобы деактивировать Канал Проекта, нажмите кнопку DEACTIVATE.
5. Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.
6. Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.
7. 1. Изменения будут применены и Канал Проекта будет активирован, если:
   2. 1. Агент обучен;
      2. токен в поле VK Teams token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
      3. будет доступен адрес Канал Проекта;
      4. удастся зарегистрировать вебхук канала.

   3. Изменения будут применены, но Канал Проекта не будет активирован, если одно или больше условий не будут выполнены.
8. Чтобы отменить внесение изменений, нажмите кнопку CANCEL.
9. Чтобы удалить Канал Проекта, нажмите кнопку DELETE.

Общение

Общение в чатах

Для общения Бота в чатах VK Teams необходимо разрешить добавлять Бота в чаты. Для этого необходимо:

1. Перейти в @metabot
2. Отправить ему команду /setjoingroups, отправить ник или Id своего Бота, отправить слово enable.
3. После этого Бота можно будет добавлять в чаты.

Переменная	Конечный канал	Переменная в запросе из канала	Примечания
channel_visitor_id	VK Teams	from.userId
channel_conversation_id	VK Teams	Нет
channel_visitor_firstname	VK Teams	from.firstName
channel_visitor_lastname	VK Teams	from.lastName
channel_visitor_account	VK Teams	Нет
channel_visitor_phone	VK Teams	Нет
channel_visitor_email	VK Teams	Нет
channel_visitor_source	VK Teams	Нет
channel_visitor_auth	VK Teams	Нет
channel_visitor_location	VK Teams	Нет
channel_message_id	VK Teams	msgId
channel_message_recipient	VK Teams	Нет
channel_service_data	VK Teams	Нет

Сервисные сообщения из VK Teams

На данный момент не поддерживается передача Сервисные сообщения канала VK Teams.

Функционал общения	Конечный канал	Доступность в канале	Примечания
channel_chat_id	VK Teams	Да	Имеет формат: chat.chatId|vk_teams
Сообщения дойдут до собеседника, если агент напишет первый в существующем чате	VK Teams	Да
Кнопки	VK Teams	Да	Кнопки выводятся инлайн, по одной кнопке в строке, максимум 14 кнопок
Перевод на оператора	VK Teams	Нет
Передача файлов в виде файлов от Агента (Attachment)	VK Teams	Частично	Приложение отправляется ссылкой из поля Source Слота Attachment , которую VK Teams преобразует в файл
Передача файлов в виде ссылок от Агента (Attachment)	VK Teams	Да
Получение файла от Собеседника в сценарий	VK Teams	Да	Формат: file:Тип файла|ID файла|Ссылка на файл
Получение геолокации от собеседника в сценарии	VK Teams	Нет
Доставка сообщений более 1000 символов от Агента до Собеседника	VK Teams	Да
Получить ссылку на источник лида	VK Teams	Нет
Использование маркдауна	VK Teams	Нет
Рассылки с помощью Notification	VK Teams	Нет