Salebot.pro
Search…
Вконтакте
Подключаем бота к группе Вконтакте
Максимальная длина текстового сообщения 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, 'ТЕКСТ ПЕРЕД КАРУСЕЛЬЮ')
Вы можете воспользоваться табличкой и просто вставить нужные значения заголовков, ссылок и тд, а потом просто скопировать в ваш блок
В поле "Ответ" оставляем #{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
Copy link
On this page
Как подключить группу ВК
Как прописать метку в прямой ссылке на сообщения группы
Как автоматизировать группу с помощью Salebot
Событие: Пользователь оставил новый комментарий
Событие: Пользователь сделал репост записи себе на стену
Событие: Вступление в группу
Событие: Выход из группы
Событие: Клиент лайкнул пост
Как работать с комментариями под постами
Как оставить комментарий на стене:
Как настроить работу бота в беседе
Как исключить пользователя из беседы:
Как получить имя пользователя
Как удалить последнее сообщение в беседе
Как отправить стикер
Как сделать Кармабот ВКонтакте
Как собрать схему кармабота
Как настроить кармабот внутри ВК
Что умеет делать Кармабот:
Как создать Карусель
Как отправить несколько картинок
Как обработать реакцию на сторис ВК
Как обрабатывать отклики на товары ВК
Как получить Лидформу Вконтакте (ответы из Форм сбора заявок)
Как сделать минилендинг ВК
Возможные ошибки при работе с ВКонтакте:
Ошибка 2000
Ошибка 10 (912)
Как избавиться от дублирования сообщений в ВК
Как настроить ретаргетинг Вконтакте
Основные данные
Как добавить пользователя в аудиторию ретаргетинга ВК
Как удалить пользователя из аудитории ретаргетинга ВК
Как добавить новую аудиторию ретаргетинга ВК
VK Pay
Как узнать идентификатор пользователя и идентификатор группы
Уведомления VK Donut
API Вконтакте (функции для использования всех возможностей Вконтакте)