AI-чатбот для Telegram: группы и личные сообщения без кода

AI-чатбот для Telegram может отвечать на вопросы по знаниям вашей компании в группе или личном диалоге. Quickchat AI подключает AI Agent к Telegram через общего бота: добавьте его в группу, подтвердите подключение в панели, и участники смогут задавать вопросы, упоминая бота. Для этого способа не нужны код или токен BotFather.

В руководстве мы создадим Saltmarsh Sailing School, вымышленную школу с группой участников и личными обращениями. Два Agent используют одинаковые сведения: Saltmarsh Group отвечает на публичные вопросы, а Saltmarsh Sailing School принимает личные заявки на пробное занятие и привлекает сотрудника для возвратов. Заявка поступает в офис на рассмотрение и не означает подтверждённую запись.

Два Agent разделяют ответственность. У группового нет Action для передачи или приёма заявок; личный обрабатывает обращения и ответы сотрудников.

Следуйте маршруту ниже. Расширение Google Sheets необязательно: сначала можно завершить ответы и передачу сотруднику.

Скачайте комплект Saltmarsh для Telegram с точными знаниями, Main Prompt, настройками Action, критериями оценки и тестовыми сообщениями. Это редактируемые файлы для следующих шагов, а не импорт Agent одним нажатием. Копируемые материалы демонстрации и снимки экрана остаются на английском.

Что нужно для создания чатбота Telegram?

Нужны аккаунт Quickchat AI, два Agent и аккаунт Telegram с правом добавить бота в тестовую группу. Для необязательной записи заявок также нужен аккаунт Google, который может разрешить доступ к Google Sheets.

1. Создайте аккаунт Quickchat AI и при необходимости подтвердите почту. Free подходит для личного некоммерческого обучения. Тариф действует на каждый Agent, поэтому бизнесу, использующему обоих, нужно подходящее коммерческое покрытие для каждого. Preview и Simulation расходуют AI-кредиты. См. действующие тарифы.
2. Создайте группу Telegram Saltmarsh Members. Используйте тестовую группу, чтобы проверить упоминания, отсутствие ответа и продолжение диалогов до приглашения клиентов.
3. Проходите руководство со своим аккаунтом Telegram, в том числе отправляйте с него сообщения посетителя. Вы также можете работать в Inbox Quickchat AI. Перед приглашением клиентов попросите коллегу проверить работу с другого аккаунта.
4. Распакуйте комплект. Сохраните сведения о школе единым набором; перед запуском замените их своими проверенными правилами.

Скриншоты Quickchat App показывают локально запущенное приложение с вымышленной конфигурацией Saltmarsh; тестовые данные подключений отмечены в подписях. Скриншоты Telegram и Google Sheets показывают реальные ответы подключённой демонстрации и сохранённую заявку. Личные данные аккаунта обрезаны или явно скрыты. Используйте итоговый чек-лист, чтобы повторить проверки со своими знаниями и подключёнными аккаунтами.

Шаг 1: как обучить чатбота Telegram знаниям о вашем бизнесе?

Поместите факты о компании в Knowledge Base, а инструкции поведения в Main Prompt. Разделение позволяет исправить ответ, не меняя поведение Agent.

Цены и правила относятся к фактам источника. Краткость, неопределённость и маршрутизация относятся к инструкциям.

Создайте Agent и добавьте знания

1. В новом аккаунте выберите Set up manually. В существующем сначала выберите Add new AI Agent, затем ручную настройку.
2. В Identity введите Saltmarsh Group в Name your AI Agent. Вставьте group-main-prompt.txt из комплекта в Describe what you want your agent to do.
3. Продолжите настройку, пока не подключая внешние приложения. Завершите выбор тарифа; для учебного аккаунта можно использовать Skip for now.
4. Откройте Knowledge Base > Add Article. Введите Courses and trial enquiries в Create custom article, выберите Create article, вставьте saltmarsh-courses.txt в Content и нажмите Save.
5. Повторите для Weather, parking and personal enquiries, используя saltmarsh-policies.txt. Дождитесь статуса Ready у обеих статей.
6. Откройте Actions & MCPs у Saltmarsh Group. Оставьте Human Handoff выключенным и не добавляйте Action для пробного занятия.
7. Выберите Add new AI Agent и повторите ручную настройку для Saltmarsh Sailing School, используя main-prompt.txt и те же два файла знаний. Второй Agent будет вести личные диалоги. Перед изменением настроек выбирайте нужный Agent в переключателе аккаунта.

Два коротких источника показывают, какие факты есть у Agent. Перед проверкой знаний дождитесь Ready.

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

Настройте Main Prompt и проверьте ответ

1. Откройте Identity > Main Prompt у каждого Agent и проверьте соответствующий промпт Saltmarsh. Групповой отвечает на общие вопросы и направляет к закреплённой личной ссылке; личный собирает обращения и использует Human Handoff.
2. Откройте AI Preview и спросите How much is Start Sailing?. Проверьте два дня и EUR 240.
3. Спросите Do you rent wetsuits?. Убедитесь, что ответ признаёт отсутствие информации.

Промпт личного Agent задаёт приём заявок и передачу. Групповой Agent использует отдельный промпт, оба Action выключены.

Два фрагмента реальных настроек группового Agent. Он отвечает по знаниям, но у него нет Action для приёма или передачи обращений.

Два Agent явно разделяют маршруты. У группового нет функции передачи, которая могла бы сработать случайно; личный может передать возврат сотруднику, не приостанавливая группу. Preview проверяет сведения школы, а следующие шаги проверяют каждое подключение Telegram.

Шаг 2: как добавить AI-чатбота в группу Telegram?

Откройте External Apps > Telegram, добавьте общего бота в группу, затем вернитесь в Quickchat AI и нажмите Confirm. До подтверждения Agent будет молчать в этой группе.

Участие в Telegram и подтверждение Quickchat AI являются отдельными шагами.

1. Выберите Saltmarsh Group в переключателе Agent. Откройте External Apps, выберите Telegram и найдите Quickchat AI bot.
2. Нажмите Add to a Telegram group. В Telegram выберите Saltmarsh Members и подтвердите добавление бота.
3. Вернитесь в Quickchat AI. В Waiting for your confirmation проверьте название группы и сведения Added by.
4. Нажмите Confirm у нужной группы. Она должна перейти в Connected chats с включённым переключателем.
5. В Telegram введите @ и выберите бота из списка упоминаний. Спросите How much is Start Sailing?. Обычно имя общего бота @QuickchatAI_bot; используйте фактическое имя в вашей группе.
6. Ответьте прямо на его сообщение: What should I bring?. Затем отдельно отправьте без упоминания Does anyone know the gate code?. Общий бот должен ответить на прямой ответ и промолчать на обычное сообщение.

Выберите Saltmarsh Members в Telegram, затем вернитесь в Quickchat AI и подтвердите подключение.

Реальный локальный интерфейс с заранее созданными тестовыми данными группы показывает расположение Confirm. Это иллюстрация элемента управления, а не доказательство вступления в реальную группу Telegram.

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

Ответ на сообщение бота работает без повторного упоминания. Бот перечисляет предоставленные сведения о снаряжении.

Подтверждение важно, потому что данные приглашения видны в группе. Quickchat AI требует решения со стороны аккаунта, прежде чем считать группу адресатом Agent. Не подтверждайте незнакомые группы. Справочник подключения Telegram описывает эту же границу.

Завершите подтверждение, прежде чем выходить из настройки. Если бот покинул неподтверждённую группу, создайте новую ссылку Add to a Telegram group, добавьте его снова и сразу подтвердите ожидающую группу в Quickchat AI. Добавление бота через поиск участников Telegram не заменяет этот процесс подключения.

Значок Admin показывает статус бота в Telegram. Для обычных ответов общего бота он не нужен. Назначение администратором также не меняет правило ответа только на упоминания или прямые ответы.

Шаг 3: как включить личные чаты Telegram?

Включите Direct message link и передайте полный созданный URL. Ссылка выбирает ваш Agent внутри общего Telegram-бота, поэтому клиент может задать вопрос лично, не добавляя бота в группу.

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

1. Выберите личный Agent Saltmarsh Sailing School. Откройте External Apps > Telegram и включите Direct message link. Не подключайте к нему группы.
2. Скопируйте созданную ссылку. Сохраните параметр start=; обычная ссылка на общего бота не определяет ваш Agent.
3. Откройте её в Telegram и при необходимости нажмите Start.
4. Спросите How much is Start Sailing? без упоминания бота. Проверьте ответ школы и найдите диалог в Inbox.
5. Закрепите ссылку в приветственном сообщении группы, чтобы участники нашли её до передачи персональных данных.

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

Telegram доставил приветствие Saltmarsh после Start. Затем проверьте ответ по знаниям: одно приветствие не проверяет поиск информации.

Два фрагмента одного экрана Telegram показывают закреплённое приглашение. Значение start демонстрационной ссылки скрыто; закрепите собственную полную созданную ссылку.

Личный чат с общим ботом привязан к одному Agent в каждый момент. Открытие личной ссылки другого Agent может изменить привязку. Для собственной идентичности Telegram и отдельного диалога используйте вариант с собственным ботом.

Выключение Direct message link запрещает новые подключения по ней. Чтобы остановить уже подключённый чат, используйте его переключатель или Disconnect. Ссылка служит публичным входом, а не ограничением доступа к конфиденциальным знаниям.

Шаг 4: как сохранить заявку на пробное занятие в Google Sheets?

Интеграция Google Sheets создаёт таблицу и Action добавления строки. Адаптируйте его для трёх обязательных полей заявки, затем проверьте настоящую строку. Шаг необязателен и работает с общим Telegram-ботом.

Результат является заявкой для сотрудника. Он не резервирует место и не определяет стоимость пробного занятия.

Подключите Sheets и настройте один Action

1. В Saltmarsh Sailing School откройте Actions & MCPs > Add Action > Google Sheets и выберите Connect Google Sheets. Войдите в нужный аккаунт Google и предоставьте запрошенный доступ.
2. Откройте созданную таблицу Quickchat Leads. Сохраните название вкладки Leads, поскольку URL Action обращается к ней.
3. Замените заголовки по порядку на Name, Preferred weekday, Sailing experience, Conversation link, Channel.
4. В Actions & MCPs отредактируйте созданный Action log_lead_to_google_sheet. Используйте рецепт ниже. Одновременно меняйте параметры, тело запроса и заголовки таблицы, чтобы позиции совпадали.

API Action Name

Record trial-lesson request

What to ask the user first

Установите для всех трёх No default и удалите исходные параметры почты и обращения. В этом рецепте спрашиваются только эти три поля. Имя пользователя Telegram необязательно и ненадёжно как обязательный контакт; записанная ссылка на диалог позволяет сотруднику вернуться к заявке.

Метод и URL: оставьте созданный URL POST. Он уже содержит ID таблицы, вкладку Leads и valueInputOption=RAW. Заполнять шаблонный ID не нужно.

Заголовки: сохраните настройки интеграции.

Во вкладке Body раздела API Endpoint используйте:

{"values":[["{{name}}","{{preferred_weekday}}","{{sailing_experience}}","{{conversation_url}}","{{conversation_channel}}"]]}

Через Add AI Data вставляйте элементы параметров и переменных диалога в нужных местах. Первые три значения берутся из разговора, последние два предоставляет Quickchat AI.

API Action Description

In a private chat only, call this once when the person has requested a trial lesson and provided their name, preferred weekday and sailing experience. Ask for the next missing required field before calling. Do not call it for general course questions, in groups, or to confirm a booking. A successful call records an enquiry for the office; it does not reserve a place.

Откройте Advanced settings > Run only when и добавьте telegram_chat_type equals private. Используйте ключ метаданных без metadata_ и фигурных скобок. Это не даст отправить HTTP-запрос для группового сообщения, даже если модель попытается его вызвать. Проверка описана в справочнике условий запуска.

Установите Response filter в $.updates.updatedRows, чтобы Action возвращал число строк, а не лишний ответ провайдера. Оставьте Action включённым.

Используется ключ telegram_chat_type. Условие проверяется до отправки запроса.

Локальная конфигурация рецепта. URL Sheets и OAuth-разрешение должны происходить из вашего подключения Google.

Проверьте строку, затем неполную заявку

Отправьте следующее сообщение через личную Telegram-ссылку Agent:

I am Alex Morgan. I want a trial on Tuesday. I am a beginner.

Проверьте три места: ответ описывает заявку, карточка Action в Inbox показывает переданные значения, а настоящая вкладка Leads содержит соответствующую строку. Ни убедительный ответ, ни высокая оценка Simulation не доказывают запись в Google Sheets.

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

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

Начните отдельный тест с I would like a trial lesson. Перед запуском Action Agent должен спрашивать недостающие поля по одному. Также попробуйте How much is Start Sailing?: обычный вопрос не должен создавать строку. Промпт требует одну запись на заявку, но этот рецепт добавления не является идемпотентной системой бронирования. Проверьте дубли перед рабочим использованием.

Шаг 5: как передать диалог Telegram сотруднику?

Настройте Human Handoff, затем проверьте назначение диалога в Inbox. Промпт со словами «офис ответит» сам по себе не меняет ответственного и не приостанавливает AI.

Контрольный результат состоит в смене ответственного. Пусть сотрудник завершит случай; возврат к AI проверяйте отдельно.

1. Выберите Saltmarsh Sailing School, откройте Actions & MCPs > Human Handoff и включите. Для Saltmarsh Group оставьте этот Action выключенным.
2. В Handoff Rules нажмите +. Введите Private enquiries в Rule Name, вставьте handoff-rule.txt в Description и включите State. Новые строки изначально неактивны. Правило охватывает возвраты, жалобы, просьбы позвать человека и согласие на помощь сотрудника у личного Agent.
3. Очистите Keywords, выключите предустановленные правила примера, оставьте активным только пользовательское и сохраните. Изоляция группы обеспечивается выключенным Human Handoff у отдельного группового Agent; правило описывает момент передачи у личного.
4. Задайте Confirmation как I have passed this private conversation to the Saltmarsh office. A member of staff can reply here. Укажите в Human Agents’ availability реальное время работы команды и честное сообщение для нерабочих часов.
5. В личном Telegram-чате отправьте I want a refund for last week. Can I speak to a person?.
6. Найдите диалог в Inbox, проверьте назначение, выберите Assign to me и отправьте Hi, I’m Alex from the office. I’ll review your request. Убедитесь, что сообщение пришло в Telegram.
7. Отправьте ещё одно сообщение клиента, пока диалогом владеет сотрудник. AI должен молчать. Пусть оператор завершит и разрешит случай в Inbox. Возврат к AI считайте отдельным тестом.

State пользовательского правила включён. Готовые триггеры выключены, поэтому для проверки остаётся одно правило.

Реальный запрос в Telegram запустил Handoff. Назначение в Inbox и исходящий ответ оператора проверены отдельно.

При проверке в рабочем подключении разговор перешёл в Unassigned, чтобы его мог взять сотрудник. Оператор выбрал Assign to me, отправил ответ офиса, и Telegram принял сообщение. Скриншот выше показывает ответ о передаче; последующего сообщения оператора на нём нет. При повторении теста проверяйте и назначение, и отправку.

Оставьте этот случай у оператора до решения. В локальном тесте возврата переключение на AI Agent позволило дать один ответ, после чего Handoff сработал снова. Для возврата к AI нужен отдельный успешный тест следующего сообщения; это не входит в критерии завершения данного процесса. Руководство по передаче человеку подробнее объясняет организацию работы сотрудников и ответственность за разговор.

Шаг 6: как проверить весь чатбот Telegram?

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

Проверяйте систему, отвечающую за результат: знания для фактов, журналы Action для запросов, Sheets для строк и Telegram для доставки.

Запустите повторяемый набор вопросов

1. Откройте Testing, создайте набор Saltmarsh: knowledge checks и выберите Paste messages.
2. Вставьте simulation-messages.txt. Сохраните отдельные строки --- между случаями.
3. В Evaluation criteria вставьте evaluation-criteria.txt из комплекта и сохраните.
4. Выберите Run > Start Run и изучите отдельные ответы вместе с оценками.

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

Читайте ответы вместе с оценкой. Это локальная проверка знаний, а не доставки Telegram.

Оценщику нужны факты школы для проверки точности. Ему также нужно знать, что текст диалога не доказывает строку таблицы, доставку Telegram или смену ответственного. Обычная текстовая Simulation не передаёт метаданные Telegram, поэтому их отсутствие не означает поломку условия личного Action. Зависимые от канала проверки выполняйте в реальном личном чате.

Что изменили локальные тесты?

Первоначально один Agent обслуживал оба входа. Локальный тест показал, что запрос возврата в группе переводит общий разговор в Human Handoff. Мы разделили Agents и отключили Handoff и Actions приёма заявок у группового Agent. Повторные проверки возврата и пробного занятия в группе направляли к закреплённой личной ссылке, сохраняя назначение AI. Поэтому в шаге 1 разделение двух разговоров обеспечивается настройками наряду с инструкциями.

Все десять итоговых локальных проверок знаний получили 5/5, а оба размещённых Agents прошли те же десять случаев. Эти небольшие прогоны не оценивают точность в продакшене. Реальная группа также ответила на вопросы о цене курса и необходимых вещах, а затем отказалась подтверждать прокат гидрокостюмов. Сохраняйте случаи с отсутствующими фактами при адаптации комплекта: правильные цены сами по себе не проверяют сдержанность Agent.

При отсутствии знаний ответ звучит как «не могу подтвердить». Отдельное сообщение о коде ворот не обращается к боту, и на этом снимке ответа на него нет.

Реальная личная заявка на пробное занятие вызвала один успешный Sheets Action со значениями Alex Morgan, Tuesday и beginner. Google вернул HTTP 200 и одну обновлённую строку; сохранённая строка также содержала ссылку на разговор и канал telegram. Отдельный тест Action с метаданными группового чата не отправил HTTP-запрос. При адаптации ограничения проверяйте и принятый личный запрос, и отклонённый групповой контекст.

Проверьте канал и его внешние эффекты

Записывайте свои наблюдения в пустой test-matrix.csv из комплекта. Скриншоты выше показывают продемонстрированные результаты; таблица также включает проверки для вашей конфигурации. При проверке молчания фиксируйте прошедшее время и отделяйте передачу человеку от последующего возврата к AI.

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

Когда стоит создать собственного бота через BotFather?

Создавайте своего Telegram-бота, если нужны собственные имя и изображение, Telegram Bot API Actions или группа, получающая обычные сообщения. Для ответов в группе и личных чатах выше достаточно общего бота.

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

1. Откройте подтверждённый аккаунт BotFather в Telegram и отправьте /newbot.
2. Выберите отображаемое имя, затем свободное имя пользователя с окончанием bot. BotFather вернёт токен. Храните его в секрете.
3. Выберите Saltmarsh Group, если этот бот будет добавлен в группу. Используйте Saltmarsh Sailing School только для личных чатов. В External Apps > Telegram откройте Your own bot и выберите Connect to Telegram.
4. Вставьте токен в Bot Token и завершите подключение. Убедитесь, что Enable your own bot включён.
5. Откройте Telegram-ссылку бота, отправьте /start, затем тот же вопрос о цене.
6. Для получения обычных сообщений используйте /setprivacy в BotFather, выберите бота и Disable, затем удалите его из тестовой группы и добавьте заново. Бот-администратор также получает обычные сообщения. Правила доставки объясняет документация режима приватности.

Вставляйте токен только в Bot Token. Поле показано пустым, чтобы не публиковать учётные данные.

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

Могут ли ChatGPT или Claude помочь настроить чатбота Telegram?

Подключённое приложение управления аккаунтом Quickchat AI помогает создать Agent, добавить знания, изменить поддерживаемые настройки и запустить тесты. Если клиент предоставляет настройку Telegram, приложение может включить личную ссылку общего бота. Выбор группы и подтверждение в панели остаются шагами владельца. В некоторых клиентах активация личной ссылки и настройки Human Handoff также требуют панели, поэтому сначала попросите помощника проверить доступные инструменты.

Подключите плагин Quickchat AI для ChatGPT или коннектор Claude, затем передайте файлы комплекта с этим запросом:

Use my connected Quickchat AI account to create two Agents from the attached kit: Saltmarsh Group with group-main-prompt.txt and Saltmarsh Sailing School with main-prompt.txt. Add both knowledge files to each. Keep Actions and Human Handoff off on Saltmarsh Group. Prepare the supplied knowledge-test dataset. Check the tools available in this client before changing settings. Show me the configuration and ask before running credit-consuming tests or writing to Google Sheets. Where supported, enable only Saltmarsh Sailing School's shared-bot direct-message link and return the complete link. Leave group selection, dashboard confirmation, BotFather setup, Google OAuth and unsupported settings for me, with exact dashboard steps. Report what was configured, what was actually tested and what remains to verify in Telegram.

Набор инструментов зависит от клиента и прав аккаунта. Для входа следуйте справочнику управления аккаунтом. Это подключает помощника к Quickchat AI, но не превращает личный разговор с ChatGPT или Claude в размещённый сервер Telegram-бота.

Почему чатбот Telegram не отвечает?

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

Перед приглашением клиентов замените вымышленные факты, проверьте разделение группового и личного общения и назначьте сотрудников на очередь передачи. В качестве финальной проверки перед запуском попросите коллегу проверить публичные точки входа с другого аккаунта. Для другого канала сообщества руководство по чат-боту Discord предлагает похожий путь создания и проверки. Для общения с персонажами используйте руководство по ролевым ботам Telegram.

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

Настройка Saltmarsh для копирования

Ниже приведены полные факты источников и инструкции этого руководства. В загрузке также есть рецепт Action, критерии оценки и тесты.

Групповой Agent: Main Prompt

Вставьте в Identity > Main Prompt у Saltmarsh Group. Оставьте Human Handoff и пользовательские Actions выключенными.

You answer general questions in the Saltmarsh Sailing School members' group. Use only the Knowledge Base and keep each reply to two or three sentences. Do not add facts or requirements the sources do not contain. If a fact is missing, say that you cannot confirm it.

For trial requests, refunds, complaints, personal details or a request for a person, direct the member to the school's private link pinned in the group; do not invent a link. Do not collect personal details in this group. You cannot record requests, confirm bookings, approve refunds or transfer a conversation to staff. Do not claim you did any of these things. The private Agent records an enquiry; it cannot check live availability or confirm a trial. Only the office confirms availability and price.

Личный Agent: Main Prompt

Вставьте в Identity > Main Prompt у Saltmarsh Sailing School. Название Action должно совпадать с рецептом.

You are the private-chat assistant of Saltmarsh Sailing School. Answer school questions from the Knowledge Base. Do not add plausible details that are not in the sources, including extra clothing or footwear requirements. Keep replies to two or three sentences and ask at most one question per message. If a fact is missing, say that you cannot confirm it; do not invent dates, availability, gate codes or wetsuit rental. Explain weather policy without claiming to know the current forecast.

When a person requests a trial lesson, collect their name, preferred weekday and sailing experience. Ask for only the next missing field. When all three are present, use Record trial-lesson request once. Say the request was recorded only after the Action succeeds. Explain that the office still needs to confirm availability and price; never say a lesson is booked. If the Action is unavailable or fails, say the request has not been recorded and offer a person.

Use Human Handoff for a current unresolved refund request, complaint or explicit request for a person. After a staff member has resolved the enquiry and returned the conversation to AI, answer new general questions normally; do not hand off again solely because an earlier message mentioned a refund or asked for a person. Do not approve refunds or promise a response time. For a missing fact, say what is unknown and offer a person; do not treat uncertainty as a negative answer about the service.

Знания: курсы и заявки на пробное занятие

Вставьте в Content первой статьи знаний.

Saltmarsh Sailing School demonstration information

This fictional school is used only for a tutorial. It contains no real customer data.

Start Sailing is a two-day course costing EUR 240. Day Skipper theory runs across five evenings and costs EUR 310. A private lesson lasts 90 minutes and costs EUR 95.

Courses run from April to October. Course dates are published on the school's website one month ahead. This source does not contain the next available date or live availability.

Bring a waterproof jacket, non-marking shoes and a change of clothes. The school provides buoyancy aids.

A trial-lesson request is an enquiry, not a confirmed booking. The office needs the person's name, preferred weekday and sailing experience, then confirms availability and price. Do not collect payment details. Do not infer a trial price from the private-lesson price.

Знания: правила и информация для участников

Вставьте в Content второй статьи.

Saltmarsh Sailing School demonstration policies

If the forecast shows more than 25 knots of wind or thunderstorms, the session moves to the next available date at no extra cost. The instructor decides on the morning of the session. This source is a policy, not a live weather forecast or a cancellation decision.

Parking is free at the clubhouse. The gate code is sent to enrolled students the day before their course. The code itself is not in this Knowledge Base.

Refunds and complaints are handled by the office. An AI answer cannot approve a refund. A member of staff must decide each case.

The Telegram members' group is for general questions. Trial requests, refunds and other personal details belong in a private conversation with the school's Agent, opened from the school's direct-message link.

Правило Human Handoff

Вставьте в Human Handoff > Handoff Rules и настройте реальную доступность сотрудников.

Transfer this private conversation to a person when the visitor has a current unresolved refund request, complaint, explicit request for a person, or accepts an offer of human help. After a staff member resolves the enquiry and returns it to AI, earlier refund or handoff messages must not trigger a new transfer for a general course question. Explain that a staff member can review the case here without approving a refund or promising a response time. This Agent is used only for private enquiries; the separate group Agent has Human Handoff disabled.

Частые вопросы

Как добавить AI-чатбота в группу Telegram?

В Quickchat AI откройте External Apps, выберите Telegram и Add to a Telegram group. Выберите группу в Telegram, вернитесь в Quickchat AI и нажмите Confirm. Участники могут задавать вопросы упоминанием общего бота или ответом на его сообщение.

Отвечает ли AI-чатбот Telegram на каждое сообщение?

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

Нужны ли BotFather или токен Telegram-бота?

Для общего бота и его личной ссылки BotFather и токен не нужны. Создайте собственного бота через BotFather, если нужны своё имя и изображение Telegram или Actions, вызывающие Telegram Bot API. Обычные Google Sheets Actions работают с общим ботом.

Могут ли клиенты писать чатботу Telegram лично?

Да. Включите Direct message link в Quickchat AI и поделитесь полной созданной ссылкой. Клиент открывает её и при необходимости нажимает Start. Ссылка выбирает ваш Agent внутри общего бота. Выключение запрещает новые подключения; у существующих личных чатов отдельные переключатели включения и отключения.

Бесплатен ли AI-чатбот Telegram?

Создание бота через BotFather само по себе не добавляет AI-сервис. Quickchat AI предлагает Free для личного некоммерческого обучения с ограниченным запасом AI-кредитов. Коммерческому запуску нужен платный тариф. Ответы, Preview и Simulation расходуют кредиты; внешние сервисы могут оплачиваться отдельно.

Есть ли в Telegram AI-чатботы?

Telegram поддерживает сторонних AI-ботов и AI-интеграции. Руководство подключает Agent Quickchat AI, отвечающий по знаниям вашего бизнеса. BotFather создаёт идентичность бота, но не предоставляет эти знания и не настраивает процесс поддержки.

Понимает ли чатбот фотографии и файлы?

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

Можно ли создать ролевого или персонажного бота Telegram?

Да. То же подключение Telegram может обслуживать Agent с образом персонажа и подходящими инструкциями. Здесь используется пример бизнес-поддержки; ролевому Agent нужны собственные промпт и тесты.