Подключение и работа с группами Вконтакте: основные настройки

В данной статье пошагово описывается процесс подключения группы Вконтакте к проекту и дальнейшая настройка на платформе Salebot

Основные разделы статьи:

ВАЖНО! При подключении группы Вконтакте необходимо учесть следующее:

  1. Максимальная длина текстового сообщения 4096 символов

  2. В сутки вы можете отправить сообщение не более 20 людям, которые не являются вашими друзьями и не состояли с вами в переписке до этого.

    К сообщению можно прикрепить максимум 10 вложений

    Сообщение можно редактировать в течение 24ч

  3. Ограничения при использовании кнопок:

  4. Клавиатура может отображаться внутри сообщения — это inline-отображение. Чтобы включить его, передайте параметр inline в объект клавиатуры. Её максимальный размер составит 5 × 6. Максимальное количество клавиш: 10.

  5. По умолчанию, если не передан параметр inline, клавиатура показывается под полем ввода в диалоге с пользователем (reply). Максимальный размер стандартной клавиатуры — 5 × 10. Максимальное количество клавиш: 40.

Читайте первоисточник: https://dev.vk.com/api/bots/overview

Подключение группы ВКонтакте

Для подключения сообщества Вконтакте, Вам необходимо перейти в раздел "Каналы" и выбрать Вконтакте.

Если ранее Вы не авторизовывались через Вконтакте на Salebot, то увидите такую кнопку. Нажимаем на нее.

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

В списке будут также отображены группы, у которых отключены сообщения. (Для включения сообщений необходимо перейти в настройки группы, в разделе "сообщения" поставить галочку "разрешить сообщения").

Если какая-то из ваших групп уже подключена к другому проекту, будет указан номер этого проекта.

В качестве примера подключим группу “Тест”.

После нажатия "Подключить" необходимо разрешить системе доступ к основным разделам группы ВКонтакте (здесь также жмем Разрешить).

ОБРАТИТЕ ВНИМАНИЕ! При подключении дважды запрашивается доступ к группе, так как создаются два ключа доступа к Вашей группе с разным уровнем доступа.

ДАТЬ РАЗРЕШЕНИЕ НАДО 2 РАЗА!

Также с ключом доступа сообщества можно совершать до 20 запросов в секунду.

Обратите внимание, что с ключом доступа сообщества можно совершать до 20 запросов в секунду.

После успешного подключения группы она появится в списке ботов Вконтакте.

На этом подключение бота к группе ВКонтакте завершено.

Видео-инструкция

Установка приложения Salebot в сообщество ВКонтакте

Для работы с Подписной страницей Вконтакте, необходимо установить в сообщество ВКонтакте приложение Salebot .

Ссылку на приложение можно получить на платформе Salebot в разделе Минилендинги - создать минилендинг - Общие настройки - Мессенджеры - нажать на ссылку для установки приложения:

Далее выберите сообщество, в которое необходимо добавить приложение Salebot:

Уведомления о прочтении сообщений

Для клиентов ВК есть возможность включить функцию прочитанности сообщений.

Для этого в разделе Каналы для группы Вк необходимо переключить бегунок Прочитанность сообщений.

После включения уведомления в диалогах можно увидеть сообщения, помеченные галочками. Одна галочка - не прочитано. Две галочки - прочитано.

В рассылках при включенной Прочитанности сообщений появляется статистика. На примере ниже в рассылке 24 сообщений ВК, из них просмотрено 12

Рассылка должна быть создана в конструкторе воронок из блоков состояния диалога.

Из раздела Рассылки и из блоков Не состояния - статистика о прочтении НЕ БУДЕТ СЧИТАТЬСЯ. Потому что клиент не находится в данных блоках.

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

Для этого в блоке с сообщением необходимо включить значок с двумя галочками.

В работе с Вконтакте учитывайте следующее:

  1. Максимальная длина текстового сообщения 4096 символов

  2. В сутки вы можете отправить сообщение не более 20 людям, которые не являются вашими друзьями и не состояли с вами в переписке до этого.

  3. К сообщению можно прикрепить максимум 10 вложений

  4. Сообщение можно редактировать в течение 24ч

Параметр уведомление о прочтении: message_read

Помните: Callback о просмотре работает в ВК и email!

Важно: Callback придет, только если клиент находится в данном блоке, если он его покинул, то колбека не будет.

Как прописать метку в прямой ссылке на сообщения группы ВКонтакте

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

Для чего это можно использовать:

1. Оценивать эффективность контента, в котором даёте помеченную ссылку на сообщения группы и призываете написать вам. 2. Для запуска в боте определенной ветки воронки, проверяя наличие переменной/метки. Давать разный контент в зависимости от того, откуда пришел пользователь.

Как пользоваться:

  • Ссылка на бота Вашей группы отображена рядом именем группы в списке ботов Вконтакте, скопируйте ее

  • Дописываем к полученной ссылке метки Передать можно два параметра: ref и ref_source

Получаем ссылку следующего вида: https://vk.com/im?sel=-198248940&ref=параметр1&ref_source=параметр2 вместо “параметр1” и “параметр2” вписываете значения своих меток

Есть еще 2 варианта ссылок: vk.me/group_name?ref=параметр1&ref_source=параметр2 где group_name - идентификатор вашего сообщества

или

vk.com/write-group_id?ref=параметр1&ref_source=параметр2 где group_id - уникальный числовой идентификатор сообщества

Пример использования

Отследим, сколько пользователей пришло в https://vk.com/public202836320 с телеграм канала Test. Для начала соберем ссылку, например, такую: vk.me/public202836320?ref=telegram&ref_source=test

или вот такую:

vk.com/write-202836320?ref=telegram&ref_source=test

Обратите внимание, что в ссылке должен быть только один знак вопроса ?, далее мы присоединяем параметры через знак апмерсанта &

И разместим в канале, при переходе по данным ссылкам откроется диалог и на любое сообщение пользователя ему запишется две переменные в Salebot:

Автоматизация группы с помощью Salebot

Заходим в Каналы, включаем все события для бота, как на скрине:

Когда пользователь будет совершать то или иное действие, вы это сможете отследить с помощью колбека события:

1. Событие: Пользователь оставил новый комментарий

client_wall_reply_new

Колбек приходит в виде:

где 10 — id поста, под которым был оставлен комментарий "неплохой набор" — текст оставленного комментария

Дополнительные параметры сохраняются в переменные:

wall_reply_text — текст комментария, который оставил пользователь

wall_reply_id — id комментария

wall_reply_post_id —id поста, который комментируют

wall_reply_to_user — id пользователя, которому ответили

wall_reply_to_comment — id комментария, который оставили

2. Событие: Пользователь сделал репост записи себе на стену

client_wall_repost

в данном случае 10 — это id поста, который репостнули

Обращаем внимание! Если профиль пользователя Вконтакте закрыт, то коллбек о репосте на стену не приходит!

Дополнительные параметры сохраняются в переменные:

wall_repost_text — текст, который пользователь добавляет к репосту

wall_repost_post_id — id поста, который репостнули

3. Событие: Вступление в группу

client_group_join

Когда у вас добавится новый подписчик, коллбэк будет отображаться так:

В переменную сохраняется значение join_type

Если у вас закрытая группа, то после одобрения заявки значение переменной изменится:

4. Событие: Выход из группы

client_group_leave

5. Событие: Клиент лайкнул пост

client_liked_post

в данном случае 1 — id поста, который лайкнули

Вы можете настраивать разные реакции на колбеки, например, на лайк определенного поста. Например, присылать сообщение клиенту в лс:

В условии блока первостепенной проверки стоит "1" это id поста, лайк под которым нужно проверять. Если убрать число и оставить client_liked_post, то реакция будет приходить на любой пост, который лайкнули

При лайке, репосте, вступлении в группу и выходе из неё клиент не создаётся

Если клиент не давал разрешения на сообщения или не писал ничего ранее в личные сообщения группы, то вы первым написать ему не сможете (например, приветствовать в личку сразу при вступлении в группу нельзя)

Такое вы увидите, если клиент не дал разрешение на отправку сообщений или не писал ничего ранее в личные сообщения группы

Коллбеки:

client_group_join request - подан запрос на вступление в группу client_group_join approved - клиент принят в группу

6. Событие: Реакция на сообщение

Для включения коллбэка для реакции на сообщение нужно зайти в управление, пункт в настройках работа с API, выбрать во вкладке callback API наш сервер и зайти в типы событий, там найдете Действие с реакциями на сообщение и поставите галочку напротив этого поля. После этого в чаты будет приходить коллбэк с информацией на сообщение с каким conversation_id была реакция и какая.

react 2 on 629 - 2 реакция на cmID 629

cancel reaction on 629 - отменил ранее поставленную реакцию на cmID 629

Как работать с комментариями под постами ВКонтакте

Чтобы иметь возможность отвечать под комментариями, необходимо вручную добавить токен.

Для этого заходите в Вашу группу ВКонтакте, открываете Управление / Работа с API

Нажимаете "Создать ключ" и копируете его.

Дальше переходите в Salebot, раздел Каналы, и для подключеного бота ВКонтакте выбираете "Показать токены".

В открышейся форме вставляете скопированный токен и нажимайте на кнопку "Добавить".

После того, как добавили токен для работы с комментариями можно работать с комментариями, используя функции(API) в калькуляторе.

Все возможные функции работы с комментариями для ВКонтанте можно увидеть в этой статье:

Все функции API указываем в Калькуляторе блока.

Видеогид

Настройка Чат-бота для группы

1. Подключение Чат-бота в группу

Чтобы можно было добавить бота в чат группы Вконтакте, необходимо в настройках включить это разрешение:

Бот с правами администратора видит все сообщения в чате. Если бот не обладает этими правами, бот видит только те сообщения, где его упомянули через символ @

Общие переменные чата:

Переменные для чатаОписание переменной

from_id

идентификатор того, кто отправил последнее сообщение

conversation_message_id

идентификатор последнего сообщения

Если в беседе кто-то перешлет сообщение, то в боте появятся эти переменные. В них будет указано, кто и что процитировал.

Переменные для чатаОписание переменной

from_id

идентификатор того, кто процитировал

reply_from_id

идентификатор того, кого процитировали

reply_text

текст сообщения, которое было процитировано

reply_attachments

вложение, которое было процитировано

После входящего сообщения в карточке клиента будет появляться переменная cmid, в ней хранится порядковый номер сообщения в чате.

Обратите внимание на требования к файлам: можно использовать публичные объекты, которые уже были загружены ВКонтакте (прислать фотографию со стены своего сообщества или видеозапись из поиска), или загрузить новое вложение.

Ограничения при использовании кнопок:

Клавиатура может отображаться внутри сообщения — это inline-отображение. Чтобы включить его, передайте параметр inline в объект клавиатуры. Её максимальный размер составит 5 × 6. Максимальное количество клавиш: 10.

По умолчанию, если не передан параметр inline, клавиатура показывается под полем ввода в диалоге с пользователем (reply). Максимальный размер стандартной клавиатуры — 5 × 10. Максимальное количество клавиш: 40.

2. Исключение пользователя из беседы

vk_remove_chat_user(member_id)

где member_id — id пользователя, которого нужно исключить. Здесь же вы можете использовать значение from_id.

Пример: исключение из беседы при отправке ключевого слова.

Бот удалит из беседы того, кто прислал этот текст

3. Как получить имя пользователя

vk_get_name(from_id, full)

где full может принимать значение True (вы получите имя и фамилию) и False (получите только имя)

4. Как удалить последнее сообщение в беседе

vk_delete_last_message()

в скобках ничего не указывается. Произойдёт удаление последнего сообщения в беседе. На личные сообщения не распространяется

5. Как отправить стикер

vk_send_sticker(platform_id, sticker_id)

где platform_id — id клиента в мессенджере, sticker_id — id стикера.

Как узнать id стикера? Тот, кто подключал бота ВК, отправляет в бота нужный стикер. Его id при этом записывается в переменную. Значение переменной копируете из раздела Клиенты (см скрин:)

Результат:

Колбеки для группы:

client_group_join request - подан запрос на вступление в группу client_group_join approved - клиент принят в группу

6. Как обработать реакцию на сторис ВКонтакте

Если клиент отреагировал на сторис, в диалог автоматически придет уведомление об этом:

Данные о сторис будут в разделе "Информация о клиенте" в переменных:

story_id - идентификатор сторис

story_owner_id - владелец сторис

Кармабот для группы

Схему кармабота собирать не нужно, мы сделали это за вас! В разделе Шаблоны уже есть готовая воронка, ее нужно только установить и настроить. По ссылке ниже вы найдете подробное описание.

Геймификация в чатах ВКонтакте (Игра на активность)

1. Как настроить кармабот внутри ВК

Для работы Кармабота вам необходимо создать отдельную группу в ВК. В разделе "Управление - Сообщения - Работа в боте" вам необходимо поставить галочку "Разрешать добавлять сообщество в чаты"

После этого в меню группы Кармабота добавится следующее:

Нажимаете и выбираете, в какую беседу добавлять будущего бота:

Далее заходите в группу, где находится эта беседа. Нажимаете в меню справа "Сообщения":

Выбираете нужный чат. В нем кликаете на количество участников (вверху чата), в выпадающем окне устанавливаете боту права администратора

Назначать администратором обязательно, иначе бот в беседе работать не будет!

2. Что умеет делать Кармабот:

  • начислять +1 кармы, если один пользователь процитировал другого и поблагодарил

  • начислять +5 к карме по команде

  • исключать из чата по команде "бан"

  • удалять сообщения с нецензурными словами

Если участник чата благодарит сам себя, ему приходит сообщение:

Если забывает процитировать другого, то получает напоминание:

Если цитируют самого Кармабота, то:

Карма начисляется автоматически, если один пользователь цитирует другого и пишет ему "спасибо" и другие слова благодарности

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

Как получить Лидформу Вконтакте (ответы из Форм сбора заявок)

1. Как подключить Форму заявок к сообществу

Перейдите в Управление -> Приложения вашего сообщества, выберите приложение Форма заявок:

2. Как настроить лидформу

Чтобы настроить лидформу, нажмите на "Изменить" в Форме сбора заявок:

Откроется форма, где вы можете настроить доступ пользователей, сниппет и выбрать название:

3. Как получить данные лидформы в бот

Чтобы в Ваш бот передавались ответы из Форм сбора заявок, включите переключатель "Заполнение лидформы" в настройках подключенного канала

4. Как активировать лидформу нашего сообщества

После настройки формы копируем ссылку, идем в раздел Меню, добавляем новый раздел меню. Описание и добавляем ссылку на лидформу

Ваш клиент будет видит форму в соответствии с выполненными Вами настройками

После заполнения данных клиентом значения будут переданы в карточку клиента с соответствующим колбеком lead_forms_new

Как получить полный Вебхук Вконтакте

Вебхук (Webhook) - это возможность встроить уведомления на платформу о произошедшем событии, содержащее значения измененных переменных.

Для получения полного вебхука от ВКонтакте достаточно присвоить любое значение переменной save_webhook (переменная может быть как константой проекта, так и переменной сделки). При этом запрос от ВКонтакте будет записан в переменную vk_request.

Проверка подписки

Last updated