1.7 Личные сообщения и комментарии

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

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

"Дополнительные настройки" - ссылка, разворачивающая дополнительную секцию с второстепенными опциями.

"Отправлять пользователю один раз" - это сообщение будет отправлено один раз, даже если активность запустится несколько раз. Бывают ситуации, когда активность нужно перезапустить, но присылать одно и то же пользователю нельзя - это как раз для таких случаев. Если сообщение должно уходить несколько раз (например, сообщение о текущем балансе) - эта опция должна быть, естественно, отключена.

"С момента отправки прошло не менее" - полезно, если вы хотите, например, сделать благодарность за репост или комментарий и пользователю не должно прийти много сообщений, если он делает несколько комментариев.

"Группировать" (только для комментариев) - при помощи этой опции, вы можете делать несколько блоков "Комментарий", которые будут отправлены одним составным комментарием в конце выполнения схемы. Это стоит использовать, например, если вы шлёте пользователю разные варианты текста и одну динамическую картинку. На выходе получается текст с картинкой.

"Ответ на ID комментария" - комментарий будет отправлен в ответ на пользовательский комментарий с этим ID. Например, если вы отвечаете не сразу, а после каких-то действий пользователя. Тогда $el_id его изначального комментария сохраняется в ресурс или хранилище, а потом можно отправить ответ, используя это сохранённое значение.

"Токен сообщества" - опция, позволяющая использовать для отправки комментариев токен сообщества. При этом полностью снимается вопрос капчи, но невозможно закачивать картинки по ссылке. Используйте, если нужно много писать в ответы. Использование этой опции требует ручной перегенерации ключа доступа сообщества! Вы должны самостоятельно сделать ключ с разрешением доступа к стене сообщества в настройках API ВКонтакте и сохранить его в настройках сообщества AU.

Переменные

В сообщения можно вставлять переменные нескольких типов,

{name} - заменится на имя пользователя

{namelink} - имя пользователя в виде ссылки. Используйте в комментариях, чтобы привлечь внимание пользователя - у него появится уведомление при упоминании.

{fullname} - полное имя, с фамилией.

{total_text} - счёт пользователя в основной валюте группы, заменится, например на "14 монеток".

{total_text_ID} - где ID - идентификатор нужного ресурса.

{res_ID} - работает так же как предыдущая переменная, но пишет только цифры, без текста.

{resname_ID} - название ресурса. Если в настройках прописаны склонения, то можно даже сделать вот так: {resname_ID_CNT}, где CNT - количество ресурса, которое может быть переменной типа {b10_v}.

{list_ID} - покажет пользователей из списка номер ID. Осторожно с этим, список не должен быть большим, потому что у сообщений есть ограничения на объём текста. Большое сообщение просто не отправится.

{listcnt_ID} - количество пользователей в списке с указанным ID.

{link_ID} - поставить внешнюю ссылку с порядковым номером ID.

{promocode} - промокод пользователя для реферальной системы.

{inventory} - список ресурсов с типом "инвентарь" у пользователя, начиная с самых многочисленных.

{user_rate_text} - выводит краткий рейтинг в основной валюте группы, первых трёх пользователей и номер места пользователя, которому отправляется сообщение. Функция устарела, работает только в основной валюте группы и без настроек исключений.

{rate_ID} - то же самое, только с учётом всех настроек конкректного рейтинга.

{team_rate_text} - командный рейтинг в основной валюте группы

[sex]текст мальчику|текст девочке[/sex] нужный текст будет подставлен в зависимости от пола пользователя.

[вариант 1|вариант 2|вариант 3] - выдаст случайный вариант, написать их можно сколько угодно. Поддерживаются также вложенные конструкции, только не запутайтесь со скобками. Вероятность выпадения вариантов примерно одинаковая. Используйте их, чтобы разнообразить ответы бота, например так: [Здравствуйте|Доброго [дня|времени суток]], [дорогой|уважаемый|драгоценный наш] [человек|подписчик|читатель]!

Если нужно одновременно использовать переменные пола и случайные варианты - комбинируйте их так: [[sex]парню привет|девушке привет[/sex]|всем привет], то есть переменная пола внутри переменной с вариантами.

Поддержка вложений

Вложения можно отправить двумя способами. Первый - вкладка "Вложения" в редакторе ЛС или комментария. И второй - текстовые константы в тексте сообщения. Они не будут показаны пользователю, но будут преобразованы во вложения во время отправки.

{photo-11111_2222} - фото, уже закачанное ВКонтакте

{video-11111_2222} - видео

{audio-11111_2222} - аудио

{doc-11111_2222} - документ

Эти типы вложений требуют, чтобы файл был уже закачан во ВКонтакте и не был закрыт настройками приватности. А вот так можно загрузить любую картинку по ссылке.

{http://your-site.com/image.jpg} - закачка картинки по ссылке

[{http://your-site.com/image1.jpg}|{http://your-site.com/image2.jpg}|{http://your-site.com/image3.jpg}] - объединение закачки с рандомом, пользователю придёт случайная картинка из выборки. Внимательно смотрите скобки!

{http://activeusers.ru/viz/10.viz} - динамическая картинка на основе хранилища #10, если вы используете какой-либо генератор изображений (например cover41).

Переменные блоков

Если вы используете блоксхему - то можете подставить в личное сообщение результат из поля любого блока операции. Делается это так:

{b12_value} - это значит, что будет подставлено значение поля value из 12-го блока в схеме. Чтобы узнать имена полей блоков, откройте окно редактирования блока и нажмите значок исходного кода в заголовке, блок при этом покажет все свои переменные.

Переменные со знаком доллара в сообщениях не используются. Сообщения и комментарии могут только ссылаться на блоки в схеме с уже объявленными переменными.

{b0_from_id} - эта константа содержит в себе ID инициатора активности. Используйте, если вам нужно отправить администратору (выбирается в цели сообщения) ссылку на выполнившего активность или на его диалог с группой. В сообщении при этом можно использовать такие конструкции https://vk.com/gim164338148?sel={b0_from_id} и https://vk.com/id{b0_from_id}

{b0_el_id} - ID сообщения или комментария в ВК, который был создан инициатором активности.

{b0_obj_id} - ID родителя (например поста, если речь о комментарии), созданного инициатором активности.

{b0_from_link} - ссылка на личное сообщение или комментарий, созданный инициатором активности. Используйте, чтобы уведомлять администратора со ссылкой на добавленный комментарий или сообщение. Например http://vk.com/id{b0_from_id} оставил сообщение {b0_from_link}.

1.7 Личные сообщения и комментарии

Переменные

Поддержка вложений

Переменные блоков

Оглавление

Реквизиты