Botmother

Это не мы сломались, это интернет сломали.

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

Статья «How to create your first bot» в базе знаний →

#ВидеоГайдБотмамы

🎞 Видео «‎Как создать первого бота»‎

В ролике показываем, как создать нового бота в Телеграм и подключить его к Ботмаме.

Статья в базе знаний →

#ВидеоГайдБотмамы

🎞 Видеоурок «‎Как запросить номер телефона у пользователя»‎ с английским интерфейсом редактора

Статья «Requesting user phone number» в базе знаний →

#ВидеоГайдБотмамы

🎞 Видео «‎Как запросить номер телефона у пользователя»‎

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

Статья в базе знаний →

#ВидеоГайдБотмамы

🗓 График работы поддержки на новогодних праздниках

28 декабря — поддержка работает с 09:00 до 18:00 по Москве.

29 декабря, 1, 4, 5 и 7 января — выходные дни.

30, 31 декабря, 2, 3, 6 и 8 января — поддержка работает с 10:00 до 19:00 по Москве.

💡 Как использовать случайный компонент в боте

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

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

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

После Случайного компонента вы можете добавить Перемотку или Кнопки на экран, который должен идти следующим по сценарию.

Подробнее про Случайный компонент можно узнать в статье в базе знаний →

#ботхаки

💡 Как настроить одного бота для разных платформ

Разделяйте контент для разных платформ внутри одного бота — так пользователи будут проходить разные сценарии в зависимости от того, с какой платформы они вошли.

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

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

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

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

Подробнее про целевую платформу можно узнать в статье в базе знаний →

#ботхаки

В России заблокировали Viber. Имеет смысл оперативно портировать вайбер-ботов в другие платформы, в Ботмаме это сделать легко.

📌 Как использовать Нативный запрос в боте

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

Для обычных функций, таких как отправка сообщений, картинок и т.д., Нативный запрос тоже подойдет.

В отличие от обычного Запроса, в Нативном запросе вам не нужно самостоятельно формировать URL запроса, а значит вспоминать токен бота.

Метод не нужно прописывать вручную — его можно выбрать из списка в самом компоненте.

Кроме этого, если в Тело запроса вы не включите параметры chat_id для Телеграма и user_id для VK, то Нативный запрос всё равно сработает у пользователя, который его проходит.

Чтобы воспользоваться Нативным запросом, добавьте его на экран. Если запрос уйдет в ВК, то откройте выпадающий список на компоненте и поменяйте Телеграм на ВК. Если планируете отправлять запрос в Телеграм, то оставьте Платформу без изменений.

Выберите нужный метод из списка. Например, это может быть sendMessage для Телеграм.

В настройки компонента добавьте Тело запроса, для sendMessage оно выглядит так:

{
"text": "Привет из бота!"
}

Готово. Проходя Нативный запрос в боте в Телеграм, пользователь получит сообщение «Привет из бота!»

Подробнее про Нативный запрос можно узнать в статье в базе знаний →

#про_конструктор

💡 Как добавить кнопку для Web App в список диалогов в Telegram

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

1. Откройте в Telegram бота @BotFather, командой
/mybots выберите бота для которого нужно добавить кнопку с Web App.
2. Нажмите Bot Settings, затем Configure Mini App.
3. После этого нажмите кнопку Enable Mini App.
4. Отправьте боту ссылку на ваше мини приложение.

Готово. Теперь кнопка открывающая мини-приложение появится в списке диалогов. Вместе с этим кнопка для Web App появится в описании бота в Телеграм.

Подробнее про добавление кнопки Web App в диалоги можно узнать в статье в базе знаний →

#ботхаки

💡 Как распределять пользователей по разным сценариям внутри одного бота

Пользователей по разным экранам можно распределять с помощью кнопок.

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

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

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

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

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

Подробнее про проверку переменной в Развилке можно узнать в статье в базе знаний →

#ботхаки

🍂 Новости Botmother — осень 2024

Рассказываем, что нового появилось в Ботмаме за осень.

Коротко:
• Добавили возможность подключить бота к платформе ТамТам.
• Сделали Usedesk отдельной платформой для подключения.
• Добавили новый ИИ-компонент — Голосовые сообщения в текст.
• Добавили новый тип форматирования — Мarkdown.
• Добавили возможность делать копию уже созданной рассылки.
• Добавили кнопки для копирования компонентов.
• Добавили новые опции для Преднастроенных компонентов.
• Добавили ручной ввод модели в компонент Запрос к GPT OpenAI.
• Добавили Ввод от пользователя в секцию быстрого добавления компонентов на экран.
• Теперь кнопка Добавить цель в Развилке отображается на самом компоненте, если включить настройку Разместить цели развилок на экране.

Подробнее обо всех этих обновлениях читайте в статье.

💸 Мы начинаем Черную пятницу!

С 25 по 30 ноября включительно забирайте за полцены годовую подписку на любой тариф в рублях.

Никакие промокоды не нужны, новые цены уже ждут вас в личном кабинете. Заходите в конструктор и оформляйте годовые тарифы за 50% от стоимости.

⚠️ Скидка работает для тех, кто пока пользуется бесплатным тарифом.

💡 Как перенести бота в Ботмаму из другого сервиса

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

Перед переносом пройдите регистрацию и создайте бота с нужным сценарием на нашей платформе.

Затем составьте CSV-таблицу со списком всех пользователей. В таблице должны быть имена пользователей, ID внутри платформы каждого пользователя и название платформы. Пришлите эту таблицу в чат поддержки и мы загрузим пользователей в указанный вами бот.

Обязательно нужно отвязать токен бота от прошлого сервиса перед добавлением к нам. После этого вы сможете вставить токен в настройки Ботмамы.

Подробнее про импортирование пользователей можно узнать в статье в базе знаний →

#ботхаки

💡 Как тестировать экраны по отдельности

Тестируйте экраны сразу после их сохранения:

1. В поле редактора нажмите на экран, который собираетесь запустить. После этого у экрана появится синяя рамка по периметру.
2. Перейдите во вкладку Экран на правой панели. В разделе Ссылки на экран вы увидите ссылки на платформы, где подключен бот. Такие ссылки поддерживаются не везде. Например, в ВК экран можно протестировать с помощью события Шаблон.
3. Скопируйте ссылку на экран или сразу перейдите по ссылке, нажав значок стрелки.

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

Подробнее про редактор ботов можно узнать в статье в базе знаний →

#ботхаки

🛠 В ночь с 18 на 19 ноября с 00:00 до 04:00 по Москве, проведем работы по улучшению надежности системы. В это время возможны короткие перебои в работе ботов на 5-10 минут.

💡 Как в Телеграме удалить последнее сообщение от пользователя

Используйте этот метод для удаления последнего сообщения отправленного пользователем.

Добавьте Нативный запрос, выберите метод deleteMessage и добавьте Тело запроса:

{
"message_id": "{{lastUpdate.update.message_id}}"
}

Расположите этот запрос после Ввода от пользователя или Развилки, в зависимости от того, с помощью чего принималось присланное сообщение. После этого сохраните изменения.

Подробнее про то, как удалять последнее сообщение от пользователя можно узнать в статье в базе знаний →

#ботхаки

💡 Как в боте автоматически подставлять нужное окончание в сообщение

Когда заранее не известно сколько упаковок товара закажет клиент и в других подобных случаях, можно создать универсальное сообщение после заказа: «В вашей корзине упаковок: {{var}}». Пользователи будут получать такие сообщения: «В вашей корзине упаковок: 1», «В вашей корзине упаковок: 2» и т.д.

Чтобы в оповещении подставлялось правильное окончание в зависимости от числа, которое указал пользователь, используйте хелпер declension

Добавьте такой текст шаблона, если число упаковок было записано в переменную var:

В вашей корзине {{var}} {{declension (var) "упаковка,упаковки,упаковок"}}

Благодаря хелперу declension, бот автоматически подставит правильное окончание в слове после числа: «В вашей корзине 1 упаковка», «В вашей корзине 2 упаковки», «В вашей корзине 10 упаковок».

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

#ботхаки

💡 Как сделать сворачиваемую цитату в Телеграм

Теперь можно форматировать тексты с помощью Markdown на платформах Телеграм и ТамТам. Для этого мы добавили выбор Способа форматирования в настройки компонентов.

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

В редакторе форматирование будет иметь такой вид:

**>Эти строки
>пользователи увидят
> не раскрыв цитату
>А эту часть будет видно
>только после открытия||

Можно сделать более длинный текст, добавляя в середину строчки, которые начинаются со знака «‎больше»‎.

Подробнее про новое форматирование можно узнать в статье в базе знаний →

#ботхаки

Восстановили работу.

Прилегли, разбираемся.

💡 Как сделать копию бота

Копировать ботов можно как внутри аккаунта, так и между аккаунтами.

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

Чтобы скопировать бота на другой аккаунт, напишите нам на [email protected] с почты владельца бота и укажите аккаунт, на который бота нужно скопировать.

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

Подробнее про копирование и другие настройки можно узнать в статье в базе знаний →

#ботхаки

🗓 График работы поддержки на ноябрьских праздниках

Поддержка работает 2 ноября с 9:00 до 19:00 по московскому времени, 3 и 4 ноября — выходные.

💡 Как повторить рассылку

Вы можете повторно отправлять рассылки из раздела Завершенные. Для дублирования рассылки нажмите кнопку Создать черновик и перейдите в раздел Черновики.

Чтобы рассылка стала готовой к отправке, нажмите кнопку Редактировать. Теперь вы можете отправить точную копию когда-то отправленной рассылки или внести правки.

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

#ботхаки

💡 Как настроить бота на разные ответы в рабочее и не рабочее время

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

Используйте такой сценарий для бота срабатывающего в разные часы по-разному.
Например, в боте с поддержкой отвечающей только в рабочее время, пользователь должен попадать на экран с оператором исключительно с 10 до 19. Если написать боту вечером и ночью, то придет уведомление о том, что саппорт сможет ответить только завтра.

Для создания подобного сценария, запишите текущее время в переменную. В ее Значении используйте хелпер {{formatDate "HH:mm"}}

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

Для этого добавьте Цель в Развилке и поменяйте тип данных на Регулярное выражение, затем запишите регулярку для диапазона с 10 до 19: ^1[0-8]\:[0-5][0-9]$

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

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

#ботхаки

💡 Как отредактировать последнее сообщение от бота в ВК

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

Поменяйте платформу с Телеграма на ВКонтакте, затем выберите метод запроса messages.edit.

В настройках Нативного запроса добавьте Тело запроса для удаления последнего сообщения. Новый текст сообщения должен быть в значении параметра message:

{
"peer_id": "{{this_user.platform_id}}",
"message": "новый текст сообщения",
"message_id":"{{lastMessageId}}"
}

Готово. Бота можно сохранить и протестировать в ВК.

Подробнее про то как редактировать последнее сообщение от бота в ВК можно узнать в статье в базе знаний →

#ботхаки

📌 Как использовать Триггерные событие в боте

Используйте Триггерные события для отправки отложенных сообщений:

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

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

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

После создания ярлыка перейдите из редактора в раздел Настройки, пролистайте до подраздела События и создайте новое событие.

Скопируйте название ярлыка из редактора и задайте время через которое придет Триггер.

Если единица измерения времени — это дни, недели или месяцы, то вы можете поставить галочку Отправлять в определенное время и выбрать точное время суток для срабатывания Триггера.

После этого выберите экран или напишите сообщение, которое придет когда сработает триггер.

Подробнее про Триггерное событие можно узнать в статье в базе знаний →

#про_конструктор

💡 Как оформлять сообщения от бота в Telegram

В ботах Телеграм поддерживается форматирование HTML. Начертание можно поменять на жирное, курсив и другие.

Чтобы отформатировать текст, добавляйте к сообщениям следующие теги:

<b>Это предложение должно быть выделено жирным шрифтом</b>
<i>Это предложение должно быть выделено курсивом</i>
<code>Этот текст должен отображаться как код</code>
<s>Этот текст должен быть зачеркнут</s>
<u>Этот текст должен быть подчеркнут</u>
<tg-spoiler>Этот текст будет скрыт, пока на него не кликнуть</tg-spoiler>

Кроме этого, сообщение можно сделать в виде списка. Для переноса пункта на следующую строку используйте Shift + Enter.

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

1. Пункт 1
2. Пункт 2
3. Пункт 3

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

Подробнее про оформление текста в Телеграм и на других платформах можно узнать в статье в базе знаний →

#ботхаки

💡 Как защитить контент в Телеграм

Защитите контент в боте чтобы сообщения нельзя было копировать, пересылать и делать скриншоты экрана телефона с этим сообщением.

Чтобы предотвратить пересылку для всего содержимого, откройте Настройки Ботмамы и активируйте чек-бокс Защитить контент во всем боте. Эта настройка находится в области подключения токена и других настроек Телеграма.

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

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

Защита контента поддерживается для компонентов Видео, Сообщение, Изображение, Медиафайлы, Платные медиафайлы, Галерея, Динамические кнопки, Документ, Аудио, Кнопки.

Подробнее про то, как защитить контент в ботах Телеграм можно узнать в статье в базе знаний →

#ботхаки

📌 Как исправить ошибку в рассылке

Если рассылка ушла с ошибкой, значит эту ошибку можно найти в логах.

Перейдите в раздел Рассылка и прокрутите до конца, до подраздела Завершенные.

Для поиска нужной рассылки в Завершенных используйте время начала рассылки или ID.

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

В логах вы увидите подробности ошибки. Вернитесь из логов и создайте заново рассылку без ошибок. Затем отправьте ее.

Подробнее про то, как узнавать об ошибках в рассылке можно узнать в статье в базе знаний →

#про_конструктор

Поднялись

Прилегли, разбираемся.

💡 Как отправить запрос в Кнопке

Отправляйте Запросы API прямо в кнопках.

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

Отметьте чек-бокс Возможность отправлять запрос.

Для обращения к Telegram API для отправки текста заполните URL запроса по шаблону:

https://api.telegram.org/botTOKEN/sendMessage

Слово TOKEN поменяйте на токен вашего бота — его можно узнать в BotFather с помощью команды /token

Выберите метод запроса POST и добавьте Тело запроса:

{
"chat_id": "{{this_user.platform_id}}",
"text": "Привет из бота!"
}

Текст сообщения вы можете изменить в теле запроса.

Подробнее про Кнопки можно узнать в статье в базе знаний →

#ботхаки

📌 Как самостоятельно разблокировать бота при зацикливании

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

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

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

Найдите в редакторе этот экран, исправьте ошибку и сохранитесь.

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

#про_конструктор

📺 Сделали видео про удаление сообщений

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

В одном видеоролике собрали способы для удаления четырех видов сообщений:

• последнего сообщения от бота,
• любого сообщения от бота,
• блока сообщений от бота,
• последнего сообщения от пользователя.

Посмотреть видео на YouTube →
Посмотреть видео на RuTube →

📌 Как Преднастроенные компоненты ускоряют работу в редакторе ботов

Ускорьте работу над компонентами с одинаковыми или похожими настройками с помощью Преднастроенных компонентов.

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

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

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

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

Подробнее про Преднастроенные компоненты можно узнать в статье в базе знаний →

#про_конструктор

💡 Как проверить подписку на Telegram-канал

Сделайте бота доступным только для подписчиков вашего Телеграм-канала.

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

В редакторе добавьте Нативный запрос с методом getChatMember

В настройки компонента добавьте шаблон Тела запроса:

{
"chat_id": "ID канала",
"user_id": "{{this_user.platform_id}}"
}

В этом шаблоне поменяйте ID канала на ID вашего канала или на его название в формате @botmothercom. Это название можно скопировать из настроек канала в Телеграм.

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

В Значениях Целей пропишите возможные статусы пользователя относительно канала: member, creator, administrator, left, kicked.

Эти статусы Телеграм пришлёт в переменные после прохождения пользователем Нативного запроса.

Развилка берущая значение переменной из last_request.result.status разведет пользователей с разными статусами по экранам, указанным в переходе Цели.

Подробнее про проверку подписки в Telegram можно узнать в статье в базе знаний →

#ботхаки