Сайт сервиса Сообщество ВК

Событие

Блок события отвечает за действия, которые совершили пользователи или произошли с ботом.

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

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

Если создать несколько контейнеров событий в одном блоке, то выходной порт блока сработает при срабатывании любого из таких событий.

Подробнее о логике работы контейнеров [читайте тут].

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

Для удобства, вы можете добавить условие прямо в контейнере события без необходимости создавать отдельный блок условия.

Подробнее о работе блоков условий [читайте тут].

Важное пояснение для новичков!

БОТ

Смысл значения слова БОТ может зависеть от контекста.

Если бот в Telegram - здесь всё понятно, это отдельная сущность, которая создается в Telegram как бот через помощника @botfather,

то во ВКонтакте нет отдельных ботов. Тут ботом является сообщество.

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

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

ЧАТ

В Telegram и большинстве других мессенджеров - это "группа". Во ВКонтакте - это "беседа".

Учитывайте эти моменты, когда будете выбирать нужный контейнер в блоке события.

Тип запуска события

В блоке условия есть несколько типов запуска.

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

Всего есть шесть типов запуска:

  • Перезапускать всю схему

  • Перезапускать ветку

  • Выполнять, если завершил ветку

  • Разрешать параллельный запуск

  • Выполнять ветку не более одного раза

  • Выполнять, если завершил схему

Ниже разберем каждый тип подробнее.

Важное пояснение!

Ветка — это цепочка соединенных между собой блоков с помощью стрелок.

Их может быть много.

Ветка всегда начинается с блока события.

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

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

Перезапускать всю схему

Если пользователь попадет повторно в этот блок события, то эта опция запускает схему заново и удаляет пользователя из ожиданий событий, кнопок и таймеров.

Перезапускать ветку (стоит по умолчанию)

Если пользователь попадет повторно в этот блок события, то эта опция запускает ветку заново и удаляет пользователя из ожиданий событий, кнопок и таймеров (в рамках ветки этого события).

Выполнять, если завершил ветку

Блок события сработает повторно, только если пользователь прошел ветку. Т.е. дошел до последнего блока без кнопок и стрелок на выходе в рамках ветки этого события.

Выполнять, если завершил всю схему

Блок события сработает повторно, только если пользователь дошел до блока без кнопок и стрелок на выходе.

Выполнять ветку не более одного раза

Если пользователь проходил этот блок однажды хотя бы раз, то событие не сработает.

Разрешать параллельный запуск

Если пользователь еще не прошел схему, параллельно запустится её вторая копия. Будьте осторожны, может привести к задвоению сообщений!

Описание каждого типа события по разделам:

Общие типы

Сообщение (события с реакцией на сообщения в сообществе / боте)

  1. Входящее сообщение По умолчанию срабатывает на любое входящее сообщение, которое написал пользователь в бота Telegram или сообщество ВКонтакте. Не забудьте добавить условие — например, "Ключевое слово".

  2. Нажата кнопка сообщения (инлайн) Срабатывает на нажатие любой inline-кнопки (кнопка внутри сообщения). Не забудьте добавить условие — например, "Текст события"

  3. Сообщение исправлено По умолчанию срабатывает на любое сообщение, которое исправил пользователь в диалоге с ботом Telegram или с сообществом ВКонтакте.

  4. Входящее сообщение в чате По умолчанию срабатывает на любое входящее сообщение, которое написал пользователь в чате Telegram или беседе ВКонтакте. Не забудьте добавить условие — например, "Ключевое слово".

  5. Исправлено сообщение в чате По умолчанию срабатывает на любое сообщение, которое изменил пользователь в чате Telegram или беседе ВКонтакте.

  6. Новый голос в опросе бота Реагирует на участие в опросах, в боте, сообществе, чате.

Бот (события связанные с ботами)

  1. Бот запущен / Разрешены сообщения В Telegram срабатывает на запуск бота (не срабатывает на "/start"). В ВКонтакте либо на первое сообщение, либо на нажатие кнопки "Разрешить сообщения".

  2. Бот остановлен / Запрещены сообщения В Telegram срабатывает на блокировку/остановку бота. В ВКонтакте запрет сообщений в сообществе.

  3. Бот добавлен в чат Срабатывает, когда чат Telegram или беседу ВКонтакте добавляется новый бот.

  4. Бот удален из чата Срабатывает, когда из чата Telegram или беседы ВКонтакте удаляется бот. Например, администратором.

  5. Бот назначен админом в чате Срабатывает, когда в настройках беседы/чата, изменяется статус прав бота на админский.

  6. Бот разжалован до участников в чате Срабатывает, когда в настройках беседы/чата, изменяется статус прав бота с админских на пользовательские.

  7. Бот добавлен в канал / сообщество Срабатывает, когда в канал Telegram добавляется новый бот (для ВК не работает).

  8. Бот удален из канала / сообщества Срабатывает, когда из канала Telegram удаляется бот (для ВК не работает). Например, администратором.

  9. Изменены права бота на канале Реагирует на изменение прав доступа у бота в канале/сообществе. Например, если боту выданы права администратора или наоборот - бот разжалован.

Чат (события, которые происходят в чате / беседе)

События для ВК и TG:

В чатах, когда происходят какие-то действия - появляются уведомления. В ВК нет событий чатов, но есть уведомления. И на них можно реагировать. В Telegram есть и уведомления и полноценные события.

  1. Входящее сообщение в чате Реакция на входящее сообщение в беседе ВКонтакте или Telegram-чате.

  2. Исправлено сообщение в чате По умолчанию срабатывает на любое сообщение, которое изменил пользователь в чате Telegram или беседе ВКонтакте.

Уведомления чата (системные сообщения). Назначения понятны из названий

  1. Уведомление: Участник вступил в чат

  2. Уведомление: Участник добавлен в чат

  3. Уведомление: Участник вышел из чата

  4. Уведомление: Участник удален из чата

  5. Уведомление: Изменено название чата

  6. Уведомление: Изменен аватар чата

  7. Уведомление: Закреплено сообщение в чате

  8. Уведомление: Откреплено сообщение в чате

События ниже работают только в Telegram!

  1. Новая заявка на вступление в чат Реакция на входящую заявку в беседу ВКонтакте или Telegram-чат. Например, человек подал заявку и бот проверяет оплатил пользователь доступ или нет. Если да, то принимает заявку, если нет, то отклоняет её.

  2. Участник вступил в чат Реакция на добровольное вступление нового пользователя в беседу ВКонтакте или Telegram-чат. Например, можно реагировать на вступление и отправлять приветственное сообщение в чат.

  3. Участник вышел из чата Реакция на добровольный выход пользователя из Telegram-чата.

  4. Участник добавлен в чат Реакция на добавление администратором пользователя в Telegram-чат.

  5. Участник удален из чата Реакция на удаление админом или ботом пользователя из Telegram-чата.

  6. Бот добавлен в чат Реакция на добавление админом бота в Telegram-чат.

  7. Бот удален из чата Реакция на удаление админом бота из Telegram-чата.

  8. Участник назначен админом в чате Реакция на назначение админом участника чата.

  9. Админ разжалован в участники чата Реакция на разжалования пользователя чата из админа до участника.

  10. Участник забанен в чате Реакция на блокировку участника в чате.

  11. Бот назначен админом в чате Срабатывает, когда в настройках беседы/чата, изменяется статус прав бота на админский.

  12. Бот разжалован до участников в чате Срабатывает, когда в настройках беседы/чата, изменяется статус прав бота с админских на пользовательские.

Канал / Сообщество (события, которые происходят в канале / сообществе)

События для ВК и TG:

  1. Новая заявка на вступление в канал / сообщество Реакция на входящую заявку в сообщество ВКонтакте или Telegram-канал. Например, человек подал заявку и бот проверяет оплатил пользователь доступ или нет. Если да, то принимает заявку, если нет, то отклоняет её.

  2. Участник подписался на канал / сообщество Реакция на добровольное добавление пользователем в сообщество ВКонтакте или Telegram-канал.

  3. Участник отписался от канала / сообщества Реакция на добровольный выход из сообщества ВКонтакте или Telegram-канала

  4. Участник добавлен в канал / сообщество Реакция на добавление пользователя администратором или ботом в сообщество ВКонтакте или Telegram-канал.

  5. Участник удален из канала / сообщества Реакция на удаление пользователя администратором или ботом из сообщества ВКонтакте или Telegram-канала.

  6. Участник назначен админом в канале Реакция на смену прав доступа пользователю на админские, в сообществе ВКонтакте или Telegram-канале

  7. Админ канала разжалован в участники Реакция на смену прав доступа пользователю с админских на пользовательские, в сообществе ВКонтакте или Telegram-канале

События уведомлений:

Работают только в Telegram!

В Telegram, в чате, когда происходят какие-то действия - появляются уведомления. Мы можем реагировать на эти уведомления действиями бота.

  1. Уведомление: Участник забанен в канале

  2. Уведомление: Закреплено сообщение в канале

  3. Уведомление: Изменено название канала

  4. Уведомление: Изменен аватар канала

События бота реакции на бота в канале смотрите в разделе Бот выше.

Стена (события, которые происходят на стене сообщества ВК или канала TG)

  1. Комментарий создан Реакция на новый комментарий на стене ВКонтакте или под публикациями в Telegram-канале.

  2. Комментарий исправлен Реакция на исправление комментария на стене ВКонтакте или под публикациями в Telegram-канале.

  3. Комментарий удален Реакция на удаление комментария на стене ВКонтакте или под публикациями в Telegram-канале.

  4. Комментарий восстановлен Реакция на восстановление комментария на стене ВКонтакте или под публикациями в Telegram-канале.

  5. Лайк добавлен Реакция на новый лайк на стене ВКонтакте или под публикациями в Telegram-канале.

  6. Лайк удален Реакция на удаление лайка на стене ВКонтакте или под публикациями в Telegram-канале.

  7. Репост поста Реакция на репост поста на стене ВКонтакте или в канале Telegram.

  8. Пост создан Реакция на публикацию нового поста на стене ВКонтакте или в канале Telegram.

  9. Пост исправлен Реакция на исправление поста на стене ВКонтакте или в канале Telegram.

Сайт

Здесь хранятся события, связанные с управлением сайтами.

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

  1. Входящий вебхук Позволяет сервису Multy.AI реагировать на входящие запросы из других сервисов. Например, передать данные с вашего сайта.

  2. Переход по ссылке Реагирует на переход по ссылке, сформированную с помощью переменной {url:}

Продажи

Временно недоступны. Будут работать, когда добавим конструктор сайтов.

  1. Поступил новый платеж Срабатывает, когда ваша платежная система присылает отчет в Малти о поступившей оплате от клиента.

  2. Заказ создан

  3. Заказ изменен

  4. Заказ удален

  5. Платная подписка создана

  6. Платная подписка продлена

  7. Платная подписка отменена

  8. Истек срок платной подписки

  9. Ошибка продления платной подписки

  10. Уведомление платной подписки

Уникальные события интеграций

ВКонтакте

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

  2. Исправлен комментарий в обсуждении ВК Срабатывает, когда пользователь исправляет свой комментарий в обсуждении сообщества ВКонтакте

  3. Удален комментарий в обсуждении ВК Срабатывает, когда пользователь удаляет комментарий в обсуждении сообщества ВКонтакте

  4. Восстановлен комментарий в обсуждении ВК Срабатывает, когда пользователь восстанавливает (возвращает удаленный) комментарий в обсуждении сообщества ВКонтакте

Рассылки

  1. Подписка на группу в Senler Запускается в момент подписки пользователя на группу подписчиков Senler

  2. Отписка от группы в Senler Запускается в момент отписки пользователя от группы подписчиков Senler

  3. Входящий вебхук от бота Senler По умолчанию срабатывает на любой входящий вебхук, отправленный из бота Senler. Можете добавить условие — например, "Бот Senler".

Подробные инструкции о каждом событии

Входящий вебхук

Событие «Входящий вебхук» позволяет сервису Multy.AI реагировать на входящие запросы из других сервисов, например, передать данные с вашего сайта.

В этой инструкции будет показан наглядный пример, но перед началом убедитесь, что интегрировали ваше сообщество ВКонтакте или бота в Telegram с сервисом Multy.AI по этим инструкциям:

Интегрировали? Отлично, идем дальше Перед подключением вебхука в блок-схеме его необходимо создать. Для этого в вашем проекте выбираете «Настройки проекта» -> «Вебхуки» и нажимаете «Создать»

Пример создания вебхука

Создание вебхука

Не пугайтесь, все рассмотрим по пунктам:

1) Заголовок - Имя для администраторов. Используется в списках и таблицах. Можете указать человекопонятный заголовок для администраторов. Например: Tilda.

2) Включено и работает - Включенный переключатель сигнализирует о том, что сервис Multy.AI будет реагировать на запросы. Если он выключен, то соответственно не будет.

3) Webhook URL- Адрес для отправки запросов в сервис Multy.AI. Используйте на внешнем ресурсе для отправки запросов на этот вебхук

4) Текст ответа - В данном поле вы указываете какой ответ должен вернуть сервис Multy.AI стороннему сервису, чтобы запрос считался успешным и не было повторных запросов, что сервер успешно принял и обработал вебхук. Примеры ответов можете найти в документации к соответcтвующим сервисам.

5) URL для перенаправления (в приоритете) - Здесь можно указывать на какой адрес перенаправлять пользователя.

6) Тип контакта - Здесь указываете по какому параметру будет произведен поиск пользователя. Включает следующие 2 параметра. Если задать, то бот попытается найти или создать пользователя еще до запуска блок-схем.

Варианты:

  • Не задано. Обрабатывать схемой - поиск пользователя игнорируется. Следующие два параметра игнорируются.

    • Системный ID пользователя в рамках проекта - поиск пользователя по системному ID в рамках проекта Multy.AI.

    • Номер телефона - поиск пользователя по номеру телефона.

    • Email - поиск пользователя по электронной почте.

    • ID аккаунта в Telegram - поиск пользователя по указанному ID в мессенжере Telegram.

    • ID профиля ВКонтакте - поиск пользователя по указанному ID в социальной сети ВКонтакте.

7) Источник данных - Часть объекта запроса в которой будет происходит поиск по указанному ниже пути.

Варианты:

  • JSON параметры запроса - параметры запроса переданы в виде JSON.

  • GET-параметры ссылки - параметры ссылки переданы в виде GET-параметров, они указаны после ?. Например, для сайта https://youdomain.com?id=123 GET-параметр ID со значением 123

  • Классический POST запрос - поля HTML формы (multipart/form-data)- параметры переданы в виде POST-параметров.

8) Путь к значению контакта - нужно указать, где будет искать путь для пользователя. Например, для ВКонтакте значение ID может быть найдено по такому пути: object.from_id

9) Задать интеграцию - В данном списке вы можете выбрать интеграцию для которой будет срабатывать вебхук. Например вы можете выбрать бота и все сообщения будут отправляться от его имени.

После настройки не забудьте нажать «Сохранить».

Сложно? Нет, ниже будет примерчик, как настроить рассылку в Telegram, через запросы.

Открываем сайт: https://skyjoom.com/servises/a/3-sites/291-massovyj-zapusk и видим что параметры нужно передать в sid. Отлично.

Сохраняем и копируем вебхук на сайт https://skyjoom.com/servises/a/3-sites/291-massovyj-zapusk в соответствующее поле и дописываем параметр ?sid=%sid%. Telegram ID указываем как на скрине. Там написано ID ВКонтакте, но мы сделаем рассылку в Telegram.

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

Пример массового запуска.

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

Будьте внимательны.

Рассмотрение схемы

Создаем событие «Входящий вебхук» с условием «Вебхук, который запустил событие» и выбираем нужную интеграцию. В примере: Telegram

Важно! Этот пример создан для понимания работы вебхуков.

Добавляем действие «Отправить сообщение» с текстом рассылки:

Привет, {var:users.user.first_name} {var:users.user.last_name}! Приглашаем вас на наш вебинар по курсу аэрографии, который проводится 25 января в 17:00 по московскому времени.

и соединяем блоки. Включаем схему и жмем кнопку на сайте массового запуска.

Готово!

PreviousВиды блоковNextДействие

Last updated