# SamBot — полная справка > Полные тексты всех статей. Источник: https://sambot.ru/ ## Telegram-бот-визитка на Sambot для сбора заявок и анализа новых подписчиков URL: https://sambot.ru/case_telegram-bot-vizitka-na-sambot-dlya-sbora-zayavok-i-analiza-novykh-podpischikov_73 Кейс: разработчик автоматизировал сбор заявок на Sambot — снизил потери до 0%, ускорил обработку с 12 часов до 5 минут. Мини-CRM в Google Sheets без кода. Кейс реализован Спириной Мариной — разработчиком Telegram-ботов на платформе Sambot.ru. 📌 Задача Автоматизирует сбор заявок на личную консультацию Отслеживает новых подписчиков Telegram-канала Фиксирует все обращения в одном месте — без потерь, ручной работы и хаоса 🎯 Цели внедрения Сделать первую точку контакта с подписчиком — системной Автоматизировать сбор и обработку заявок Сформировать структуру для мини-CRM в Google Sheets Уменьшить нагрузку на владельца канала ⚙️ Реализованное решение Платформа: Telegram Конструктор ботов: Sambot Интеграции: Google Sheets Что умеет бот: Отправляет приветственное сообщение новым пользователям Представляет эксперта и услуги Предлагает кнопки: «Записаться на консультацию» «Узнать подробнее» При записи запрашивает: Имя Telegram-контакт Цель консультации Удобное время Автоматически заносит все данные в Google Таблицу Присылает уведомление о новой заявке Технические особенности: Вся логика собрана через визуальный интерфейс Sambot Использованы формы ввода и автоответы Возможность быстрой правки сценария без кода 📈 Результаты Показатель До внедрения После запуска Потерянные заявки ~30% 0% Время на обработку до 12 часов менее 5 минут Загрузка менеджера 1–2 часа в день не требуется Скорость ответа клиенту вручную мгновенно (бот) Видимость базы заявок отсутствует полная, в таблице Рост числа заявок — +80% за 2 недели 🧩 Кому особенно полезен такой бот Эксперты и консультанты Психологи, коучи, менторы, карьерные консультанты, нутрициологи → Автоматизация заявок, упрощение сбора данных, чистая база клиентов Онлайн-школы и наставники → Запись на консультацию перед покупкой курса, воронка Telegram → CRM SMM-специалисты и таргетологи → Быстрый MVP для клиентов, лидогенерация без лишнего кода Фрилансеры → Мини-анкета, возможность принимать заказы без сайта Мастера и локальные специалисты → Маникюр, стилисты, фотографы: бот — это «менеджер по заявкам» Продюсеры и ассистенты → Быстрый запуск бота без IT-специалистов, входная воронка перед продажей 🔧 Почему именно Sambot Не требует программирования Подходит для быстрого запуска и тестирования гипотез Идеален для работы в Telegram ✅ Вывод Первая точка касания с подписчиком Автоматический сбор и сортировка заявок Прозрачная база клиентов в Google Sheets Минимум ручной работы Готовность к масштабированию Теперь никакая заявка не теряется, а каждый вступивший в канал — это потенциальный клиент, с которым установлена связь и зафиксированы данные. --- ## Telegram-бот для записи на услуги: автоматизация онлайн-записи клиентов URL: https://sambot.ru/case_bot-dlya-zapisi-na-uslugi_91 Чат-бот для онлайн-записи в салон, медцентр или автосервис: меню услуг, календарь, уведомление администратору, мини-CRM в Google Таблице. Когда клиент пишет в Direct, Telegram или WhatsApp — кто-то должен ответить и записать его в расписание. Ночью и в выходные — некому, и часть клиентов уходит к конкурентам, которые ответили первыми. Бот делает это автоматически в любое время, без выходных. 📌 Задача Принимать запись 24/7 без участия оператора. Уведомлять мастера или администратора о каждой новой записи. Складывать записи в единое место — Google Таблицу или CRM — чтобы не терять клиентов. 🎯 Кому подойдёт Салоны красоты и мастера маникюра, парикмахеры, бровисты. Медцентры, частные стоматологи, врачи-консультанты. Автосервисы и шиномонтажи. Фитнес-клубы, тренеры, студии йоги. Любой бизнес с записью по слотам. ⚙️ Что увидит клиент Запускает бот в Telegram или ВКонтакте — получает приветствие и меню услуг кнопками. Выбирает нужную услугу (например, «Маникюр»). Бот предлагает выбрать дату и время через календарь. Бот подтверждает: «Запись на маникюр, 15 марта 14:30. До встречи!» 🔧 Что получит мастер Мастер сразу получает уведомление в свой личный чат с ботом: 📅 Новая запись Услуга: маникюр Клиент: Анна (@anna_user) Дата: 15 марта 14:30 Опционально каждая запись пишется строкой в Google Таблицу — получается простая мини-CRM без отдельной системы. 🛠 Как это собирается в SamBot Если бота ещё нет — пройдите быстрый старт для Telegram или ВКонтакте, чтобы привязать токен и увидеть админку. Дальше — четыре реакции в разделе «Реакции», не зависящие от количества услуг. 1. Реакция «Старт» — выбор услуги Показывает клиенту меню услуг и запоминает выбор. В блоке «1. Срабатывает на» включите «1.1.1. Содержит ключевые слова», добавьте start и запись. В блоке «4. Действия» в уже включённом «4.1. Отправить сообщение» нажмите «+ Текст». Впишите «Выберите услугу» и добавьте кнопки типа «Текст» — по одной на каждую услугу (Маникюр, Стрижка, Массаж …). Добавить новую услугу позже — просто ещё одна кнопка, без новых реакций. В этом же сообщении нажмите «Сохранить ответ» → галка «Параметр пользователя», имя service. После клика по кнопке выбранная услуга запишется в параметр. В этом же сообщении укажите «Запустить реакцию» — реакцию выбора даты (шаг 2). После клика по любой из кнопок-услуг сохранится service и запустится следующая реакция. 2. Реакция «Выбор даты» — общая для всех услуг Одна реакция, неважно какую услугу выбрал клиент. Действие «4.1. Отправить сообщение» — текст «Выберите удобную дату и время» и кнопка типа «Календарь». В настройках кнопки укажите поля (день, час, минута), а в поле «Реакция» — реакцию-подтверждение (шаг 3). В этом же сообщении нажмите «Сохранить ответ», отметьте галку «Параметр пользователя», впишите имя booking_date. Когда клиент подтвердит дату, она сохранится в этот параметр и будет доступна в шаблонах сообщений как {user:booking_date}. 3. Реакция «Подтверждение» — для клиента Одна для всех услуг — подтверждает запись клиенту и запускает следующую цепную реакцию для уведомления админа. Действие «4.1. Отправить сообщение» — подтверждение клиенту: Запись на {user:service} подтверждена на {user:booking_date}. Ждём! Действие «4.16. Запустить цепную реакцию» — укажите реакцию-уведомление (шаг 4) и в её настройке выберите ваш админский чат. Так подтверждение уйдёт клиенту, а следом отдельное уведомление — вам. 4. Реакция «Уведомление админу» — отдельная Срабатывает только из цепной реакции и шлёт сообщение в админский чат, не клиенту. В блоке «2. В чатах» укажите ваш админский чат (личный с ботом или групповой). Реакция не должна срабатывать в других чатах. Действие «4.1. Отправить сообщение» с текстом для вас: Новая запись на {user:service} от {first_name} на {user:booking_date}. Добавление новой услуги в будущем — просто ещё одна кнопка в первой реакции. Реакции 2 – 4 трогать не нужно. 5. (опционально) Запись в Google Таблицу Если хочется собирать историю в единой таблице, добавьте в реакцию-подтверждение действие «4.6. Отправить в Google Таблицу». Каждая запись — строка с услугой, клиентом и датой. Получается простая мини-CRM. 📈 Что можно добавить Напоминание за день — цепная реакция с отложенным запуском (4.16) присылает клиенту «Завтра в 14:30 ждём вас». Предоплата — подключите платёжного провайдера (ЮKassa, Robokassa, Prodamus, Т-Банк) и добавьте кнопку оплаты перед подтверждением. Несколько мастеров — меню «Выберите мастера» перед календарём, у каждого мастера свой график. Контроль повторных записей — ограничение на одну активную запись от клиента (через метку или параметр). Перенос/отмена записи — отдельные команды у клиента, без звонка администратору. Если нужна помощь со сборкой SamBot — это конструктор, в нём можно собрать всё описанное самому, без программиста. Если разбираться некогда — напишите нам, поможем настроить или предложим готовый шаблон под ваш бизнес. Стоимость доступна для самозанятых и небольших студий. Заведите бота, попробуйте на своём расписании — и через час у вас будет автоматизированная запись 24/7. --- ## Telegram-бот «чат-менеджер»: переписка клиента и менеджера через бота URL: https://sambot.ru/case_bot-chat-menedzher_93 Бот, через который клиенты пишут в общий чат менеджеров: менеджер отвечает реплаем — ответ возвращается клиенту автоматически, без личных контактов. Клиент пишет боту, бот пересылает сообщение в общий чат менеджеров. Любой свободный менеджер отвечает реплаем на это сообщение в чате — и ответ автоматически уходит обратно клиенту. Клиент видит диалог «с ботом», на деле общается с живым человеком, без раскрытия личных контактов. 📌 Задача Дать клиенту единую точку входа: один бот вместо номеров и контактов конкретных менеджеров. Не раскрывать личные Telegram/телефоны сотрудников. Видеть всю переписку с клиентами в одном чате — удобно искать и передавать дела. Работать с нескольких менеджеров параллельно: кто свободен — тот и отвечает. 🎯 Кому подойдёт Службы поддержки, отделы продаж — первая линия общения с клиентами. Агентства, студии, школы — приём заявок и консультации. Самозанятые с большим потоком запросов, кому неудобно отвечать с личного номера. Любой бизнес, где переписку ведут несколько сотрудников по очереди. ⚙️ Как это выглядит со стороны клиента Клиент находит бота в Telegram, нажимает /start — получает приветствие: «Здравствуйте! Напишите свой вопрос — менеджер ответит в ближайшее время». Пишет любой текст («Сколько стоит выезд мастера?»). Через какое-то время приходит ответ от «бота» — это менеджер ответил в своём чате, бот переслал клиенту. Клиент пишет уточнение — и так до закрытия вопроса. 🔧 Как это выглядит со стороны менеджеров В общем чате (где сидят все менеджеры и бот) появляется новое сообщение от бота: Анна Петрова, Отправлена реакция «Сообщение клиента» Сколько стоит выезд мастера? Менеджер делает reply (ответить на сообщение) прямо в этом чате и пишет: «От 1500 руб. в черте города». Бот видит, что это ответ на его пересланное сообщение, находит исходного клиента и отправляет текст ему в личку. Никаких отдельных интерфейсов или CRM-окон не нужно — общение идёт привычным реплаем в Telegram-чате. 🛠 Как это собирается в SamBot Если бота ещё нет — пройдите быстрый старт для Telegram или ВКонтакте, чтобы привязать токен и увидеть админку. Дальше — один параметр у чата и две реакции. 1. Чат менеджеров: пометить как «Управляемый» В Telegram создайте групповой чат, добавьте всех менеджеров и вашего бота, дайте боту права администратора. Затем в SamBot откройте раздел «Чаты», выберите этот чат и включите галку «Управляемый чат». Без этой галки SamBot не будет распознавать реплаи менеджеров как ответы клиентам. 2. Реакция «Приветствие» — на /start Срабатывает, когда клиент впервые открывает бота. В блоке «1. Срабатывает на» включите «1.1.1. Содержит ключевые слова», добавьте start. В блоке «2. В чатах» — оставьте «Приватные чаты». В уже включённом «4.1. Отправить сообщение» впишите текст приветствия: «Здравствуйте! Напишите свой вопрос — менеджер ответит в ближайшее время». 3. Реакция «Сообщение клиента» — пересылка в чат менеджеров Срабатывает на любое текстовое сообщение в личке — пересылает его в чат менеджеров с именем клиента. В блоке «1. Срабатывает на» разверните «1.1. Текстовое сообщение» и включите галку «1.1.5. Содержит любой текст» — реакция сработает на любую реплику клиента. Оставьте чат-фильтр на «Приватные чаты» — реакция нужна только в лички, не в других чатах. В действии «4.13. Отправить уведомление» укажите ваш чат менеджеров. Включите три галки: «Имя пользователя» — чтобы менеджер видел, кто пишет. «Действие» — добавит подпись и ссылку на реакцию (помогает SamBot'у потом распознать реплай). «Сообщение пользователя» — чтобы пересылался сам текст клиента. Опционально — включите галку «Дополнительный текст» и впишите что-то вроде «Новое сообщение от клиента» с эмодзи — это привлечёт внимание свободных менеджеров. Действие «4.1. Отправить сообщение» в этой же реакции выключите — иначе клиент получит автоответ, а нам нужно дождаться ответа живого менеджера. Как работает ответ менеджера Когда менеджер делает reply на пересланное сообщение в чате менеджеров — SamBot находит, какому клиенту это сообщение относилось (по имени и ссылке на реакцию в тексте бота), и отправляет ответ ему в личку. Никакой отдельной настройки не нужно — это встроенная механика SamBot для управляемых чатов. 📈 Что можно добавить Авто-FAQ перед эскалацией — на типовые вопросы (цена, адрес, часы работы) добавьте отдельные реакции с ключевыми словами и готовыми ответами. Они сработают раньше «Сообщения клиента» и разгрузят менеджеров. Метки для диалогов — настройте теги (#оплата, #доставка), чтобы фильтровать историю по тематике в чате менеджеров. Вызов реакции через # — менеджер пишет в чате #«ключевое слово» в реплае на сообщение клиента, и бот отправит ему готовый ответ из этой реакции. Удобно для типовых ответов. Передача между менеджерами — добавьте параметр пользователя assigned_manager и команду «передать», чтобы делить нагрузку и вести историю по ответственным. Часы работы и офф-режим — ограничьте срабатывание реакции по времени, а вне рабочих часов отправляйте автоответ «Ответим завтра в 9:00». Если нужна помощь со сборкой SamBot — это конструктор, в нём можно собрать всё описанное самому, без программиста. Если разбираться некогда — напишите нам, поможем настроить или предложим готовый шаблон под ваш бизнес. Стоимость доступна для небольших команд и частных мастеров. Заведите бота, добавьте чат менеджеров — и уже сегодня сможете принимать сообщения от клиентов, не раскрывая личных контактов сотрудников. --- ## Бот ВКонтакте для онлайн-записи на занятия и услуги URL: https://sambot.ru/case_vk-bot-onlayn-zapis-na-zanyatiya-i-uslugi_95 Как собрать бота ВКонтакте, который принимает заявки на занятия и услуги: меню, выбор даты кнопками, подтверждение клиенту и сигнал администратору. Заявки в сообществе ВКонтакте теряются легко: кто-то спрашивает в комментариях, кто-то — в «Сообщения сообщества», и пока админ доберётся до ответа, человек уже записался в другом месте. Бот в вашем сообществе разговаривает с клиентом за вас 24/7 и сразу складывает запись в нужное место. Зачем это нужно Один цельный сценарий вместо разрозненной переписки: клиент сам выбирает услугу, удобное время и получает подтверждение. Вы узнаёте о записи мгновенно. Не нужно спрашивать «как вас записать?», уточнять контакты, переспрашивать дату. Подойдёт сообществам ВКонтакте у следующих типов бизнеса: фитнес-клубы, студии йоги и танцев, спортивные секции; тренеры по индивидуальным занятиям, реабилитологи, массажисты; детские кружки и развивающие центры; стоматологии, частные клиники и диагностические центры; репетиторы и онлайн-школы — запись на пробное занятие; любая ниша, где работа идёт по слотам в расписании. Что происходит со стороны клиента Подписчик заходит в ваше сообщество, нажимает «Написать сообщение» — ему открывается диалог с ботом. Бот предлагает кнопочное меню услуг: «Тренировка», «Массаж», «Растяжка» — любой набор под вашу нишу. После выбора услуги бот спрашивает дату и время и показывает кнопочный календарь. Клиент жмёт удобный слот, видит сводку: «Тренировка, 15 марта в 18:00. До встречи в зале!» Что приходит администратору или тренеру Сразу после подтверждения вам приходит уведомление в личный диалог с ботом или в общий админский чат: 🔔 Новая запись Услуга: тренировка Имя: Алексей Время: 15 марта 18:00 По желанию каждая запись записывается отдельной строкой в Google Таблицу — это лёгкая мини-CRM без отдельных систем учёта. Как собрать бота в SamBot Если бот в сообществе ещё не подключён — пройдите быстрый старт ВКонтакте: понадобится токен сообщества и настроенный Callback API. После этого вернитесь сюда и добавьте четыре реакции в разделе «Реакции». Количество услуг не влияет на число реакций. Шаг 1. Реакция «Меню услуг» Стартует диалог и запоминает выбор клиента. В блоке «1. Срабатывает на» отметьте «1.1.1. Содержит ключевые слова» и добавьте слова start, начать, запись. ВКонтакте по умолчанию шлёт «Начать» при первом обращении — это слово реакция тоже поймает. В блоке «4. Действия» в уже включённом «4.1. Отправить сообщение» нажмите «+ Текст». Текст: «Что хотите забронировать?», под ним кнопки типа «Текст» — по одной на каждую услугу. Понадобилась новая услуга — просто добавляете кнопку, остальные реакции трогать не нужно. В этом же сообщении нажмите «Сохранить ответ», отметьте «Параметр пользователя», имя — service. Когда клиент кликнет по кнопке, выбранная услуга запишется в этот параметр. Прямо в этом же сообщении укажите «Запустить реакцию» — реакцию выбора даты (шаг 2). После клика по любой кнопке-услуге сначала сохранится service, затем запустится следующая реакция. Шаг 2. Реакция «Календарь» Одна реакция для всех услуг. Действие «4.1. Отправить сообщение» — текст «Выберите дату и время» и кнопка типа «Календарь». SamBot сам собирает календарь из кнопок (день, час, минута) и показывает его в сообщении — нативного календаря у ВКонтакте нет, но SamBot закрывает это за вас. В настройках кнопки в поле «Реакция» укажите реакцию-подтверждение из шага 3. В этом же сообщении нажмите «Сохранить ответ», отметьте «Параметр пользователя», впишите booking_date. Выбранный слот сохранится в этот параметр и будет доступен в шаблонах как {user:booking_date}. Шаг 3. Реакция «Запись подтверждена» Отвечает клиенту и запускает уведомление администратору цепной реакцией. Действие «4.1. Отправить сообщение» — текст подтверждения: Бронь оформлена: {user:service}, {user:booking_date}. Ждём вас! Действие «4.16. Запустить цепную реакцию» — укажите реакцию-уведомление из шага 4. В её настройках выберите ваш админский чат или личный диалог. Сначала клиенту уйдёт подтверждение, потом сигнал — вам. Шаг 4. Реакция «Сигнал администратору» Срабатывает только из цепной реакции и шлёт уведомление вам. В блоке «2. В чатах» укажите ваш админский чат (личный диалог с ботом или групповой чат для команды). В других чатах реакция срабатывать не должна. Действие «4.1. Отправить сообщение» с текстом для вас: Новая запись: {user:service} от {first_name} на {user:booking_date}. Чтобы добавить новую услугу позже, нужно лишь добавить кнопку в первой реакции — реакции 2 – 4 универсальны. Шаг 5 (по желанию). Запись в Google Таблицу Если хочется, чтобы все записи копились в единой таблице, в реакцию-подтверждение добавьте действие «4.6. Отправить в Google Таблицу». Каждая запись — строка с услугой, клиентом и временем. Получится мини-CRM без отдельных систем. Что добавляют сверху Напоминание накануне — цепная реакция (4.16) с отложенным запуском за сутки или за два часа: «Завтра в 18:00 ждём вас на тренировку». Предоплата перед подтверждением — подключите ЮKassa, Robokassa, Prodamus или Т-Банк и добавьте кнопку оплаты до шага 3. Несколько тренеров или мастеров — добавьте меню «У кого тренируемся?» перед календарём, у каждого свой график. Защита от дублей — ограничьте число активных записей у одного клиента через метку или параметр. Перенос и отмена записи — команды у клиента «перенести» и «отменить», без звонков администратору. Если хочется готовое решение SamBot — конструктор: всё описанное собирается без программиста за вечер. Если разбираться некогда — напишите нам, поможем настроить под вашу нишу или предложим готовый шаблон. Цена адекватная для тренеров, мастеров и небольших студий. Подключите бота в ваше сообщество, попробуйте на своём расписании — и уже сегодня клиенты смогут записываться сами, без вашего участия. --- ## Бот ВКонтакте для связи клиента с менеджером через сообщество URL: https://sambot.ru/case_vk-bot-svyaz-s-menedzherom-cherez-soobshchestvo_97 Подписчики пишут в сообщество ВКонтакте, бот пересылает в общий чат команды, менеджер отвечает реплаем — клиенту приходит ответ автоматически. В сообщения сообщества часто пишут с вопросами: «сколько стоит?», «когда вы работаете?», «есть ли скидки?». Кто-то из команды должен ответить, и тот, кто отвечает, светит свою личную страницу. Этот кейс закрывает обе проблемы: бот пересылает диалоги в ваш общий командный чат, и любой из менеджеров отвечает оттуда реплаем. Клиент видит ответ от «бота сообщества», а не от конкретной страницы. Зачем это нужно Подписчики пишут в единое окно — сообщения сообщества — а не ищут, кому из администраторов писать в личку. Менеджеры отвечают со своих рабочих аккаунтов в общем чате, не показывая клиентам личные страницы. Вся переписка по клиентам копится в одном чате — легко искать историю и передавать вопрос коллеге. Можно работать в несколько рук: кто свободен, тот и отвечает. Кому подойдёт Магазины и шоурумы с витриной в ВКонтакте — приём заявок и консультации. Студии услуг (репетиторы, стилисты, инструкторы), где общается команда. Сообщества курсов и онлайн-школ — ответы на вопросы абитуриентов. Локальные бизнесы — агентства недвижимости, авто-, стройуслуги, где админы меняются по сменам. Как это устроено для подписчика Подписчик заходит в сообщество, нажимает «Написать сообщение» — открывается диалог с ботом. Видит приветствие: «Здравствуйте! Опишите свой вопрос — ответим как только сможем». Пишет, что ему нужно. Через какое-то время приходит ответ от «бота сообщества» — это менеджер написал в командном чате, бот доставил клиенту. Дальше идёт обычный диалог. Как это устроено для команды В общем чате (где сидят менеджеры и ваш бот) появляется новое сообщение от бота: Анна П., Отправлена реакция «Сообщение клиента» Здравствуйте, есть ли скидки на курс? Любой менеджер делает reply на это сообщение прямо в этом же чате (стрелочка «Ответить») и пишет: «Да, до конца месяца действует промокод SPRING на 15%». SamBot видит, что менеджер ответил на пересланное ботом сообщение, находит исходного клиента и шлёт ему ответ в диалог сообщества. Никаких отдельных интерфейсов и CRM — команда работает в привычном чате, бот делает магию переадресации. Сборка в SamBot Если бота в сообществе ещё нет — пройдите быстрый старт ВКонтакте: токен, Callback API, всё по инструкции. Дальше в SamBot нужно сделать три вещи: пометить ваш командный чат, добавить приветствие и добавить пересылку. Шаг 1. Командный чат → отметить как «Управляемый» Создайте в ВКонтакте обычный чат, добавьте туда менеджеров и ваше сообщество (как пользователя, иначе бот не сможет туда писать). Откройте этот чат в SamBot в разделе «Чаты» и поставьте галку «Управляемый чат». Без неё SamBot не будет распознавать reply'ы менеджеров как ответы клиентам. Шаг 2. Реакция «Приветствие» Срабатывает на первое обращение клиента в сообщество. В блоке «1. Срабатывает на» отметьте «1.1.1. Содержит ключевые слова», добавьте start, начать. ВКонтакте по умолчанию шлёт «Начать» при первом обращении — реакция это слово поймает. В блоке «2. В чатах» оставьте «Приватные чаты» — приветствие нужно только в диалогах с сообществом. В уже включённом «4.1. Отправить сообщение» текст: «Здравствуйте! Опишите свой вопрос — ответим как только сможем». Шаг 3. Реакция «Сообщение клиента» — пересылка в командный чат Срабатывает на любое текстовое сообщение в диалоге с сообществом. В блоке «1. Срабатывает на» разверните «1.1. Текстовое сообщение» и включите галку «1.1.5. Содержит любой текст» — реакция сработает на любую реплику клиента. Чат-фильтр — только «Приватные чаты». В командном чате реакция срабатывать не должна, иначе бот будет пересылать собственные пересылки. В действии «4.13. Отправить уведомление» укажите ваш командный чат и включите три галки: «Имя пользователя» — бот напишет, кто из подписчиков задал вопрос. «Действие» — добавит подпись и ссылку на реакцию (она нужна, чтобы потом распознать reply менеджера). «Сообщение пользователя» — чтобы переслать сам текст вопроса. По желанию — «Дополнительный текст»: например «🔔 Новый вопрос от клиента» — приоритизирует уведомления в чате. Действие «4.1. Отправить сообщение» в этой же реакции отключите: иначе клиент получит автоответ, а нужно дождаться живого менеджера. Как ответ менеджера возвращается клиенту Когда менеджер делает reply в командном чате на сообщение бота, SamBot по тексту находит, какому подписчику было адресовано пересланное сообщение (по имени и ссылке на реакцию), и шлёт ответ ему в диалог сообщества. Никакой дополнительной настройки не нужно — это встроенная логика SamBot для управляемых чатов. Что добавляют сверху Готовые ответы на частые вопросы — добавьте отдельные реакции с ключевыми словами «цена», «адрес», «график» и готовыми ответами. Они сработают раньше «Сообщения клиента» и разгрузят менеджеров. Метки и теги — настройте теги (например, #запись, #продажи, #претензия) для удобной фильтрации истории в командном чате. Быстрая реакция через # — менеджер пишет в командном чате #«ключевое слово» в реплае на сообщение клиента, и бот пришлёт клиенту готовый текст из этой реакции. Удобно для типовых ответов. Назначение менеджера — сохраняйте параметр assigned_manager, чтобы делить нагрузку и вести историю по ответственным. Расписание поддержки — включите ограничение реакции по времени, а вне рабочих часов отправляйте автоответ «Ответим утром в 9:00». Если хочется готовое решение SamBot — конструктор: всё описанное собирается без программиста. Если разбираться некогда — напишите нам, поможем настроить под вашу команду или предложим готовый шаблон. Тариф адекватный для небольших агентств и студий. Подключите бота в сообщество, добавьте командный чат — и уже сегодня сможете отвечать клиентам в ВКонтакте всей командой, не показывая личных страниц. --- ## Бот-консультант с искусственным интеллектом: ChatGPT, YandexGPT, Claude и другие нейросети в одном окне URL: https://sambot.ru/case_bot-konsultant-s-iskusstvennym-intellektom_99 Чат-бот с ChatGPT, YandexGPT, Claude, Gemini, Perplexity в одном окне. Свои API-ключи, оплата провайдерам по себестоимости, поддержка изображений и голоса. Раньше чат-боты умели только отвечать по заранее прописанным сценариям. Сейчас можно подключить нейросеть — и бот будет понимать произвольные вопросы клиентов, отвечать с учётом контекста, переводить, суммировать длинные тексты, генерировать картинки и расшифровывать голосовые сообщения. SamBot умеет работать с десятком провайдеров ИИ — от OpenAI до YandexGPT — через ваши собственные API-ключи. Что умеет бот с ИИ в SamBot Отвечать на произвольные вопросы клиентов — не только по ключевым словам, как обычные сценарные боты. Держать контекст диалога — помнить предыдущие сообщения и отвечать связно. Использовать системный промпт — инструкцию для ИИ типа «ты консультант магазина X, отвечай вежливо, не уходи от темы». Генерировать изображения по запросу клиента (gpt-image-1.5 от OpenAI, YandexART). Расшифровывать голосовые сообщения в текст (Whisper) — и дальше отвечать на них как на обычное сообщение. Озвучивать ответы голосом (ElevenLabs, OpenAI TTS). Эскалировать сложные вопросы живому менеджеру — если ИИ не уверен, передаёт в общий чат команды (см. кейс «Чат-менеджер»). Поддерживаемые провайдеры На момент написания статьи в SamBot есть готовые интеграции с этими нейросетями: OpenAI — ChatGPT (gpt-4o, gpt-4-turbo, gpt-3.5-turbo), Assistants, gpt-image-1.5 / gpt-image-1 / gpt-image-1-mini (генерация и редактирование изображений), Whisper (распознавание речи), TTS (синтез голоса). OpenRouter — единый шлюз к Claude (Anthropic), Gemini (Google), Llama (Meta), Mistral, DeepSeek и ещё к нескольким десяткам моделей. YandexGPT — российский аналог, подходит, если важен российский хостинг. Google Gemini — напрямую, без OpenRouter. Perplexity — нейросеть с поиском в интернете, для ответов с актуальными данными. Grok — модель xAI. GoGPT — российский ChatGPT-совместимый сервис. ElevenLabs — синтез речи (TTS) и распознавание (STT) в высоком качестве. Airagic — ещё одна модель для генерации текстов. Можно подключить несколько провайдеров одновременно и использовать разные для разных задач: например, OpenAI для диалогов, YandexART для картинок, ElevenLabs для озвучки. Как устроена оплата Честно: за каждый запрос к нейросети платить нужно — но не нам, а провайдеру нейросети. Вы получаете API-ключ у OpenAI / YandexGPT / любого другого, заводите свой счёт у них, привязываете ключ в SamBot. SamBot вызывает API за вас, провайдер списывает деньги с вашего счёта по своим тарифам — это и называется «по себестоимости»: никаких наценок поверх не берём. SamBot вы при этом тоже оплачиваете, но по своему тарифу — за количество отправленных сообщений из бота, а не за использование ИИ. Минимальный тариф — 390 рублей за 1000 запросов, никаких подписок. Этого хватит, чтобы попробовать и понять, нужно ли вам это. Сколько в деньгах примерно: для OpenAI gpt-4o-mini один диалог из 5–10 сообщений обходится в 0,1–0,5 рубля. Для YandexGPT Lite — сопоставимо. То есть тысяча клиентских диалогов — это около 200–500 рублей нейросети плюс ваш тариф SamBot. Кому подойдёт Магазины и услуги — первая линия консультаций (цена, наличие, сроки доставки). Образовательные проекты — объяснение материала, проверка задач, помощь в учёбе. Эксперты и консультанты — FAQ-бот по вашим методикам и статьям. Поддержка по продуктам — если есть документация, ИИ может отвечать по ней. Творческие задачи — генерация контента, идей, текстов. Локальные сообщества и комьюнити — модерация, ответы новичкам, переводы. Сценарий со стороны клиента Клиент пишет произвольный вопрос: «Привезёте до Питера за три дня?» Бот отправляет вопрос в нейросеть с вашим системным промптом («ты менеджер интернет-магазина X, доставка по РФ, сроки 1–7 дней по регионам, тариф …»). Нейросеть формулирует ответ: «Да, по Санкт-Петербургу доставляем за 1–3 дня курьерской службой, стоимость …» Бот отправляет ответ клиенту — в его привычном мессенджере, как обычное сообщение. Клиент не замечает разницы: он видит знакомый чат с «ботом магазина», получает осмысленный ответ за 2–5 секунд. Сборка в SamBot Шаги одинаковы для Telegram и ВКонтакте: реализация делается в SamBot, мессенджер не имеет значения. Вся настройка укладывается в три действия и несколько минут. 1. Возьмите API-ключ у провайдера Самый универсальный вариант — OpenRouter: один ключ даёт доступ к Claude, GPT, Gemini, Llama, DeepSeek и другим. Регистрация по email, кнопка «Create Key» в личном кабинете. Если хочется ChatGPT напрямую — platform.openai.com/api-keys. Для российского хостинга — YandexGPT через Yandex Cloud. Для ответов с актуальной информацией из интернета — Perplexity. На счёт у провайдера достаточно положить 5–10 долларов на тесты. 2. Подключите интеграцию в SamBot Раздел «Интеграции» → «Добавить» → выбираете тип (например, OpenRouter), вставляете ключ, сохраняете. На этом всё — ключ сохранён в интеграции и готов к использованию в реакциях. 3. Создайте реакцию «AI-консультант» Реакция получает сообщение клиента, отправляет в нейросеть, возвращает ответ — одним ИИ-сообщением. «1. Срабатывает на» — галка «1.1.5. Содержит любой текст». «2. В чатах» — «Приватные чаты». В уже включённом действии «4.1. Отправить сообщение» на панели типов сообщения нажмите «+ ИИ» (рядом с «+ Текст», «+ Фото», «+ Файл»). Откроется модалка ИИ-сообщения. В модалке: Интеграция — выберите ту, что подключили на шаге 2. Включите галку «Инструкции», в textarea впишите системный промпт: «ты консультант магазина детских игрушек ”Радуга”, отвечай дружелюбно и кратко. Если не знаешь точно — говори ”уточню у менеджера”, не выдумывай». Включите галку «Текст», впишите {message_text} — это сообщение клиента, которое уйдёт в нейросеть как пользовательский ввод. (по желанию) Включите «Модель» и укажите конкретную модель — openai/gpt-4o-mini для OpenRouter, gpt-4o-mini для OpenAI. Если не указать — подставится модель по умолчанию из интеграции. Галка «Отправить ответ пользователю» уже включена — ответ нейросети сразу уйдёт клиенту, отдельная «+ Текст» не нужна. Сохраните модалку, сохраните реакцию. Напишите боту любой вопрос — через 2–5 секунд придёт осмысленный ответ от нейросети. (по желанию) Контекст диалога В той же модалке ИИ-сообщения есть пункт «Сохранять историю»: указываете параметр пользователя (например, chat_history), и SamBot сам ведёт переписку — каждое новое сообщение клиента и ответ ИИ дописываются в этот параметр, при следующем запросе подставляются как контекст. Бот начинает помнить предыдущие реплики и отвечать связно. Если контекст не нужен — оставьте пустым, нейросеть будет отвечать на каждый вопрос независимо. Аналогично есть «Сохранять ответ» — в параметр пользователя сохранится сам ответ нейросети, его потом можно использовать в других реакциях через {user:имя_параметра}. Расширения Голосовые сообщения — добавьте реакцию на «1.4. Голосовое сообщение» с действием Whisper / OpenAI Transcription. Текст из голоса сохраняется в параметр и дальше отправляется в ИИ как обычное сообщение. Озвучка ответа голосом — после получения ответа от ИИ добавьте действие OpenAI TTS или ElevenLabs Text-to-Speech. Получите аудиофайл, отправьте клиенту вместо текста. Генерация картинок — отдельная реакция на ключевое слово «нарисуй» или «сгенерируй»: запрос идёт в gpt-image-1.5 (OpenAI) или YandexART, бот возвращает картинку клиенту. Эскалация к человеку — научите промпт говорить кодовое слово (например, «передаю менеджеру») при сложных вопросах, ловите его ключевыми словами и запускайте кейс «Чат-менеджер». Метки клиентов — по ключевым словам в вопросах ставьте теги (#оплата, #доставка, #претензия) для аналитики и сегментации рассылок. Сохранение диалогов в Google Таблицу — чтобы видеть, как ИИ отвечает, и корректировать промпт по реальной обратной связи. Несколько персон — можно держать несколько системных промптов и переключаться между ними по команде клиента или по его метке (например, разные ответы для новичков и постоянных). Поиск в интернете — через Perplexity, для ответов с актуальной информацией (новости, цены конкурентов, погода и т. п.). Что важно учесть Промпт — главное. Качество ответов на 90% зависит от того, что и как вы написали в системном промпте. Стартовый промпт уточняйте по реальным диалогам с клиентами. ИИ может ошибаться. Особенно когда отвечает по фактам (цены, наличие, расписание). Обязательно добавьте в промпт инструкцию: «Если не знаешь точно — говори ”уточню у менеджера”, не выдумывай». И настройте эскалацию. Скорость ответа — 2–5 секунд для коротких ответов, до 15 секунд для длинных. Если клиенту нужно мгновенно — используйте более быструю модель (gpt-4o-mini вместо gpt-4o). Языки — все упомянутые модели одинаково хорошо работают на русском и английском. Если клиенты пишут на других языках — ИИ автоматически отвечает на их языке без дополнительной настройки. Если нужна помощь SamBot — это конструктор: всё описанное собирается без программиста. Если разбираться некогда — напишите нам, поможем выбрать провайдера, написать стартовый промпт под вашу нишу или настроить расширения. Цена адекватная для любого бизнеса. Подключите интеграцию, попробуйте на десятке тестовых вопросов — и уже сегодня клиенты смогут получать осмысленные ответы 24/7, без вашего участия. --- ## Telegram-бот-магазин с корзиной: динамический каталог, листание, оплата URL: https://sambot.ru/case_bot-magazin-s-korzinoy_109 Чат-бот-магазин с каталогом-каруселью, корзиной и счётом на динамическую сумму. Подходит мастерам и преподавателям — 5–15 позиций, добавляются через бота, без админки. Не всем нужен полноценный интернет-магазин. Мастеру маникюра, преподавателю онлайн-курсов, организатору воркшопов часто хватает 5–15 позиций — и поднимать ради этого отдельное решение избыточно. Этот кейс — про мини-магазин прямо внутри Telegram-бота: каталог-карусель с листанием, корзина с накоплением товаров, оплата на итоговую сумму. 📌 Задача Показать клиенту небольшой каталог товаров или услуг прямо в боте. Дать собрать заказ из нескольких позиций (накопить корзину). Выставить счёт на общую сумму и принять оплату через подключённую платёжную систему. Сделать так, чтобы каталог можно было пополнять без захода в админку — из самого чата с ботом. 🎯 Кому подойдёт Магазин на 5–15 позиций для мастеров, преподавателей, ивент-менеджеров. На тот же паттерн ложится не только торговля — это «накопительный каталог»: клиент собирает несколько позиций, бот считает их общую сумму и показывает заказ списком. Бронирование набора услуг — клиент выбирает несколько процедур, бот собирает общий счёт. Запись на курс с модулями — клиент выбирает нужные модули, бот считает стоимость. Сбор заявок мероприятия — участник набирает места или билеты. ⚠️ Когда это не подойдёт Если каталог большой (сотни товаров, фильтры по характеристикам, склад, личный кабинет покупателя, отзывы) — лучше использовать специализированные решения. SamBot в таком сценарии можно подключить как канал общения с клиентом — уведомления, поддержка, рассылки — но сам каталог держать в нём не стоит. ⚙️ Что увидит клиент Пишет в бот «магазин» (или другое выбранное вами слово). Получает карточку первого товара: фото, название, цена, кнопки ◀ ▶ для листания, «В корзину», «Перейти в корзину». Листает каталог кнопками ◀ ▶. В нужных карточках жмёт «В корзину» — бот молча добавляет товар. Нажимает «Перейти в корзину» — видит свой заказ списком, итоговую сумму и кнопку «Оплатить» с уже подставленной суммой. Жмёт «Оплатить» — переходит на страницу платёжной системы и оплачивает. При желании может нажать «Очистить корзину» — начать сборку заново. 🔧 Что получит мастер В админке — стандартный список оплат через подключённую платёжную систему (ЮKassa, Robokassa, Prodamus, Т-Банк). Каждая оплата привязана к конкретному клиенту в боте, видно кто и на какую сумму. Опционально каждая покупка дублируется строкой в Google Таблицу — простой учёт без отдельной системы. А главное — добавить новый товар можно прямо из чата с ботом: написать «товар», отправить фото с подписью «Название | Цена», и всё. Без админки. 🛠 Как это собирается в SamBot Если бота ещё нет — пройдите быстрый старт для Telegram или ВКонтакте. Дальше нужны три параметра, одна платёжная система и пять реакций. Количество товаров на структуру не влияет. 1. Параметры В разделе «Параметры» создайте три параметра: catalog, режим «Хранить все значения» — общий список товаров. cart, режим «Хранить все значения» — персональная корзина клиента. catalog_position, режим «Хранить последнее значение» — номер товара, который клиент сейчас просматривает. 2. Платёжная система В разделе «Оплаты» подключите любого провайдера (ЮKassa, Robokassa, Prodamus, Т-Банк …). Понадобится в реакции корзины. 3. Реакция «Добавить товар» Это «админ-режим» для пополнения каталога. Подробно описан в отдельной статье — «Как накопить данные в параметре через реакцию». Кратко: Триггер — ключевое слово товар в вашем личном чате с ботом. Сообщение — «Отправьте фото товара с подписью в формате «Название | Цена».» В настройке «Сохранить ответ»: ожидаемый тип — фото, параметр catalog, режим «Хранить все значения», галка «Глобальный». 4. Реакция «Витрина» Показывает один товар по текущей позиции. Триггер не указывается — запускается только из цепной реакции (см. ниже). В блоке «4. Действия» в уже включённом «4.1. Отправить сообщение» добавьте одно сообщение типа «Фото». Файл фото оставьте пустым — включите «Отправить параметр» и в поле подстановки впишите: {global:catalog:{user:catalog_position}} Это сложная подстановка: сначала бот посмотрит текущую позицию клиента, потом возьмёт фото из каталога по этой позиции. В этом же сообщении включите «С текстом» и впишите подпись через формулу: {formula:FIELD(JP({global:catalog:{user:catalog_position}};"$.caption");" | ";"{0} — {1}₽")} Здесь JP(...; "$.caption") достаёт исходную подпись («Мыло | 500»), а FIELD(...; " | "; "{0} — {1}₽") переоформляет её в «Мыло — 500₽» по шаблону. Добавьте четыре кнопки: ◀ — тип «Реакция», ведёт в «Назад» (шаг 5). ▶ — тип «Реакция», ведёт в «Вперёд» (шаг 5). В корзину — тип «Реакция», ведёт обратно в «Витрину» (re-render), плюс в настройках кнопки нажмите «Сохранить ответ»: параметр cart, режим «Хранить все значения», значение — формула: {formula:JP({global:catalog:{user:catalog_position}};"$.caption")} Это сохранит подпись текущего товара в корзину. Перейти в корзину — тип «Реакция», ведёт в «Корзина» (шаг 7). 5. Реакции «Назад» и «Вперёд» Две похожие реакции, обе только из цепи. Назначение — обновить позицию клиента и показать товар. Назад: В настройке параметров реакции добавьте catalog_position с режимом «Хранить последнее значение» и значением: {formula:MAX({user:catalog_position}-1;1)} MAX с единицей — нижняя граница, чтобы листание не ушло в ноль. В блоке цепной реакции («4.16. Запустить реакцию») выберите «Витрину» и поставьте «В личные сообщения». Вперёд — то же, но значение позиции: {formula:MIN({user:catalog_position}+1;COUNTA({global:catalog:1-}))} MIN с COUNTA(...) — верхняя граница, она автоматически равна числу товаров в каталоге. 6. Реакция «Магазин» (вход) Триггер — ключевое слово магазин в личке. Назначение — сбросить позицию на первую и запустить витрину. В настройке параметров реакции добавьте catalog_position, режим «Хранить последнее значение», значение 1. В цепной реакции («4.16») укажите «Витрину», чат — «В личные сообщения». 7. Реакция «Корзина» Показывает заказ списком, итог и кнопку оплаты. Триггер не нужен — запускается из кнопки «Перейти в корзину» витрины. Одно сообщение типа «Текст» с двумя формулами: Ваш заказ: {formula:JOIN(NL();FOREACH({user:cart:1-};LAMBDA(item;FIELD(item;" | ";"{0} — {1}₽"))))} Итого: {formula:SUM(FOREACH({user:cart:1-};LAMBDA(item;FIELD(item;" | ";1))))}₽ Первая формула проходит по всем товарам корзины и форматирует каждый по шаблону. Вторая считает сумму вторых полей (цен). В этом же сообщении кнопка «Оплатить» типа «Оплата». В поле «Сумма» вставьте ту же формулу: {formula:SUM(FOREACH({user:cart:1-};LAMBDA(item;FIELD(item;" | ";1))))} Сумма счёта будет ровно равна сумме корзины — клиент платит за то, что собрал. Вторая кнопка — «Очистить корзину» типа «Реакция», ведёт в реакцию очистки. 8. Реакция «Очистить корзину» Одно сообщение «Корзина очищена.» В настройке параметров реакции добавьте cart с режимом «Удалить все значения». Это сотрёт всё содержимое корзины этого клиента. 💡 Что можно докрутить Скидка от суммы — в поле «Сумма» оплаты вместо чистой SUM поставьте IF(SUM>3000;SUM*0.9;SUM). И строку «Скидка 10% от 3000 ₽» в тексте корзины. Категории каталога — несколько параметров (catalog_clothes, catalog_accessories) и по витрине на каждый раздел. Уведомление менеджеру после оплаты — цепная реакция на успешную оплату с тем же списком товаров отправляется в ваш админский чат. Запись заказа в Google Таблицу — в реакцию «Корзина» добавьте действие «Отправить в Google Таблицу». Мини-CRM без отдельной системы. Если нужна помощь SamBot — это конструктор, всё описанное собирается мышкой в админке без программиста. Если хочется быстрый старт — напишите нам, поможем настроить под вашу нишу или предложим готовый шаблон. Стоимость доступна и для самозанятых мастеров, и для маленьких студий. Заведите бота, попробуйте на своём ассортименте — и через час у вас будет рабочий мини-магазин внутри Telegram. --- ## Быстрый старт Telegram: ваш первый бот за 10 минут URL: https://sambot.ru/guide_bystryy-start_87 Пошаговая инструкция: регистрация, создание бота через @BotFather, подключение в SamBot, первая реакция и проверка в Telegram. Без навыков программирования. Эта инструкция проведёт вас от регистрации в SamBot до первого работающего бота, отвечающего на сообщения. Времени уйдёт около 10 минут. Никаких навыков программирования не нужно — настройка через визуальный интерфейс. Что вам понадобится аккаунт в Telegram (для общения с @BotFather и тестирования); email — для регистрации в SamBot; браузер. Шаг 1. Регистрация в SamBot Откройте sambot.ru и нажмите «Регистрация». Введите email и пароль, подтвердите регистрацию по ссылке из письма. Шаг 2. Создаём бота в Telegram Бот в Telegram — отдельная сущность Telegram, и сначала нужно создать его официально через @BotFather: В Telegram откройте чат с @BotFather. Отправьте команду /newbot. Введите имя бота — то, что увидят пользователи в шапке диалога (например, «Магазин подарков»). Введите username — он должен оканчиваться на bot и быть уникальным (например, my_gift_shop_bot). BotFather пришлёт токен вида 123456789:AAEs... — скопируйте его. Это секретный ключ доступа к боту. Совет: храните токен в надёжном месте — кто им владеет, тот управляет ботом. Шаг 3. Подключаем бот в SamBot В личном кабинете SamBot нажмите «Добавить бота» и выберите Telegram. Вставьте токен из шага 2 и нажмите «Сохранить». После создания бота нужен тариф для запуска. Если вы используете SamBot впервые — примените промокод (даётся однократно) или оплатите подходящий тариф. Перейдите в раздел «Оплата тарифа» и нажмите ссылку «У меня есть промокод». После сохранения откроется страница «Статистика» бота. В левом меню сверху — ссылка «Оплата тарифа», ниже идут «Статистика», «Настройки», «Чаты», «Пользователи», «Реакции» и другие разделы. Шаг 4. Создаём первую реакцию Реакция — это правило вида «при определённом триггере выполнить определённые действия». Форма создания реакции разделена на четыре блока: 1. Срабатывает на, 2. В чатах, 3. Условия, 4. Действия. Создадим простую: бот будет отвечать на слово «привет». В боковом меню откройте раздел «Реакции» и нажмите «Добавить реакцию». В поле «Заголовок» впишите название реакции, например Приветствие — это единственное обязательное поле. В блоке «1. Срабатывает на» разверните «1.1. Текстовое сообщение», включите галочку «1.1.1. Содержит ключевые слова» и добавьте ключевое слово привет. В блоке «4. Действия» галочка «4.1. Отправить сообщение» уже включена по умолчанию. Нажмите кнопку «+ Текст» — откроется форма добавления текстового сообщения. Впишите ответ: Привет! Я твой первый бот на SamBot. Сохраните сообщение. Нажмите «Сохранить». Шаг 5. Проверяем в Telegram Откройте бота в Telegram (по username из шага 2: https://t.me/your_bot_username). Нажмите «START» и напишите «привет». Бот ответит вашим сообщением. ✓ Если ничего не пришло: Проверьте, что бот включён в SamBot. Убедитесь, что в реакции включена галочка «1.1.1. Содержит ключевые слова» и что слово в поле «Ключевые слова» совпадает с тем, что вы отправляете боту. Проверьте раздел «Статистика» — там видно, какие сообщения пришли и сработала ли реакция. Что дальше Когда первый бот заработал, переходите к более интересным сценариям: Реакции — все типы триггеров (текст, кнопка, время, событие) и действий. Кнопки и опросы — добавьте интерактива в ответы. Метки — сегментация подписчиков для рассылок и условий. Формулы и параметры пользователя — динамический контент: имя пользователя, дата, расчёты. Приём платежей — подключите платёжного провайдера (ЮKassa, Robokassa, Prodamus, Т-Банк) и продавайте товары и услуги. --- ## Быстрый старт VK: ваш первый бот в сообществе ВКонтакте URL: https://sambot.ru/guide_bystryy-start-vk_89 Пошаговая инструкция: токен сообщества, подключение Callback API, первая реакция и проверка в сообществе ВКонтакте. Без навыков программирования. Эта инструкция проведёт вас от регистрации в SamBot до первого работающего бота в сообществе ВКонтакте. По сравнению с Telegram шагов чуть больше — нужно связать сервер SamBot с сообществом через Callback API. Никаких навыков программирования не нужно. Что вам понадобится аккаунт ВКонтакте с правами администратора в сообществе (или возможность создать новое сообщество); email — для регистрации в SamBot; браузер. Шаг 1. Регистрация в SamBot Откройте sambot.ru и нажмите «Регистрация». Введите email и пароль, подтвердите регистрацию по ссылке из письма. Шаг 2. Получаем токен сообщества ВКонтакте Если у вас уже есть сообщество — используйте его. Иначе сначала создайте новое: vk.com → слева «Сообщества» → «Создать сообщество». Чтобы SamBot мог отвечать от имени сообщества, нужен токен: Откройте сообщество, которым управляете. В настройках сообщества: Управление → Дополнительно → Работа с API → Ключи доступа. Нажмите «Создать ключ», выдайте права на сообщения сообщества и на управление сообществом. Скопируйте полученный токен (длинная строка). Это секретный ключ — храните его в надёжном месте. Шаг 3. Подключаем бота в SamBot В личном кабинете SamBot нажмите «Добавить бота». В появившемся диалоге выберите ВКонтакте. Вставьте токен из шага 2 и нажмите «Сохранить». Сразу после этого откроется мастер «Связать сервер с ВКонтакте» — переходим к нему. Шаг 4. Связываем сервер с ВКонтакте (Callback API) Это ключевой шаг: ВКонтакте должна знать, на какой адрес отправлять события. SamBot уже подготовил все данные — осталось их скопировать в настройки сообщества. Мастер называется «Связать сервер с ВКонтакте» и показывает 5 нумерованных шагов: Откройте настройки сообщества: Управление → Дополнительно → Работа с API → Callback API. Не закрывайте мастер SamBot — переключайтесь между вкладками. В мастере SamBot скопируйте адрес сервера (есть кнопка copy) и вставьте его в поле URL на вкладке Callback API в ВКонтакте. ВКонтакте покажет код подтверждения — скопируйте его и вставьте в поле «Код подтверждения сервера» мастера SamBot. В мастере SamBot есть «Секретный ключ (Callback API)», сгенерированный автоматически. Скопируйте его и вставьте в поле «Секретный ключ» на вкладке Callback API в ВКонтакте. В мастере SamBot нажмите «Сохранить». Затем вернитесь в ВКонтакте и нажмите «Подтвердить» на вкладке Callback API. ВКонтакте сделает тестовый запрос на адрес SamBot и подтвердит подключение. Эти сведения позже можно обновить в Настройках бота. Шаг 5. Включаем типы событий По умолчанию ВКонтакте не отправляет SamBot новые сообщения — их нужно явно подписать. На той же странице Callback API перейдите на вкладку «Типы событий». Включите «Входящее сообщение». Если планируете обрабатывать ответы на кнопки — включите также события об их нажатиях. Сохраните. Шаг 6. Создаём первую реакцию Форма реакции в SamBot одинакова для Telegram и ВКонтакте — разделена на четыре блока: 1. Срабатывает на, 2. В чатах, 3. Условия, 4. Действия. Создадим простую: бот будет отвечать на слово «привет». В боковом меню откройте раздел «Реакции» и нажмите «Добавить реакцию». В поле «Заголовок» впишите название реакции, например Приветствие — это единственное обязательное поле. В блоке «1. Срабатывает на» разверните «1.1. Текстовое сообщение», включите галочку «1.1.1. Содержит ключевые слова» и добавьте ключевое слово привет. В блоке «4. Действия» галочка «4.1. Отправить сообщение» уже включена по умолчанию. Нажмите кнопку «+ Текст» — откроется форма добавления текстового сообщения. Впишите ответ: Привет! Я твой первый бот ВКонтакте на SamBot. Сохраните сообщение. Нажмите «Сохранить». Шаг 7. Проверяем в сообществе Откройте сообщество в ВКонтакте, нажмите «Написать сообщение» и отправьте «привет». Бот ответит вашим сообщением. ✓ Если ничего не пришло: Проверьте, что бот включён в SamBot. Убедитесь, что в ВКонтакте на вкладке Callback API стоит статус «Подтверждено». На вкладке «Типы событий» включено «Входящее сообщение». В настройках сообщества «Управление → Сообщения» сообщения сообщества включены. Проверьте раздел «Статистика» в SamBot — там видно, какие события пришли и сработала ли реакция. Что дальше Реакции — все типы триггеров и действий. Кнопки и опросы — добавьте интерактива в ответы. Метки — сегментация подписчиков. Формулы и параметры пользователя — динамический контент. Приём платежей — подключите платёжного провайдера. --- ## Настройки бота телеграм в конструкторе Sambot.ru URL: https://sambot.ru/guide_nastroyki-bota_17 Какие настройки можно указать у бота в конструкторе Sambot.ru и на что они влияют. Страница настроек состоит из нескольких основных блоков: Информация, которая передается Телеграмом: имя и аватарка бота. Отредактировать эти и другие данные (About, Description, Системные команды) можно только в телеграме в боте @BotFather, в котором вы его создавали. Если данные в @BotFather обновлены, пожалуйста, нажмите кнопку "Синхронизация", чтобы конструктор скачал изменения. Обращение к боту. Об этом более подробно написано в Справе "Обращение к боту". После внесения изменений, не забывайте, нажать кнопку "Сохранить" --- ## Ключевые слова и фразы URL: https://sambot.ru/guide_klyuchevye-slova_5 Как работать с полем "Ключевые слова", чтобы бот правильно "понимал", на какие сообщения ему стоит реагировать и каким именно сценарием. Перейдите и 🔔 подпишитесь на наш обучающий Youtube-канал. Инструкция по работе: "Ключевые слова" - это перечень слов, "услышав" которые бот должен отреагировать по заданному сценарию. Здесь есть некоторые нюансы. Разберемся с вариантами - как можно указывать ключевые слова. Как добавлять ключевые слова: В блоке "Ключевые слова" нажмите кнопку "+ Добавить". Появится окно со строкой для ввода ключевого слова: Здесь можно выбрать специальные ограничения слов: "содержит" (по умолчанию и никак не обозначается), " [ начинается", "заканчивается ] ", " [ только ] ". Здесь укажите одно ключевое слово из фразы. К примеру, если вы прописываете фразу "аренда байков" - укажите здесь только слово "аренда", сохраните, а "байков" добавите отдельно. Здесь укажите "синонимы" указанного ключевого слова, если необходимо. Синонимами мы будем называть слова, которые можно использовать вместо основного слова, но это могут быть не обязательно синонимы в прямом смысле этого слова. Если вы добавили "синонимы", в дальнейшем вы можете удалить один из вариантов по отдельности. Так же вы можете удалить всю группу слов сразу. Варианты указания ключевых слов и фраз: Жёсткое указание ключевой фразы: аренда байка - сработает, если между словами будет только пробел; аренда крутого байка и другие варианты - НЕ сработает. Мягкое указание ключевой фразы: аренда байка - сработает; аренда крутого байка - сработает; прокат скутера - НЕ сработает. Используйте "синонимы" слов: пользователи могут использовать другие слова, которые будут обозначать тоже самое. Добавьте синонимы. Как, смотрите начало этой страницы. Добавляйте новые ключевые фразы, чтобы срабатывать при большей вариативности запросов: Следите за условиями "И" и "ИЛИ". Таким образом данный пример имеет большое число рабочих ключевых фраз: аренда байка - сработает; аренда скутера - сработает; аренда мотоцикла - сработает; арендовать мотоциклы - НЕ сработает; прокат байка - сработает; прокат скутера - сработает; прокат мотоцикла - сработает; прокат мотоциклов - НЕ сработает; обучение вождению - сработает; уроки вождению - сработает, но так НЕ говорят! Отбросьте приставки и окончания у ключевых слов в фразе, чтобы увеличить охват вариантов: В этом случае сработают все фразы, которые в предыдущем примере не сработали бы. Важно следить за тем, чтобы оставшиеся части слов не могли использоваться пользователями, как слова, далекие от заданных. Используйте специальные ограничения слов: 0. Отсутствие ограничения - приравнивается к условию "Содержит" (стоит по умолчанию, никак не обозначается в списке слов). Слово, которое будет содержать в любой своей части заданное ключевое слово - будет считаться подходящим под условие. К примеру слово "аренд" содержится в слове "субарендатор". Приставка и окончание не помеха в этом случае. 1. Ограничение "Начинается" обозначается как красная открывающаяся квадратная скобка и означает, что условие сработает только в том случае, если слово будет начинаться с указанного ключевого слова. К примеру " [ прокат" сработает при запросе "прокатчик", и НЕ сработает в случае с "напрокат". 2. Ограничение "Заканчивается" обозначается как красная закрывающаяся квадратная скобка и означает, что условие сработает только в случае, если слово будет заканчиваться на указанное ключевое слово. К примеру "скутер ] " НЕ сработает при запросе "скутерист". 3. Ограничение "Только" обозначается парой красных открывающейся и закрывающейся квадратных скобок, которые означают, что условие сработает только, если в используемом слове нет ничего кроме как только указанное вами ключевое слово. Вариант условия " [ урок ] " сработает только в этом виде, и НЕ сработает при добавлении приставки или окончания, как в вариантах слов "шнурок" или "урокодатель". Нажмите кнопку "Посмотреть варианты": Откроется окно, где вы можете проверить все возможные комбинации ваших ключевых словосочетаний: Начинайте с простых вариантов. Со временем у вас будет получаться ключевые фразы более изобретательными. --- ## Как указать и использовать обращение к боту в Телеграм URL: https://sambot.ru/guide_obrashchenie-k-botu_6 Чтобы бот не вмешивался в разговоры участников чата, можно придумать обращение, по которому он будет понимать, что вопрос задан именно ему. Перейдите и 🔔 подпишитесь на наш обучающий Youtube-канал. По умолчанию, всем ботам дали имя. И имя это - бот! Это немного бесчеловечно, но часто удобно оставить имя именно таким, так как многие пользователи знают этот "позывной". В любом случае, в вашем праве дать своему боту другой позывной. Имя или позывной - в системе называется как "Обращение". Зайдите на главную страницу и у нужного бота справа выберите иконку "Редактировать". Там есть поле единственное поле, которое можно поменять - "Обращение". Сохраните изменения. Зачем нужно обращение к боту Неважно, какой модуль вы используете, но если общение с ботом идет в приватном с ним чате - обращение не требуется. Это диалоговое окно, там только пользователь и бот, и третьего не дано. Специально называть бота там по имени не требуется (но и не возбраняется). А вот если бот участвует в публичных чатах, то тут нужно разделять, реагировать боту только когда к нему обращаются или нужно что-то делать и без обращения к нему лично. Пример для второго случая - реакция на мат, спам и т.д. - когда бот должен среагировать даже, если "спасателя никто не звал на помощь". А в первом случае, если вашего бота зовут, к примеру, "Кот", а в ключевых словах вашего сценария у вас указано "помощь", то по фразе, к примеру, "Кот, мне нужна помощь" - выполнится ваш сценарий. Таким образом, бот в публичных чатах читает все сообщения и только при обнаружении условий, при которых ему нужно реагировать - он будет что-то делать. --- ## Метки для сегментации Пользователей URL: https://sambot.ru/guide_metki_19 Чтобы сегментировать Пользователей (подписчиков) бота в Телеграме - используйте Метки. Перейдите и 🔔 подпишитесь на наш обучающий Youtube-канал. Чтобы сегментировать Пользователей (подписчиков) Бота в Телеграме - используйте Метки. Метки можно указывать у всех сообщений и у всех кнопок (кроме кнопок со ссылками) Когда пользователь получает сообщение или нажимает кнопку с меткой - она присваивается ему В сообщении или кнопке можно выбрать: (+) присваивать и/или (-) удалять метку Пользователю. Проставление меток доступно везде, где добавляются сообщения или кнопки, а сегментировать сценарии по меткам можно в Ответах и Рассылках. В базе Пользователи доступно массовое и ручное изменение меток (добавление или удаление) --- ## Прием платежей через Бота Telegram URL: https://sambot.ru/guide_priem-platezhey_22 Настройте автоматический прием платежей и отработку Ответа, в котором будет "содержаться", к примеру, ваша услуга или инфопродукт. Перейдите и 🔔 подпишитесь на наш обучающий Youtube-канал. Приём платежей - простой способ получать оплату, к примеру, за свои услуги или инфопродукты и автоматически предоставлять их через бота. Инструкция по работе: Выберите Бота, с которым будем работать. Выберите модуль "Приём платежей" и нажмите на кнопку "Добавить способ приёма платежей". Укажите заголовок (для себя). Мы рекомендуем указывать здесь способ оплаты, который мы сейчас далее будем прописывать. Способ оплаты - это вариант, которым могут воспользоваться покупатели: оплата Яндекс.Деньгами, картой, со счета мобильного телефона и т.д. У каждого способа оплаты свои комиссии, поэтому мы не включаем сразу все варианты. Вы можете настроить каждый способ оплаты отдельно, и далее подключать их в кнопках оплаты (см. п.7 далее). Выберите один из способов оплаты для этой настройки Платежа. В "Получателе платежа" укажите ваш счет в Яндекс.Деньгах. Чтобы автоматизировать продажи через Бота обязательно настройте уведомления о входящих переводах. Так Бот будет знать о каждом поступлении средств, по счетам, которые он выставит пользователям. Вот так выглядит страница Настроек уведомлений в системе Яндекс.Деньги: Отлично. Сохраните страницу с этим способом Приёма платежей. При необходимости добавьте другие способы оплаты. Теперь, чтобы начать выставлять счета, в Ответах создайте сообщение, в котором вы опишите ваш продукт или услугу, его стоимость и другие необходимые данные. К сообщению добавьте кнопки для разных способов оплаты: Настройки Кнопки оплаты следующие: 1. Укажите надпись на кнопке (по ней должно быть понятно, какой способ оплаты вы предлагаете); 2. Выберите из списка ваших заготовленных Способов приёма платежей соответствующий этой кнопке вариант; 3. Укажите цену в рублях (в зависимости от способа приёма платежей комиссия будет списываться или с отправителя или с получателя - об этом подробнее есть информация при выборе способа оплаты); 4. Укажите Назначение платежа - краткое описание, чтобы пользователь на стороне Яндекс.Денег мог видеть за что он платит. Так же эту информацию будет использовать Бот в качестве указания назначения платежа. 5. Укажите Ответ (см. следующий пункт), который должен запустить сразу после того, как к вам на счет в Яндекс.Деньгах придет оплата от покупателя. 6. Если есть в этом необходимость, вы можете указать временную Метку, благодаря которой можно ограничить доступ к вашему Ответу по времени. Заранее в Ответах создайте сценарий со всей необходимой информацией (в нашем случае - предоставление файла PDF), чтобы он был отработан сразу после получения оплаты покупателем. В Боте все должно работать правильно: должен быть пост с информацией о продукте и кнопками оплаты (1), Информация о выставленном счете или (после получения оплаты) о положительном результате оплаты (2) и пост с самим Продуктом, отправленный после оплаты (3). В модуле "Приём платежей" у вас отражаются все настроенные Способы приёма платежей и все выставленные и оплаченные счета с подробной информацией о каждом счете. --- ## Приём платежей через Robokassa URL: https://sambot.ru/guide_robokassa_23 Настройте интеграцию с Robokassa, чтобы осуществлять приём платежей от подписчиков ваших Telegram-ботов. Вы можете настроить интеграцию с Robokassa для приёма платежей от подписчиков своего Telegram-бота всего за несколько шагов: 1. Зарегистрируйтесь в сервисе Robokassa в качестве ИП или Юридического лица и добавьте свой магазин: 2. После модерации магазина, перейдите в его вкладку "Технические настройки" и укажите следующие данные: 3. Перейдите в SAMBOT.RU в раздел "Приём платежей" и добавьте новую интеграцию, в соответствии с данными, указанными в Robokassa: 4. Скопируйте ссылки Result Url, Success Url и Fail Url для указания их в системе Robokassa. 5. Проведите тестовый платёж и в случае успеха, переключите Статус магазина в режим "Магазин активирован и готов принимать платежи". Поздравляем! Ваши Telegram-боты могут принимать платежи через Robokassa. --- ## Приёма платежей через Продамус (Prodamus) URL: https://sambot.ru/guide_prodamus_51 Пошаговая инструкция: интеграция чат-бота Sambot с Продамусом. Настройка платёжной формы, автоматическая обработка оплат, реакция после оплаты. 1. Зарегистрируйтесь в конструкторе SAMBOT.RU и добавьте бота. 2. Соберите основной функционал бота, используя короткие мастер-классы. 3. Чтобы начать работать с Продамус, вам нужно зарегистрироваться и получить доступ к личному кабинету. Используйте промокод SAMBOT для скидки 2000 рублей при регистрации. 4. Перейдите в раздел Приём платежей и Добавьте новый способ приёма платежей. Укажите Заголовок на своё усмотрение. Выберите в качестве Платёжной системы Prodamus. Укажите URL-адрес платёжной формы в системе Продамус (он выдаётся вам после регистрации в Продамусе). Укажите Секретный ключ - его можно получить в личном кабинете. Выберите автоматическую обработку платежей. Нажмите кнопку "Добавить". 5. Перейдите в ту Реакцию, которая должна запустить приём оплаты через систему Продамус. Добавьте текст призывы к действию. Добавьте кнопку с призывом к действию. 6. Выберите тип кнопки (слева от текста кнопки) и укажите корректные значения полей. Укажите текст на кнопке. Выберите из имеющихся у вас способов оплаты тот, который вы настроили на систему Продамус. Укажите сумму оплаты. Укажите назначение платежа. Выберите Реакцию, которая должна запуститься при успешной оплате. При необходимости можете назначить покупателю метки или указать данные в персональные параметры. 7. Обязательно самостоятельно протестируйте оплату, через бота! Удостоверьтесь, что все работает корректно. Успешной вам работы! Вход или регистрация → https://sambot.ru/ --- ## Как открыть канал, группу или сделать бота в Telegram URL: https://sambot.ru/guide_kak-otkryt-kanal-gruppu-ili-sdelat-bota-v-telegram_53 Простая инструкция, как создать в Телеграм свой канал, публичную группу или умного бота. Скачать Telegram на смартфон можно в Google Play или App Store. Для ноутбука на сайте Telegram.org Как перейти в Телеграм из Инстаграм, Фейсбук, Ютуб, Вотсап, Вайбер и Тик ток. Сначала решите, что вы хотите делать в Телеграм? ✅ ГРУППА Если вы хотите общаться в небольшой группе, к примеру, со своей семьёй, вам нужна частная группа, которая будет доступна только вашему кругу. Аналоги групповых приватных чатов есть в Вотсапе, Скайпе и т.д. Группа может быть и публичной. Это решение хорошо подходит для людей, объединённых одной целью или идеей, например, для учащихся одного обучающего курса, жителей одного городка или для поклонников Филиппа Киркорова. Качественных аналогов подобного формата нет нигде. К аналогу можно отнести Беседы в ВК, но по удобству там еще очень далеко, а так же Группы в Фейсбук, где каждый участник может публиковать свою информацию в общую ленту. Как создать группу в Телеграм - сморите инструкцию ниже. ✅ КАНАЛ Если вы хотите создать в Телеграм ленту своих новостей (аналог лент Инстаграм, Страниц в Фейсбук и т.д.), то вам стоит открыть канал. Они также бывают приватными (только для своих) и публичными (для всех). Как создать канал в Телеграм - сморите инструкцию ниже. ✅ БОТ Если вам нужен бот-помощник (делает то, что мы ему скажем и не устаёт), тогда вам нужен бот. Он может работать как самостоятельно (у него можно что-то спросить) или в каналах и группах (может приветствовать новых подписчиков, отвечать на популярные вопросы, следить за матом и спамом в чатах и т.д.). Как создать бота в Телеграм - сморите инструкцию ниже. Прочитайте статью до конца и получите ПРОМОКОД НА 14 ДНЕЙ тестирования конструктора Telegram-ботов! ❌ НИЧЕГО НЕ НУЖНО Если вы хотите просто общаться с друзьями один на один, вам не нужен ни канал, ни группа, ни бот. Вы просто находите контакт и переписываетесь с ним. Аналоги есть во всех мессенджерах (Вотсап, Вайбер, Фейсбук мессенджер, Скайп, Директ и т.д.) Определились? Давайте сделаем все это прямо сейчас! Как создать ГРУППУ в Телеграм Откройте Телеграм и выберите меню мессенджера. Нажмите Создать группу. Добавьте аватарку и название группы. Можно оставить это на потом. Добавьте первых участников в группу. Это тоже можно будет сделать позже. Группа создана. Перейдите в Управление группы. чтобы настроить ей. Здесь можно установить или заменить аватарку, название и описание группы. Выберите Тип группы. Доступ к частной группе предоставляется только по ссылкам-приглашениям. Публичным чатам можно указать короткое имя, чтобы заходить в нее по адресу https://t.me/namegroup. Также публичные группы может найти любой пользователь Telegram через внутренний поиск. История чатов может быть видна или скрыта от новых пользователей. Выбирать вам. Группа в Telegram создана! Создайте для своего канала бота, который будет принимать оплату за услуги или товары. Просто посмотрите короткий мастер-класс и повторите все шаг за шагом. все мастер-классы на нашем канале Как создать КАНАЛ в Телеграм Откройте Телеграм и выберите меню мессенджера. Нажмите Создать канал. Добавьте аватарку, название и описание канала. Можно оставить это на потом. Канал создан. Перейдите в Управление каналом. чтобы настроить его. Здесь можно установить или заменить аватарку, название и описание канала. Выберите Тип канала. Доступ к частному каналу предоставляется только по ссылкам-приглашениям. Публичным каналам можно указать короткое имя, чтобы заходить в него по адресу https://t.me/namechannel. Также публичные каналы может найти любой пользователь Telegram через внутренний поиск. Для того, чтобы посты в канале можно было комментировать, к нему нужно подключить группу. Выберите из имеющихся или создайте новую. Канал в Telegram создан! Создайте для своей группы антиспам- и антимат-бота. Просто посмотрите короткий мастер-класс и повторите все шаг за шагом. все мастер-классы на нашем канале Как создать БОТА в Телеграм Откройте Телеграм и найдите в поискe: @Botfather - бот, который регистрирует всех других ботов в Telegram. Нажмите кнопку [ / ] или начините набирать слеш "/". Выберите /newbot (создать новый бот). Ботфазер спросит, а вы отправьте ему название вашего бота: напишите название компании или что-то другое. Потом можно будет исправить. Бот спросит, а вы отправьте ему имя бота (username). Оно может быть только латинскими буквами и заканчиваться на bot или _bot. Придумайте интересное имя бота. При успехе, Ботфазер пришлёт вам подтверждение и уникальный код вашего бота (token). Скопируйте его. Перейдите на простой конструктор Telegram-ботов https://sambot.ru и зарегистрируйтесь или авторизуйтесь в нём. После подтверждения регистрации на главном экране нажмите кнопку "Добавить бота телеграм". Скопированный ранее в @Botfather токен вашего бота вставьте в форму и нажмите кнопку "Добавить". В верхнем левом меню выберите пункт "Реакции", чтобы научить бота приветствовать новых подписчиков. В заголовке можете написать все, что угодно. Например значение данной реакции бота: Приветствие. Ниже выберите Срабатывает на: Системное сообщение и установите галку "Участник добавился в чат". Именно тогда боту нужно будет поприветствовать нового подписчика. Прокрутите страницу ниже и вы увидите блок "Отправить сообщение". Нажмите голубую кнопку "+ Текст" и добавьте в поле текст вашего приветствия. В самом конце страницы настроек реакции нажмите "Добавить". Настройка приветствия завершена. В поиске Телеграм напишите имя вашего бота и выберите его из предложенных поиском вариантов. Запустите бота и проверьте, как бот будет вас приветствовать. Все получилось? Чат-бот для Телеграм создан! Создайте бота-визитку, чтобы он 24/7 предоставлял информацию о вас подписчикам и потенциальным клиентам. Просто посмотрите короткий мастер-класс и повторите все шаг за шагом. все мастер-классы на нашем канале 🎁 ИСПОЛЬЗУЙТЕ ПРОМОКОД: SAMBOTRU ДЛЯ БЕЗЛИМИТНОГО ТЕСТИРОВАНИЯ НА 14 ДНЕЙ ХОТИТЕ БОЛЬШЕ ИЛИ ЕСТЬ ВОПРОСЫ? Если вы хотите научить вашего бота отвечать на вопросы, создавать сообщения с кнопками, ссылками, фотографиями и видео. Если хотите, чтобы бот помогал вам в модерировании публичных чатов или публиковал по расписанию посты в канал: ✅ Присоединяйтесь в наш дружный Чат заБОТы в Телеграм https://t.me/sambotru и задавайте вопросы. Мы поможем! ✅ Посмотрите бесплатные короткие мастер-классы по созданию ботов на Youtube https://www.youtube.com/playlist и просто научитесь собирать ботов для себя или на заказ. ✅ Записывайтесь на ближайший Курс «Telegram-боты с нуля» https://t.me/sambot_ru_bot и приобретите новую профессию. Зарабатывать можно хорошо, а работать удалённо. Артём Кук, руководитель простого конструктора SAMBOT.RU --- ## Приём платежей через Юкассу URL: https://sambot.ru/guide_yookassa_65 Инструкция по подключению платежного сервиса Юкассы к телеграм чат-боту в конструкторе Самбот. Сайт: https://yookassa.ru/ ЮKassa — сервис для приёма платежей в интернете: Подходит для Самозанятых, ИП и Юр.лиц Больше 10 способов оплаты Комиссия за приём платежей — от 0,4% Сервис массовых выплат Эквайринг для самозанятых Кредитование покупателей Автоплатежи Холдирование Поддержка всегда рядом — 24/7 Подключите ЮKassa — начните с регистрации. Как подключить онлайн прием платежей? Будем учитывать, что вы уже прошли регистрацию на Самботе и заключили договор с Юкассой. Теперь разберёмся, как подключить приём оплат в вашем Телеграм чат-боте. Шаг 1 В личном кабинете Самбота перейдите в раздел «Приём платежей». Нажмите кнопку «+ Добавить способ приёма платежей». Шаг 2 Укажите произвольный заголовок для данной интеграции, к примеру: «Оплаты через Юкассу». Из списка платёжных систем выберите Юkassa. Шаг 3 Перейдите в раздел API Юkassa и скопируйте там Идентификатор магазина. Вставьте его в соответствующее поле настроек интеграции на Самботе. Аналогично укажите Секретный ключ. Если вы хотите в автоматическом режиме обрабатывать платежи, т.е. запускать работу бота сразу после успешной оплаты, выберите в Обработку платежей «Автоматически». В ручном режиме бот не будет знать о платежах. Для Автоматического режима обработки платежей вам понадобится указать ссылку https://sambot.ru/payments/notifications для уведомлений на стороне Юкассы. Шаг 4 Чтобы работать в соответствии с 54 Федеральным законом — для отправки чеков покупателям и в налоговую установите галку «Чек». Вам нужно настроить бота, чтобы перед оплатой пользователь предоставил данные: электронную почту и/или телефон. Сохраните эти данные в Параметры, а в настройках блока «Чек» - укажите их подстановки. Таким образом при оплате в систему Юкассы отправятся необходимые данные плательщика. Выберите свою систему налогообложения. Уточните Признак предмета рассчета. Шаг 5 В случае, если вы хотите использовать возможность Автоплатежей (рекуррентных платежей) через Юкассу - укажите чек-бокс «Автоплатежи». Оплаты будут автоматически производиться с карты плательщика, на условиях, на которые он согласился. «Без промежуточной страницы оплаты» - означает, что при нажатии кнопки «Оплаты» в чат боте, плательщик сразу попадет на платёжную страницу Юkassa, минуя промежуточную страницу Самбота, которая запрашивает дополнитиельное подтверждение. Видео-инструкция по подключению Юкассы к Телеграм ботам Успешного подключения Юкассы! Техподдержка Юkassa Чат заБОТы Самбота --- ## Приём платежей через Т-Банк (Тинькофф) URL: https://sambot.ru/guide_priem-platezhey-cherez-t-bank_71 Инструкция по подключению магазина Т-Банк к Sambot: эквайринг, чеки, тестовые платежи. Автоматический приём онлайн-оплаты в чат-боте. Подробная инструкция по созданию магазина на стороне Т-банк по ссылке Шаг 1: Создание магазина в Т-Банке На стороне Т-банк создаем Магазин в разделе «Интернет-эквайринг». Шаг 2: Создание реакции для запроса email в Sambot На стороне Sambot создаём реакцию для запроса e-mail у пользователя и сохраняем его в параметр, чтобы потом подставлять этот параметр в чек. Заходим в раздел «Реакции» и добавляем новую реакцию. В пункте 4.1 по кнопке «+текст» добавляем сообщение с просьбой отправить адрес электронной почты боту. Тут же в окне добавления текста спускаемся вниз и в поле «Ожидаемый ответ» выбираем «текст». После выбора ниже появится поле «Проверить текст ответа:». Его можно оставить пустым или выбрать «Email» - в этом случае система автоматически проверит ответ пользователя, и если будет прислан ответ, не являющийся электронной почтой, то бот пришлёт сообщение пользователю об этом. Далее в самом низу нажимаем на строку «Сохранить ответ при завершении реакции». В открывшемся окне отмечаем «Параметр пользователя». Затем указываем название параметра, в который хотим сохранить почту пользователя и выбираем тип хранения. Всё сохраняем (настройки параметра, добавленное сообщение). И сохраняем реакцию. ВАЖНО! Данная реакция приведена как пример запроса и сохранения почты пользователя. После создания реакции вам необходимо включить её в логику вашего бота, то есть задать настройки как или откуда эта реакция будет запускаться, и какая реакция должна запуститься после того, как пользователь пришлёт свою почту. Шаг 3: Настройка приема платежей в Sambot В Sambot заходим в раздел Приём платежей. Указываем название и добавляем способ приёма платежа, выбираем – Т-банк (Тинькофф). В полях - Идентификатор терминала и Пароль терминала вводим ТЕСТОВЫЕ данные из магазина в Т-банк Включаем пункт «Чек» и в поле «Электронная почта покупателя» указываем параметр, в который сохранили почту пользователя. Для этого открываем подстановки, нажав на иконку человечка в верхнем правом углу над полем ввода. Находим наш параметр в списке и нажимаем на него – параметр автоматически подставится в поле. Для чека обязательным является указание почты, телефон можно не указывать! Также указываем: Система налогообложения, Ставка НДС, Признак предмета расчета – эти данные вносятся в соответствии с данными магазина. Следующий пункт «Обработка платежей»: «Вручную» – означает, что каждый выставленный счёт вам нужно будет подтверждать вручную в подразделе «Счета» «Автоматически» – означает, что бот будет получать уведомление о платеже от Т-банка и после его получения автоматически запустит реакцию, указанную в кнопке оплаты. Обратите внимание на пункт «Без промежуточной страницы оплаты»: Пункт отмечен (включен) – в этом случае бот присылает дополнительное сообщение пользователю с кнопками «Перейти к оплате» и «Проверить оплату». Данное сообщение удаляется только при получении оплаты и если оплата была совершена в течение 48 часов после выставления счёта. Пункт не отмечен (выключен) – в этом случае бот не присылает дополнительное сообщение. При нажатии на кнопку оплаты пользователю будет предложено перейти на промежуточную страницу оплаты Sambot. Если пользователь не оплатил сразу продукт по этой кнопке, и решил оплатить позднее, а у вас уже изменилась стоимость этого продукта, то пользователь оплатит его по той цене, которая была указана в счёте при его выставлении! Вы можете настроить удаление сообщения через указаное время, но не более 48 часов, чтобы избежать таких случаев Если всё настроено верно, сохраните интеграцию. Шаг 4: Создание реакции с кнопкой оплаты и тестовые платежи Далее необходимо создать реакцию с кнопкой оплаты и после выполнить тестовые платежи, чтобы Т-банк увидел действия со стороны Sambot. Создаем реакцию с платёжной кнопкой на любую сумму, не забываем запросить данные email перед этим. В реакции по кнопке «+текст» добавляем сообщение и добавляем к нему кнопку В настройках кнопки выбираем тип «Приём платежа». Заполняем все поля и указываем действие при успешной оплате, выбрав реакцию, которая будет запущена. Также здесь вы можете добавить метку и параметры, если это необходимо. Они будут добавлены пользователю при успешной оплате. Всё сохраняем. Вы можете связать реакцию с запросом почты и реакцию с кнопкой оплаты через пункт 4.16 в реакции запроса почты. Таким образом сразу после ответа пользователя, ему будет отправлено сообщение с просьбой оплатить продукт. Теперь можно совершить тестовые платежи. Следуйте условиям, которые имеются на стороне Т-банк. Шаг 5: Проведение тестовых платежей и активация магазина Перейдите в диалог с ботом в телеграм и запустите реакцию запроса почты. Дойдите до кнопки оплаты. Совершите оплату. При оплате вводим данные карты из ТЕСТОВЫХ данных на стороне Т-банк. Пройдите все тесты от Т-банк. Обратите внимание, что для каждого теста свой номер карты! На последнем тесте необходимо выполнить отмену платежа. Для этого на стороне Т-банк совершаем отмену. После прохождения всех тестовых платежей необходимо отследить, чтобы статус интернет-магазина был «Проверяем», при необходимости обращайтесь в техническую поддержку Т-банк, чтобы они проверили интернет-магазин и изменили статус. После проверки, магазину присвоят рабочий статус "Принимает платежи". После этого замените в настройках интеграции тестовый терминал и пароль на данные рабочего терминала. --- ## Как накопить данные в параметре через реакцию: бот-копилка для каталога, FAQ, заявок URL: https://sambot.ru/guide_nakopit-dannye-v-parametre_107 Паттерн «бот-копилка»: пишете ключевое слово, бот спрашивает фото или текст, сохраняет в параметр. Список растёт без админки. Применим к каталогу, FAQ, контактам, курсам. Бывает удобно собирать данные «голосом», прямо в чате с ботом, без открытия админки. Мастер сфотографировал новый товар на телефон → отправил боту с подписью → бот сохранил его в каталог. Менеджер написал боту вопрос и ответ → бот добавил их в базу FAQ. Это называется «накопительный параметр»: одна реакция, которая принимает сообщение и кладёт его очередной строкой в общий список. 📌 Зачем Каталог товаров или услуг — фото с ценой и названием. FAQ — список «вопрос/ответ» для бота-консультанта. Контакты или адреса филиалов — текст и геолокация. Расписание занятий или мероприятий — даты и описание. Чек-лист задач или достижений — что угодно, что хочется накопить. Везде идея одна: сказал волшебное слово — отправил сообщение — оно осело в общем списке, доступном в других реакциях через подстановку. 🎯 Кому подойдёт Мастерам, преподавателям, организаторам мероприятий, маленьким студиям — тем, кто хочет вести небольшую базу в боте, без отдельной CMS и без захода в браузер. Для больших объёмов (сотни записей с фильтрами и кабинетом покупателя) нужны специализированные решения. 🛠 Как настроить Если бота ещё нет — пройдите быстрый старт для Telegram или ВКонтакте. Дальше всего два шага: создать параметр и собрать одну реакцию. 1. Параметр В разделе «Параметры» создайте параметр с понятным именем (например, catalog, faq, contacts). Режим хранения — «Хранить все значения». В этом режиме каждое новое значение добавляется отдельной строкой, прежние не затираются — ровно то, что нужно для накопления. 2. Реакция «Принять данные» В блоке «1. Срабатывает на» включите «1.1.1. Содержит ключевые слова» и добавьте короткое слово-команду — например, товар, добавить, вопрос. Это «вход в админ-режим» бота. В блоке «2. В чатах» поставьте «В личных сообщениях». Чтобы случайные пользователи в группе не могли добавлять данные, можно дополнительно ограничить разрешённый чат конкретным id (вашим личным с ботом). В блоке «4. Действия» в уже включённом «4.1. Отправить сообщение» добавьте одно сообщение типа «Текст» с инструкцией — что отправить дальше. Например: «Отправьте фото товара с подписью в формате «Название \| Цена».» либо «Напишите вопрос и ответ через тире.» В этом же сообщении нажмите «Сохранить ответ». Откроется окно с настройками: «Ожидаемый ответ»: выберите тип того, что вы пришлёте боту. Фото — для каталога с картинками. Текст — для FAQ, контактов, расписания. Можно выбрать оба. «Параметр пользователя»: ваш накопительный параметр (catalog). «Режим»: «Хранить все значения» — значения копятся. «Глобальный»: включить. Это важная галка: без неё параметр будет приватным для каждого пользователя; с ней — один общий список, видимый из любой реакции. Готово. Реакция работает: вы пишете боту «товар», он отвечает «Отправьте фото…», вы шлёте фото с подписью — бот сохраняет его в catalog очередной строкой. 🔍 Что получилось Каждый раз, когда вы добавляете элемент, в базе бота появляется новая запись параметра. Если открыть админку и посмотреть значения параметра catalog, вы увидите все сохранённые фото с их подписями. Дальше эти данные можно использовать в других реакциях через подстановки и формулы: {global:catalog:1} — первое значение списка. {global:catalog:1-} — весь список (массив). В формулах: {formula:JP({global:catalog:1};"$.caption")} — подпись первого элемента. {formula:COUNTA({global:catalog:1-};"")}-1 — сколько элементов в списке. {formula:FIELD({user:input};" \| ";0)} — первое поле строки с разделителем. 💡 Полезные расширения Реакция-просмотр — команда «список», по которой бот выводит текущее содержимое параметра в сообщение. Реакция-очистка — команда «очистить», в настройке параметров реакции используется режим «Удалить все значения». Полезно при отладке или для «начать заново». Формат записи с разделителем — если в подписи писать «Название \| Цена», потом можно вытащить любое поле формулой FIELD(текст; " \| "; 0). Удобно для каталога с вычислимыми суммами. Безопасность — ограничьте реакцию вашим личным чатом, чтобы посторонние не могли «загрязнить» список. Это особенно важно, если бот доступен публично. 📦 Готовый кейс на этой технике Главное применение этого паттерна, ради которого мы его описали — Telegram-бот-магазин с корзиной. Каталог собирается этой техникой, а витрина с листанием товаров, корзиной и оплатой — уже отдельная статья. Если нужна помощь SamBot — это конструктор, всё описанное собирается мышкой в админке без программиста. Если разбираться некогда — напишите нам, поможем настроить под вашу нишу или предложим готовый шаблон. --- ## Быстрый старт MAX: ваш первый бот в мессенджере MAX за 10 минут URL: https://sambot.ru/guide_bystryy-start-max_111 Пошаговая инструкция: регистрация, создание бота через @MasterBot, подключение в SamBot, первая реакция и проверка в MAX. Без навыков программирования. Эта инструкция проведёт вас от регистрации в SamBot до первого работающего бота, отвечающего на сообщения в MAX. Времени уйдёт около 10 минут. Никаких навыков программирования не нужно — настройка через визуальный интерфейс. Что вам понадобится аккаунт в мессенджере MAX (для общения с @MasterBot и тестирования); email — для регистрации в SamBot; браузер. Шаг 1. Регистрация в SamBot Откройте sambot.ru и нажмите «Регистрация». Введите email и пароль, подтвердите регистрацию по ссылке из письма. Шаг 2. Создаём бота в MAX Боты в MAX создаются и управляются через официального бота @MasterBot: В MAX откройте чат с @MasterBot. Отправьте команду /newbot и следуйте его подсказкам. Введите имя бота — то, что увидят пользователи в диалоге. По завершении @MasterBot выдаст токен — скопируйте его. Это секретный ключ доступа к боту. Совет: храните токен в надёжном месте — кто им владеет, тот управляет ботом. Шаг 3. Подключаем бот в SamBot В личном кабинете SamBot нажмите «Добавить бота» и выберите MAX. Вставьте токен из шага 2 и нажмите «Сохранить». После создания бота нужен тариф для запуска. Если вы используете SamBot впервые — примените промокод (даётся однократно) или оплатите подходящий тариф. Перейдите в раздел «Оплата тарифа» и нажмите ссылку «У меня есть промокод». После сохранения откроется страница «Статистика» бота. В левом меню сверху — ссылка «Оплата тарифа», ниже идут «Статистика», «Настройки», «Чаты», «Пользователи», «Реакции» и другие разделы. Шаг 4. Создаём первую реакцию Реакция — это правило вида «при определённом триггере выполнить определённые действия». Форма создания реакции разделена на четыре блока: 1. Срабатывает на, 2. В чатах, 3. Условия, 4. Действия. Создадим простую: бот будет отвечать на слово «привет». В боковом меню откройте раздел «Реакции» и нажмите «Добавить реакцию». В поле «Заголовок» впишите название реакции, например Приветствие — это единственное обязательное поле. В блоке «1. Срабатывает на» разверните «1.1. Текстовое сообщение», включите галочку «1.1.1. Содержит ключевые слова» и добавьте ключевое слово привет. В блоке «4. Действия» галочка «4.1. Отправить сообщение» уже включена по умолчанию. Нажмите кнопку «+ Текст» — откроется форма добавления текстового сообщения. Впишите ответ: Привет! Я твой первый бот в MAX на SamBot. Сохраните сообщение. Нажмите «Сохранить». Шаг 5. Проверяем в MAX Откройте бота в MAX и напишите «привет». Бот ответит вашим сообщением. ✓ Если ничего не пришло: Проверьте, что бот включён в SamBot. Убедитесь, что в реакции включена галочка «1.1.1. Содержит ключевые слова» и что слово в поле «Ключевые слова» совпадает с тем, что вы отправляете боту. Проверьте раздел «Статистика» — там видно, какие сообщения пришли и сработала ли реакция. Что дальше Когда первый бот заработал, переходите к более интересным сценариям: Реакции — все типы триггеров (текст, кнопка, время, событие) и действий. Кнопки и опросы — добавьте интерактива в ответы. Метки — сегментация подписчиков для рассылок и условий. Формулы и параметры пользователя — динамический контент: имя пользователя, дата, расчёты. Приём платежей — подключите платёжного провайдера (ЮKassa, Robokassa, Prodamus, Т-Банк) и продавайте товары и услуги. --- ## Мастер-классы по Telegram-ботам URL: https://sambot.ru/guide_master-klassy-telegram_119 Видеоуроки по созданию ботов на SamBot: магазин, рассылка, воронка продаж, онлайн-школа, приём платежей, поддержка и другие сценарии. Смотрите и собирайте бота по шагам. Подборка видеоуроков по созданию ботов на SamBot — от первого запуска до готовых сценариев: магазин, рассылка, воронка продаж, онлайн-школа, приём платежей и другие. Начните с обзорного видео, затем выбирайте мастер-класс под свою задачу. Начало ♨️ ~ 23 мин. Бизнес визитка ~ 19 мин. Магазин ~ 25 мин. Рассылка ~ 24 мин. Сегментация ~ 20 мин. Воронка продаж ♨️ ~ 37 мин. Онлайн-школа ♨️ ~ 42 мин. Наставник ~ 16 мин. Приём платежей ~ 18 мин. Служба поддержки ~ 16 мин. Доступ ~ 27 мин. Игра ♨️ ~ 15 мин. Тест ~ 21 мин. Информер ~ 21 мин. Справочник ~ 18 мин. Калькулятор ♨️ ~ 14 мин. Все мастер-классы --- ## Реакции в SamBot — основа автоматизации бота URL: https://sambot.ru/kb_chto-takoe-reakciya-v-sambot_103 Реакция в SamBot — правило «если случилось X, то сделать Y». Из реакций собирается весь бот: ответы на ключевые слова, опросники, передача менеджеру. Реакция — центральная единица SamBot. Это правило в стиле «если случилось X, то сделать Y»: «если клиент написал „цена" — отправить ему прайс», «если в группу зашёл новый участник — поприветствовать его», «если поступила оплата — выдать доступ и уведомить менеджера». Из реакций собирается весь бот: его поведение в любом сценарии — это сумма реакций, которые срабатывают по правилам. Каждая реакция определяется четырьмя вопросами: на что срабатывает (триггер), в каких чатах работает, при каких условиях срабатывает и что делает. На странице создания реакции эти четыре блока расположены сверху вниз. Чтобы освоиться — проще всего пройтись по двум практическим примерам. Пример 1: FAQ-реакция Самая базовая реакция: клиент написал ключевое слово — бот ответил готовым текстом. Идеально для типовых вопросов про цену, адрес, часы работы. На что срабатывает: текстовое сообщение содержит ключевое слово «цена». В каких чатах: только в приватном чате с ботом. Что делает: отправляет одно сообщение — «Базовая услуга — 1500 ₽, выезд мастера — 500 ₽». Что происходит в диалоге: Клиент: «Какая цена услуги?» Бот: «Базовая услуга — 1500 ₽, выезд мастера — 500 ₽». Несколько таких реакций — и у вас FAQ-бот, разгружающий менеджеров от однотипных вопросов. На ключевые слова можно настроить разные ответы: «адрес» — карту, «доставка» — условия, «расписание» — часы работы. Важная деталь: одна реакция может реагировать не на одно слово, а на несколько вариантов — «цена», «стоимость», «сколько стоит». В настройках срабатывания есть режимы «содержит», «содержит как отдельное слово», «начинается с», «заканчивается на» и «равно». Пример 2: Запрос обратного звонка Более продвинутый сценарий: клиент пишет «перезвоните» — бот спрашивает у него номер телефона, сохраняет ответ в карточку клиента и отправляет уведомление менеджеру в служебный чат. Главная техническая особенность: одно из сообщений реакции — «вопрос», бот ждёт на него ответ. Это означает, что реакция приостанавливается ровно в тот момент, когда отправлен этот вопрос. Все следующие действия (второе сообщение, уведомление менеджеру) выполнятся только после того, как клиент пришлёт ответ. Настраиваем одну реакцию с двумя сообщениями и уведомлением менеджеру: На что срабатывает: текст содержит «перезвоните» (можно добавить «позвоните», «обратный звонок» и т. п.). В каких чатах: только в приватном чате с ботом. Что делает: Сообщение 1 — «Напишите номер телефона, на который вам перезвонить». Включена галочка «Ожидаемый ответ — Текст», и ответ клиента сохраняется в параметр callback_phone. Сообщение 2 — «Спасибо! Мы вам перезвоним». Раздел «Куда отправлять» (4.13) — чат менеджеров. Включены галочки «От кого» (имя клиента) и «Реакция бота» (ссылка на реакцию). В диалоге это выглядит так: Клиент: «Перезвоните пожалуйста». Бот: «Напишите номер телефона, на который вам перезвонить». [Бот ждёт ответ. Ничего больше не делает.] Клиент: «8-900-123-45-67». Бот: «Спасибо! Мы вам перезвоним». [В чат менеджеров уходит уведомление: «FirstName1 LastName1 → Запрос обратного звонка». Менеджер открывает карточку клиента и видит сохранённый callback_phone.] Что показал этот пример: «Ожидаемый ответ» — это барьер. Реакция приостанавливается на сообщении-вопросе, и все следующие действия (второе сообщение, уведомление менеджеру) ждут ответа клиента. Это позволяет собирать анкетные сценарии в одной реакции: задать вопрос — подождать ответ — задать следующий вопрос — подождать — и так далее. Сохранение в параметр — механика «состояния» клиента в SamBot. Параметр клиента (callback_phone, cart_total, last_order_id и т. п.) виден в карточке клиента, доступен в других реакциях через подстановку {user:NAME}, и может стать триггером ещё одной реакции. Уведомление в служебный чат — стандартный паттерн «передать менеджеру». Реакция отправляет в управляемый чат имя клиента и ссылку на реакцию. Из этих кубиков собирается всё За этими двумя примерами скрыта вся палитра возможностей платформы: Триггеры — не только текст с ключевыми словами, но и медиа-сообщения, системные события (новый участник в группе, оплата прошла), команды (/start), нажатия кнопок, опросы, время — периодически, по расписанию. Условия — реакция может срабатывать только при определённой метке у клиента, при определённом значении параметра, в рабочие часы, на каждое N-е сообщение и т. д. Это позволяет точно регулировать «когда» реакция запускается. Действия — отправить сообщение, сохранить параметр, поставить/снять метку, передать менеджеру, выставить счёт на оплату, запустить другую реакцию (цепочка), вызвать ваш API через web-request, обратиться к ИИ. В одной реакции можно использовать несколько действий — они выполнятся по очереди сверху вниз. Сложные сценарии (запись на услугу, многошаговый опросник, продажа курса с автоматической выдачей материалов) собираются из нескольких связанных реакций — одна реакция запускает другую, передавая контекст через параметры клиента. Где это в UI Реакции бота находятся в разделе «Реакции» в его меню. Кнопка «Создать реакцию» открывает редактор, где те самые четыре блока: «Срабатывает на», «В чатах», «Условия», «Действия» — расположены сверху вниз. --- ## Как создать ИИ-агента на SamBot URL: https://sambot.ru/kb_kak-sozdat-ii-agenta-na-sambot_101 Как сделать ИИ-чат на SamBot, который не только отвечает, но и выполняет действия — обновляет параметры клиента, ставит метки, обращается к вашему API. Представьте: клиент пишет вашему боту — «Расскажите про мой заказ номер 12345». Обычный ИИ-чат на это не ответит — у модели нет доступа ни к вашим заказам, ни к данным клиента. Она знает только то, что было в её обучающей выборке, и то, что вы написали в промпте. Теперь — та же ситуация, но у бота есть функция get_order_status. Что происходит: Клиент пишет: «Расскажите про мой заказ номер 12345». ИИ понимает, что нужно вызвать get_order_status с аргументом order_id=12345. SamBot отправляет запрос на ваш сервер: GET https://your-shop.ru/api/orders/12345. Сервер возвращает JSON: {"status":"готов","amount":1500,"ready_at":"12 мая"}. ИИ получает данные и отвечает клиенту: «Заказ №12345 на 1 500 ₽ готов, можно забрать после 12 мая». Бот сам решил: какой инструмент позвать, какие данные подставить и как сформулировать ответ. Это превращает ИИ-чат в ИИ-агента: он не только говорит — но и делает. В SamBot два типа функций: Внешняя — как в примере: HTTP-запрос на ваш сервер, ответ возвращается ИИ. Внутренняя — действия прямо в SamBot, без своего сервера: записать параметр клиента, запустить реакцию для уведомления менеджеру, выдать заранее заготовленный ответ. Дальше — по шагам, как настроить оба типа. Функции в SamBot работают с двумя интеграциями OpenAI: «Ответы» (Responses API) и «Ассистенты» (Assistants API). Для других интеграций ИИ функции пока недоступны — ИИ-сообщение продолжит работать как раньше, без действий. Важно. OpenAI объявила о прекращении поддержки Assistants API: после августа 2026 года ассистенты перестанут работать. Для новых ботов выбирайте интеграцию «Ответы» — это целевое место OpenAI для function calling. Если у вас уже настроены ассистенты — перенесите их на «Ответы» до истечения срока. Что такое функция Функция — это бизнес-действие, которое вы даёте в распоряжение ИИ. У каждой есть название (короткое имя для ИИ), описание словами — что она делает (по описанию ИИ понимает, когда её вызывать), и опционально — список аргументов, которые ИИ может передать в функцию. В SamBot два типа функций: Внешняя — ИИ обращается к вашему сайту/API. Например, узнать остаток товара по запросу к вашей CRM. Возвращает данные, которые ИИ использует в ответе. Внутренняя — ИИ действует прямо в SamBot, без вашего сервера. Имеет до трёх независимых эффектов — любая комбинация: Сохранить параметры пользователя — записать значения в параметры клиента сразу, ещё до ответа ИИ. Запустить реакцию в фоне — дополнительные действия (уведомление менеджеру или в другой чат, цепная реакция, метки). ИИ не ждёт её завершения. Ответ ИИ — заранее заготовленный текст с подстановками, который уйдёт обратно в модель. Две схемы дополняют друг друга: внешняя — чтобы получить актуальные данные из ваших систем, внутренняя — чтобы дать ИИ управлять состоянием клиента в SamBot без своего сервера. Аргументы функции ИИ может передать в функцию аргументы — если вы их объявите. Каждый аргумент: имя, тип (строка / число / целое / булево), описание словами и флаг обязательный. Описание подсказывает ИИ, какое значение туда подставить. Где использовать значения аргументов: В URL внешней функции: https://api.example.com/orders/{arg:order_id} — значения подставляются в адрес автоматически. В значении сохраняемого параметра пользователя: например, в параметр cart_total можно записать {arg:total}. В тексте ответа ИИ: «Товар {arg:item_name} добавлен в корзину». Что происходит при срабатывании Поток одинаков, мессенджер не имеет значения: Клиент пишет произвольное сообщение. SamBot отправляет сообщение ИИ и вместе с ним передаёт список ваших функций — названия, описания и аргументы. ИИ решает: ответить просто текстом или сначала вызвать функцию. Если решает вызвать — сообщает SamBot, какую именно и с какими аргументами. Дальше зависит от типа функции: Если внешняя — SamBot подставляет аргументы в URL, отправляет HTTP-запрос и получает ответ. Если внутренняя — SamBot сразу записывает заявленные параметры пользователя (значения с подстановкой {arg:NAME}), запускает реакцию в фоне и формирует текст ответа из шаблона. Полученный результат уходит обратно в ИИ — и тот формулирует финальный ответ клиенту, учитывая результат вызова. Ключевой момент: блок «Сохранить параметры пользователя» применяется синхронно — значения уже в БД, когда SamBot формирует текст ответа ИИ. Поэтому в ответе можно безопасно использовать {user:NAME} — ИИ увидит свежее значение. Реакция, наоборот, запускается в фоне — её эффекты к моменту ответа ИИ ещё не отработают. Поэтому если параметр должен быть применён до ответа — записывайте его через «Сохранить параметры», а не через реакцию. Полезные паттерны 1. Параметр + ответ Внутренняя функция сохраняет параметр пользователя и возвращает ИИ свежее значение в ответе. Классический пример — взять у клиента телефон для обратной связи: Название: save_callback_phone Описание: «Сохраняет номер телефона клиента, на который ему перезвонить» Аргументы: phone (строка, обязательный) — номер в формате, который написал клиент Сохранить параметры: callback_phone — режим «Хранить последнее значение», значение {arg:phone} Ответ ИИ: «Записал номер {user:callback_phone}, менеджер свяжется в течение часа» Клиент: «Перезвоните мне на 8-900-123-45-67». ИИ: «Записал номер 8-900-123-45-67, менеджер свяжется в течение часа». Параметр callback_phone сохранён в карточке клиента — дальше он виден на странице пользователей и доступен в других реакциях. 2. Действие в фоне Реакция запускается в фоне для дополнительных действий — уведомление менеджеру или в другой чат, цепная реакция. ИИ ответ ИИ — подтверждение клиенту: Название: escalate_to_manager Описание: «Передаёт диалог менеджеру — когда клиент просит человека или жалуется» Вызвать реакцию: «Уведомить менеджера» (отправляет в управляемый чат) Ответ ИИ: «Передал ваш вопрос менеджеру — он скоро подключится» Клиент: «Хочу поговорить с живым человеком». ИИ: «Передал ваш вопрос менеджеру — он скоро подключится. Пока могу ответить на другие вопросы». Параллельно менеджер получает уведомление в чате. 3. Справочная функция Без действий, только заготовленный текст для ИИ. Полезно для FAQ-данных, которые меняются редко: Название: get_company_info Описание: «Возвращает контакты и адрес компании» Ответ ИИ: «Адрес: Казань, Баумана 12. Телефон: 8-800-000-00-00. Часы работы: пн-пт 9–19» Клиент: «А где вы находитесь и до скольки работаете?». ИИ получает данные и отвечает в натуральной формулировке — на языке клиента, с учётом контекста разговора. 4. Внешняя функция с аргументами ИИ передаёт значения в ваш сервис, тот возвращает данные: Название: find_order Описание: «Находит заказ клиента по номеру» Аргументы: order_id (строка, обязательный) URL: https://crm.example.com/api/orders/{arg:order_id} Клиент: «Где мой заказ 12345?». ИИ обращается к https://crm.example.com/api/orders/12345, получает статус и формулирует ответ. Когда какую делать Нужны данные из вашей системы (CRM, ERP, склад, своё API) — делайте внешнюю. Нужно обновить состояние клиента в SamBot или запустить готовый сценарий (реакцию) — делайте внутреннюю. Часто полезно несколько функций сразу — ИИ сам выберет нужную или вызовет несколько последовательно. Сборка по шагам В разделе «Интеграции» создайте интеграцию OpenAI — Ответы (или OpenAI — Ассистенты, если ассистент уже настроен; см. предупреждение о прекращении поддержки выше): нужны API-ключ, для «Ассистентов» — ещё ID ассистента. В нужной реакции включите действие «4.1. Отправить сообщение» и добавьте сообщение типа «+ИИ», выберите эту интеграцию. В настройках ИИ-сообщения включите галку «Обработать функции». Нажмите «Добавить обработку функции» — откроется окно. Заполните Название (например, add_to_cart) и Описание словами. Если функции нужны входные данные от ИИ — нажмите «Добавить аргумент»: имя, тип, описание (для ИИ), флаг «Обязательный». Подставлять значения в другие поля можно будет через {arg:NAME} — из списка подстановок (группа «Аргументы функции» появляется наверху). Выберите Тип — «Внешняя» или «Внутренняя». Для «Внешней» укажите URL веб-сервиса (можно с {arg:NAME}). Для «Внутренней» включите нужные галки — любую комбинацию: «Сохранить параметры пользователя» — список параметров с значениями (можно с {arg:NAME}). Применяются сразу. «Вызвать реакцию» — реакция из списка. Запустится в фоне, ИИ её завершения не ждёт. «Ответить ИИ» — текст с подстановками ({arg:NAME}, {user:NAME} и т. д.). Сохраните. Можно добавить несколько функций — ИИ сам выберет нужную в момент диалога. Главное правило: описание функции — это инструкция для ИИ, когда её вызывать. Чем понятнее описание, тем чаще и точнее ИИ использует функцию. Если ИИ не вызывает функцию, хотя по контексту должен — сделайте описание подробнее. Что хорошо работает как внутренняя функция Любые быстрые действия, после которых вы либо обновили состояние клиента, либо запустили готовый сценарий: Обновить параметр клиента (через блок «Сохранить параметры» — значение видно ИИ сразу). Поставить или снять метку (через реакцию — она запустится в фоне). Запустить цепочку, которая отправит уведомление в админский чат. Передать диалог живому менеджеру через цепную реакцию. Не стоит использовать как функцию реакции, в которых клиент должен что-то ответить или нажать — опросы, календари, главное меню. Такие реакции выставляют ожидание ответа клиента, а ИИ в этот момент пытается формулировать свой ответ — получится конфликт. Для диалоговых сценариев лучше отдельная реакция, которую ИИ запускает для передачи диалога живому менеджеру или в готовый сценарий — а дальше всё работает обычным образом без участия ИИ. Примеры применения Поддержка — find_ticket (внешняя, в вашу систему тикетов), escalate_to_manager (внутренняя, передача в управляемый чат), mark_priority_client (внутренняя, метка приоритета). Запись на услуги — check_slot_available (внешняя, проверка свободных слотов), book_slot (внешняя, оформляет бронь), cancel_appointment (внешняя, отмена). Магазин — find_product (внешняя, поиск в каталоге), get_delivery_info (справочная функция со статичным текстом), subscribe_newsletter (внутренняя, метка для рассылок). Образование — get_homework (внешняя, по API школы), mark_lesson_completed (внутренняя, метка), request_certificate (внутренняя, заявка в админский чат). Один промпт «ты консультант магазина X, при просьбе оформить заказ вызывай create_order» заменяет десятки реакций по ключевым словам. Бот понимает синонимы, парафразы, сложные контексты, а не только заранее прописанные шаблоны. --- ## Как работать с пользователями бота — пошаговое руководство URL: https://sambot.ru/kb_razdel-polzovateli_47 Как сегментировать аудиторию бота, ставить метки и параметры, смотреть диалоги, импортировать и экспортировать базу — пошаговое руководство Sambot. В разделе «Пользователи» вы посмотрите диалог каждого пользователя с ботом, найдёте нужного по фильтрам, изучите его карточку и при необходимости поправите метки и параметры. Ниже — пошаговое руководство по всем возможностям раздела. Оглавление Общая информация Поиск и сегментация пользователей Карточка пользователя Работа с метками пользователя Работа с параметрами пользователя Запуск реакции и отправка сообщений Избранное Импорт пользователей Экспорт пользователей Настройка меток Настройка параметров Общая информация Раздел «Пользователи» состоит из нескольких подразделов: Избранное Импорт пользователей Экспорт пользователей Настройка меток Настройка параметров Раздел «Пользователи», изображение 1 В разделе «Пользователи» есть фильтр, который позволяет сортировать и осуществлять поиск пользователей по меткам, параметрам, ID, имени, фамилии, username, наличию диалога с ботом. Также отображается полный список пользователей, где вы видите общее количество пользователей в боте (№1), включая тех, кто отписался от бота, а также информацию по каждому пользователю: дату и время, когда пользователь запустил бота (№2) дату последнего действия (№3) диалог с ботом (№4) статус (№5) метки (№6) параметры (№7) знак «Избранное» (№8) Раздел «Пользователи», изображение 2 Поиск и сегментация пользователей Общая информация В разделе «Пользователи» можно отсортировать пользователей по различным параметрам или найти конкретного пользователя. Также можно определённой группе пользователей, которую вы сегментировали при помощи фильтров, присвоить метку либо удалить метку. На эти действия запросы не тратятся. Поля фильтра для поиска и сегментирования пользователей, изображение 3 Фильтровать или искать пользователей можно по: Наличию диалога с бизнес-аккаунтом (№1) ID (№2) Имени (№3) Фамилии (№4) Username (№5) Наличию или отсутствию приватного чата (№6) Блокировке пользователя Меткам (№8) Параметрам (№9) Для поиска можно заполнить как одно, так и несколько. Чтобы сегментировать пользователей по заданным параметрам поиска, надо нажать кнопку «Найти», которая расположена ниже, под полями фильтров. Кнопка «Найти», изображение 4 Фильтр по наличию приватного чата Если в поле «Приватный чат» задано значение «есть», то откроются дополнительные поля, в которых можно будет выбрать даты и время периода поиска. Задать даты можно через календарик, который открывается, если кликнуть на полях «От» и «До», либо написать самостоятельно в формате дд.мм.гггг. Выберем для примера период с 27 марта 2023 года по 31 декабря 2024 года и нажмём кнопку «Найти», которая расположена ниже, под полями фильтров. Поиск по наличию приватного чата за период, изображение 5 Будут показаны только те пользователи, которые начали диалог с ботом в заданный нами период и у которых в данный момент есть активный диалог с ботом (эти люди не заблокировали бота). Дату первого запуска бота каждого пользователя можно увидеть в крайнем правом столбце. Общее количество пользователей, которые соответствуют заданным условиям поиска, отображается вверху списка. Результаты поиска, изображение 6 Фильтр по меткам Чтобы начать сегментацию пользователей по меткам, нажмите на кнопку «Добавить фильтр по меткам». Откроется поле, в котором можно выбрать одну или несколько меток из списка созданных меток. Если вы хотите отфильтровать пользователей, у которых нет конкретной метки, то слева от метки поменяйте знак «+» на «-». После выбора метки нажмите кнопку «Сохранить». Выбор метки для сегментации пользователей, изображение 7 Далее нажмите кнопку «Найти», чтобы выполнить сортировку. Сегментация пользователей по наличию метки, изображение 8 Если выбрать несколько меток сразу, то отобразятся пользователи, у которых есть ИЛИ одна, ИЛИ другая метка. Выбор двух меток с условием ИЛИ, изображение 9 Результат поиска с условием одна метка ИЛИ другая: выборка 517 человек, изображение 10 Если нужно отсортировать только тех пользователей, у которых есть ОБЕ метки, то следует выбрать сначала одну метку, затем нажать на знак «+» рядом с выбранной меткой и в открывшемся окне добавить вторую метку. Добавление второй метки для условия одна И вторая метка, изображение 11 После добавления второй метки нажимаем кнопку «Найти». В этом случае бот будет искать пользователей, у которых есть И одна, И вторая метка. Результат поиска с условием одна метка И другая: выборка 44 человека, изображение 12 Фильтр по параметрам Чтобы начать сегментацию пользователей по параметрам, нажмите на кнопку «Добавить фильтр по параметрам». Откроется поле, в котором можно выбрать параметр из списка ранее созданных, указать тип параметра (глобальный или персональный), а также выбрать сравнение значений: = (равно) != (не равно) < (меньше) <= (меньше либо равно) > (больше) >= (больше либо равно) + (есть параметр) - (нет параметра) ~ (содержит) !~ (не содержит) [ (начинается на) ![ (не начинается на) ] (заканчивается на) !] (не заканчивается на) При выборе типа сравнения «равно», «не равно», «содержит», «не содержит», «заканчивается на», «не заканчивается на», «начинается на», «не начинается на» можно указать, сравниваются последнее значение параметра или все значения параметра. При выборе типа сравнения «меньше», «меньше либо равно», «больше» и «больше либо равно» можно выбрать тип данных, которые сравниваются: Целые числа Числа с плавающей точкой Текст Дата После выбора параметра и условий сравнения нажмите кнопку «Сохранить». Заданные условия поиска по параметру, изображение 13 Нажмите кнопку «Найти», чтобы найти пользователей с заданными значениями параметра. Поиск по пользователям с условием по параметрам, изображение 14 Как и в фильтре по меткам, в фильтре по параметрам можно комбинировать поиск по разным параметрам. Чтобы отсортировать пользователей, у которых есть ИЛИ один, ИЛИ другой параметр, выберите сначала один параметр, а потом нажмите на значок «+» рядом с ним и задайте условие по сравнению второго параметра. Затем нажмите кнопку «Найти», чтобы осуществить поиск по пользователям. Выбор условия: ИЛИ один параметр, ИЛИ другой, изображение 15 Отобразится список пользователей, у которых есть искомые значения ИЛИ одного, ИЛИ второго параметра. Результат сортировка с фильтром один параметр ИЛИ другой: выборка 31 человек, изображение 16 Чтобы отсортировать пользователей, у которых есть И один, И другой параметр, выберите сначала один параметр, а потом нажмите на значок «+» правее и задайте условие по сравнению второго параметра. Затем нажмите кнопку «Найти», чтобы осуществить поиск по пользователям. Выбор условия: один параметр И другой, изображение 17 Отобразится список пользователей, у которых есть искомые значения И одно, И второго параметра. Результат сортировки с фильтром один параметр И другой: пользователей, у которых есть оба параметра не найдено, изображение 18 Функционал «Применить метку» Этот функционал позволяет оперативно добавить или удалить какую-то метку выбранному сегменту пользователей без создания дополнительной реакции. При этом можно добавлять как уже созданные метки, так и назначить новую, которую ранее вы не задавали в боте. Сначала отфильтруйте нужных пользователей. Затем нажмите кнопку «Добавить или удалить метку». ВАЖНО: Если параметры фильтров не заданы, то метка добавится/удалится у всех пользователей бота, включая тех, у кого в данный момент нет диалога с пользователем. Применение действия к выбранному сегменту пользователей, изображение 19 Откроется окно, в котором можно выбрать метку из списка уже созданных, либо создать новую. Если хотите создать новую метку, то просто напишите её название в строке и нажмите кнопку «Сохранить». Задаём метку, которую хотим добавить выбранным пользователям, изображение 20 После добавления метки появится кнопка «Применить». Нажимаем её. Появилась кнопка «Применить», изображение 21 Метка, указанная в разделе «Применить действие» будет добавлена всем пользователям из выборки. Результат применения действия: добавилась метка, изображение 22 Карточка пользователя Чтобы войти в карточку пользователя, нажмите на знак диалога, напротив имени пользователя. Как открыть диалог с пользователем, изображение 23 В карточке пользователя вы можете посмотреть диалог с ботом, в котором видно все действия как бота, так и пользователя: время и последовательность запуска и завершения реакций время получения и удаления сообщений (если оно было настроено) нажатие кнопок простановку и удаление меток изменение параметров Диалог с ботом можно посмотреть только за последние три месяца. Более ранняя история действия недоступна, однако все метки и параметры, полученные ранее сохраняются. Справа от диалога видны данные пользователя: ID, метки и параметры. Работа с метками пользователя Общая информация Посмотреть или изменить метки пользователя можно из карточки пользователя или из раздела пользователи. Для этого нажмите на значок «Метки». Просмотр меток из карточки пользователя, изображение 24 Просмотр меток пользователя из раздела «Пользователи», изображение 25 И в том, и в другом случае, откроется список меток пользователя. Жёлтым выделены действующие метки, срок действия которых не истёк, либо вообще не был задан. Серым выделены временные метки: те, по которым был установлен срок действия и он уже истёк. Чтобы посмотреть, когда была выдана метка, изменить или удалить её, нажмите на название этой метки. Добавление метки Чтобы добавить новую метку, нажмите на кнопку «Добавить». Добавление новой метки, изображение 26 Откроется форма добавления метки. Вы можете выбрать из списка ранее заданных меток, либо создать новую. Форма добавления метки, изображение 27 В поле №1 укажите название метки. В поле №2 вы можете задать срок действия метки в днях, часах, минутах или секундах. Указывать срок действия метки необязательно. После того, как вы зададите название и срок метки (по необходимости), нажмите кнопку «Сохранить». Новая метка отобразится в списке меток у пользователя. Изменение срока действия метки Чтобы посмотреть и изменить срок действия метки, нажмите на название этой метки. Откроется информация, где видны дата и время выдачи метки, а также срок действия метки, если он был задан. Чтобы изменить срок, нажмите на три точки слева от даты получения метки. Изменение срока действия метки, изображение 28 Во всплывающем меню выберите «Редактировать». Откроется новое окошко, где можно будет изменять дату и время выдачи и окончания действия метки. Всплывающее меню при редактировании метки, изображение 29 ВАЖНО: Если у вас был задан только один срок действия метки или он не задан вовсе (при просмотре информации о метке отображается одна строка) и вы выберете не «Редактировать», а «Удалить метку», то удалится не срок действия метки, а сама метка. Редактирование срока действия метки, изображение 30 При нажатии на дату откроется календарь, в котором можно выбрать новую дату. Время также можно редактировать: стереть старое и написать новое в формате чч:мм:сс. Когда закончите редактировать срок действия метки, нажмите кнопку «Сохранить». Изменение даты действия метки, изображение 31 Отобразится метка с изменёнными данными. Чтобы выйти в общее меню, нажмите кнопку «Отменить» или крестик в правом верхнем углу. Метка с изменёнными данными, изображение 32 Удаление метки Если вы хотите удалить метку, то нажмите на нужную метку и выберите значок корзины. Удаление метки, изображение 33 Откроется окошко, в котором надо будет подтвердить удаление метки. Нажмите «Удалить». Подтверждение удаления метки, изображение 34 Метка удалится из списка меток пользователя. Работа с параметрами пользователя Общая информация Посмотреть или изменить параметры пользователя можно из карточки пользователя или из раздела пользователи. Для этого нажмите на значок «Параметры». Просмотр параметров из карточки пользователя, изображение 35 Просмотр параметров из раздела «Пользователи», изображение 36 И в том, и в другом случае, откроется список параметров пользователя. Здесь отражены как персональные параметры пользователя (№1), так и глобальные параметры (№2). Глобальные параметры имеют одинаковое значение для всех пользователей бота и их можно просмотреть или изменить из карточки любого пользователя. Список параметров пользователя, изображение 37 Добавление параметра Чтобы добавить новый параметр, нажмите на кнопку «Добавить». Добавление нового параметра, изображение 38 Откроется форма добавления параметра. Вы можете выбрать из списка ранее заданных параметров, либо создать новый. Форма добавления параметра, изображение 39 В поле №1 вы можете выбрать, какой параметр создаёте: параметр пользователя или глобальный. Если вы создаёте глобальный параметр, он создастся у всех пользователей бота. В поле №2 укажите название параметра. В поле №3 укажите тип параметра: Хранить первое значение – в параметре будет храниться только то значение, которое вы сейчас зададите. Вы не сможете в дальнейшем его перезаписывать. Хранить все значения – этот тип параметра похож на массив. У параметра есть несколько ячеек, каждая хранит одно значение. Максимум параметр может хранить 1000 значений. Хранить последнее значение – параметр может хранить только одно значение – последнее, которое было в него записано. То есть впоследствии можно будет заменить значение, которое вы в него запишете. В поле №4 укажите тип значения параметра: Текст – любое текстовое значение, в том числе числовое Фото – изображения в формате jpeg, png и другие Видео – видеофайл в формате mp4, mov и другие Видео-заметка – видео-заметка, записанная в телеграм («кружочки») Аудио – аудиофайл в формате mp3, ogg и другие Документ – файл в формате docx, pdf и другие Голосовое – аудиосообщение, записанное в телеграм Местоположение – геолокация Контакт – телефон пользователя Dice – эмодзи 🎳, 🎰 и другие В поле №5 укажите значение параметра. Чекбокс №6 нужно отметить, если вы в параметре указали ID чата для запуска реакции в этом чате. Чекбокс №7 нужно отметить, если вы указали в параметре дату и время и хотите использовать это значение для запуска реакции по времени из п.1.6. После того, как вы заполните все нужные поля, нажмите кнопку «Сохранить». Новый параметр отобразится в списке параметров у пользователя. Изменение параметра Чтобы изменить значение параметра, откройте параметры пользователя, нажмите на три точки, напротив названия того параметра, который вы хотите изменить. Во всплывающем окне нажмите «Редактировать». Выбор параметра, который надо изменить, изображение 40 Откроется окно, где вы сможете изменить тип параметра и/или его значение. Когда закончите вносить изменения, нажмите кнопку сохранить. Изменение параметра, изображение 41 Изменённый параметр отобразится в списке параметров пользователя. Удаление параметра Чтобы удалить параметр, откройте параметры пользователя, нажмите на три точки, напротив того параметра, который хотите удалить. Во всплывающем окне нажмите «Удалить». Удаление параметра, изображение 42 Откроется окошко, в котором надо подтвердить удаление параметра. Нажмите «Удалить». Подтверждение удаления параметра, изображение 43 Параметр удалится у пользователя. Если вы удаляли глобальный параметр, то параметр удалится у всех пользователей. Запуск реакции и отправка сообщений Из карточки пользователя вы можете запускать реакции или общаться с пользователем от имени бота. Чтобы запустить какую-то реакцию, нажмите на значок реакции в правом нижнем углу. Выбор отправки реакции, изображение 44 Откроется окно, в котором можно будет выбрать нужную реакцию. Выбор реакции, изображение 45 Когда выберете нужную реакцию, нажмите кнопку «Отправить». Отправка выбранной реакции, изображение 46 Реакция тут же запустится у пользователя и отобразится в диалоге. ВАЖНО: запущенная таким образом реакция выполнится в любом случае, то есть вне зависимости от того, выполняются условия, заданные в п.3 или нет. Помимо отправки реакций можно написать пользователю сообщение от имени бота. Для этого нажмите на строку внизу. Выбор отправки сообщения, изображение 47 Откроется окно, в котором можно написать текст сообщения, а затем нажать кнопку «Отправить». Отправление сообщения пользователю, изображение 48 Сообщение тут же отправится пользователю, что будет видно в диалоге. Написанное сообщение отправлено пользователю, изображение 49 Удалить или отредактировать отправленное таким образом сообщение невозможно. Избранное Раздел «Избранное» отображает только тех пользователей, которых ранее добавили в избранное. Чтобы добавить пользователя в избранное, наведите курсор мыши на значок звездочки слева от его имени и нажмите. Добавление пользователя в «Избранное», изображение 50 Появится сообщение, в котором вас попросят подтвердить добавление пользователя. Подтверждение добавления пользователя в «Избранное», изображение 51 Нажмите «Да». Снова откроется раздел «Пользователи», у пользователя, которого вы добавили в избранное, значок звездочки будет жёлтым. Пользователя добавили в «Избранное», изображение 52 В избранное удобно добавлять пользователей, с которыми вы часто работаете. Например, администраторов/менеджеров. Тогда вам не надо будет искать их в общем списке, а достаточно будет просто перейти в избранное. Импорт пользователей Этот раздел позволяет перенести базу пользователей, если вы переносите своего бота с другой платформы на Sambot ВАЖНО: перенести можно базу только того бота, который у вас был подключен на другой платформе, а сейчас вы переносите его на Sambot. База пользователей из любого другого бота, просто собранный список контактов работать не будет. Бот просто не сможет отправить пользователям сообщения, так как они не инициировали диалог с ботом, то есть не запускали конкретно этого бота. Чтобы добавить свою базу пользователей, перейдите в раздел «Импорт пользователей», нажмите кнопку «Выберите файл». Импорт базы пользователей, изображение 53 В открывшемся окне выберите файл с базой, который вы ранее скачали на своё устройство, и нажмите кнопку «Открыть». Загрузка файла с базой пользователей, изображение 54 Выберете тип разделителя в соответствии с тем, который использовался при выгрузке базы на той платформе, откуда вы скачали базу. Выбор разделителя при импорте базы пользователей, изображение 55 Нажмите кнопку «Обработать». изображение 56 Отобразятся все поля загружаемой базы пользователей. Обязательно укажите, какие поля содержат ID пользователей, имя и фамилию. Выбор столбцов, соответствующих ID, имени и фамилии, изображение 57 По желанию можно также выбрать метки и параметры. ВАЖНО: Метки и параметры/переменные с другой платформы не всегда переносятся корректно. Выбор условия переноса меток, изображение 58 После того, как вы проверили все столбцы и задали нужные значения, спуститесь вниз страницы и нажмите кнопку «Импортировать». Кнопка «Импортировать» для загрузки базы пользователей, изображение 59 База загружена. Теперь пользователи могут взаимодействовать с вашим ботом. База пользователей загружена, изображение 60 Экспорт пользователей Этот раздел позволяет выгрузить базу пользователей, чтобы перенести её на другую платформу или проанализировать. Вы можете выбрать, какие данные выгружать, а также какой разделитель использовать при выгрузке. Сначала раскройте список «Данные» и отметьте, какие данные вы хотите выгрузить. Выбор данных при экспорте пользователей, изображение 61 Далее выберете разделитель данных. Выбор разделителя при экспорте пользователей, изображение 62 Теперь нажмите кнопку «Скачать», начнётся автоматическое скачивание файла на ваше устройство. Скачивание базы пользователей, изображение 63 База пользователей скачивается в формате zip-архива. В архиве файл в формате csv с экспортированной базой пользователей. Настройка меток В этом разделе вы можете настроить видимость меток, а также удалить неиспользуемые метки. Включение и выключение видимости меток Видимость меток – это отображение метки сразу в разделе «Пользователи». То есть метку видно в общем списке пользователей, не нужно открывать отдельно метки каждого пользователя. ВАЖНО: включение и выключение видимости меток не влияет на присвоение или удаление меток у пользователей. Эта функция позволяет визуально отслеживать наличие конкретной метки у пользователя в общем списке в разделе «Пользователи», не открывая полный список меток каждого пользователя. Чтобы включить отображение метки, нажмите на значок слева от названия метки. Включение видимости метки, изображение 64 Откроется окно, где надо подтвердить включение видимости метки. Нажмите кнопку «Показать». Подтверждение включения видимости метки, изображение 65 Значок метки изменится. Видимость метки включена, изображение 66 Метка теперь отображается в общем списке пользователей. Отображение метки, изображение 67 Чтобы отключить видимость метки, надо нажать на значок слева от названия метки. Отключение видимости метки, изображение 68 Откроется окно, где надо подтвердить выключение видимости метки. Нажмите кнопку «Скрыть». Подтверждение выключения видимости метки, изображение 69 Значок метки изменится, а сама метка перестанет отображаться в общем списке пользователей. Удаление меток В разделе «Настройка меток» вы можете удалить ненужные метки. ВАЖНО: метка удалится сразу везде: и у пользователей, и во всех реакциях, где она проставлялась, удалялась или использовалась в условии в п. 3.1. Чтобы удалить метку, нажмите на значок корзины справа от названия метки. Удаление метки, изображение 70 Откроется окно, где нужно будет подтвердить удаление метки. Нажмите кнопку «Удалить». Подтверждение удаления метки, изображение 71 Метка удалится из общего списка меток, у всех пользователей, у которых она была, а также из всех реакций, в которых она использовалась. Настройка параметров В этом разделе вы можете настроить видимость параметров, а также удалить неиспользуемые параметры. Включение и выключение видимости параметров Видимость параметров – это отображение параметра сразу в разделе «Пользователи». То есть параметр видно в общем списке пользователей, не нужно открывать отдельно параметры каждого пользователя. ВАЖНО: включение и выключение видимости параметров не влияет на присвоение или удаление параметров у пользователей. Эта функция позволяет визуально отслеживать наличие конкретного параметра у пользователя в общем списке в разделе «Пользователи», не открывая полный список параметров каждого пользователя. Чтобы включить или выключить отображение параметра, нажмите на значок слева от названия параметра. Включение видимости параметра, изображение 72 Откроется окно, где надо подтвердить включение видимости параметра. Выбор режима отображения параметра, изображение 73 Можно выбрать один из трёх режимов: Скрыть – параметр не будет отображаться в общем списке пользователей. Показать – параметр будет отображаться в общем списке пользователей, но видно будет только название. Показать с последним значением – параметр будет отображаться в общем списке пользователей, видно будет название параметра и его последнее значение. Выберите режим отображения параметра и нажмите кнопку «Сохранить». Подтверждение изменения отображения параметра, изображение 74 Значок слева от параметра изменится. При этом, по виду значка можно определить, скрыт параметр в общем списке пользователей (№1), виден (№2) или виден вместе с последним значением (№3). Отображение видимости параметра в разделе «Настройка параметров», изображение 75 Параметры, у которых включена видимость, также отображаются в общем списке пользователей. Отображение параметров с включённой видимостью в общем списке пользователей, изображение 76 Удаление параметров В разделе «Настройка параметров» вы можете удалить ненужные параметры. ВАЖНО: параметр удалится сразу везде: и у пользователей, у которых он был, и во всех реакциях, где проставлялся, удалялся, применялся в формулах или сообщениях, использовался в условии в п. 3.2. Чтобы удалить параметр, нажмите на значок корзины справа от названия параметра. Удаление параметра, изображение 77 Откроется окно, где нужно будет подтвердить удаление параметра. Нажмите кнопку «Удалить». Подтверждение удаления параметра, изображение 78 Параметр удалится из общего списка параметров, у всех пользователей, у которых он был, а также из всех реакций, в которых он использовался. --- ## Часто задаваемые вопросы про SamBot URL: https://sambot.ru/kb_chasto-zadavaemye-voprosy_105 Частые вопросы про SamBot: приём оплаты, автоворонки для онлайн-школы, ИИ-агенты, интеграции с CRM, веб-запросы, отложенные действия, 152-ФЗ. Подборка частых вопросов от тех, кто только знакомится с SamBot или выбирает платформу для своего проекта. Если ответ короткий — здесь же, если требует подробностей — ссылка на разбор-статью. Как принимать оплату в Telegram-боте? В SamBot встроена поддержка нескольких платёжных провайдеров. Подключите тот, с которым уже работает ваш бизнес, или выберите по комиссии и удобству: ЮKassa — универсальный, простой старт Robokassa — широкий выбор способов оплаты, есть автоплатежи Т-Банк (Тинькофф) — низкая комиссия для ИП и юрлиц Prodamus — быстрая платёжная страница без своего сайта Telegram Payments — оплата прямо в чате через провайдера в BotFather После настройки бот сам запускает выбранную реакцию (например, «выдать доступ к курсу»), как только платёж зачислен. Как сделать автоворонку для онлайн-школы? Полноценная воронка для онлайн-школы (онбординг, прогрев, продажа курса, удержание) без своих скриптов и внешних сервисов: Триггер — ключевое слово, переход из рекламы по deep-link, заход в канал. Метки — на каждом шаге воронки бот ставит метку: «прошёл вступление», «открыл прайс», «оплатил». Метки сегментируют базу для дальнейших рассылок. Реакции по таймеру — отложенные сообщения через минуту, час, сутки от события: первый прогрев, напоминание, повторное предложение. Реакция после оплаты — срабатывает автоматически по факту успешного платежа: меняем метку, выдаём доступ к материалам, отправляем приветствие в закрытый канал. Условия — каждая следующая реакция проверяет состояние клиента (метки, параметры) и отправляет именно то, что нужно на этом шаге. Подробнее по инструментам — статьи «Реакции в SamBot — основа автоматизации бота» и «Метки для сегментации Пользователей». Как подключить ИИ так, чтобы он не только отвечал, но и совершал действия? В SamBot есть ИИ-агент — ИИ может вызывать функции: запросить данные из вашего CRM, обновить параметр клиента, поставить метку, запустить дополнительную реакцию (например, передать диалог менеджеру). Бот сам решает, какой инструмент применить и с какими аргументами, и формулирует финальный ответ с учётом результата. Поддерживаются интеграции OpenAI «Ответы» (Responses API) и OpenAI «Ассистенты» (Assistants API; OpenAI прекращает поддержку ассистентов после августа 2026 года — для новых ботов выбирайте «Ответы»). Подробно с разбором сценария «get_order_status» — в статье «Как создать ИИ-агента на SamBot». Как интегрировать бота с CRM, Google Таблицами или внешним API? Несколько способов в зависимости от системы: Google Таблицы и Google Drive — встроенная интеграция, мини-CRM на Google Sheets без кода. GetCourse — встроенная интеграция: события из геткурса, обращение к геткурсу из бота. Любой REST API — через действие «Веб-запрос» в реакции (см. следующий вопрос) или через внешнюю ИИ-функцию. Подробнее: «Раздел Интеграции» в справке + статья «Как создать ИИ-агента на SamBot» (для CRM через ИИ). Как отправить запрос на свой сервер из бота? Как принять извне? Из бота наружу. В реакции есть действие «Веб-запрос» — бот делает HTTP-запрос с подстановкой параметров пользователя в URL, заголовки и тело. Ответ сохраняется в параметр и используется в следующих действиях (например, в тексте сообщения). Альтернатива — внешняя ИИ-функция: ИИ сам решает, когда обратиться к API. Извне в бота. У SamBot есть API, через который внешний сервис запускает реакцию у конкретного пользователя по его id. Используется для уведомлений из CRM, событий платёжных систем, синхронизации статусов. Можно ли отложить действие — удалить сообщение через час, написать через сутки? Да, всё одной галкой в настройках реакции — без cron, скриптов и внешних таймеров: Отложенное сообщение — отправить через N минут / часов / суток или в конкретное время дня. Удаление сообщения через … — после отправки бот сам удалит сообщение через указанное время. Полезно для временных уведомлений и капч. Запуск по времени из параметра — например, через 30 минут после значения, записанного в параметре пользователя (дата регистрации, дата оплаты, дата записи). Воронка строится автоматически. Можно ли сгруппировать реакции, чтобы было проще ориентироваться? Да. У каждой реакции можно задать теги — произвольный список меток вроде «воронка», «ИИ», «оплата», «черновик». Дальше в разделе «Реакции» работают фильтры по тегам: показать только воронку, спрятать черновики, экспортировать набор. Удобно, когда у бота уже несколько десятков реакций — ориентироваться по названиям становится тяжело, а по тегам сразу видно структуру. Безопасно ли в SamBot по 152-ФЗ? Сервера SamBot расположены на территории РФ (мощности АО «Селектел») и соответствуют требованиям 152-ФЗ, приказу ФСТЭК № 17, ГОСТ Р 57580, ISO 27001/27017/27018, PCI DSS, SOC 2. Готовый пакет документов под вашу деятельность можно получить через бот @docsfzbot — отправляете ему данные о собираемых ПД и получаете комплект (политика, согласие пользователя, уведомление в Роскомнадзор и т. д.). Платформа активно развивается? Да. Самые крупные обновления последних лет: Боты ВКонтакте — модуль для сообществ ВК с тем же набором реакций, что и для Telegram. ИИ-агент — ИИ с function calling, который не только отвечает, но и выполняет действия. Новые ИИ-провайдеры — ChatGPT, YandexGPT, Claude, Gemini, Perplexity в одном окне. Новые платёжные системы — Т-Банк, автоплатежи Robokassa. HTML-форматирование, премиум-эмодзи, стили кнопок — тонкая работа с внешним видом сообщений. Юридическая упаковка — сервера в РФ, помощник по 152-ФЗ. Полный список — в разделе «Новости». Если нужного функционала пока нет — напишите в поддержку: в SamBot есть культура отзываться на запросы пользователей и добавлять полезное. --- ## Чат-бот для Telegram — конструктор SamBot URL: https://sambot.ru/telegram Создайте чат-бота для Telegram без программирования. Автоответы по ключевым словам, ИИ-агент, приём платежей, Google Таблицы, сегментация — конструктор, настройка в браузере. SamBot — визуальный конструктор чат-ботов для Telegram. Без единой строки кода настройте автоответы по ключевым словам, ИИ-агента с вызовом функций, приём платежей через ЮKassa и Telegram Stars, рассылки по расписанию и сегментацию аудитории. Данные хранятся на серверах в России (152-ФЗ). Интеграции с Google Таблицами, Google Диском и GetCourse доступны из коробки. --- ## Чат-бот для ВКонтакте — конструктор SamBot URL: https://sambot.ru/vk Создайте чат-бота для сообщества ВКонтакте без программирования. Автоответы по ключевым словам, ИИ-агент, приём платежей, Google Таблицы, сегментация — конструктор, настройка через Callback API. SamBot — визуальный конструктор чат-ботов для ВКонтакте. Без единой строки кода настройте автоответы по ключевым словам, ИИ-агента с вызовом функций, приём платежей через ЮKassa, рассылки по расписанию и сегментацию аудитории. Данные хранятся на серверах в России (152-ФЗ). Интеграции с Google Таблицами, Google Диском и GetCourse доступны из коробки. --- ## Чат-бот для MAX — конструктор SamBot URL: https://sambot.ru/max Создайте чат-бота для мессенджера MAX без программирования. Автоответы по ключевым словам, ИИ-агент, приём платежей, Google Таблицы, сегментация — конструктор, настройка в браузере. SamBot — визуальный конструктор чат-ботов для MAX. Без единой строки кода настройте автоответы по ключевым словам, ИИ-агента с вызовом функций, приём платежей, рассылки по расписанию и сегментацию аудитории. Данные хранятся на серверах в России (152-ФЗ). Интеграции с Google Таблицами, Google Диском и GetCourse доступны из коробки. --- ## ⚠️ Удаляем бот из групп и каналов URL: https://sambot.ru/news_udalyaem-bot-iz-grupp-i-kanalov_63 В Sambot можно удалять бота из групп и каналов одним кликом. Удалённый чат исчезает из списка и реакций — простое и безопасное управление. Боты, как и обычные пользователи, могут покидать группы и каналы. Мы добавили такую возможность в Sambot Для этого нужно: 👉 Зайти в раздел "Чаты" 👉 Напротив чата нажать на иконку корзины 👉 Подтвердить действие Готово! В статистике отобразится, что бот покинул группу/канал. ВАЖНО! Чат будет удалён из списка чатов и из реакций, в которых он использовался! Особенно удобно для того, чтобы удалить бот из чатов, в которые вы его не добавляли 😉 --- ## Поддержка HTML-форматирования в полученных сообщениях и подписях 🔥 URL: https://sambot.ru/news_podderzhka-html-formatirovaniya-v-poluchennykh-soobshcheniyakh-i-podpisyakh_61 Бот сохраняет HTML-форматирование сообщений и подписей к медиа в параметр. Жирный, курсив, ссылки и другие стили сохраняются автоматически. Теперь мы можем сохранять форматирование сообщений и подписей к медиа! Для этого добавлена обработка html-сущностей в полученных ботом сообщениях. Как это работает: 👉 Включаем новую функцию в настройках 👉 Настраиваем сохранение сообщения удобным способом (пункт 4.2 или ожидание ответа) После этого все полученные сообщения и подписи к медиа будут сохраняться в параметр в том формате, в котором они были присланы боту — жирный, курсив, ссылки и т.д. сохраняются! При отправке такого параметра ботом форматирование будет как у полученного сообщения. Пример использования: вы можете настроить бот и задавать сообщения для рассылок по пользователям и публикаций в каналах, не заходя на платформу Теперь вы можете гибко работать с форматированием текста прямо в сообщениях! --- ## Сервера Самбота на территории РФ URL: https://sambot.ru/news_servera-sambota-na-territorii-rf_41 Сервера Sambot на мощностях Селектел в РФ. Соответствие 152-ФЗ, приказу ФСТЭК, ГОСТ Р 57580, ISO 27001/27017/27018, PCI DSS, SOC 2. Сервера расположены на мощностях АО «Селектел», соответствующих стандартам безопасности: 152-ФЗ17 приказ ФСТЭК ГОСТ Р 57580 ISO 27001 / 27017 / 27018 PCI DSS SOC 2 Реестр отечественного ПО 📍 Адрес серверов: Россия, г. Москва, улица Берзарина, 36с3 Реквизиты компании: https://selectel.ru/about/details/ --- ## Ограничение тестового периода URL: https://sambot.ru/news_ogranichenie-testovogo-perioda_59 Тестовые периоды по промокодам ограничены 1000 запросами в день из-за злоупотреблений. Некоторые боты заблокированы. Подробности от 26 мая 2025. К нашему большому сожалению, в связи с постоянными махинациями с промокодами (многократное использование), мы вынуждены: Во-первых, заблокировать часть ботов (по причине описанной в п.3.2.7. Публичной оферты → Обман Администрации), до момента полного возмещения вреда. Во-вторых, ограничить все тестовые периоды по всем промокодам до 1000 запросов в день. Срок предоставления тестового периода остается прежним - 14 дней. Изменения вступили в силу с момента публикации данного поста. --- ## ⚠️ Отслеживайте ошибки, не заходя на платформу URL: https://sambot.ru/news_otslezhivayte-oshibki-ne-zakhodya-na-platformu_57 Включите обработку ошибок в Sambot: сохранение в глобальный параметр, выбор групп, использование в реакциях. Отслеживайте проблемы, не заходя на платформу. Вы можете настроить сохранение ошибок в работе бота в глобальный параметр и затем использовать этот параметр в реакциях по вашему сценарию. Для этого: Зайдите в раздел "Настройки" Включите пункт "Задать действия при ошибке" Выберите группы ошибок в подпункте "Обрабатывать только указанные группы ошибок" Укажите, в какой параметр сохранять ошибки в пункте "Сохранять ошибки в глобальном параметре" Нажмите кнопку "Сохранить" ⚠️ Формат сохранения ошибки в параметре: { "code": 403, "error_type": "bot_forbidden", "error": "Бот заблокирован пользователем", "message": "Forbidden: bot was blocked by the user" } Получить код ошибки: JP({global:errors}; "$.code") Совет: используйте параметр "хранить все значения", чтобы сохранять ошибки и запускать реакцию по времени или ключевому слову. --- ## Интеграция с Yandex GPT и Google Gemini 🔥 URL: https://sambot.ru/news_integratsiya-s-yandex-gpt-i-google-gemini_43 Теперь можно использовать Yandex GPT и Google Gemini для генерации текста. Модели доступны в разделе "Интеграции". Теперь можно использовать Yandex GPT и Google Gemini для генерации текста. Как добавить интеграцию: Нажмите "Добавить интеграцию" Укажите заголовок Выберите тип "ИИ" Выберите нужный сервис Укажите API ключ Нажмите "Добавить" Теперь можно использовать ИИ в реакциях для генерации ответов. --- ## Самбот помогает избежать штрафов по федеральному закону о персональных данных URL: https://sambot.ru/news_sambot-pomogaet-izbezhat-shtrafov-po-federalnomu-zakonu-o-personalnykh-dannykh_45 Полный пакет документов для соответствия 152-ФЗ о персональных данных. Отправьте боту docsfzbot данные о деятельности и собираемых ПД — получите комплект. 152 ФЗ о Персональных данных существует уже почти 20 лет. Но все это время штрафы за несоблюдение этого закона были крошечными и им многие пренебрегали. ‼️ В конце 2024 года был подписан Указ о многократном увеличении штрафов за несоблюдение закона о ПД - вплоть до ДВАДЦАТИ МИЛЛИОНОВ РУБЛЕЙ. И в действие эти штрафы вступают уже с 🗓 30 мая 2025 года. Кого это касается? Нас (Самбот) и вас (разработчики, заказчики ботов). 🟢 Самбот уже уведомлял пользователей о расположении ПД на территории РФ на защищенных серверах. Документация (Согласие на обработку ПД, Политика конфиденциальности и Согласие на получение новостных и рекламных рассылок) так же юридически доработана в соответствии с законом. Самбот полностью соответствует ✅ 152 ФЗ в рамках сбора, хранения и обработки Персональных данных. 🔴 Разработчики и их клиенты (заказчики) имеют собственную ответственность перед законом, так как собирают в чат-ботах Персональные данные своих пользователей: Имя, username, id telegram, дату рождения, адрес доставки и другие данные. Споры на счет того, что является, а что не является ПД ведутся давно и сложно, и часто в Судах. Всем разработчикам Самбота нужно грамотно и ответственно подойти к вопросу соответствия своей деятельности и закона о Персональных данных. ‼️ Самбот в этом случае не несет ответственность за ваши действия. Она лежит полностью на Операторе сбора ПД, коими являетесь вы. 🟡 Что делать? Самбот, выручай! Стоимость разработки полного пакета юридически верных документов именно для вашего чат-бота или сайта стоит от 45000 рублей. 🔥 Самбот совместно с Юридической компанией ООО «Бизнес решение» под руководством Александры Литвиновой создал 🏛 Юридический конструктор, который позволяет формировать документы персонально для каждого бизнеса. Подробнее и стоимость в боте: 👉 https://t.me/docsfzbot Кроме этого сейчас мы бонусом выдаем рекомендации по правильному расположению каждого документа на сайте или в чат-боте, с какими пунктами Субъект персональных данных должен согласиться обязательно, а с какими на свое усмотрение и т.д. 🧑🎓 Напоминаем, что всё проработано совместно с профессиональными Юристами! Разработка полного пакета документов для соответствия вашего бизнеса 152 Федеральному закону, а, соответственно, и защита от штрафов займет 1 сутки после того, как вы отправите боту 👉 @docsfzbot информацию о деятельности и собираемых ПД. ‼️ Успейте до 30 мая ‼️ --- ## Нумерованные / маркированные списки и блок кода в редакторе текста URL: https://sambot.ru/news_numerovannye-markirovannye-spiski-i-blok-koda_55 В редакторе Sambot теперь доступны нумерованные и маркированные списки, а также блоки кода. Стилизуйте сообщения бота быстрее и удобнее. В текстовом редакторе теперь доступны: нумерованные списки, маркированные списки, блоки кода (тег
).
Стилизуйте ваш текст легко с новыми инструментами 😉
---
## Автоплатежи Робокассы
URL: https://sambot.ru/news_avtoplatezhi-robokassy_77
Запускайте клубы по подписке и не только с автоплатежами на Самботе
Мы добавили автоплатежи от Робокассы.
Для использования автоплатежей:
🔹 запросите подключение автоплатежей в кабинете Робокассы.
🔹 После одобрения добавьте приём платежей через Робокассу на странице бота в Самботе.
🔹 Заполните необходимые данные по инструкции (https://sambot.ru/guide_robokassa_23)
🔹 В поле "Обработка платежей" выберите "Автоматически", после чего откроются доп настройки.
🔹 Включите пункт "автоплатежи" и сохраните
Готово!
Остается только настроить реакцию с кнопкой оплаты
Запускайте клубы по подписке и не только с автоплатежами на Самботе
Видео МК
---
## Стили кнопок в сообщениях бота
URL: https://sambot.ru/news_stili-knopok-v-soobshcheniyakh-bota_79
Стилизованные кнопки сообщений бота делают их более понятными для пользователей
В настройках кнопок появилась новая возможность — теперь можно выбрать стиль кнопки, который определяет её цвет.
Доступны следующие стили:
Primary — синий
Success — зелёный
Danger — красный
Если стиль не выбран, кнопка будет отображаться в стиле по умолчанию.
---
✨ Что это даёт
Теперь вы можете визуально выделять кнопки в зависимости от их назначения:
🔵 Primary — для основных действий
🟢 Success — для подтверждений и позитивных сценариев
🔴 Danger — для отмены, удаления или важных предупреждений
Это поможет сделать сообщения бота более понятными, наглядными и удобными для пользователей.
---
## Поддержка премиум эмодзи в сообщениях бота
URL: https://sambot.ru/news_podderzhka-premium-emodzi-v-soobshcheniyakh-bota_81
Делайте сообщения бота более живыми, наглядными и выразительными с помощью премиум эмодзи на Самботе
Теперь вы можете отправлять кастомные (премиум) эмодзи Telegram прямо в тексте сообщений бота
Мы сделали это максимально просто — достаточно открыть список подстановок и выбрать
«Кастомный (премиум) эмодзи», после чего вставить его в нужное место текста.
🧩 Как это работает
Подстановка вставляет кастомный эмодзи Telegram с указанным ID:
{emoji:5368324170671202286}
По умолчанию используется базовый эмодзи: 🙃
Вы также можете указать свой базовый эмодзи через точку с запятой:
{emoji:5368324170671202286;🥶}
В этом случае будет использован кастомный эмодзи с базовым отображением – 🥶
📌 ВАЖНО
Отправка премиум эмодзи доступна только ботам, владельцы которых имеют Telegram Premium.
🔎 Как узнать ID нужного эмодзи
Самый простой способ:
– Создайте реакцию, которая запускается по пункту 1.1.5
– Включите пункт 4.2 "Изменить параметры" и укажите в параметре сохранение подстановки "Обновление" ({update})
– Ограничьте запуск реакции только для себя или администраторов
– Отправьте боту нужный/ые премиум эмодзи
В сохранённом параметре вы увидите ID этого эмодзи
Теперь вы можете делать сообщения бота более живыми, наглядными и выразительными с помощью премиум эмодзи 🚀
---
## Обновление окна диалога пользователя
URL: https://sambot.ru/news_obnovlenie-okna-dialoga-polzovatelya_83
Мы улучшили окно диалога пользователя с ботом, чтобы работа с историей и параметрами стала быстрее и удобнее. 🗓 Кнопка «Показать с даты…» В к
Мы улучшили окно диалога пользователя с ботом, чтобы работа с историей и параметрами стала быстрее и удобнее.
🗓 Кнопка «Показать с даты…»
В карточке пользователя (меню слева) появилась новая кнопка «Показать с даты…»
Она позволяет:
– открыть диалог, начиная с указанной даты
– автоматически перейти к ближайшему действию, если в выбранную дату активности не было
Это особенно удобно при анализе конкретных ситуаций или поиске нужных событий в истории
⌨️ Быстрое копирование параметров
Теперь работать с параметрами можно намного быстрее:
– можно скопировать значение параметра в один клик — нажмите на иконку рядом с его значением
– можно скопировать название параметра, просто нажав на него
После вставки в сообщение реакции параметр автоматически будет добавлен как подстановка в формате:
{user:НАЗВАНИЕ_ПАРАМЕТРА}
Это значительно упрощает использование параметров при настройке реакций
🔄 Управление автообновлением диалога
Ранее окно диалога обновлялось автоматически без возможности отключения
Теперь вы можете самостоятельно управлять автообновлением, сняв галочку в соответствующем пункте.
Это удобно, если нужно:
– спокойно анализировать диалог
– избежать смещения при появлении новых событий
– работать с конкретным участком истории
Обновление делает работу с диалогами более гибкой, удобной и эффективной ⚡️
---
## НОВЫЙ МОДУЛЬ: БОТЫ ВКОНТАКТЕ
URL: https://sambot.ru/news_novyy-modul-boty-vkontakte_85
В Sambot добавлена поддержка ботов ВКонтакте: создайте VK-бота, получите токен, настройте Callback API и подключите к сообщениям сообщества.
Мы добавили поддержку ВКонтакте – теперь вы можете создавать и настраивать ботов для сообществ ВК прямо в самботе 🎉
Добавим ваш первый бот ВК!
– В Самбот нажмите "Добавить бот" и выберите добавление бот ВК.
– Укажите токен бота
🔑 Как получить токен
Перейдите в настройки сообщества ВК:
Управление → Дополнительно → Работа с API → Ключи доступа
Создайте и скопируйте токен и вставьте его на Самбот.
После откроется дополнительно окно настроек: "Связать сервер с ВКонтакте"
Выполните настройку по инструкции и сохраните.
❗️ОБЯЗАТЕЛЬНО 👇
📌 в окне Callback API На вкладке «Типы событий» не забудьте отметить нужные события, на которые сможет реагировать бот
💬 Как работает бот
Бот уже умеет работать в сообщениях сообщества
Диалог сообщества с пользователем в самботе отображается как приватный чат (по аналогии с Telegram)
👥 Также бот можно добавлять в чаты (беседы)
Чтобы добавить бота в беседы:
1️⃣ Перейдите в настройки сообщества
Сообщения → Настройки для бота
2️⃣ Включите пункт:
«Разрешать добавлять сообщество в чаты»
⚠️ ВАЖНО:
после включения пользователи смогут добавлять бот сообщества в свои чаты (беседы)
После этого на странице сообщества появится кнопка «Добавить в чат»
Мы выкладываем функционал ВКонтакте поэтапно, чтобы вы уже могли начать собирать ботов и тестировать их в работе
Если в процессе заметите ошибки или что-то работает некорректно — напишите нам 👉 @sup_sambot
Теперь вы можете создавать ботов не только для Telegram, но и для ВКонтакте — расширяйте охват и автоматизируйте общение с аудиторией на новых площадках 🚀
---
## Раздел "Оплата тарифа"
URL: https://sambot.ru/support_razdel-oplata-tarifa_29
Выбор и оплата тарифа для Telegram-бота: тарифы по запросам и с дневным лимитом. Поддержка Robokassa, Telegram Payments и промокодов.
Раздел «Оплата тарифа» позволяет пользователям выбрать и приобрести подходящий тариф для работы с Telegram-ботом.
Доступные тарифы
По количеству запросов — без ограничения по времени (например, 1 000 запросов, 100 000 запросов и т.д.).
С ограничением по запросам в день — на определённый срок (например, до 1 000 запросов в день на 30 дней, или до 100 000 в день на 360 дней).
То есть данные тарифы ограничены временем использования, а также лимитом запросов, которые бот может потратить в течение суток. При достижении лимита бот перестанет работать до наступления нового дня*. Лимит обновляется каждый день в период действия тарифа.
Доступны к покупке тарифы на 30, 90, 180 и 360 дней.
Тариф Беззаботный при покупке можно суммировать с ранее купленным тарифом Беззаботный по лимиту запросов или продлить. Настройка задаётся при покупке тарифа
Тарифы можно передавать между ботами. Это можно сделать в разделе "Настройки" по кнопке "Передать"
Если вы первый раз на нашей платформе, вы можете применить промокод SAMBOT, который позволяет 14 дней тестировать бота (действует ограничение 1000 запросов в день). Промокод можно применить только один раз.
Способы оплаты
Через Robokassa
Через Telegram
Для оплаты по б/н расчёту и криптовалютой пишите @artemkook
История платежей
История покупки тарифов отображается внизу страницы, где указаны как оплаченные, так и ожидающие оплаты тарифы.
Дополнительная информация
Запросы – любые действия, связанные с обработкой информационных сообщений (текст, фото, видео, аудио и т.д.) от пользователей через Telegram в приватных и публичных чатах, в которых вы разрешили работать боту в настройках конструктора, при обращении и без обращения к боту, и действия исходящие от бота (отправка, удаление, пересылка сообщений), на основании ваших настроек модулей конструктора Sambot.ru.
Пример: Для запуска одной реакции, которая отправляет одно сообщение одному пользователю бот потратит 2 запроса.
1-й запрос на запуск реакции, 2-й запрос на отправку сообщения.
* Вы можете приобрести тариф Запросы в дополнение к тарифу Беззаботный. В этом случае при достижении дневного лимита тарифа Беззаботный бот будет расходовать Запросы, таким образом бот не остановит свою работу в важный момент.
---
## Раздел "Статистика"
URL: https://sambot.ru/support_razdel-statistika_31
Анализ запросов, реакций, интеграций и платежей в Telegram-боте. Отслеживайте активность пользователей и эффективность сценариев по дням.
Раздел «Статистика» предназначен для мониторинга и анализа активности Telegram-бота. Он предоставляет подробные данные о всех действиях, выполненных ботом и пользователями, в течение выбранного дня. Это позволяет отслеживать эффективность взаимодействия с ботом, выявлять загруженность, а также оценивать, как используются функции, настроенные через конструктор Sambot.
Вы можете указать период, за который хотите получить данные по статистике. Максимальный срок хранения статистики 3 месяца
Пользователю доступен выбор различных категорий запросов:
Все действия — общее количество запросов за день
Сообщения — взаимодействия с сообщениями, медиа и кнопками
Реакции — действия, связанные с запуском/завершением реакций, задержек, отправкой веб-запросов
Интеграции — внешние подключения, такие как CRM, оповещения и API;
Приём платежей — активности, связанные с выставлением и обработкой счетов.
Ошибки — ошибки внутренние и внешние также отображаются в статистике.
Все действия отображаются с указанием точного времени, имени пользователя, ссылки на Telegram-аккаунт (если у пользователя есть username) и названием реакции, если она была задействована. Также отображается информация, был ли списан запрос с баланса за выполнение действия - зелёный самолётик напротив действия означает, что запрос был списан.
Система визуализирует статистику в виде графика, который помогает быстро понять нагрузку на бота в течение дня. Это особенно полезно для анализа сценариев с большим числом пользователей или высокой активностью.
Раздел «Статистика» — это удобный инструмент для владельцев бота, который позволяет в реальном времени отслеживать поведение пользователей, оценивать производительность и корректировать логику работы бота на основе фактических данных.
---
## Раздел "Настройки"
URL: https://sambot.ru/support_razdel-nastroyki_33
Настройте Telegram-бота: управление обращением, языком, отображением пользователей, обработкой ошибок и синхронизацией с BotFather.
Раздел «Настройки» отвечает за конфигурацию Telegram-бота. Ниже приведено краткое описание основных функциональных блоков, представленных в интерфейсе.
Общая информация и управление
В верхней части страницы отображаются текущий статус бота (включен/выключен), количество пользователей и статистика по запросам (сделано сегодня, осталось в рамках тарифа). Здесь же доступны функции:
создание и применение шаблонов ботов;
ограничение количества запросов в день;
оплата тарифа и передача тарифа другим ботам.
ВАЖНО! При передаче тарифа БЕЗЗАБОТНЫЙ другому боту, у которого также есть на балансе тариф БЕЗЗАБОТНЫЙ, суточные лимиты двух тарифов складываются
Основные поля настроек
Пользователь может настроить следующие параметры:
Обращение к боту — имя, по которому бот реагирует в группах.
Это настройка используется, если в реакции включен пункт 2.2 "В публичных чатах только при обращении к боту"
Позиция в списке — позволяет задать порядок отображения бота в списке всех ваших ботов
Режим отображения пользователей в разделе "Пользователи" — можно выбрать: всех, только активных, неактивных или заблокированных;
Язык интерфейса бота — русский или английский.
На этом языке будут отображаться все системные сообщения, отправляемые ботом
Также доступны административные действия:
синхронизация данных с BotFather по кнопке "Синхронизировать"
изменение токена бота - новый токен можно выпустить в BotFather
передача прав на бота другому пользователю, зарегистрированному в Sambot.ru
Обработка ошибок
Платформа позволяет гибко настроить поведение бота при возникновении ошибок:
указание конкретных HTTP-кодов, при которых запускать обработку
сохранение информации об ошибках в глобальный параметр (выбирается из списка).
Выбранные параметр вы можете использовать в реакциях, для отображения ошибок в вашем сценарии бота.
подробнее
Доступ к боту
В этом блоке вы можете разрешить доступ к указанным разделам настроек бота другим пользователям, зарегистрированным на платформе
Системные сообщения
В этом блоке заданы системные сообщения, который бот отправляет при ошибках, приемах платежей и других сценариях.
Вы можете редактировать эти сообщения, нажав на них.
---
## Раздел "Чаты"
URL: https://sambot.ru/support_razdel-chaty_35
Настраивайте чаты Telegram для вашего бота на Sambot: добавление групп, каналов, фильтрация доступа, управление метками и ссылками-приглашениями.
Раздел «Чаты» представляет собой интерфейс управления Telegram-чатами, с которыми взаимодействует бот. Этот раздел позволяет добавлять, настраивать и ограничивать доступ бота к различным группам, каналам и супергруппам Telegram.
Основной функционал раздела:
Фильтрация доступа
Пользователь может выбрать режим работы с чатами:
– Только указанные — бот работает исключительно с выбранными чатами.
– Кроме указанных — бот исключает определённые чаты из обработки.
Предупреждение
При удалении чата из разрешённых, он исключается из всех реакций бота. При повторном добавлении его потребуется заново указать в настройках реакций данный чат.
Список чатов
Ниже представлена таблица с информацией по каждому чату:
Название и ссылка на чат.
Тип чата (группа, супергруппа, канал, приватный чат).
Число участников.
Кнопка перехода к статистике активности.
Функция управления доступом по меткам, если включена.
Индивидуальные настройки чата
При переходе в настройки конкретного чата можно:
Активировать фильтрацию доступа по меткам.
Включить генерацию временных ссылок-приглашений с указанием интервала их обновления.
Отметить чат как «чат-менеджер» для использования в административных целях.
Раздел «Чаты» предназначен для гибкой настройки взаимодействия бота с сообществами Telegram, позволяя детально управлять его поведением, ограничивать или расширять функциональность в зависимости от нужд пользователя.
---
## Раздел "Пользователи" — обзор возможностей
URL: https://sambot.ru/support_razdel-polzovateli_25
Что есть в разделе "Пользователи" Sambot: поиск, фильтры, карточка пользователя, метки, параметры, импорт и экспорт, запуск реакций.
Раздел позволяет просматривать, фильтровать и управлять всеми пользователями, взаимодействовавшими с ботом. Можно отслеживать дату запуска бота, последние действия, диалоги, метки, параметры и статус. Доступен быстрый поиск по имени, ID, username, меткам и другим критериям.
Основные возможности:
Поиск и фильтрация: мощные фильтры по меткам, параметрам, активности, приватному чату и другим полям.
Карточка пользователя: история общения, действия бота и пользователя, текущие метки и параметры.
Редактирование данных: можно изменять или удалять метки и параметры, а также добавлять новые.
Групповые действия: массовое присвоение или удаление меток.
Избранное: быстрое добавление часто используемых пользователей для удобного доступа.
Импорт и экспорт: возможность загрузить базу пользователей или выгрузить её в файл с нужными параметрами.
Запуск реакций: возможность инициировать реакции и отправлять сообщения пользователям напрямую.
Раздел объединяет аналитику, управление и коммуникацию с пользователями в одном удобном интерфейсе.
Подробная информация по разделу по ссылке
---
## Раздел "Реакции"
URL: https://sambot.ru/support_razdel-reaktsii_27
Описание раздела "Реакции" в Sambot: триггеры, чаты, условия и действия. Узнайте, как автоматизировать ответы и действия бота в Telegram.
Раздел "Реакции"
Раздел "Реакции" в Sambot — это ядро логики бота, где настраиваются автоматические ответы и действия в ответ на определённые события. Каждая реакция состоит из триггера (что запускает), условий (при каких обстоятельствах сработает), области применения (в каких чатах) и действий (что сделает бот). Это позволяет создавать сложные и точные сценарии автоматизации общения с пользователями.
1. Срабатывает на:
Этот блок определяет, что запускает реакцию — какие события вызывают работу сценария.
Текстовое сообщение: включает фильтры по ключевым словам, ссылкам, email, username или любому тексту.
Медиа-сообщения: фото, видео, документы, голосовые, опросы и прочие вложения.
Системные события: добавление/удаление участников, реакции, изменения статуса и др.
Прочие триггеры: пересланные сообщения, ответ пользователю, наступление времени (запуск по времени - для рассылок), количество сообщений, запуск реакции по ссылке (start=id), получение внешнего веб-запроса.
2. В чатах:
Здесь задаётся, в каких чатах срабатывает реакция:
Указанные чаты: можно вручную задать список чатов.
Динамические чаты: чаты, ID которых сохранены в параметрах.
Дополнительное условие - реакция активна только при прямом обращении к боту по имени (имя бота можно задать в разделе "Настройки"). - Инструкция по настройке
3. Условия:
Дополнительные фильтры и логика, при которых реакция будет или не будет выполнена.
По меткам; параметрам; ID пользователей
По времени (период времени; время с момента появления пользователя в чате)
По количеству сообщений пользователя
Факт участия в чате - участник или не участник
Можно указать альтернативную реакцию, если условия не выполнены.
4. Действия:
Что бот сделает в ответ при срабатывании реакции:
Отправка сообщений: текстовые; сообщений с медиа, добавление кнопок, выставление задержки перед отправкой следующего действия, запуск параллельных сценариев через +реакции; настройка ответов от ИИ
Сохранение присланного сообщения в параметр
Изменение меток и параметров
Подключение интеграций: отправка данных в GetCourse, Google Таблицы, Google Диск, API-запросы
Модерация: удаление сообщений, изменение прав
Уведомления, запуск цепных реакций, переход к следующей реакции
---
## Раздел "Приём платежей"
URL: https://sambot.ru/support_razdel-priem-platezhey_37
Настройка приёма платежей в Telegram-боте: ЮKassa, Robokassa, Тинькофф, ЮMoney, Binance, Telegram Payments. Автоматическая обработка оплат.
Раздел предназначен для интеграции различных платёжных систем с ботом, чтобы пользователи могли оплачивать товары или услуги.
Это автоматизирует процесс продаж и повышает удобство для клиентов.
Платёжные системы, доступные к подключению:
ЮMoney | Яндекс.Деньги - Инструкция по подключению
ЮKassa
Robokassa - Промокод: SAMBOTRU даёт пониженную комиссия за платежи — 2.9%. Инструкция по подключению
Тинькофф
Prodamus - Промокод: SAMBOT даёт скидка 2000₽ на подключение. Инструкция по подключению
Telegram - настраивается в @BotFather в разделе Payments.
Telegram Stars
Binance
Каждая система имеет уникальные настройки: API-ключи, идентификаторы магазинов, налоговые параметры (система налогообложения, НДС), указание получателя средств для чеков и пр.
Поддерживается тестовый режим (например, для ЮKassa и Robokassa).
Самбот может автоматически обрабатывать информацию о получении платежа или вы можете самостоятельно отмечать получение оплаты в подразделе "Счета".
Для автоматической обработки нужно включить соответствующую функцию в настройках интеграции платёжной системы.
По умолчанию указана ручная обработка!
Подраздел "Счета"
На странице "Счета" отображаются выставленные ботом счета.
При нажатии на поле определённого счёта будет открыто окно с подробной информацией о нём. В этом окне можно:
проставить отметку о получении оплаты
увидеть ошибку при неуспешной оплате или настройке интеграции
---
## Раздел "Интеграции"
URL: https://sambot.ru/support_razdel-integratsii_39
Подключайте Google Таблицы, Google Диск, GetCourse и платформы ИИ к чат-боту. Расширьте функционал, автоматизируйте процессы — настройка и видео.
Интеграции
Раздел "Интеграции" предназначен для подключения внешних сервисов и автоматизации работы вашего бота.
Вы можете добавить и настроить интеграции с различными платформами:
📊 Google Таблицы
Сохраняйте данные пользователей в таблицах, обрабатывайте их с помощью встроенных функций. Получайте данные из таблицы в бот.
Видео-инструкция по настройке
Пример использования в боте
📁 Google Диск
Сохраняйте файлы на Google Диске. При загрузке на диск бот может сохранять ссылки на загружаемые файлы автоматически в параметрах пользователя или в Google Таблицах.
Видео-инструкция по настройке
🎓 GetCourse
Интеграция с платформой онлайн-обучения. Укажите название аккаунта и секретный ключ, чтобы подключить ваш бот к системе.
🤖 Искусственный интеллект
Добавьте AI-платформы для генерации текста, речи, изображений и других возможностей. Поддерживаются:
OpenAI — генерация текста, ассистенты, преобразование текста и речи, создание и редактирование изображений
ElevenLabs — текст в речь
Яндекс — генерация текста
Google AI — генерация контента
GoGPT, Perplexity, OpenRouter — Агрегаторы различных ИИ
---
## Как создать нового бота в @botfather и получить Токен
URL: https://sambot.ru/support_kak-sozdat-bota-v-botfather_2
Как сделать нового бота в @botfather и получить токен API для подключения к конструктору sambot.ru
Перейдите и 🔔 подпишитесь на наш обучающий Youtube-канал.
Инструкция по работе:
Найдите, откройте и запустите в Telegram бота с именем @BotFather.
Выберите или наберите команду /newbot и следуйте дальнейшим инструкциям.
Введите Название вашего нового бота, к примеру “Бот, который может все” (в дальнейшем это Название можно будет менять).
Введите Имя Пользователя, которое должно заканчиваться на bot или _bot, к примеру “moyperviybot” или “moyperviy_bot”. Это Имя Пользователя в дальнейшем нельзя будет заменить, поэтому основательно продумайте это название.
Если вы видите ответ “Sorry...”, это означает, что такое Имя Пользователя уже занято, как и в нашем примере ниже. Вам нужно придумать другое, мы указали "moyvtoroybot". Оно оказалось свободным и система написала нам фразу с поздравлением: “Done! Congratulations on your new bot”.
Теперь вам нужно скопировать ключ API, который идет после фразы “Use this token to access the HTTP API:” и состоит из цифр, двоеточия и сочетаний букв и цифр.
Вставьте ключ API поле Токен, при добавлении бота телеграм в наш конструктор.
С этого момента конструктор будет связан с вашим ботом и сможет наделить его необходимым функционалом.
Никому не сообщайте Токен API от своего бота, чтобы им не воспользовались злоумышленники!
👉 Перейти к Добавлению бота
👉 Вернуться в Справку
---
## Формулы для работы с параметрами
URL: https://sambot.ru/support_formuly-dlya-raboty-s-parametrami_69
Все формулы Sambot: математические, текстовые, логические, работа с JSON, датами и массивами. Примеры для создания умных и мощных ботов.
Это расширенная инструкция по внутренним функциям конструктора ботов Самбот с понятными примерами.
Математические операции
Сложение (+)
Оператор сложения позволяет складывать числа. Вы можете использовать его для сложения фиксированных чисел или значений из параметров.
Пример 1: Сложение фиксированных чисел
10 + 5 = 15
Пример 2: Сложение числа с параметром
Предположим, у пользователя в параметре {user:количество_товаров} хранится значение "3".
{user:количество_товаров} + 2 = 5
Пример 3: Сложение двух параметров
Предположим, у пользователя в {user:баланс_бонусов} хранится "100", а в {user:подарки} - "50".
{user:баланс_бонусов} + {user:подарки} = 150
Вычитание (-)
Оператор вычитания позволяет вычитать одно число из другого.
Пример 1: Вычитание фиксированного числа из параметра
Предположим, у пользователя в параметре {user:баланс} хранится "100".
{user:баланс} - 25 = 75
Пример 2: Вычитание одного параметра из другого
Предположим, у пользователя в {user:общая_сумма} хранится "500", а в {user:скидка} - "100".
{user:общая_сумма} - {user:скидка} = 400
Умножение (*)
Оператор умножения используется для умножения чисел.
Пример 1: Умножение параметра из Google Sheets на число
Предположим, в ячейке A1 таблицы Google Sheets с ID(внутренний id на платформе) 258 хранится значение "5".
{googlesheets:258:A1} * 100 = 500
Пример 2: Умножение двух параметров
Предположим, в {user:цена} хранится "20", а в {user:количество} - "3".
{user:цена} * {user:количество} = 60
Деление (/)
Оператор деления используется для деления чисел.
Пример 1: Деление одного параметра на другой
Предположим, у пользователя в {user:счёт} хранится "20", а в {user:делитель} - "10".
{user:счёт} / {user:делитель} = 2
Пример 2: Деление параметра на фиксированное число
Предположим, в {user:общее_количество} хранится "150".
{user:общее_количество} / 3 = 50
Работа со строками
Объединение (&)
Оператор объединения (конкатенации) позволяет соединять текстовые строки.
Пример 1: Объединение текста и параметра
Предположим, у пользователя в {first_name} хранится "Артём".
"Имя: " & {first_name} = "Имя: Артём"
Пример 2: Объединение нескольких параметров и текста
Предположим, в {last_name} хранится "Иванов", а в {user:city} - "Москва".
{first_name} & " " & {last_name} & ", город: " & {user:city} = "Артём Иванов, город: Москва"
ДЛСТР (LEN)
Функция ДЛСТР (LEN) возвращает количество символов в текстовой строке.
Пример 1: Длина фиксированной строки
ДЛСТР("текст") = 5
Пример 2: Длина строки из параметра
Предположим, в {user:сообщение} хранится "Привет!".
ДЛСТР({user:сообщение}) = 7
Логические функции
ЕСЛИ (IF)
Функция ЕСЛИ (IF) позволяет выполнять логическую проверку. Если условие истинно, она возвращает одно значение; если ложно — другое.
Синтаксис: ЕСЛИ(условие; значение_если_истина; значение_если_ложь)
Пример 1: Проверка роста пользователя
Предположим, у пользователя в {user:Рост} хранится "176". Проверим рост, и если рост пользователя больше 160, то запишем "высокий", иначе - запишем "низкий"
ЕСЛИ({user:Рост} > 160; "высокий"; "низкий") = "высокий"
Пример 2: Проверка наличия товара на складе
Предположим, в {user:количество_на_складе} хранится "0".
ЕСЛИ({user:количество_на_складе} > 0; "Товар в наличии"; "Нет в наличии") = "Нет в наличии"
ЕЧИСЛО (ISNUMBER)
Функция ЕЧИСЛО (ISNUMBER) проверяет, является ли значение числом. Возвращает 1 (истина), если это число, и 0 (ложь), если нет.
Пример 1: Проверка числа
ЕЧИСЛО(2) = 1
Пример 2: Проверка текста
ЕЧИСЛО("abc") = 0
Пример 3: Использование с параметром
Предположим, в {user:возраст} хранится "25".
ЕЧИСЛО({user:возраст}) = 1
Если в {user:возраст} хранится "двадцать пять".
ЕЧИСЛО({user:возраст}) = 0
И (AND)
Функция И (AND) возвращает 1 (истина), если все условия, указанные в ней, выполняются. В противном случае возвращает 0 (ложь).
Синтаксис: И(условие1; условие2; ...)
Пример 1: Проверка нулевого баланса и баллов
Предположим, у пользователя в {user:Баланс} и {user:Баллы} хранится "0".
И({user:Баланс} = 0; {user:Баллы} = 0) = 1
Пример 2: Проверка возраста и города
Предположим, в {user:возраст} хранится "18", а в {user:город} - "Санкт-Петербург".
И({user:возраст} >= 18; {user:город} = "Москва") = 0
В данном случае второе условие не выполняется.
ИЛИ (OR)
Функция ИЛИ (OR) возвращает 1 (истина), если хотя бы одно из указанных условий выполняется. В противном случае возвращает 0 (ложь).
Синтаксис: ИЛИ(условие1; условие2; ...)
Пример 1: Проверка положительного баланса или баллов
Предположим, у пользователя в {user:Баланс} хранится "50", а в {user:Баллы} - "0".
ИЛИ({user:Баланс} > 0; {user:Баллы} > 0) = 1
В этом случае условие {user:Баланс} > 0 истинно, поэтому функция возвращает 1.
Пример 2: Проверка скидки или акции
Предположим, в {user:есть_скидка} хранится "нет", а в {user:участвует_в_акции} - "да".
ИЛИ({user:есть_скидка} = "да"; {user:участвует_в_акции} = "да") = 1
Функции И и ИЛИ удобно использовать совместно с функцией ЕСЛИ для проверки нескольких условий и выдачи результатов при истинности или ложность проверки.
Например: Если возраст пользователя больше 18 лет, и он проживает в городе Санкт-Петербург, то он может посетить выставку в музее. Иначе не может.
Так будет выглядеть составная формула для этого примера:
ЕСЛИ(И({user:возраст} >= 18; {user:город} = "Москва"); "Может посетить выставку"; "Не может посетить выставку") = Не может посетить выставку
Функции для чисел
МИН (MIN)
Функция МИН (MIN) возвращает наименьшее значение из списка чисел.
Синтаксис: МИН(число1; число2; ...)
Пример 1: Минимальное из фиксированных чисел
МИН(1; 2; 3) = 1
Пример 2: Минимальное значение среди параметров
Предположим, в {user:стоимость_товара1} хранится "100", а в {user:стоимость_товара2} - "75".
МИН({user:стоимость_товара1}; {user:стоимость_товара2}; 50) = 50
Пример 3: Минимальное значение среди значений параметра с типом "хранить все значения"
Предположим, в {user:числа} хранятся значения "4, 12, 2, 89, 23, 17"
МИН({user:стоимость_товара1:1-}) = 2
МАКС (MAX)
Функция МАКС (MAX) возвращает наибольшее значение из списка чисел.
Синтаксис: МАКС(число1; число2; ...)
Пример 1: Максимальное из фиксированных чисел
МАКС(1; 2; 3) = 3
Пример 2: Максимальное значение среди параметров
Предположим, в {user:рейтинг1} хранится "4", а в {user:рейтинг2} - "5".
МАКС({user:рейтинг1}; {user:рейтинг2}; 3) = 5
ОКРУГЛ (ROUND)
Функция ОКРУГЛ (ROUND) округляет число до указанного количества десятичных знаков.
Синтаксис: ОКРУГЛ(число; количество_знаков)
Пример 1: Округление до двух знаков после запятой
ОКРУГЛ(3.1415926535; 2) = 3.14
Пример 2: Округление до целого числа (ноль знаков)
ОКРУГЛ(7.89; 0) = 8
Пример 3: Округление с использованием параметра
Предположим, в {user:стоимость_с_ндс} хранится "123.456".
ОКРУГЛ({user:стоимость_с_ндс}; 1) = 123.5
ПИ (PI)
Функция ПИ (PI) возвращает значение числа Пи (π) с высокой точностью. Не требует аргументов.
Пример:
ПИ() = 3.141592653589793
СРЗНАЧ (AVERAGE)
Функция СРЗНАЧ (AVERAGE) вычисляет среднее арифметическое для набора числовых значений. Вы можете передавать как фиксированные числа, так и значения из параметров.
Синтаксис: СРЗНАЧ(число1; число2; ...)
Пример 1: Среднее арифметическое фиксированных чисел и параметра
Предположим, в ячейке A1 таблицы Google Sheets с ID 111 хранится значение "9".
СРЗНАЧ(2; 4; {googlesheets:111:A1}) = 5
(Расчёт: (2 + 4 + 9) / 3 = 5)
Пример 2: Среднее арифметическое из нескольких параметров
Предположим, в {user:оценка1} хранится "8", а в {user:оценка2} - "7".
СРЗНАЧ({user:оценка1}; {user:оценка2}; 9) = 8
(Расчёт: (8 + 7 + 9) / 3 = 8)
СУММ (SUM)
Функция СУММ (SUM) суммирует все числовые значения, переданные в качестве аргументов.
Синтаксис: СУММ(число1; число2; ...)
Пример 1: Сумма фиксированных чисел и параметра
Предположим, у пользователя в параметре {user:Число} хранится значение "3".
СУММ(1; 2; {user:Число}) = 6
(Расчёт: 1 + 2 + 3 = 6)
Пример 2: Сумма значений из нескольких параметров
Предположим, в {user:расход_продукты} хранится "500", а в {user:расход_транспорт} - "150".
СУММ({user:расход_продукты}; {user:расход_транспорт}; 200) = 850
RANDBETWEEN (СЛУЧМЕЖДУ)
Функция СЛУЧМЕЖДУ (RANDBETWEEN) генерирует случайное целое число в заданном диапазоне, включая оба граничных значения.
Синтаксис: СЛУЧМЕЖДУ(нижнее_значение; верхнее_значение)
Пример 1: Случайное число от 1 до 10
СЛУЧМЕЖДУ(1; 10) = 7 (может быть любое число от 1 до 10)
Пример 2: Случайное число для ID заказа
СЛУЧМЕЖДУ(1000; 9999) = 5432 (например, для генерации четырёхзначного ID)
Функции для поиска в тексте
НАЙТИ (FIND)
Функция НАЙТИ (FIND) возвращает начальную позицию (порядковый номер символа) первого вхождения искомой подстроки в тексте. Учитывает регистр символов. Вы можете указать необязательный аргумент "начальная_позиция" для поиска, начиная с определенного символа.
Синтаксис: НАЙТИ(искомая_подстрока; текст; [начальная_позиция])
Пример 1: Поиск с учетом регистра
НАЙТИ("грека"; "Ехал грека через реку, видит грека – в реке рак"; 1) = 6
(Поиск начинается с 1-го символа. "грека" находится, начиная с 6-го символа)
Пример 2: Поиск, начиная с определенной позиции
НАЙТИ("грека"; "Ехал грека через реку, видит грека – в реке рак"; 10) = 30
(Поиск начинается с 10-го символа. Первое вхождение "грека" после 10-го символа начинается с 30-го символа)
Пример 3: Использование с параметрами
Предположим, в {user:фраза} хранится "Яблоко и банан".
НАЙТИ("банан"; {user:фраза}; 1) = 10
ПОИСК (SEARCH)
Функция ПОИСК (SEARCH) также возвращает начальную позицию первого вхождения искомой подстроки, но, в отличие от НАЙТИ, она не учитывает регистр символов. Так же имеет необязательный аргумент "начальная_позиция".
Синтаксис: ПОИСК(искомая_подстрока; текст; [начальная_позиция])
Пример 1: Поиск без учета регистра
ПОИСК("хвост"; "Нос крючком, Хвост пятачком"; 1) = 14
(Несмотря на то, что в тексте "Хвост" написан с заглавной буквы, функция находит его, начиная с 14-го символа.)
Пример 2: Поиск, начиная с определенной позиции, без учета регистра
ПОИСК("мир"; "Привет, Мир! Как дела, мир?"; 10) = 24
(Поиск "мир" начинается с 10-го символа. Первое вхождение "мир" после 10-го символа начинается с 24-го символа.)
Функции для работы с JSON
TOJSON
Функция TOJSON преобразует переданное значение (например, список из параметра) в строку в формате JSON. Это полезно для передачи данных в другие системы или для работы с JSON-структурами.
Синтаксис: TOJSON(значение)
Пример 1: Преобразование параметра с типом "хранить все значения" в JSON-массив
Предположим, параметр {user:Языки:1-} содержит значения "Английский", "Русский", "Тайский".
TOJSON({user:Языки:1-}) = "["Английский", "Русский", "Тайский"]"
Пример 2: Преобразование одиночного значения в JSON-строку
TOJSON("Привет") = "Привет"
Пример 3: Преобразование числа в JSON-число
TOJSON(123) = "123"
FROMJSON
Функция FROMJSON выполняет обратное действие: она преобразует строку в формате JSON обратно в соответствующий тип данных (например, массив или объект).
Синтаксис: FROMJSON(JSON_строка)
Пример 1: Преобразование JSON-массива в список и его объединение
JOIN(", "; FROMJSON("["Английский", "Русский", "Тайский"]")) = "Английский, Русский, Тайский"
Здесь FROMJSON превращает строку в список, который затем JOIN объединяет в одну строку
Пример 2: Преобразование JSON-массива в список БЕЗ объединения
FROMJSON("["Английский", "Русский", "Тайский"]") = "Тайский"
ВАЖНО! Как можно заметить, в результат записалось только одно значение - "Тайский". То есть в параметр сохранится последний элемент массива. Так работает для параметра с типом "Хранить последнее значение".
Если тип параметр будет "Хранить первое значение", то в результат запишется первый элемент массива "Английский.
А если тип параметра "Хранить все значения", то в результат будут записаны все элементы массива по очереди.
JSONPATH
Функция JSONPATH позволяет извлекать данные из JSON-структуры, используя синтаксис JSONPath. Это мощный инструмент для навигации по сложным JSON-объектам и массивам.
Синтаксис: JSONPATH(JSON_данные; JSONPath_выражение; [значение_по_умолчанию])
JSON_данные могут быть либо строкой JSON, либо результатом функции FROMJSON.
значение_по_умолчанию - необязательный аргумент, который будет возвращён, если путь не найден.
Пример 1: Извлечение всех ID из списка объектов
TOJSON(JSONPATH("{"ids":[{"id":1},{"id":3}]}"; "$.ids..id")) = "[1,3]"
Здесь "$.ids..id" означает: "взять элемент ids, затем найти все элементы с ключом id внутри него, независимо от вложенности". Результатом будет массив [1, 3], который TOJSON преобразует в строку.
Пример 2: Комбинирование FROMJSON и JSONPATH
TOJSON(JSONPATH(FROMJSON("{"ids":[{"id":1},{"id":3}]}"); "$.ids..id")) = "[1,3]"
Это эквивалентно предыдущему примеру, но демонстрирует типичное использование FROMJSON для парсинга строки в JSON-объект, прежде чем применить JSONPATH.
Пример 3: Использование значения по умолчанию
JSONPATH("{"; "$.id"; "error") = "error"
Здесь JSON-строка некорректна (просто {), путь $.id не может быть найден, и функция возвращает "error".
JSONPATHSMART (JP)
Функция JSONPATHSMART (или её короткий псевдоним JP) является более удобным способом для извлечения значений из JSON. Она автоматически пытается преобразовать переданную строку в JSON, если это возможно, что упрощает её использование.
Синтаксис: JSONPATHSMART(JSON_строка_или_объект; JSONPath_выражение)
Пример 1: Извлечение значения по ключу
JSONPATHSMART("{"key": "value"}"; "$.key") = "value"
Пример 2: Использование короткого псевдонима
JP("{"key": "value"}"; "$.key") = "value"
Пример 3: Извлечение элемента из массива по индексу
JP("{"data":["a","b","c"]}"; "$.data[1]") = "b"
Функции для работы с датами и временем
Самбот работает с датами в формате d.m.Y H:i:s (день.месяц.год часы:минуты:секунды).
DATEVALUE
Функция DATEVALUE пытается преобразовать текстовую строку в дату и время в стандартном формате Самбота. Если строка не может быть преобразована, результат не будет возвращён.
Синтаксис: DATEVALUE(строка_даты_времени)
Пример 1: Преобразование даты без времени
DATEVALUE("01.02.2024") = "01.02.2024 00:00:00"
Пример 2: Преобразование даты с временем
DATEVALUE("25.12.2023 14:30:00") = "25.12.2023 14:30:00"
Пример 3: Преобразование из другого формата (может зависеть от региональных настроек)
Хотя официальный формат d.m.Y, иногда система может распознавать другие распространённые форматы.
DATEVALUE("2024-02-01") = "01.02.2024 00:00:00" (если формат распознан)
DATEADD
Функция DATEADD увеличивает (добавляет) к заданной дате указанный интервал времени. Интервал задаётся в формате ISO 8601 Duration.
Синтаксис: DATEADD(дата; интервал)
Пример 1: Добавление одного дня
DATEADD("01.02.2024"; "P1D") = "02.02.2024 00:00:00"
(P1D означает "Период 1 День")
Пример 2: Добавление 5 часов и 30 минут
DATEADD("01.02.2024 10:00:00"; "PT5H30M") = "01.02.2024 15:30:00"
(PT5H30M означает "Период Времени 5 Часов 30 Минут")
Пример 3: Добавление 1 года и 2 месяцев
DATEADD("01.01.2024"; "P1Y2M") = "01.03.2025 00:00:00"
DATESUB
Функция DATESUB уменьшает (вычитает) из заданной даты указанный интервал времени. Интервал также задаётся в формате ISO 8601 Duration.
Синтаксис: DATESUB(дата; интервал)
Пример 1: Вычитание одного дня
DATESUB("01.02.2024"; "P1D") = "31.01.2024 00:00:00"
Пример 2: Вычитание 2 недель
DATESUB("15.03.2024 12:00:00"; "P2W") = "01.03.2024 12:00:00"
(P2W означает "Период 2 Недели")
DATEDIF (РАЗНДАТ)
Функция DATEDIF (РАЗНДАТ) вычисляет разницу между двумя датами в указанных единицах.
Синтаксис: DATEDIF(начальная_дата; конечная_дата; единица_измерения)
Доступные единицы измерения:
Y: Годы (полные)
M: Месяцы (полные)
D: Дни
H: Часы
I: Минуты
S: Секунды
MD: Разница в днях, без учёта месяцев и лет
YM: Разница в месяцах, без учёта лет
YD: Разница в днях, без учёта годов
Пример 1: Разница в полных годах
DATEDIF("28.10.1981"; "01.02.2024"; "Y") = 42
Пример 2: Разница в полных месяцах
DATEDIF("28.10.2020"; "28.09.2024"; "M") = 47
Пример 3: Разница в днях
DATEDIF("28.10.2023"; "27.10.2024"; "D") = 365
Пример 4: Разница в часах
DATEDIF("27.10.2024 12:00:00"; "28.10.2024 11:30:00"; "H") = 23
Пример 5: Разница в минутах
DATEDIF("28.10.2024 12:00:00"; "28.10.2024 12:30:00"; "I") = 30
Пример 6: Разница в секундах
DATEDIF("28.10.2024 12:00:00"; "28.10.2024 12:00:45"; "S") = 45
Пример 7: Разница в днях без учёта месяцев и лет (для дней рождения)
DATEDIF("28.10.1981"; "27.10.2024"; "MD") = 29
Пример 8: Разница в месяцах без учёта годов
DATEDIF("28.10.1981"; "27.10.2024"; "YM") = 11
Пример 9: Разница в днях без учёта годов
DATEDIF("28.10.1981"; "27.10.2024"; "YD") = 365
DATEFORMAT
Функция DATEFORMAT позволяет форматировать дату и время в различных представлениях, используя специальные символы форматирования. Также можно указать язык для названий дней недели и месяцев.
Синтаксис: DATEFORMAT(дата; формат; [язык])
Символы форматирования (примеры, полный список по ссылке):
j: День месяца без ведущего нуля (1-31)
d: День месяца с ведущим нулём (01-31)
D: Краткое название дня недели (Пн, Вт...)
l: Полное название дня недели (Понедельник, Вторник...)
n: Номер месяца без ведущего нуля (1-12)
m: Номер месяца с ведущим нулём (01-12)
M: Краткое название месяца (янв, фев...)
F: Полное название месяца (Январь, Февраль...)
f: Полное название месяца в родительном падеже (января, февраля...) - часто используется в русском языке
N: Номер дня недели (1 для понедельника, 7 для воскресенья)
y: Год в двух цифрах (81)
Y: Год в четырёх цифрах (1981)
W: Номер недели года (например, 23)
z: День года (от 0 до 365)
H: Часы в 24-часовом формате (00-23)
i: Минуты (00-59)
s: Секунды (00-59)
U: Преобразует дату в UNIX формат
Пример 1: Форматирование с различными элементами даты/времени
DATEFORMAT("05.06.1981 10:22:53"; "j, d, D, l, n, m, M, F, f, N, y, Y, W, z") = "5, 05, Fri, Friday, 6, 06, Jun, June, June, 5, 81, 1981, 23, 155"
(Обратите внимание, что f даёт "June" в английском, но для русского будет склоняться)
Пример 2: Форматирование с указанием английского языка
DATEFORMAT("05.06.1981 10:22:53"; "j, d, D, l, n, m, M, F, f, N, y, Y, W, z"; "en") = "5, 05, Fri, Friday, 6, 06, Jun, June, June, 5, 81, 1981, 23, 155"
Пример 3: Форматирование с указанием русского языка
DATEFORMAT("05.06.1981 10:22:53"; "j, d, D, l, n, m, M, F, f, N, y, Y, W, z"; "ru") = "5, 05, Пт, Пятница, 6, 06, июн, июня, июнь, 5, 81, 1981, 23, 155"
Здесь видно, как D, l, M, F, f изменяются в зависимости от языка.
Пример 4: Вывод текущей даты и времени в формате "DD.MM.YYYY HH:MM"
DATEFORMAT(DATEVALUE({user:date_time}); "d.m.Y H:i")
(Предполагается, что {user:date_time} содержит текущее время, и DATEVALUE его корректно парсит)
Функции для сортировки и кодирования
SORT
Функция SORT сортирует переданные значения по возрастанию (алфавитному для строк, числовому для чисел).
Синтаксис: SORT(значение1; значение2; ...)
Пример 1: Сортировка смешанных типов данных
JOIN(", "; SORT("10"; "1"; "2"; "a"; "c"; "b")) = "1, 2, 10, a, b, c"
(Числа сортируются как числа, строки как строки, затем числовые значения идут перед строковыми)
RSORT
Функция RSORT сортирует переданные значения по убыванию (в обратном алфавитном порядке для строк, в обратном числовом для чисел).
Синтаксис: RSORT(значение1; значение2; ...)
Пример 1: Обратная сортировка смешанных типов данных
JOIN(", "; RSORT("10"; "1"; "2"; "a"; "c"; "b")) = "c, b, a, 10, 2, 1"
TOBASE64
Функция TOBASE64 кодирует текстовую строку в формат Base64. Используется для безопасной передачи бинарных данных или текста.
Синтаксис: TOBASE64(строка)
Пример:
TOBASE64("test") = "dGVzdA=="
FROMBASE64
Функция FROMBASE64 декодирует строку из формата Base64 обратно в исходную текстовую строку.
Синтаксис: FROMBASE64(Base64_строка)
Пример:
FROMBASE64("dGVzdA==") = "test"
Функции для работы с массивами (списками)
ARRAYFIND
Функция ARRAYFIND находит индекс (позицию) элемента в массиве. Нумерация индексов начинается с 0. Вы можете искать по конкретному значению или использовать лямбда-функцию для более сложного условия поиска.
Синтаксис:
ARRAYFIND(массив; значение)
ARRAYFIND(массив; LAMBDA(val; [key]; условие)) – val и key это аргументы лямбда-функции и вы можете их назвать как вам удобно в ваших формулах. Val - это значение в массиве, key - это индекс этого значения
Пример 1: Поиск по значению
ARRAYFIND(FROMJSON("[1, 5, 12]"); 5) = 1
(Элемент 5 находится по индексу 1 в массиве [1, 5, 12])
Пример 2: Поиск с использованием лямбда-функции (по значению)
ARRAYFIND(FROMJSON("[1, 5, 12]"); LAMBDA(x, x = 5)) = 1
(Лямбда-функция LAMBDA(x, x = 5) проверяет, равно ли значение x пяти.)
Пример 3: Поиск с использованием лямбда-функции (по индексу)
Предположим, нужно найти элемент на определённой позиции.
ARRAYFIND(FROMJSON("[1, 5, 12]"); LAMBDA(val; key; key = 2)) = 2
(Лямбда-функция LAMBDA(val; key; key = 2) проверяет, равен ли индекс key двум. В данном случае, это значение 12.)
ARRAYREMOVE
Функция ARRAYREMOVE удаляет элемент из массива по значению или по условию, заданному лямбда-функцией. Возвращает новый массив без удалённых элементов.
Синтаксис:
ARRAYREMOVE(массив; значение)
ARRAYREMOVE(массив; LAMBDA(val; [key]; условие))
Пример 1: Удаление по значению
TOJSON(ARRAYREMOVE(FROMJSON("[1, 5, 12]"); 5)) = "[1,12]"
(Удаляется значение 5.)
Пример 2: Удаление с использованием лямбда-функции (по значению)
TOJSON(ARRAYREMOVE(FROMJSON("[1, 5, 12]"); LAMBDA(val; key; val = 5))) = "[1,12]"
(Эквивалентно предыдущему, но с лямбдой.)
Пример 3: Удаление с использованием лямбда-функции (по индексу)
TOJSON(ARRAYREMOVE(FROMJSON("[1, 5, 12]"); LAMBDA(val; key; key = 2))) = "[1,5]"
(Удаляется элемент с индексом 2 (значение 12).)
ARRAYADD
Функция ARRAYADD добавляет элемент в массив. Вы можете добавить его в конец массива или по указанному индексу.
Синтаксис:
ARRAYADD(массив; элемент) (добавляет в конец)
ARRAYADD(массив; элемент; индекс) (добавляет по указанному индексу)
Пример 1: Добавление элемента в конец массива
TOJSON(ARRAYADD(FROMJSON("[1, 5, 12]"); 11)) = "[1,5,12,11]"
Пример 2: Добавление элемента по определённому индексу
TOJSON(ARRAYADD(FROMJSON("[1, 5, 12]"); 11; 1)) = "[1,11,5,12]"
(Элемент 11 добавляется на позицию с индексом 1.)
ARRAYREPLACE
Функция ARRAYREPLACE заменяет элемент в массиве по указанному индексу.
Синтаксис: ARRAYREPLACE(массив; новый_элемент; индекс)
Пример:
TOJSON(ARRAYREPLACE(FROMJSON("[1, 5, 12]"); 11; 1)) = "[1,11,12]"
(Элемент по индексу 1 (было 5) заменяется на 11.)
FOREACH
Функция FOREACH выполняет итерацию по каждому элементу массива и применяет к нему лямбда-функцию. Возвращает новый массив, содержащий результаты применения лямбда-функции к каждому элементу.
Синтаксис: FOREACH(массив; LAMBDA(val; [key]; выражение))
Пример 1: Добавление префикса к каждому значению
JOIN(", "; FOREACH(FROMJSON("[1, 5, 12]"); LAMBDA(val; "значение: "&val))) = "значение: 1, значение: 5, значение: 12"
(К каждому числовому значению добавляется строка "значение: ", и все значение объединяются в одну строку функцией JOIN)
Пример 2: Форматирование вывода с использованием индекса и значения
JOIN(", "; FOREACH(FROMJSON("[1, 5, 12]"); LAMBDA(val; key; key&": "&val))) = "0: 1, 1: 5, 2: 12"
(Для каждого элемента создаётся строка "индекс: значение".)
Функции для работы со строками (регистр)
UPPER (ПРОПИСН)
Функция UPPER (ПРОПИСН) преобразует все символы текстовой строки в верхний регистр.
Синтаксис: UPPER(строка)
Пример:
UPPER("test") = "TEST"
LOWER (СТРОЧН)
Функция LOWER (СТРОЧН) преобразует все символы текстовой строки в нижний регистр.
Синтаксис: LOWER(строка)
Пример:
LOWER("TEST") = "test"
UPPERFIRST (ПРОПИСНПЕРВ)
Функция UPPERFIRST (ПРОПИСНПЕРВ) преобразует только первый символ строки в верхний регистр, оставляя остальные символы без изменений.
Синтаксис: UPPERFIRST(строка)
Пример:
UPPERFIRST("test") = "Test"
UPPERFIRST("another test") = "Another test"
Функции для создания JSON-структур
JSONOBJECT
Функция JSONOBJECT создаёт JSON-объект из переданных пар "ключ-значение".
Синтаксис: JSONOBJECT(ключ1; значение1; ключ2; значение2; ...)
Пример:
TOJSON(JSONOBJECT("ключ1"; "значение1"; "ключ2"; "значение2")) = {"ключ1":"значение1","ключ2":"значение2"}
Пример 2: Создание объекта пользователя из параметров
Предположим, в {user:имя} хранится "Анна", а в {user:возраст} - "28".
TOJSON(JSONOBJECT("name"; {user:имя}; "age"; {user:возраст}; "is_active"; true)) = "{"name":"Анна","age":"28","is_active":true}"
JSONARRAY
Функция JSONARRAY создаёт JSON-массив из переданных значений.
Синтаксис: JSONARRAY(значение1; значение2; ...)
Пример:
TOJSON(JSONARRAY("значение1"; "значение2")) = "["значение1","значение2"]"
Пример 2: Создание массива из значений параметра
Предположим, {user:выбранные_товары:1-} содержит "Молоко", "Хлеб".
TOJSON(JSONARRAY({user:выбранные_товары:1-})) = ОШИБКА
Будет ошибка, так как функция JSONARRAY должна содержать не менее двух аргументов. В данном случае запись {user:выбранные_товары:1-} это один аргумент в виде строки "Молоко, Хлеб"
Вспомогательные функции
NL
Функция NL() возвращает символ новой строки (\n). Это полезно для форматирования текста в сообщениях бота или для создания многострочных записей в параметрах.
Синтаксис: NL()
Пример 1: Использование для создания новой строки
"Строка 1" & NL() & "Строка 2" = "Строка 1
Строка 2"
Пример 2: Объединение элементов параметра с новой строки
Предположим, в {user:param:1-} содержатся значения 1, 5, 12.
JOIN(NL(); {user:param:1-}) = "1
5
12"
Функции для работы с параметрами
PARAMID
Функция PARAMID возвращает внутренний ID конкретного значения параметра. Это особенно полезно для параметров с типом "хранить все значения", где каждое сохранённое значение имеет свой уникальный ID. Вы можете найти ID по порядковому номеру значения (позиции) в параметре или по условию, используя лямбда-функцию. В отличии от массивов, позиция значения для функций этого раздела начинается с 1 (единицы).
Этот ID необходим только для работы с функциями PARAM..
Важно: Первый аргумент функции — название параметра в кавычках, без фигурных скобок.
Синтаксис:
PARAMID("название_параметра"; позиция_значения) (позиция начинается с 1)
PARAMID("название_параметра"; LAMBDA(val; [key]; условие))
Пример 1: Получение ID первого значения параметра
Предположим {user:param} содержит значения: test, 3, value. Внутренние ID у этих параметров 3, 23, 24 соответственно.
PARAMID("user:param"; 1) = 3
Возвращает ID первого значения параметра
Пример 2: Получение ID значения по его содержимому
Если {user:param} содержит значение "test".
PARAMID("user:param"; LAMBDA(v; k; v = "test")) = 3
Возвращает ID того значения, которое равно "test". Если таких значений несколько:
– при сохранении в параметр "хранить первой значение" вернёт ID первого найденного значения
– при сохранении в параметр "хранить последнее значение" вернёт ID последнего найденного значения
– при сохранении в параметр "хранить все значения" вернёт ID всех найденных значения, записав их по очереди
Пример 3: Получение ID по определённому индексу
Если {user:param} содержит значения: test, 3, value. Внутренние ID у этих параметров 3, 23, 24 соответственно.
PARAMID("user:param"; LAMBDA(v; k; k = 2)) = 23
Возвращает ID значения на позиции с индексом 2 (то есть второго элемента), если такой существует.
PARAMREMOVE
Функция PARAMREMOVE удаляет значение параметра по его ID. Это мощная функция для управления параметрами с типом "хранить все значения"
В режимах параметра "хранить первое/последнее/все значение(я)" она возвращает (сохраняет в указанный в названии параметр) количество удаленных значений.
В режиме "Изменение значения" удаляет значение параметра без сохранения дополнительной информации (просто очищает его).
Синтаксис: PARAMREMOVE(ID_значения_параметра)
Пример 1: Удаление по конкретному ID
Предположим, вы ранее получили ID значения = 3 с помощью PARAMID.
PARAMREMOVE(3) = 1
Удаляет значение параметра с ID = 3 и возвращает 1, так как было удалено одно значение.
Пример 2: Удаление значений по условию (через LAMBDA и PARAMID)
Если {user:Параметр3} с типом "хранить все значения" содержит значения: 2, 3, 14, 3, 2
PARAMREMOVE(PARAMID("user:Параметр3"; LAMBDA(val; key; val < 3))) = 2
(Сначала PARAMID найдёт ID всех значений, которые меньше 3 (то есть 2 и 2). Затем PARAMREMOVE удалит эти значения. Вернёт 2, так как было удалено два значения.)
Пример 3: Удаление значения по индексу (через LAMBDA и PARAMID)
Если {user:Параметр3} содержит значения: 2, 3, 14, 3, 2.
PARAMREMOVE(PARAMID("user:Параметр3"; LAMBDA(val; key; key = 3))) = 1
(Удаляет значение, которое находится на позиции с индексом 3 (третий элемент = 14). Возвращает 1.)
PARAMREPLACE
Функция PARAMREPLACE заменяет существующее значение параметра на новое. Как и PARAMREMOVE, она работает с ID значений параметра.
В режимах параметра "хранить первое/последнее/все значение(я)" она возвращает количество заменённых значений.
В режиме "Изменение значения" заменяет значение параметра без сохранения дополнительной информации.
Синтаксис: PARAMREPLACE("название_параметра"; новое_значение; ID_значения_параметра_или_условие)
Пример 1: Замена по конкретному ID
Предположим, мы хотим заменить значение параметра user:Параметр3 с ID = 1 на "новое значение".
PARAMREPLACE("user:Параметр3"; "новое значение"; 1) = 1
Заменяет значение с ID = 1 и возвращает 1.
Пример 2: Замена значений по условию (через LAMBDA)
Если {user:Параметр3} содержит значения: 2, 3, 14, 3, 2.
PARAMREPLACE("user:Параметр3"; "новое значение"; LAMBDA(val; key; val = 3)) = 2
Найдет все значения, равные 3, и заменит их на "новое значение". Возвращает 2, так как было заменено два значения. В параметре будут значения 2, новое значение, 14, новое значение, 2
Пример 3: Замена значения по индексу (через LAMBDA)
Если {user:Параметр3} содержит значения: 2, 3, 14, 3, 2.
PARAMREPLACE("user:Параметр3"; "новое значение"; LAMBDA(val; key; key = 4)) = 1
Заменит значение на позиции с индексом 4 (четвертый элемент = 3). Возвращает 1.
HASH (ХЭШ)
Функция HASH (ХЭШ) преобразует заданную текстовую строку в криптографический хеш, используя указанный алгоритм. Хеширование — это односторонний процесс, который создаёт уникальный "отпечаток" данных фиксированной длины. Это полезно для проверки целостности данных, безопасного хранения паролей (когда сравнивается не сам пароль, а его хеш) и других задач, где нужно быстро сравнить данные без их прямого раскрытия.
Синтаксис: HASH(алгоритм; строка)
Доступные алгоритмы:
"md5"
"sha1"
"sha224"
"sha256"
"sha384"
"sha512"
Пример 1: MD5 хеш для строки "text"
HASH("md5"; "text") = "1cb251ec0d568de6a4bf74534882e989"
Пример 2: SHA256 хеш для строки "Hello World!"
HASH("sha256"; "Hello World!") = "c0535e4be2b79ffd93291305436bf889314e4ffcd5e06dffbe8ef9e0816993c8"
Пример 3: Сравнение хешей для проверки пароля (в сценарии бота)
Предположим, у вас в базе хранится SHA256 хеш пароля "secretpass", и пользователь вводит "secretpass".
ЕСЛИ(HASH("sha256"; {user:введенный_пароль}) = {global:пароль_хеш_из_базы}; "Пароль верный!"; "Неверный пароль.")
Если {user:введенный_пароль} = "secretpass", а {global:пароль_хеш_из_базы} = "7e7a59a9a3b6d2149b25141b714b7e7a59a9a3b6d2149b25141b714b7e7a59a9", то результат будет "Пароль верный!".
FROMJWT
Функция FROMJWT проверяет цифровую подпись JWT (JSON Web Token) с использованием указанного публичного ключа и, в случае успешной проверки, возвращает содержимое токена в формате JSON. JWT часто применяется для авторизации, передачи информации о пользователе и других задач, связанных с безопасностью.
Синтаксис: FROMJWT(токен; публичный_ключ)
Параметры:
токен — строка, содержащая JWT.
публичный_ключ — открытый ключ, с помощью которого проверяется подпись токена.
Результат: JSON-объект с полезной нагрузкой (payload) токена, если подпись корректна. Если подпись не проходит проверку, возвращается ошибка.
Пример 1: Разбор JWT с публичным ключом
FROMJWT("eyJhbGciOi..."; "-----BEGIN PUBLIC KEY-----...")
= {"name": "John Doe"}
FROMJWK (ИЗ JWK В ПУБЛИЧНЫЙ КЛЮЧ)
Функция FROMJWK преобразует ключ в формате JWK (JSON Web Key) в стандартный публичный ключ, который можно использовать для проверки цифровых подписей или для операций шифрования. Формат JWK применяется в современных протоколах безопасности (например, OAuth 2.0, OpenID Connect) для удобного обмена ключами в JSON-формате.
Синтаксис: FROMJWK(jwk)
Параметры:
jwk — строка с JSON-объектом ключа в формате JWK.
Результат: публичный ключ в строковом виде, который можно передавать в функцию FROMJWT для проверки токенов.
Пример 1: Конвертация JWK в публичный ключ
FROMJWK("{\"kty\":\"RSA\",\"n\":\"0vx7...\",\"e\":\"AQAB\"}")
= "-----BEGIN PUBLIC KEY----- MIIBIjANBgkqh... -----END PUBLIC KEY-----"
Пример 2: Использование для верификации JWT
FROMJWT({user:jwt}; FROMJWK({global:jwk_key}))
Примеры составных функций
Составные функции позволяют создавать очень гибкую и мощную логику в боте.
Пример 1: Простая проверка длины имени и приветствие (начальный уровень)
Задача: Если имя пользователя длиннее 5 символов, поприветствовать его полным именем, иначе – кратко.
Формула:
ЕСЛИ(ДЛСТР({user:first_name}) > 5; "Привет, " & {user:first_name} & "!"; "Привет!")
Примеры использования:
Если {user:first_name} = "Артём": "Привет!"
Если {user:first_name} = "Александр": "Привет, Александр!"
Пример 2: Расчёт стоимости заказа со скидкой и округлением (средний уровень)
Задача: Рассчитать итоговую стоимость заказа с учётом количества товаров, их цены, возможной скидки, а затем округлить сумму до двух знаков после запятой.
Предполагаемые параметры:
{user:количество_товаров}: "3"
{googlesheets:123:B2}: "15.50" (цена за единицу) - подстановка из google таблицы
{user:скидка_сумма}: "10"
Формула:
ОКРУГЛ(({user:количество_товаров} * {googlesheets:123:B2}) - {user:скидка_сумма}; 2)
Примеры использования:
Расчёт: (3 * 15.50) - 10 = 46.50 - 10 = 36.50
Округление: ОКРУГЛ(36.50; 2) = 36.50
Если googlesheets:123:B2 = "15.333", то ОКРУГЛ( (3 * 15.333) - 10; 2) = 36.00
Пример 3: Форматирование текущей даты и времени для отчёта (средний уровень)
Задача: Получить текущую дату и время, отформатировать их в виде "День недели, DD месяц YYYY года, HH:MM" и добавить 3 дня.
Предполагаемый параметр:
{user:date_time} = "12.06.2025 22:24:20"
Формула:
DATEFORMAT(DATEADD(DATEVALUE({user:date_time}); "P3D"); "l, d F Y года, H:i"; "ru")
Пример использования:
Итоговый вывод: "Воскресенье, 15 июня 2025 года, 22:24"
Пример 4: Обработка JSON-ответа и условный вывод (сложный уровень)
Задача: Из JSON-ответа получить список продуктов, затем отфильтровать только те, у которых статус "доступен", объединить их через запятую и вывести сообщение, или указать, что продуктов нет.
Предполагаемый параметр:
{user:api_response}:
{
"products": [
{"id": 1, "name": "Молоко", "status": "доступен"},
{"id": 2, "name": "Хлеб", "status": "нет в наличии"},
{"id": 3, "name": "Масло", "status": "доступен"}
]
}
Формула:
ЕСЛИ(ДЛСТР(
JOIN(", "; ARRAYREMOVE(UNIQUE(FOREACH(
JP({user:api_response}; "$.products");
LAMBDA(product; ЕСЛИ(JP(product; "$.status") = "доступен"; JP(product; "$.name"); ""))));LAMBDA(val; key; val="")))) > 0;
"Доступные товары: " &
JOIN(", "; ARRAYREMOVE(UNIQUE(FOREACH(
JP({user:api_response}; "$.products");
LAMBDA(product; ЕСЛИ(JP(product; "$.status") = "доступен"; JP(product; "$.name"); ""))));LAMBDA(val; key; val="")));
"Нет доступных товаров.")
Примеры использования:
Если {user:api_response} содержит данные выше, то запишется в параметр: "Доступные товары: Молоко, Масло"
Если {user:api_response} содержит: {"products": [{"id": 1, "name": "Молоко", "status": "нет в наличии"}]} , то запишется в параметр:"Нет доступных товаров."
Краткий разбор формулы
Эта формула предназначена для извлечения названий "доступных" продуктов из JSON-ответа API, сохранённого в параметр {user:api_response} и формирования сообщения для пользователя. Если такие продукты найдены, она выводит их список; в противном случае — сообщает об их отсутствии.
Порядок выполнения формулы слева направо (от внутреннего к внешнему):
JP(..., "$.products"): Используя синтаксис JSONPath, извлекает массив (список) всех продуктов из полученного JSON-объекта.
FOREACH(..., LAMBDA(product; ЕСЛИ(JP(product; "$.status") = "доступен"; JP(product; "$.name"); ""))):
Эта функция проходит по каждому product (объекту продукта) в извлеченном массиве.
Внутри LAMBDA, ЕСЛИ(...) проверяет: если значение status продукта равно "доступен", то возвращается его name (имя).
В противном случае (если статус не "доступен"), возвращается пустая строка "".
Результатом этой части будет новый массив, содержащий имена доступных продуктов и пустые строки для недоступных. Например: ["Молоко", "", "Масло"].
UNIQUE(...): Удаляет любые повторяющиеся элементы из массива. В данном сценарии это может быть избыточно, но является хорошей практикой для обработки списков.
ARRAYREMOVE(..., LAMBDA(val; val="")): Удаляет все пустые строки ("") из массива, которые были добавлены для недоступных продуктов на шаге 3. Это очищает список, оставляя только имена доступных товаров.
JOIN(", "; ...): Объединяет оставшиеся элементы массива (имена доступных товаров) в одну строку, разделяя их запятой и пробелом. Например: "Молоко, Масло".
ДЛСТР(...): Вычисляет длину полученной строки с именами доступных товаров.
ЕСЛИ(ДЛСТР(...) > 0; ...; ...):
Это главное условие. Если длина строки доступных товаров больше нуля (то есть, есть хотя бы один доступный товар), то выполняется первая часть ЕСЛИ.
Если истина: Формируется сообщение "Доступные товары: " и к нему добавляется список товаров, полученный на шаге 5.
Если ложь: Выводится сообщение "Нет доступных товаров.".
Таким образом, формула эффективно фильтрует и форматирует информацию о продуктах из JSON-ответа для удобного отображения пользователю.
---
## Создание Группы или Канала в Telegram: Секреты и Автоматизация с Чат-Ботами
URL: https://sambot.ru/support_sozdanie-gruppy-ili-kanala-v-telegram_75
Как создать группу или канал в Telegram и подключить чат-бота: пошаговая инструкция, выбор формата, добавление бота — просто и быстро.
Telegram стал мощной платформой для общения, продвижения и продаж. Хотите создать своё сообщество, делиться знаниями или развивать бизнес? Создание чата или канала в Telegram – это первый шаг к успеху! Но как сделать так, чтобы ваше сообщество росло, а управление им не превратилось в рутину? Ответ прост: автоматизируйте процессы с помощью чат-ботов!
Зачем Создавать Свой Чат или Канал в Telegram?
Telegram – это не просто мессенджер, это мощный инструмент для построения лояльной аудитории и монетизации своих знаний и услуг. Создание чата позволяет вам напрямую общаться с подписчиками, получать обратную связь и формировать крепкое комьюнити. Создать канал телеграмм – отличный способ делиться экспертным контентом, новостями и эксклюзивными предложениями с широкой аудиторией. Если вы хотите создать свой чат для обсуждения общих интересов, продвижения бренда или продажи товаров, Telegram предоставляет все необходимые инструменты.
Группа или Канал: Что Выбрать для Ваших Целей?
В Telegram есть два основных формата сообществ: группы и каналы. В чем разница? Чем отличается группа от канала? В группе все участники могут общаться друг с другом, обмениваться мнениями и задавать вопросы. Это идеальный вариант для создания комьюнити, где важна вовлеченность и взаимодействие. Канал же предназначен для односторонней трансляции информации от администратора к подписчикам. Если ваша цель – делиться контентом и новостями с широкой аудиторией, выбирайте канал. Важно понимать, что выбор между группой или каналом зависит от ваших целей и задач.
Как Создать Чат или Канал в Telegram: Пошаговая Инструкция
Создать свой чат или канал в Telegram очень просто. Следуйте нашей пошаговой инструкции:
Откройте приложение Telegram на своем устройстве.
Нажмите на значок создания нового сообщения (обычно в правом нижнем углу экрана).
Выберите "Создать группу" или "Создать канал".
Придумайте название для своего чата или канала.
Добавьте описание (необязательно, но рекомендуется).
Добавьте участников (для группы) или настройте параметры видимости (для канала).
Более подробную информацию о том, как создать чат телеграм и как создать канал телеграм, вы найдете в наших видео-инструкциях. Посмотрите их, чтобы избежать ошибок и настроить все правильно с первого раза! Как создавать чаты в телеграмм – это просто, если у вас есть четкая инструкция.
Секрет Успешного Telegram-Сообщества: Чат-Боты – Ваши Незаменимые Помощники
Управление большим Telegram-сообществом может быть трудоемким. Модерация, ответы на вопросы, рассылка новостей – все это отнимает много времени и сил. Но есть решение! Чат-боты – это ваши незаменимые помощники, которые автоматизируют рутинные задачи и освободят вас для более важных дел. Модератор чата больше не нужен, если у вас есть умный чат-бот! Автоматизация процессов с помощью чат-ботов – это ключ к успеху вашего Telegram-сообщества.
Что Может Делать Чат-Бот в Вашем Telegram-Чате или Канале?
Возможности чат-ботов в Telegram практически безграничны. Они могут:
Приветствовать новых участников и давать им полезную информацию.
Модерировать чат и удалять нежелательные сообщения.
Отвечать на часто задаваемые вопросы.
Рассылать новости и уведомления.
Проводить опросы и голосования.
Организовывать конкурсы и розыгрыши.
Продавать товары и услуги.
И это далеко не все! Телеграмм боты для чатов – это ваш шанс вывести свое сообщество на новый уровень.
Как Добавить Чат-Бота в Telegram: Просто и Быстро
Добавить чат-бота в свой Telegram-чат или канал очень просто:
Найдите нужного бота в Telegram (или создайте своего собственного, как мы расскажем ниже).
Добавьте бота в свой чат или канал.
Назначьте бота администратором с необходимыми правами.
Подробные видео-инструкции о том, как добавить, подключить бота, вы найдете на нашем сайте. Бот в группе телеграмм – это не просто модный тренд, это необходимость для успешного развития вашего сообщества. Добавить бота в канал – значит автоматизировать рутинные задачи и освободить время для творчества и развития.
Конструктор Чат-Ботов SAMBOT: Создайте Своего Идеального Помощника Без Знания Программирования
Мечтаете о своем собственном чат-боте, но не знаете, как программировать? Не беда! С конструктором чат-ботов SAMBOT вы сможете создать своего идеального помощника без каких-либо специальных знаний. SAMBOT – это простой и интуитивно понятный инструмент, который позволит вам создать чат-бота любой сложности всего за несколько кликов. Забудьте о сложном коде и утомительных инструкциях! С SAMBOT создание ботов без программирования стало реальностью.
Примеры Чат-Ботов, Которые Вы Можете Создать с SAMBOT
С SAMBOT вы можете создать чат-ботов для решения самых разных задач:
Бот-модератор: автоматически удаляет нежелательные сообщения и блокирует нарушителей.
Бот-продавец: принимает заказы и обрабатывает платежи прямо в Telegram.
Бот-поддержка: отвечает на вопросы пользователей и помогает решать проблемы.
Бот-опросник: проводит опросы и собирает обратную связь.
Готовы Автоматизировать Свой Telegram-Чат или Канал?
Не упустите возможность вывести свой Telegram-чат или канал на новый уровень! Создайте своего чат-бота прямо сейчас в конструкторе SAMBOT! Это быстро, просто и эффективно.
Создать Чат-Бота Бесплатно
---