Действие

Блок действия отвечает за действия, которые совершает сервис Малти / Бот.

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

Также в навигации есть три вкладки:

1. Основные

2. Интеграции

3. Программы

Основные действия

Описание каждого типа действий по разделам:

Сообщения и чаты

1. Отправить сообщение Простое действие, которое работает во всех соц. сетях и мессенджерах. В отличие от блока сообщения не создает дополнительные порты выхода. Например, из кнопок невозможно направить в разные ветки схемы. Подробнее

2. Отредактировать сообщение Это действие по умолчанию реагирует на последнее сообщение. Например, чтобы каждый раз не отправлять новое сообщение с кнопками, а заменять одно сообщение Инлайн-кнопками. Подробнее

3. Отправить картинку Позволяет загрузить изображение с вашего устройства (ПК, телефона...). Ограничение по размеру файла — 10мб.

   Поддерживаются форматы: "jpg", "jpeg", "png". Подробнее

4. Исправить картинку Возможность исправить/заменить уже отправленную картинку. Подробнее

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

6. Удалить сообщение По умолчанию реагирует на последнее сообщение пользователя или бота, перед попаданием в этот блок.

7. Заявка на вступление в чат Позволяет принять или отклонить заявку на вступление в закрытый чат.

8. Исключить участника из чата Позволяет исключить участника из закрытого чата.

9. Забанить участника чата

10. Разбанить участника чата

11. Отправить опрос / викторину в Telegram

Стена

Стена в сообществе Вконтакте или в канале Telegram.

Действия по работе со стеной:

1. Написать комментарий Под конкретным постом написать комментарий или ответить пользователю (Игры в комментариях)

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

CRM

CRM (Customer Relationship Management) – система управления взаимоотношений с клиентами.

В этом разделе находятся функции управления пользователями.

1. Добавить в список Добавляет пользователя в один или несколько списков. Список можно создать как в отдельном разделе, так и прямо в этом контейнере.

2. Удалить из списка Удаляет пользователя из одного или нескольких списков.

3. Обновить профиль пользователя Обновляет в сервисе "Малти" стандартные поля пользователя на заданные вами. Например, с помощью переменных.

4. Добавить контакт в профиль Добавляет в профиль пользователя внутри сервиса "Малти" контактные данные: Телефон, Email, ID Telegram, ID ВКонтакте.

5. Поменять местами пользователей события Позволяет изменить выполнение логики работы бота на другого пользователя: Пользователь, Автор, Чат./Канал

6. Удалить контакты из профиля Удаляет из профиля пользователя внутри сервиса "Малти" контактные данные: Телефон, Email, ID Telegram, ID ВКонтакте.

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

8. Найти пользователя по значению поля Поиск производится по полю профиля пользователя и его значению.

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

10. Задать значение числового поля Управление содержимым числовых полей. Вы можете задать значение, прибавить, отнять, умножнить и т.д. Числовые поля можно создать прямо в этом контейнере или в специальном разделе пользовательских полей.

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

12. Задать значение текстового поля Управление содержимым текстовых полей. Вы можете задать значение, прибавить, отнять, умножнить и т.д. Текстовые поля можно создать прямо в этом контейнере или в специальном разделе пользовательских полей.

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

14. Сохранить массив в поле профиля Позволяет сохранить массив в поле профиля с типом данных "JSON массив".

15. Задать значение JSON поля Позволяет сохранить массив в поле профиля с типом данных "JSON объект".

16. Получить значение JSON поля Позволяет достать данные из поля профиля пользователя с типом данных "JSON объект" и сохранить результат в переменную.

17. Сохранить дату и время в поле профиля Позволяет сохранить дату и время в формате Unix в поле профиля с типом данных "Дата и время".

18. Получить дату и время из поля профиля Позволяет достать данные из поля профиля пользователя с типом данных "Дата и время" в Unix-формате, сохранив в переменную.

19. Количество пользователей в списке Позволяет вывести в переменную количество пользователей в одном или нескольких списках.

20. Удалить значение поля профиля пользователя Удаляет содержимое конкретного поля у пользователя.

21. Очистить данные пользователя Удаляет все значения стандартных полей в сервисе "Малти": Фото, Имя, Фамилия, Псевдоним, Обращение, Язык, ID источника регистрации.

22. Удалить пользователя Удаляет профиль пользователя и все его активности из сервиса "Малти".

Продажи

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

Канал/Сообщество

Сообщество ВКонтакте или канал в Telegram.

1. Заявка на подписку или вступление Может принять или отклонить заявку на вступление в чат.

2. Забанить подписчика канала / страницы Блокирует доступ пользователю к вашему сообществу ВКонтакте или каналу в Telegram.

3. Разбанить подписчика канала / страницы Возвращает ранее закрытый доступ пользователю к вашему сообществу ВКонтакте или каналу в Telegram.

4. Исключить подписчика канала / страницы Исключает пользователя из вашего сообщества ВКонтакте или канала в Telegram.

Таймер

1. Запустить таймер Позволяет запустить таймер с множеством параметров.

2. Отметить таймер Позволяет отменить для пользователя конкретный таймер в текущей схеме как по id контейнера, так и по имени таймера. Также позволяет отменить ожидание нажатия на конкретную кнопку.

Функция та же, что и в отдельном блоке таймера.

Геймификация

Геймификация — это дополнительные поля пользователей, которым можно управлять с помощью блока действия.

Создавать элементы геймификации можно внутри этих функций или в отдельном разделе геймификации.

1. Изменить баланс валюты Управляйте валютой пользователя используя математические значения: добавить, отнять, умножить и т.д.

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

3. Изменить количество ресурса Управляйте ресурсами пользователя используя математические значения: добавить, отнять, умножить и т.д.

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

5. Выдать достижение Выдает пользователю выбранное достижение. Одно достижение в одни руки, т.е. нельзя выдать 2 одинаковых достижения.

6. Забрать достижение Забирает у пользователя выбранное достижение.

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

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

Схема

Эти действия влияют непосредственно на саму схему.

1. Задать значение текстовой переменной Инструмент управления текстовыми переменными. Вы можете здесь создавать свои и присваивать им определенные значения. А так же изменять содержимое и удалять переменную.

2. Задать значение числовой переменной Инструмент управления числовыми переменными. Вы можете здесь создавать свои и присваивать им определенные значения.

3. Задать переменную статуса: True/False

4. Записать в переменную JSON или массив

5. Задать пакет временных переменных

6. Удалить временную переменную

7. Задать переменную шаблона

8. Задать пакет переменных шаблона

9. Задать глобальную переменную Инструмент позволяет задать, изменить, удалить значение глобальной переменной (одинаковой для всех пользователей) в текстовом, числовом и JSON форматах.

10. Сменить значение поля шаблона

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

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

13. Сменить канал для следующих действий Выберите другой канал/сообщество, в которых будут происходить последующие действия.

14. Переключить интеграцию Укажите интеграцию, для которой будут выполняться последующие действия.

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

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

Вся информация о работе с переменными [содержится тут].

Интеграции

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

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

Рассылки

1. Добавить в группу Senler

2. Удалить подписчика из Senler

Оплата

1. Создать ссылку на оплату в YooMoney

2. Создать ссылку на оплату в Prodamus

Создает полноценную платежную страницу Prodamus. Доступный функционал:

• задать скидку

• добавить продукт и описание заказа

• Задать срок жизни ссылки

• Активировать подписку (рекуррент)

• сохранить ссылку в переменную

• и другие...

3. Сменить статус подписки в Prodamus Позволяет отключить подписку. Например, пользователь может ввести ключевое слово и подписка будет отключена с помощью данного действия.

4. Применить скидку на подписку в Prodamus Позволяет применить скидку для текущей подписки на следующие продления. Можно указать сумму скидку и количество месяцев с этой скидкой.

5. Дата след. платежа по подписке в Prodamus Позволяет отложить следующий платеж для текущей подписки.

ВКонтакте

1. Отправить запрос к API VK Позволяет с помощью простых методов отправить любой внешний запрос и получить ответ. [Инструкции VK API]

2. Загрузить картинку в историю VK

По умолчанию вы можете загрузить свою картинку.

И вызвав это действие каким-то событием, бот опубликует эту картинку в историях вашего сообщества.

Ссылка на пример готовой схемы для TG и VK: 💾 Cкачать схему 🔧 Инструкция по установке схем

Также есть дополнительные параметры:

Скачать картинку по ссылке

Здесь вы можете вставить ссылку на картинку, либо использовать переменную.

Например, если вы хотите, чтобы после публикации постов, картинка автоматически отправлялась в историю, то подставьте переменную: {var:object.attachments[0].photo_url}

Добавить кнопку

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

• Выберите какой текст будет отображаться на кнопке

• И вставьте ссылку, куда будет вести кнопка (рекомендуются ссылки только на ВК)

Например, если вы хотите, чтобы после публикации постов, ссылка автоматически подставлялась в кнопку истории, то подставьте переменную: {var:object.url}

Добавить код стикеров

Вы можете автоматически подставлять стикеры на ваши изображения в историях.

Для этого вы можете использовать JSON

Согласно документации VK. Добавляются только кликабельные области. Сами стикеры должны быть нарисованы на картинке. Координаты указывайте отталкиваясь от размеров холста: 1080х1920px

Ниже приведем пример JSON-массива:

[
  {
      "type": "mention",
      "clickable_area": [
          {
              "x": 0,
              "y": 0
          },
          {
              "x": 1080,
              "y": 0
          },
          {
              "x": 1080,
              "y": 800
          },
          {
              "x": 0,
              "y": 800
          }
      ],
      "mention": "[club{var:platform.integration.id}|@club]",
      "style": "red_gradient"
  }
]

Телеграм

1. Отправить вложение в Телеграм

Вы можете выбрать формат вложения и вставить код объекта, который ранее был отправлен в этот Telegram-бот.

Как получить код вложения:

Вам понадобится два блока: 1. Событие - "Входящее сообщение" с условием - "Тип вложения". 2. Сообщение с текстом: Код вложения: {var:object.attachments[0].code}

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

2. Отправить запрос к Telegram API Позволяет работать напрямую с API с помощью простых запросов. [список запросов]

ИИ

1. Сгенерировать сообщение от ChatGPT

• Выберите интеграцию с OpenAI

• Инструкция для бота (prompt) Не обязательна. Здесь можете задать условия, при которых будет работать бот

• Сообщение от пользователя. Здесь можете сразу задать переменную {var:object.text}

• Настроить дополнительные параметры

  • Модель - это разные конфигурации логии работы ИИ.

  • Максимум токенов - Максимальное количество символов, которое будет в ответ отправлять искусственный интеллект.

  • Температура ответов - влияет на разницу между ответами бота. Работает, если вы сохраняете предыдущие ответы и отправляете их повторно.

  • История переписки - задается в JSON-формате.

• Сохранить текст сообщения в переменную Вы можете сохранить результат ответа бота в переменную, например: otvet После чего вывести в блок сообщения переменную: {var:otvet}

2. Сгенерировать текст через OpenAI

• Выберите интеграцию с OpenAI

• Укажите текст запроса (prompt) По умолчанию рекомендуем поставить туда переменную {var:object.text}

• В дополнительных параметрах можете указать

  • Модель - это разные конфигурации логии работы ИИ.

  • Максимум токенов - Максимальное количество символов, которое будет в ответ отправлять искусственный интеллект.

• Сохранить в переменную - вы можете сохранить результат ответа бота в переменную, например: otvet После чего вывести в блок сообщения переменную: {var:otvet}

Графика

1. Создать сертификат в ГрамотаДел

Интеграция с свервисом ГрамотаДел позволяет генерировать картинки с текстом и фотографией. Например, подставлять имя и фамилию пользователя и выдавать грамоты, либо использовать картинки для геймификации.

Программы

Программы — дополнительные действия работы с математическими выражениями, текстом, массивами и внешними запросами API.

Математика

Результаты вычислений по умолчанию сохраняются в переменную {var:result}, НО она перезаписывается в следующем действии новым результатом. Рекомендуем сохранять результаты вычислений во временные переменные. В каждом действии есть возможность подставлять собственные переменные, в которых вы храните числа и хотите использовать их для вычислений.

1. Калькулятор Выполняет простые математические примеры. Умеет подставлять данные из числовых переменных.

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

3. Степень числа Задайте число и степень, в которую нужно возвести.

4. Модуль числа Используйте, если нужно преобразовать число из отрицательного в положительное. Например, задаем в поле число -5 и на выходе получаем 5.

5. Корень квадратный числа Пример: потому что 4*4=16
6. Округлить до меньшего числа Например, число 3,159 округлит до 3.

7. Округлить до большего числа Например, число 3,159 округлит до 4.

8. Цифровая сумма числа

9. Цифровой корень числа

10. Нумерологический корень числа

11. Заменить буквы на цифры

Текст

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

1. Посчитать количество символов

2. Очистить от HTML тегов

3. Сменить регистр текста

4. Поиск и замена в тексте

5. Поиск в тексте по регулярному выражению

6. Сгенерировать пароль

7. Конвертировать переменную в текст

Массивы

1. Создать массив из текста Загружаете в поле список данных и указываете тип разделителя. На выходе получаете готовый массив данных. Поддерживает переменные. Например, загружаете данные, записанные в столбик, выбираете тип разделителя - перенос строки. Каждая строка - элемент массива.

2. Преобразовать массив в текст

3. Создать массив из объекта

4. Получить элемент массива по индексу Каждый элемент массива имеет свой индекс(номер), как номер строки в списке. Это действие достает определенный элемент массива по его номеру.

5. Фильтрация и поиск элементов массива

6. Добавить новые элементы в массив

7. Удалить элемент из массива

8. Пересечение массивов

9. Расхождение массивов

10. Объединить массивы в один

11. Обрезать массив

12. Удалить повторяющиеся элементы массива

13. Посчитать количество элементов в массиве

14. Перемешать элементы массива

15. Отсортировать массив

Время

1. Смещение времени

Вы можете указать исходное время в Unis-формате, сделать смещение на определенное количество дней, часов, минут и сохранить результат в переменную.

API

1. Отправить запрос на внешний сайт

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

• Бот-цитатник

• Гороскоп

Но если вы хотите более подробно изучить действие, то посмотрите эту инструкцию.

2. Отправить запрос к API платформы

Универсальное действия для удобной работы с внешними API-запросами с любыми платформами, которые вы интегрировали в Малти.

Панель быстрого доступа

В нижней части редактирования блока есть дополнительные кнопки (всегда под рукой)

1. Создать дополнительный контейнер

2. Отправить сообщение

3. Запустить таймер

4. Задать значение текстовой переменной

5. Задать значение числовой переменной

6. Добавить в список

7. Удалить из списка