База знаний BotVsem ⤵
Автоподстановка переменных в текст
Все подстановки в текст должны быть обвернуты в двойные фигурные скобки.
Константы
! Константа — постоянное значение, которое можно подставить в текст сообщения бота. Просто добавьте в текст {{имя}}, где имя — имя константы, см. ниже.
{{name}} — Подставить полное имя клиента в сообщение
{{first_name}} — Подставить имя клиента в сообщение
{{last_name}} — Подставить фамилию клиента в сообщение
{{phone}} — Подставить номер телефона клиента в сообщение
! Свои константы вы можете создать в разделе Ваш бот > Списки > Переменные
Пользовательские переменные
! Пользовательская переменная — переменное значение, которое заполняется пользователем. Переменные вы можете создать в окне редактирования блока сценария. Добавьте в текст: {{$ИмяПеременной}}
Системные функции
! Функция — подпрограмма, которую можно вызвать. Результат выполнения функции подставляется в сообщение от бота. В функцию можно передать аргументы (параметры), от которых зависит результат выполнения функции.
Арифметические операции
{{ sum(1, 2) }} — Сумма чисел
Сумма пользовательских переменных: {{ sum($переменная1, $переменная2) }}
Сумма нескольких значений: {{ sum($переменная1, 1, 2) }}
Псевдоним функции: {{ сумма(1, 2) }}
{{ diff(4, 2) }} — Разность чисел
Разность пользовательских переменных: {{ diff($переменная1, $переменная2) }}
Разность нескольких значений: {{ diff($переменная1, 1, 2) }}
Псевдоним функции: {{ разность(4, 2) }}
{{ multiplication(2, 2) }} — Произведение чисел
Произведение пользовательских переменных: {{ multiplication($переменная1, $переменная2) }}
Произведение нескольких значений: {{ multiplication($переменная1, 1, 2) }}
Псевдоним функции: {{ произведение(2, 2) }}
{{ div(4, 2) }} — Деление чисел
Деление пользовательских переменных: {{ div($переменная1, $переменная2) }}
Деление нескольких значений: {{ div($переменная1, 4, 2) }}
Псевдоним функции: {{ деление(4, 2) }}
{{ setSumVariablesIntoVariable(«сумма», «а», «б») }} — Записать сумму переменных/чисел в переменную
В переменную $cумма запишется сумма переменных $а и $б. В функцию передаются имена переменных в двойных кавычках или числа. Количество аргументов для передачи в функцию может быть до 100 шт.
{{ setMultiplicationVariablesIntoVariable(«произведение», «а», «б») }} — Записать произведение переменных/чисел в переменную
В переменную $произведение запишется произведение переменных $а и $б. В функцию передаются имена переменных в двойных кавычках или числа. Количество аргументов для передачи в функцию может быть до 100 шт.
Генератор случайных чисел и строк
{{ rand() }} — Сгенерировать случайное число
Сгенерировать случайное число от 5 до 100: {{ rand(5, 100) }}
{{ strRandom() }} — Сгенерировать случайную строку
Сгенерировать случайную строку длинной 20 символов: {{ strRandom(20) }}
Сгенерировать случайную строку длинной 20 символов заглавными буквами: {{ strRandom(20, true) }}
Сообщение для определенного мессенджера
{{ messageToTelegram(«Сообщение») }} — Сообщение в Telegram
Пример: {{ messageToTelegram(«Это сообщение отобразится только в Telegram») }}
{{ messageToViber(«Сообщение») }} — Сообщение в Viber
Пример: {{ messageToViber(«Это сообщение отобразится только в Viber») }}
{{ messageToWhatsApp(«Сообщение») }} — Сообщение в WhatsApp
Пример: {{ messageToWhatsApp(«Это сообщение отобразится только в WhatsApp») }}
{{ messageToFacebook(«Сообщение») }} — Сообщение в Facebook
Пример: {{ messageToFacebook(«Это сообщение отобразится только в Facebook») }}
{{ messageToIcq(«Сообщение») }} — Сообщение в ICQ
Пример: {{ messageToIcq(«Это сообщение отобразится только в ICQ») }}
Счета
{{ getBalance(«Код валюты») }} — Получить баланс контакта
В рублях: {{ getBalance(«RUB») }}
В долларах: {{ getBalance(«USD») }}
Реферальная система Telegram
{{ getTelegramInviteLink() }} — Реферальная ссылка контакта в телеграм боте
{{ getTelegramReferrals() }} — Получить список рефералов контакта (последние 100 шт).
Получить первые 10 рефералов: {{ getTelegramReferrals(10) }}
Получить первые 20 рефералов с тегом «Купил»: {{ getTelegramReferrals(20, «Купил») }}
! Результат выполнения этой функции сохраняется на 10 минут в кеш, т.е. получить вычисление по новым данным возможно через 10 минут.
{{ getTelegramReferralsCount() }} — Получить количество рефералов всей сети контакта (всех уровней).
Получить количество рефералов с тегом «Купил»: {{ getTelegramReferralsCount(«Купил») }}
! Результат выполнения этой функции сохраняется на 10 минут в кеш, т.е. получить вычисление по новым данным возможно через 10 минут.
{{ getTelegramReferrer() }} — Получить своего реферера
Получить своего реферера 5 уровня: {{ getTelegramReferrer(5) }}, 5 — это максимум, для более высокого уровня воспользуйтесь API.
! Результат выполнения этой функции сохраняется на 10 минут в кеш, т.е. получить вычисление по новым данным возможно через 10 минут.
Дата
Функция date – с её помощью можно выводить текущие дату и время. Также можно настраивать в каком формате выводить.
- {{ date() }} – вывести текущую дату и время
- {{ date(“d.m.Y H:i:s”) }} – вывести текущую дату и время в заданном формате, для текущего примера 31.01.2022 13:00:00
Можно задавать более точное временное окно. Например, можно вывести дату и время вчерашнего или завтрашнего дня. Либо любой день недели на прошлой или будущей недели.
- Вчера – {{ date(“d.m.Y”, ”yesterday”) }}
- Завтра – {{ date(“d.m.Y”, “tomorrow”) }}
- Послезавтра – {{ date(“d.m.Y”, “+ 2 days”) }}
- Следующая среда – {{ date(“d.m.Y”, “next wednesday”) }}
- Прошлая пятница – {{ date(“d.m.Y”, “last friday”) }}
- Этот четверг – {{ date(“d.m.Y”, “this thursday”) }}
- 14 дней вперед – {{ date(“d.m.Y”, “+ 14 days”) }}
- 7 дней назад – {{ date(“d.m.Y”, “- 7 days”) }}
- 2 часа вперед – {{ date(“d.m.Y”, “+ 2 hours”) }}
- Описание шаблонов даты – https://www.php.net/manual/ru/datetime.format.php