Инструкция

Получение API ключа для бота в Telegram

1. Откройте Telegram и найдите BotFather

BotFather — это официальный бот @BotFather для управления всеми ботами на платформе Telegram. Он позволяет создавать новых ботов и управлять уже существующими.

• Войдите в Telegram (через мобильное приложение или веб-версию).
• В строке поиска введите BotFather и выберите этого бота (он будет верифицирован, с синим значком рядом с именем).

2. Запустите диалог с BotFather

• Нажмите кнопку Start, чтобы начать разговор с BotFather.
• BotFather предоставит вам список команд для управления ботами.

3. Создайте нового бота

Для создания нового бота выполните следующие шаги:

• Введите команду /newbot и отправьте её.
• BotFather попросит вас придумать имя для вашего бота. Введите любое имя, которое вам нравится (например, "MyCoolBot").
• Далее BotFather попросит вас ввести username для бота, который должен оканчиваться на bot (например, MyCoolBot_bot или SuperAssistant_bot). Это имя должно быть уникальным, и если оно уже занято, BotFather попросит выбрать другое.

4. Получите API ключ

После того как имя и username бота были успешно зарегистрированы, BotFather выдаст вам API токен (ключ), который выглядит как длинная строка символов, например:

123456789:ABCDefghIJKlmnopQRsTUVwxyZ1234567

Этот токен и будет вашим API ключом. Важно: не делитесь этим ключом с другими людьми, так как он дает полный доступ к вашему боту.

5. Дополнительные настройки

После получения API ключа, вы можете настроить другие параметры вашего бота:

• /setdescription — задать описание для бота.
• /setabouttext — задать информацию "О боте".
• /setuserpic — установить аватар для бота.
• /setcommands — задать команды, которые бот будет понимать.

Промпт

Промпт — это специальная инструкция для ассистента, которая задает её базовое поведение и определяет правила для ответа. Он используется для настройки поведения бота в конкретном контексте, чтобы он действовал в соответствии с определёнными инструкциями.

Отдельный промпт для голосового помощника (опционально)

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

Примеры использования системного промпта

1. Очень короткие ответы

Промпт: "Отвечай очень коротко."

Влияние: На вопрос: "Что такое Солнце?" модель ответит: Звезда.

2. Объяснение для маленького ребенка

Промпт: "Объясняй, как будто ты говоришь с 5-летним ребенком."

Влияние: На вопрос: "Что такое самолёт?" модель ответит: Самолёт — это большая машина, которая летает в небе и возит людей далеко-далеко.

База знаний

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

Простой пример:

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

Зачем это нужно:

Точные и проверенные данные: Информация, которую вы добавили в базу знаний проверена вами, поэтому бот выдаёт правильные и точные ответы.

Пример:

Вы создали категорию "Инструкции" в базе знаний, добавили в нее документ с названием "Смена пароля на сайте" а в тексте документа написали подробную инструкцию по смене пароля. После этого пользователь спрашивает бота: "Как поменять пароль на сайте?" Бот ищет в базе знаний и отвечает:

Чтобы поменять пароль на сайте, зайдите в "Настройки", выберите "Безопасность", и нажмите "Сменить пароль".

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

Раздельные документы для голосового и текстового помощника

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

Готовые вопросы и ответы

Как это работает:

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

Пример:

Вы добавили пару: "Как поменять пароль?"-"Зайдите в настройки, выберите "Сменить пароль" и следуйте инструкциям." Пользователь спрашивает: "Как изменить пароль?" Бот сразу выдаст ответ: "Зайдите в настройки, выберите "Сменить пароль" и следуйте инструкциям."

Коллабораторы

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

Настройки

Голосовые сообщения

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

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

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

Отвечать в приватных чатах

При включении этой настройки бот будет отвечать в личных сообщениях, при выключении - игнорировать их.

Отвечать в группах

Если добавить бота в группу, дать ему возможность читать все сообщения в группе через BotFather - бот будет отвечать пользователям в группе.

Чтобы добавить бота в группу Telegram и настроить его так, чтобы он отвечал на сообщения пользователей, нужно выполнить несколько шагов:

1. Добавьте бота в группу

1. Откройте Telegram и перейдите в свою группу.

2. Нажмите на название группы в верхней части экрана, чтобы открыть настройки группы.

3. Выберите "Добавить участников".

4. В строке поиска введите имя вашего бота (например, @MyBot).

5. Выберите бота из результатов поиска и добавьте его в группу.

2. Настройте бота для работы в группе

Боты по умолчанию не видят сообщения в группах. Чтобы бот мог реагировать на обычные сообщения, нужно отключить режим "Privacy Mode" (Приватный режим).

Отключение Privacy Mode:

Откройте чат с ботом BotFather.

Введите команду /setprivacy и выберите своего бота.

Выберите "Turn off", чтобы бот мог видеть все сообщения в группе и отвечать на них.

Теперь бот будет видеть все сообщения в группе и сможет на них отвечать.

3. Дайте боту права на чтение сообщений

Чтобы бот мог видеть сообщения в группе и отвечать на них, нужно дать ему разрешение на чтение сообщений:

Откройте настройки группы (кликнув на название группы).

Нажмите "Редактировать" (или "Изменить", в зависимости от языка интерфейса).

Перейдите в раздел "Права" или "Права участников".

Убедитесь, что у бота есть разрешение на чтение сообщений.

Теперь ваш бот будет добавлен в группу и сможет отвечать на сообщения.

Отвечать администраторам в группах

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

Лимит сообщений на пользователя

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

Язык бота

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