> For the complete documentation index, see [llms.txt](https://vitrina-blogerov.gitbook.io/bloggers-showcase/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vitrina-blogerov.gitbook.io/bloggers-showcase/telegram-bot-1.md).

# Telegram бот

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

{% hint style="success" %}
Хороший бот не должен звучать как техническая заглушка. Он должен вести пользователя к действию: открыть каталог, описать задачу, получить подборку блогеров или связаться с командой.
{% endhint %}

### Роль бота как первого контакта

Пользователь может впервые увидеть платформу не в браузере, а именно в Telegram. Поэтому бот должен сразу ответить на три вопроса:

* что это за сервис;
* чем он полезен;
* что делать дальше.

```mermaid
flowchart TD
    A["User opens bot"] --> B["Welcome message"]
    B --> C["Open storefront"]
    B --> D["Ask AI consultant"]
    D --> E["Receive blogger suggestions"]
    C --> F["Choose bloggers"]
    E --> F
    F --> G["Contact team"]
```

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

### Нативное оформление в Telegram

До первого сообщения пользователь видит не платформу, а Telegram-профиль бота. Поэтому оформление в Telegram важно так же, как приветствие и витрина.

{% hint style="info" %}
Часть настроек делается не в админ-панели платформы, а в BotFather и настройках Mini App внутри Telegram.
{% endhint %}

Что стоит настроить:

* аватар бота;
* имя бота;
* короткое описание;
* описание “что умеет этот бот”;
* кнопку меню с Mini App;
* loading screen Mini App;
* preview для ссылки на Mini App;
* команды, если они нужны пользователям;
* язык и тон всех публичных описаний.

#### Аватар бота

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

Хорошие варианты:

* логотип проекта на контрастном фоне;
* отдельный знак бренда;
* простая монограмма;
* визуальный символ каталога или AI-подбора.

Слабые варианты:

* скриншот витрины;
* много текста;
* сложная иллюстрация;
* изображение с низким контрастом.

#### Имя, About и Description

У Telegram-бота есть несколько текстовых зон, и они работают по-разному.

{% tabs %}
{% tab title="Name" %}
Имя видно в списке чатов и в профиле. Оно должно быть коротким, узнаваемым и соответствовать бренду.

Пример:

```
Creator Match AI
```

{% endtab %}

{% tab title="About" %}
Короткое описание видно рядом с профилем бота. Оно должно быстро объяснять пользу.

Пример:

```
AI-powered creator selection for advertising campaigns.
```

{% endtab %}

{% tab title="Description" %}
Полное описание отвечает на вопрос “что умеет этот бот”. Здесь можно чуть подробнее объяснить сценарий.

Пример:

```
This bot helps brands find suitable creators for advertising campaigns. Describe your niche, audience, region, or budget, and the AI consultant will suggest relevant bloggers from the catalog.
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
Если это демо-версия, в описании или приветствии стоит указать, что блогеры вымышлены, а ссылки на статистику используются для демонстрации возможностей.
{% endhint %}

#### Кнопка меню и Main Mini App

Кнопка меню должна вести в каталог. Это один из самых важных нативных входов в витрину: пользователь может открыть Mini App прямо из профиля или меню бота, не дожидаясь сообщения.

Рекомендуемый текст кнопки:

* `Open catalog`;
* `Open app`;
* `Find creators`;
* `Browse bloggers`.

Для премиального каталога лучше использовать конкретное действие: `Open catalog` или `Find creators`. Слишком общие варианты вроде `Start` или `App` хуже объясняют пользу.

#### Loading screen Mini App

Loading screen - это экран загрузки Mini App внутри Telegram. Он должен визуально совпадать с витриной: тот же бренд, настроение, цветовой акцент и уровень “премиальности”.

Что важно:

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

<details>

<summary>Что можно считать хорошим loading screen</summary>

Пользователь должен понять, что приложение загружается, а не зависло. Если loading screen визуально связан с витриной, переход из Telegram в Mini App ощущается цельным и профессиональным.

</details>

#### Preview ссылки на Mini App

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

Рекомендации:

* заголовок должен объяснять, что откроется каталог;
* описание должно обещать понятное действие;
* изображение должно совпадать с брендом витрины;
* preview не должен вводить в заблуждение;
* лучше избегать длинных технических URL в тексте сообщения.

Пример текста рядом со ссылкой:

```
Open the creator catalog, compare bloggers, and add selected options to your campaign request.
```

#### Команды бота

Если используются команды, их должно быть мало. Для клиентского бота чаще всего достаточно `/start`.

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

* `/start` - перезапустить сценарий;
* `/catalog` - открыть каталог, если команда поддерживается;
* `/help` - показать краткую помощь.

{% hint style="info" %}
Если все основные действия уже доступны через кнопки, не нужно перегружать бота списком команд. Кнопки обычно понятнее для обычного пользователя.
{% endhint %}

### Приветствие

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

{% tabs %}
{% tab title="Структура" %}
У хорошего приветствия есть три части:

1. кто говорит;
2. чем бот поможет;
3. что можно сделать прямо сейчас.

Пример:

```
Hello! I am your AI consultant for blogger selection.

Tell me who you need for your campaign, or open the catalog to explore all available creators.
```

{% endtab %}

{% tab title="Для продаж" %}
Если бот используется как часть коммерческой воронки, приветствие должно подталкивать к действию:

```
Looking for creators for your next campaign?

Describe your audience, niche, budget, or region, and I will suggest suitable bloggers from the catalog.
```

{% endtab %}

{% tab title="Для демо" %}
Если это демо-версия, лучше честно обозначить демонстрационный характер данных:

```
This is a demo catalog. Bloggers are fictional, and statistics links are provided only to show platform features.
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
Если в базе используются демонстрационные блогеры, приветствие должно прямо говорить об этом. Так платформа не вводит клиента в заблуждение и выглядит профессиональнее.
{% endhint %}

### Кнопки

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

Хорошие кнопки:

* `Open catalog`;
* `Find bloggers`;
* `Contact manager`;
* `View selected bloggers`;
* `Get recommendations`.

Слабые кнопки:

* `More`;
* `Info`;
* `Start`;
* `Submit`;
* `Next`.

<details>

<summary>Как выбирать текст кнопок</summary>

Текст кнопки лучше писать как действие. Не `Catalog`, а `Open catalog`. Не `Manager`, а `Contact manager`.

Такая формулировка снижает неопределенность: пользователь заранее понимает, что произойдет после клика.

</details>

### Тон AI-консультанта

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

{% tabs %}
{% tab title="Премиальный тон" %}
Подходит для дорогих интеграций и агентской модели.

Стиль: спокойный, экспертный, без лишнего энтузиазма.

```
I can suggest creators based on your campaign goals, target audience, geography, and budget.
```

{% endtab %}

{% tab title="Дружелюбный тон" %}
Подходит для массового каталога, малого бизнеса и легкого входа.

Стиль: проще, теплее, с мягкими подсказками.

```
Tell me what kind of audience you want to reach, and I will help you find suitable creators.
```

{% endtab %}

{% tab title="Деловой тон" %}
Подходит для B2B, экспертов и профессиональных ниш.

Стиль: коротко, структурно, без разговорных украшений.

```
Please specify the niche, region, budget, and campaign objective. I will prepare relevant creator options.
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
Тон бота должен совпадать с оформлением витрины. Если витрина премиальная, бот не должен писать слишком фамильярно. Если витрина молодежная и динамичная, бот не должен звучать как юридический документ.
{% endhint %}

### Ответы бота

Ответы должны помогать пользователю двигаться дальше. Даже если бот уточняет информацию, он должен объяснять, зачем это нужно.

Хороший ответ:

```
To suggest the right creators, please tell me the campaign niche, target region, approximate budget, and desired audience.
```

Слабый ответ:

```
Please provide more details.
```

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

<details>

<summary>Что бот должен уточнять</summary>

Для подбора блогеров чаще всего полезны:

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

</details>

### Финальное сообщение

Финальное сообщение после AI-подбора должно не просто завершать диалог, а переводить пользователя к действию.

Хорошая структура:

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

Пример:

```
I found several creators that may fit your campaign.

You can open the catalog to review their cards, compare prices, and add selected bloggers to your request.
```

{% hint style="success" %}
Финальное сообщение должно вести в витрину или к контакту. Если после ответа AI пользователь не понимает, что делать дальше, подбор теряет коммерческий смысл.
{% endhint %}

### Рассылки

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

Подходящие темы:

* новые блогеры в каталоге;
* подборки по нишам;
* специальные предложения;
* обновления платформы;
* полезные советы по рекламным кампаниям;
* сезонные подборки.

Плохие темы:

* слишком частые общие объявления;
* сообщения без ценности;
* одинаковые напоминания каждый день;
* длинные тексты без кнопки или действия.

<details>

<summary>Мини-чек-лист перед рассылкой</summary>

Перед отправкой рассылки проверьте:

* понятно ли сообщение с первой строки;
* есть ли причина отправлять его именно сейчас;
* есть ли кнопка или понятное действие;
* не слишком ли длинный текст;
* совпадает ли тон с брендом витрины.

</details>

### Посты в канал

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

Рекомендации:

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

{% hint style="warning" %}
Если у разных языковых версий разные рынки, не стоит публиковать один и тот же пост без адаптации. Для зарубежного рынка может отличаться тон, валюта, площадки, примеры и ожидания брендов.
{% endhint %}

### Медиа в сообщениях

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

Рекомендации:

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

Рекомендуемые имена файлов для документации:

* `bot-welcome-message.png`;
* `bot-ai-response.png`;
* `bot-admin-menu.png`;
* `bot-broadcast-example.png`;
* `bot-channel-post-example.png`.

### Типичные ошибки коммуникации

{% hint style="danger" %}
Коммуникация бота напрямую влияет на доверие. Даже при красивой витрине слабое приветствие или хаотичные рассылки могут создать ощущение сырого продукта.
{% endhint %}

Частые ошибки:

* приветствие слишком длинное;
* бот не объясняет, что умеет;
* не оформлены аватар, About и Description в Telegram;
* кнопка меню Mini App называется слишком абстрактно;
* loading screen не совпадает со стилем витрины;
* preview ссылки выглядит как техническая ссылка, а не как вход в продукт;
* кнопки называются абстрактно;
* AI-консультант отвечает общими фразами;
* финальное сообщение не ведет к следующему действию;
* рассылки отправляются слишком часто;
* посты в канал не адаптированы под рынок;
* медиа выглядит случайным;
* тон бота не совпадает с оформлением витрины;
* в демо-версии не указано, что блогеры вымышлены.

### Итоговый принцип

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://vitrina-blogerov.gitbook.io/bloggers-showcase/telegram-bot-1.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.