Общая информация

Наш сервис Romashka.pro позволяет создавать персонализированных Telegram-ботов с искусственным интеллектом для групп, чатов и компаний, которые хотят добавить линию первичной поддержки клиентов и, или повысить вовлеченность своих подписчиков в Telegram.
Боты работают на основе передовых языковых моделей GPT и могут быть настроены под ваши конкретные потребности.

Начало работы

Регистрация в сервисе

1. Откройте наш основной бот в Telegram https://t.me/Romashka_pro_bot

2. Введите команду /start для регистрации (если ранее не были зарегистрированы)

3. После регистрации вам будет присвоен персональный API-ключ, который потребуется для авторизации в Telegram Mini Apps

Получение API-ключа

1. В чате с ботом @Romashka_pro_bot введите команду /lk

2. Бот пришлет информацию о вашем профиле, включая API-ключ и текущий баланс

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

Важно: Храните API-key в безопасности! В случае компрометации ключа срочно обратитесь в техподдержку через команду /help в чате с ботом @Romashka_pro_bot.

Пополнение баланса

Для создания и использования собственных ботов необходимо пополнить баланс аккаунта:

1. В чате с ботом @Romashka_pro_bot введите команду /lk или нажмите кнопку "Личный кабинет" в главном меню

2. Нажмите кнопку «Пополнить баланс» (под полем ввода текста)

3. Оплата производится банковской картой через платежный шлюз Т-банка (полностью безопасно)

4. Для новых пользователей (у которых еще нет ботов) баланс должен быть не менее 990 рублей

Создание бота

Доступ к Telegram Mini Apps

1. В чате с основным ботом введите команду /svoy_bot

2. Бот пришлет кнопку со ссылкой на Telegram Mini Apps

3. Нажмите на кнопку для перехода в приложение

4. Введите ваш API-ключ для авторизации

В случае ввода неверного API-ключа:

• Система отобразит информационное сообщение об ошибке

• Если проблема не устраняется, обратитесь в техподдержку с помощью команды /help в чате с ботом @Romashka_pro_bot.

Пошаговая инструкция создания бота

Шаг 1: Создание бота в @BotFather

1. Найдите и откройте чат с @BotFather в Telegram

2. Отправьте команду /newbot

3. Следуйте инструкциям BotFather:

   • Укажите имя бота (то, которое будет отображаться пользователям)

   • Придумайте username бота (должен оканчиваться на "bot")

4. После успешного создания BotFather выдаст вам токен бота - сохраните его, он потребуется в дальнейшем

5. Для удобства ваших пользователей вы можете добавить в интерфейс вашего бота кнопки /help и /contact

Шаг 2: Создание бота в нашем сервисе

1. Убедитесь, что ваш баланс составляет не менее 990 рублей

2. Авторизуйтесь в Telegram Mini Apps, используя API-ключ (предоставленный нашим ботом @Romashka_pro_bot)

3. Нажмите кнопку "Создать бота" в верхней части экрана

4. Заполните регистрационную форму:

   Имя бота:
   Укажите понятное название для бота. Рекомендуется использовать то же имя, которое вы указали при создании бота в @BotFather.

   Телеграм токен:
   Вставьте токен, полученный от @BotFather.

   Username бота:
   Введите username бота, включая символ @ (например, @your_name_bot).

   Выберите модель:
   Вам доступны две модели:

   • GPT-4o-mini: Более доступная модель (0,0005 рублей за токен)

   • GPT-4o: Более мощная модель с расширенными возможностями (0,001 рублей за токен)

   Слова-триггеры (через запятую):
   Укажите слова, на которые бот будет реагировать в групповых чатах.
   Важно: бот реагирует только если триггер-слово идет первым в сообщении. Рекомендуется указать 3-5 слов, возможно на разных языках или сокращенные имена.

   Системный промпт:
   Системный промпт - это инструкция, которая задает поведение языковой модели. Это своего рода "личность" вашего бота. Напишите четкие указания, описывающие:

   • Кто этот бот и какую компанию/сервис он представляет

   • Какие задачи он должен выполнять

   • Каким тоном общаться с пользователями

   • Какие ограничения у него есть

   • С кем нужно связаться в случае оформления заказа (например напишите про команду /contact)

   Примеры эффективных системных промптов:

   • «Вы - консультант IT-компании Romashka.pro. Ваше имя Ромашка. Ваша задача консультировать клиентов по созданию Telegram-ботов и услугам компании. Вы отвечаете на основе контекста ниже. Используйте простой и дружелюбный стиль в общении. Предлагайте пользователю не стесняться и задавать любые интересующие вопросы. В случае крайней необходимости (например если пользователю нужна поддержка специалиста компании или он хочет оформить заказ) вы можете порекомендовать связаться с сотрудником компании через команду /contact.»

   • «Ты бот-консультант по юридическим вопросам, отвечай четко и профессионально на основе контекста ниже. При необходимости связи пользователя со специалистом компании предлагайте оставить заявку через команду /contact»

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

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

Шаг 3: Загрузка базы знаний (рекомендуется)

После создания бота система предложит загрузить файл с данными для персонализации модели (RAG-система):

1. Подготовьте файл в одном из следующих форматов: PDF, DOCX, DOC, TXT, ODT, XLS, XLSX (оптимальный формат - TXT)

2. Максимальный размер файла - 20 МБ

3. Для повышения эффективности системы подготовьте логические абзацы с ограничением в 2500 символов

Например у вас есть текст:

Услуги и обязательства Описание доступных услуг и их функциональности.

"Romashka.pro" предоставляет следующие услуги: Услуга «Диалог»: пользователи имеют возможность арендовать доступ к сервису обработки данных с использованием искусственного интеллекта, для получения сгенерированных искусственным интеллектом ответов на свои запросы. Услуга «Рисовать»: платформа предоставляет сервис генерации изображения по текстовым описаниям. пользователи имеют возможность арендовать доступ к сервису обработки данных с использованием искусственного интеллекта (API), для получения сгенерированных искусственным интеллектом ответов на свои запросы ввиде графических изображений. Услуга «Речь»: платформа предоставляет сервис по транскрибации текста из аудио и видео файлов; синтезирование аудиофайла на основе текстового ввода пользователя. Услуга «RAG-система»: представляет собой улучшенную услугу «Диалог». Пользователю доступно загрузка файлов с собственными данными для повышения эффективности получения ответов на свои вопросы. Услуги «WEB-разработка»: представлены на платформе в виде сервиса автоматического сбора заявок. Обработка таких заявок осуществляется вручную и может занять до 5 дней. Подача заявки означает желание пользователя ознакомиться с условиями предоставления указанных услуг.

Оплата и подписка

Структура цен и система подписки. Romashka.pro предлагает платные услуги, такие как «Диалог» «Рисовать» «Речь» «RAG-система» на основе подписки и тарификации данных. Стоимость подписки составляет 8 рублей 30 копейки в день, что равно 249 рублей в месяц. Списание средств за подписку осуществляется ежемесячно, в последний день месяца. Пользователь принимает и оплачивает услуги по принципу «как есть» В случае услуги «Диалог» и «RAG-система», тарификация производится по системе токенов, где 1 токен равен 0.0007 рубля за 1 токен текстовых запросов и 0.0014 рубля за 1 токен аудио запросов. Количество токенов, используемых для каждого запроса, определяется программными алгоритмами на основе таких параметров как язык запроса, скорость интернета, структура слова. Ответ API включает в себя количество входных и выходных токенов. В любом случае 1 символ не превышает 1 токена. В случае услуги «Рисовать» стоимость одного сгенерированного изображения равна 4 рублям. В случае услуги «Речь», подуслуга «текст в речь» тарифицируется по стоимости 1 (один) рубль за 1 минуту озвученного текста. Сервис округляет время результата до ближайшей минуты. Подуслуга «речь в текст» рассчитывается как 1 рубль за 1 минут обрабатываемого аудиофайла и 1 рубль за одну минуту + 2 рубля за видеофайлы. В случае постобработки подуслуги «речь в текст» расчет происходит по тарифам услуги «Диалог» В случае некорректной обработки заказа Пользователь вправе требовать возврат за такой заказ, для этого ему необходимо через команду /help обратиться к сервису Romashka.pro с требованием о возврате и предоставлении аргументированных причин. В случае нарушения пользователем инструкций при оформлении заказа Romashka.pro оставляет за собой право на возврат за некорректный заказ.

Правильный пример абзацев:
"Romashka.pro" предоставляет следующие услуги: Услуга "Хостинг Telegram-ботов"; Услуга "Диалог"; Услуга «Рисовать»; Услуга «Речь»; Услуга «RAG-система»; Услуги «WEB-разработка».

Услуга «Диалог»: пользователи имеют возможность арендовать доступ к сервису обработки данных с использованием искусственного интеллекта, для получения сгенерированных искусственным интеллектом ответов на свои запросы. В случае услуги «Диалог» и «RAG-система», тарификация производится по системе токенов, где 1 токен равен 0.0007 рубля за 1 токен текстовых запросов и 0.0014 рубля за 1 токен аудио запросов. Количество токенов, используемых для каждого запроса, определяется программными алгоритмами на основе таких параметров как язык запроса, скорость интернета, структура слова. Ответ API включает в себя количество входных и выходных токенов. В любом случае 1 символ не превышает 1 токена.

Услуга «Рисовать»: платформа предоставляет сервис генерации изображения по текстовым описаниям. пользователи имеют возможность арендовать доступ к сервису обработки данных с использованием искусственного интеллекта (API), для получения сгенерированных искусственным интеллектом ответов на свои запросы ввиде графических изображений. В случае услуги «Рисовать» стоимость одного сгенерированного изображения равна 4 рублям.

Услуга «Речь»: платформа предоставляет сервис по транскрибации  текста из аудио и видео файлов; синтезирование аудиофайла на основе текстового ввода пользователя. В случае услуги «Речь», подуслуга «текст в речь» тарифицируется по стоимости 1 (один) рубль за 1 минуту озвученного текста. Сервис округляет время результата до ближайшей минуты. Подуслуга «речь в текст» рассчитывается как 1 рубль за 1 минут обрабатываемого аудиофайла и 1 рубль за одну минуту + 2 рубля за видеофайлы. В случае постобработки подуслуги «речь в текст» расчет происходит по тарифам услуги «Диалог».

Услуги «WEB-разработка»: представлены на платформе в виде сервиса автоматического сбора заявок. Обработка таких заявок осуществляется вручную и может занять до 5 дней. Подача заявки означает желание пользователя ознакомиться с условиями предоставления указанных услуг. Беремся за масштабные проекты, выполняем с любовью, креативом, точно в срок а то и раньше.

Пояснения:
Мы согласовали абзацы, добавили в них информацию из нескольких абзацев. Кроме того, мы создали отдельный абзац, который сможет ответить на гепотетический вопрос, что-то типа этого "Какие услуги предоставляет ваша компания" или "Что вы предлагаете". Более того, мы оптимизировали информацию в подсказке (логическом абзаце), чтобы отвечая на вопрос пользователя бот сразу ответил и о стоимости конкретной услуги.

Неправильный пример абзаца:
Оставить все как есть. Пояснения: Если вы оставите все как есть, то для получения обширного ответа боту придется ответить на большее количество вопросов, что в свою очередь повлияет на себестоимость консультации.

Еще один пример:

• Правильный пример абзаца:
  "Наша компания "ТехСервис" предоставляет гарантию 2 года на все устройства, приобретенные в официальных магазинах. Для получения гарантийного обслуживания клиенту необходимо предоставить чек и гарантийный талон. В случае заводского брака ремонт или замена производится бесплатно в течение 14 рабочих дней. Гарантия не распространяется на случаи механических повреждений по вине пользователя."

  Неправильный пример абзаца:
  "Гарантия 2 года. Нужен чек. Замена при браке."

Рекомендации по включению некоторых абзацев:

Обязательно включите абзац(ы), которые помогут боту ответить на вопрос о том, как связаться с представителями вашей компании. Например:
Для связи с представителями комании Romashka.pro можно использовать множество способов: отправьте команду /contact и текс сообщения; позвоните по номеру +7-999-699-99-91; вы также можете отправить заявку на нашем сайте по ссылке https://romashka.pro/conect/ ; отправить письмо на электронный ящик roman@ipromashkin.ru ; также вы можете связаться с представителем Romashka.pro отправив команду /help в нашем основном Telegram-боте @Romashka_pro_bot.

После загрузки файла:

• Система уведомит о примерном времени обработки

• Статус обработки можно отслеживать в настройках бота в разделе "База знаний"

• Система также обрабатывает изображения в файлах, создавая их текстовые описания

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

Управление ботом

Настройка чата с администратором

После создания бота необходимо настроить чат с администратором:

1. Откройте профиль бота, нажав на шестеренку рядом с его именем

2. Перейдите в раздел "Настройки бота" и нажмите на карандашик

3. В поле "Чат с админом" введите необходимый ID чата

По умолчанию используется user_ID создателя бота. Чтобы узнать id группы или супергруппы:

1. Откройте Telegram Web (web.telegram.org)

2. ID чата находится в URL после https://web.telegram.org/a/#

3. Для групп и супергрупп ID может начинаться со знака "-"

Финансовые аспекты

• Стоимость бота: 990 рублей в месяц

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

• Если расходы меньше 990 рублей, спишется недостающая сумма до 990 рублей

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

• Использование специальных команд не тарифицируется

В разделе "Финансы" мини-приложения вы можете просмотреть:

• Общую сумму трат за месяц

• Список транзакций (списания и пополнения)

Мониторинг чатов

В разделе "Профиль" > "Чаты" вы можете:

• Увидеть все чаты, в которых участвует ваш бот

• Посмотреть расходы по каждому конкретному чату

• Отследить количество обработанных голосовых запросов

• Просмотреть историю сообщений (вопросы и ответы)

Команды для администраторов бота

Создателю бота доступны следующие команды:

• /reply chat_id текст - ответить пользователю от имени бота

• /mailing текст_рассылки - разослать сообщение по всем чатам бота

• /block user_id [причина] - заблокировать пользователя

• /unblock user_id - разблокировать пользователя

Команды для обычных пользователей:

• /start - начать работу с ботом

• /help - получить справку

• /contact - связаться с администратором

Блокировка пользователей

При блокировке пользователя через команду /block, заблокированный пользователь увидит сообщение:

⛔️ Вы были заблокированы в боте {имя_бота}.
Для связи с администратором напишите: {контакт_администратора}

Обновление настроек бота

Для обновления настроек бота:

1. Авторизуйтесь в мини-приложении

2. Нажмите на шестеренку рядом с именем бота

3. Перейдите в профиль бота

4. В разделе "Настройки" нажмите на карандаш

5. Внесите необходимые изменения

Обновление или удаление базы знаний:

1. Перейдите в раздел "База знаний" в профиле бота

2. Используйте иконки корзины (для удаления) или обновления (для замены)

Особенности работы бота

• Бот может обрабатывать текстовые сообщения, голосовые сообщения и изображения

• Важно: При обработке изображений контекст предыдущей истории диалога недоступен

• Бот реагирует в групповых чатах только на сообщения, начинающиеся с заданных слов-триггеров

• При добавлении бота в чат дайте боту права администратора (убедитесь что у бота есть доступ к сообщениям) и запустите бота, отправив в чат команду /start

Устранение неполадок

Если бот перестал отвечать:

1. Подождите некоторое время (возможно, есть временные сбои на серверах Telegram)

2. Проверьте баланс вашей учетной записи

3. Убедитесь, что бот не был заблокирован или удален

4. Обратитесь в службу поддержки: в основном боте (@Romashka_pro_bot) введите команду /help и следуйте инструкциям

Техническая поддержка

Для получения технической поддержки:

1. Вы можете получить консультацию по данному сервису у нашего специального Telegram-бота @manager_romashka_pro_bot

2. Если консультации бота недостаточно, то в чате с @manager_romashka_pro_bot введите команду /contact текст сообщения опишите вашу проблему максимально подробно . Также вы можете обратиться в тех.поддержку в основном боте @Romashka_pro_bot отправив команду /help