Вконтакте

Search…
Вконтакте
Подключаем бота к группе Вконтакте
​Как подключить группу ВК​
​Как прописать метку в прямой ссылке на сообщения группы​
​Как автоматизировать группу с помощью Salebot​
​Как работать с комментариями под постами​
​Как настроить работу бота в беседе​
​Как сделать Кармабот ВКонтакте 
​Как создать Карусель ​
​Как отправить несколько картинок​
​Как обработать реакцию на сторис ВК​
​Как обрабатывать отклики на товары ВК ​
​Как получить Лидформу Вконтакте (ответы из Форм сбора заявок) ​
​Как сделать минилендинг ВК ​
​Возможные ошибки при работе с ВКонтакте ​
​Как настроить ретаргетинг Вконтакте​
​VK Pay​
​API Вконтакте (функции для использования всех возможностей Вконтакте)​
Максимальная длина текстового сообщения 4096 символов
Как подключить группу ВК
Переходим в раздел "Мессенджеры и чаты"  и выбираем Вконтакте.
Если вы ранее не авторизовывались через Вконтакте на salebot, то увидите такую кнопку. Нажимаем на нее.
Далее будет выведен список со всеми группами, в которых Вы являетесь админом, а следовательно, у Вас есть права для подключения к ним бота. В списке будут также отображены группы, у которых отключены сообщения. Чтобы включить сообщения группы, следуйте указаниям документации вконтакте. (Для включения сообщений необходимо перейти в настройки группы, в разделе "сообщения" поставить галочку "разрешить сообщения"). 
Если какая-то из ваших групп уже подключена к другому проекту, будет указан номер этого проекта. 
В качестве примера подключим группу “Тест”.
После нажатия "Подключить" необходимо разрешить системе доступ к сообщениям группы в формах аутентификации ВКонтакте (здесь также жмем Разрешить). После успешного подключения группы она появится в списке.
Надо в настройках группы разрешить возможности для ботов, как показано на Рисунке 3. Без этого кнопки в боте работать не будут.
Рисунок 3
На этом подключение бота к группе ВКонтакте завершено
Как прописать метку в прямой ссылке на сообщения группы
Вы можете отслеживать с какого именно места/источника перешел пользователь который пишет в сообщения группы.
Для чего это можно использовать:
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 с телеграм канала ТесТ.
Для начала соберем ссылку, например такую:

vk.me/public202836320?ref=telegram&ref_source=ТесТ
или вот такую
vk.com/write-202836320?ref=telegram&ref_source=ТесТ
И разместим в канале, при переходе по данным ссылкам откроется диалог и на любое сообщение пользователя ему запишется две переменные в salebot:

Как автоматизировать группу с помощью Salebot
Заходим в Мессенджеры и чаты, включаем все события, как на скрине:
Когда пользователь будет совершать то или иное действие, вы это сможете отследить с помощью коллбэка события:
Событие: Пользователь оставил новый комментарий
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 комментария, который оставили
Событие: Пользователь сделал репост записи себе на стену
client_wall_repost
в данном случае 10 — это id поста, который репостнули
Дополнительные параметры сохраняются в переменные:
wall_repost_text — текст, который пользователь добавляет к репосту
wall_repost_post_id — id поста, который репостнули
Событие: Вступление в группу
client_group_join 
Когда у вас добавится новый подписчик, коллбэк будет отображаться так:
В переменную сохраняется значение join_type
Если у вас закрытая группа, то после одобрения заявки значение переменной изменится:
Событие: Выход из группы
client_group_leave
Событие: Клиент лайкнул пост
client_liked_post 
в данном случае 11 — id поста, который лайкнули
Вы можете настраивать разные реакции на коллбэки, например, на лайк определенного поста. Например, присылать сообщение клиенту в лс:
здесь в условии стоит "11" это id поста, лайк под которым нужно проверять. Если убрать число, то реакция будет приходить на любой пост, который лайкнули
При лайке, репоста, вступлении в группу и выходе из неё клиент не создаётся
Если клиент не давал разрешения на сообщения или не писал ничего ранее в личные сообщения группы, то вы первым написать ему не сможете (например, приветствовать в личку сразу при вступлении в группу нельзя)
Такое вы увидите, если клиент не дал разрешение на отправку сообщений или не писал ничего ранее в лс группы
Как работать с комментариями под постами
Работает только на тарифе "Премиум"
Чтобы иметь возможность отвечать под комментариями, нужно вручную добавить токен.
Для этого заходите в вашу группу ВК, открываете Управление / Работа с API.
​
Нажимаете "Создать ключ" и копируете его.
Дальше переходите в Salebot, раздел Мессенджеры и чаты, в подключении ВК выбираете "Показать токены". Сюда вставляете скопированный токен и жмете "Добавить".
Как оставить комментарий на стене:
vk_create_comment(post_id, message, reply_to_comment, sticker_id)
где post_id — id комментируемого поста, message — текст комментария, reply_to_comment — id комментария, на который отвечаем (необязательный параметр), sticker_id — id стикера (необязательный параметр)
Если не передавать необязательные параметры, то функция будет выглядеть так: vk_create_comment(post_id, message)
Как настроить работу бота в беседе
Чтобы можно было добавить бота в беседу, необходимо в настройках включить это разрешение:
Бот с правами администратора видит все сообщения в беседе. Если бот не обладает этими правами, бот видит только те сообщения, где его упомянули через символ @
Если в беседе кто-то перешлет сообщение, то в боте появятся эти переменные. В них будет указано кто и что процитировал.
from_id 
reply_from_id 
reply_text 
reply_attachments
Переменная from_id хранит идентификатор того, кто отправил сообщение.
Как исключить пользователя из беседы:
vk_remove_chat_user(member_id)
где member_id — id пользователя, которого нужно исключить. Здесь же вы можете использовать значение from_id. 
Пример: исключение из беседы при отправке ключевого слова. 
Бот удалит из беседы того, кто прислал этот текст 
Как получить имя пользователя
vk_get_name(from_id, full)
где full может принимать значение True (вы получите имя и фамилию) и False (получите только имя)
Как удалить последнее сообщение в беседе
vk_delete_last_message()
в скобках ничего не указывается. Произойдёт удаление последнего сообщения в беседе. На личные сообщения не распространяется
Как отправить стикер
vk_send_sticker(platform_id, sticker_id)
где platform_id — id клиента в мессенджере, sticker_id — id стикера. 
Как узнать id стикера? Тот, кто подключал бота ВК, отправляет в бота нужный стикер. Его id при этом записывается в переменную. Значение переменной копируете из раздела Клиенты (см скрин:)
Результат
Как сделать Кармабот ВКонтакте
Как собрать схему кармабота
Схему кармабота собирать не нужно, мы сделали это за вас! В разделе Шаблоны уже есть готовая воронка, ее нужно только установить и настроить. По ссылке ниже вы найдете подробное описание.
Геймификация в чатах ВКонтакте (Игра на активность)
Как настроить кармабот внутри ВК
Для работы Кармабота вам необходимо создать отдельную группу в ВК. В разделе "Управление - Сообщения - Работа в боте" вам необходимо поставить галочку "Разрешать добавлять сообщество в беседы"
После этого в меню группы Кармабота добавится следующее:
Нажимаете и выбираете, в какую беседу добавлять будущего бота:
Далее заходите в группу, где находится эта беседа. Нажимаете в меню справа "Сообщения":
Выбираете нужный чат. В нем кликаете на количество участников (вверху чата), в выпадающем окне устанавливаете боту права администратора
Назначать администратором обязательно, иначе бот в беседе работать не будет!
Что умеет делать Кармабот:
начислять +1 кармы, если один пользователь процитировал другого и поблагодарил
начислять +5 к карме по команде
исключать из чата по команде "бан"
удалять сообщения с нецензурными словами
Если участник чата благодарит сам себя, ему приходит сообщение:
Если забывает процитировать другого, то получает напоминание:
Если цитируют самого Кармабота, то:
Карма начисляется автоматически, если один пользователь цитирует другого и пишет ему "спасибо" и другие слова благодарности
​
Сообщения от админов бот удалять не может, как и исключать их из беседы
Как создать Карусель
В карточках могут использоваться фотографии с соотношением сторон ТОЛЬКО 13:8 (Например, 1300 на 800 пикселей). Если взять другие фото, сообщение от бота НЕ придет
Рассмотрим на примере карусели из 3 карточек. Для создания карточек вам нужно в поле "Калькулятор" написать следующее:
p = [{"title":"заголовок", "description": "ОПИСАНИЕ КАРТОЧКИ 1", "image": "ССЫЛКА НА КАРТИНКУ 1", "buttons":[{"text":"ТЕКСТ КНОПКИ 1"}]},{"title":"заголовок", "description": "ОПИСАНИЕ КАРТОЧКИ 2", "image": "ССЫЛКА НА КАРТИНКУ 2", "buttons":[{"text":"ТЕКСТ КНОПКИ 2"}]}, {"title":"заголовок", "description": "ОПИСАНИЕ КАРТОЧКИ 3", "image": "ССЫЛКА НА КАРТИНКУ 3", "buttons":[{"text":"ТЕКСТ КНОПКИ 3"}]}]
r = send_carousel(p, 'ТЕКСТ ПЕРЕД КАРУСЕЛЬЮ')
То есть сначала записываем массив с title, description, image, buttons в переменную p (вы можете назвать переменную иначе), а далее используем ее в методе send_carousel(p, 'ТЕКСТ ПЕРЕД КАРУСЕЛЬЮ')
Вы можете воспользоваться табличкой и просто вставить нужные значения заголовков, ссылок и тд, а потом просто скопировать в ваш блок
​https://docs.google.com/spreadsheets/d/1QcZbSZ-Hjntm3kIp7Fm0chwvrvrQENfa/edit#gid=552753053​
В поле "Ответ" оставляем #{none}
В кнопки карточек карусели вы можете вставлять ссылки, тогда при нажатии на кнопку пользователь перейдет по ссылке
Чтобы вставить ссылку в кнопку на карточке, запишите в массив так (на примере одной карточки)
p = [{"title":"заголовок", "description": "ОПИСАНИЕ КАРТОЧКИ 1", "image": "ССЫЛКА НА КАРТИНКУ 1", "buttons":[{"text":"ТЕКСТ КНОПКИ 1", "url":"ССЫЛКА ДЛЯ КНОПКИ" }]}]
Как отправить несколько картинок
Для отправки нескольких картинок используйте функцию:
vk_send_some_photo(platform_id, image_list, text)
platform_id — id клиента в мессенджере 
image_list - массив картинок (подробнее ниже) 
text - необязательный параметр, текст сообщения с картинками
Пример
image_list: '["Ссылка на картинку 1", "Ссылка на картинку 2", "Ссылка на картинку 3"]'
Пример запроса: 
vk_send_some_photo('55741919977', '["https://mobimg.b-cdn.net/v3/fetch/5e/5e65ccfa836667c2747afed39c530952.jpeg", "https://mobimg.b-cdn.net/v3/fetch/c7/c7218e3b6c4aa73c29e356d80473648f.jpeg"]', 'Сообщение над картинками')
Как обработать реакцию на сторис ВК
Если клиент отреагировал на сторис, в диалог автоматически придет уведомление об этом:
Данные о сторис будут в разделе "Информация о клиенте" в переменных:
story_id - идентификатор сторис 
story_owner_id - владелец сторис
Как обрабатывать отклики на товары ВК
Когда пользователь отправляет отклик на товар, ему назначаются следующие переменные:
market_description —  описание товара (берется из карточки товара)
market_title — заголовок товара
market_price — стоимость товара
market_id — id товара
Как получить Лидформу Вконтакте (ответы из Форм сбора заявок)
Чтобы в вашего бота передавались ответы из Форм сбора заявок, включите переключатель "Заполнение лидформы"
Тогда при заполнении лидформы вы получите коллбэк lead_forms_new, а в карточке клиента появятся переданные из лидформы переменные
Как сделать минилендинг ВК
Вконтакте не поддерживает ссылки с ключом подписки, для этого был сделан отдельный минилендинг для вконтакте, работающий как приложение платформы.
Рисунок 5
Подробнее можно прочитать по ссылке: 
Минилендинги
Salebot.pro
​
Для того, чтобы для вашей ВК группе работал вк-лендинг, уставите приложение в нее по ссылке​
Рисунок 6 - пример установки приложения в группу
Если вы видите это на своем минилендинге, то приложение не установлено!
Если указан тег, то кнопка вк с обычного минилендинга будет вести на вк лендинг, чтобы тег не потерялся.
Возможные ошибки при работе с ВКонтакте:
Ошибка 2000
При попытке подключения группы ВК может возникать такая ошибка:
Эта ошибка означает, что в сообществе установлено максимальное количество серверов для работы с Callback API.
Чтобы решить проблему, необходимо зайти в Управление группы - Настройки - Работа с API - Callback API. На рисунке ниже стрелочкой выделена кнопка управления серверами. Все лишние и неиспользуемые сервера следует удалить. После этого предпринять еще одну попытку подключения.
Ошибка 10 (912)
Рисунок 5
Если при подключении группы вы получили ошибку как на рисунке 5, то попробуйте подключится позже. Как правило, через час или два, подключение происходит без проблем.
Рисунок 6
Если у вас не отправляются сообщения и вы в разделе клиенты видите ошибку "This is chatbot feature, change this status in settings", вы не разрешили кнопки в группах вк. Ссылку на эту настройку можно увидеть в разделе "Мессенджеры и чаты" -> "Вконтакте".
Если у вас не воспроизводится аудио на мобильном телефоне, то его необходимо перекодировать в mp3 mono
Как избавиться от дублирования сообщений в ВК
Если у вас дублируются сообщения в ВК, проверьте количество подключенных серверов в настройках группы.
Для этого заходите в группу, подключенную к проекту, там открываете раздел Управление - Работа с API:
​
 
​
Далее нам нужна вкладка Callback API, нажимаем:
Удаляем серверы, которые там есть:
После этого заходим возвращаемся в Salebot, открываем Мессенджеры и чаты, удаляем подключение: 
и переподключаем заново:
Готово!
Как настроить ретаргетинг Вконтакте
Основные данные
Для каждого запроса в проекте должен быть авторизованный вк пользователь, у которого есть нужный рекламный кабинет. Ниже приведен пример авторизации. После чего будет выдан токен для работы с API ретаргетинга.
Если в запросе будет передан емейл не авторизованного пользователя, в ответ будет отправлено сообщение: User {email} - is not authorized
Идентификатор рекламного кабинета (account_id)
Идентификатор рекламного кабинета можно найти, перейдя в настройки. Скопируйте его: он понадобится для использования функций ретаргетинга.
Идентификатор аудитории таргетинга (target_group_id)
Идентификатор нужной аудитории таргетинга, можно найти перейдя в раздел Ретаргетинг и нажав на нужную аудиторию. В выпадающем меню выбрать пункт Редактировать правила:
если такого пункта нет, тогда выбираем - Добавить аудиторию
Во всплывающем окне находим абзац с идентификатором аудитории:
Как добавить пользователя в аудиторию ретаргетинга ВК
Для добавления пользователя в аудиторию ретаргетинга, нужно вызвать функцию: vk_add_to_target_group('email', 'account_id', 'target_group_id', 'contacts', 'ads_client_id')
где: 
email - емейл сотрудника в проекте
account_id - идентификатор рекламного кабинета.
target_group_id - идентификатор аудитории таргетинга.
contacts - (необязательный параметр) список телефонов, email адресов, мобильные рекламные идентификаторы (IDFA, GAID) или идентификаторов пользователей, указанных через запятую.
По умолчанию передается идентификатор пользователя в вк.
ads_client_id - (необязательный параметр) только для рекламных агентств. id клиента, в рекламном кабинете которого будет редактироваться аудитория.
Примеры вызова функции: result = vk_add_to_target_group('[email protected]', '1606728577', '38572961')
с ads_client_id для рекламного агентства: result = vk_add_to_target_group('[email protected]', '1606728577', '38572961', '', '1234567')
Передача собственных данных вместо идентификатора клиента: result = vk_add_to_target_group('[email protected]', '1606728577', '38572961', '#{phone}')
Передача одновременно нескольких собственных данных, в примере номеров телефонов:
result = vk_add_to_target_group('[email protected]', '1606728577', '38572961', '78111111111, 782222222, 7833333333')
Как удалить пользователя из аудитории ретаргетинга ВК
Для удаления пользователя из аудитории ретаргетинга, нужно вызвать функцию: vk_remove_from_target_group('email', 'account_id', 'target_group_id', 'contacts', 'ads_client_id')
где: 
email - емейл сотрудника в проекте
account_id - идентификатор рекламного кабинета.
target_group_id - идентификатор аудитории таргетинга.
contacts - (необязательный параметр) список телефонов, email адресов или идентификаторов пользователей, указанных через запятую. По умолчанию передается идентификатор пользователя в вк.
ads_client_id - (необязательный параметр) только для рекламных агентств. id клиента, в рекламном кабинете которого будет редактироваться аудитория.
Примеры вызова функции: result = vk_remove_from_target_group('[email protected]', '1606728577', '38572961')
с ads_client_id для рекламного агентства: result = vk_remove_from_target_group('[email protected]', '1606728577', '38572961', '', '1234567')
передача собственных данных вместо идентификатора клиента: result = vk_remove_from_target_group('[email protected]', '1606728577', '38572961', '#{phone}')
удаление из аудитории пользователей одновременно по нескольким параметрам, в примере номеров телефонов: result = vk_remove_from_target_group('[email protected]', '1606728577', '38572961', '78111111111, 782222222, 7833333333')
Как добавить новую аудиторию ретаргетинга ВК
Для добавления аудитории ретаргетинга, нужно вызвать функцию:
vk_add_new_target_group('email', 'account_id', 'name', 'lifetime', 'ads_client_id')
где: 
email - емейл сотрудника в проекте, который подключил свой аккаунт к проекту и у которого находится нужный рекламный кабинет
account_id - идентификатор рекламного кабинета
name - название аудитории ретаргетинга — до 64 символов
lifetime - количество дней, через которое пользователи, добавляемые в аудиторию, будут автоматически исключены из нее. Число от 1 до 720
ads_client_id - (необязательный параметр) только для рекламных агентств. id клиента, в рекламном кабинете которого будет редактироваться аудитория.
При успешном запросе в ответ получите идентификатор созданной аудитории: {'id': 41333076}
Примеры вызова функции:
result = vk_add_new_target_group('[email protected]', '1606728577', 'Новая аудитория', 120)
result = vk_add_new_target_group('[email protected]', '1606728577', 'Новая аудтория', 120, '1234567')
VK Pay
Salebot поддерживает возможность создания кнопки об оплате через VK Pay. Для этого в Salebot необходимо включить соответствующую галочку.
ВНИМАНИЕ! И у вас, и у отправителя средств должен быть расширенный статус VK Pay. Чтобы получить его, нужно указать данные паспорта и ещё одного документа на выбор — ИНН или СНИЛС.
Для создания кнопки оплаты в меню выбора типа кнопки стоит выбрать “VK Pay”, после чего появится четыре типа оплаты: 
- перевод заданной суммы пользователю 
        * сумма 
        * идентификатор пользователя 
- перевод заданной суммы группе 
        * сумма 
        * идентификатор группы 
- перевод произвольной суммы пользователю 
         * идентификатор пользователя 
- перевод произвольной суммы группе 
         * идентификатор группы 
Где: 
Идентификатор пользователя - это ид человека, которому будут перечислены деньги (например, 169003040) 
Идентификатор группы - это ид группы, в которую будут поступать переводы (например, 212760554).

После активации бота пользователь получит кнопку следующего вида, после клика по которой выведется окно сервиса VK Pay.
Внимание! Независимо от названия кнопки в боте, Вконтакте кнопка будет выглядеть только таким образом:

Как узнать идентификатор пользователя и идентификатор группы
Для того, чтобы узнать идентификатор пользователя, необходимо зайти на его страницу Вконтакте и посмотреть ид в адресной строке браузера:

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

Аналогично с идентификатором группы - если группа не была переименована, то ее id будет в строке, если же была - можно поискать через фотографии.

Уведомления VK Donut
Подключить VK Donut нужно в группе Вконтакте

Если Ваша группа подключена к VK Donut, вы будете получать callback сообщения о следующих событиях: 
- Оформлена подписка на группу - client_donut_subscription_create 50 RUB 
- Подписка продлена - client_donut_subscription_prolonged 50 RUB 
- Подписка отменена - client_donut_subscription_cancelled 
- Подписка закончилась - client_donut_subscription_expired
API Вконтакте (функции для использования всех возможностей Вконтакте)
API в калькуляторе
Salebot.pro