> 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/admin-panel/pervichnaya-nastroika.md).

# Первичная настройка

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

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

### Быстрый чек-лист

1. Войти в веб-админку.
2. Сменить пароль администратора.
3. Подключить Telegram bot token.
4. Настроить AI для витринного поиска.
5. Настроить AI для Telegram-бота.
6. Проверить и адаптировать промпты.
7. Добавить Telegram ID администраторов бота.
8. Указать `CHANNEL_ID` для постов в канал.
9. Настроить приветствие бота.
10. Настроить финальное сообщение после выдачи результатов.
11. Проверить витрину, Mini App и `/start` в боте.

```mermaid
flowchart TD
    A["Установка завершена"] --> B["Смена пароля"]
    B --> C["Telegram bot token"]
    C --> D["AI: витрина и бот"]
    D --> E["Промпты"]
    E --> F["Админы бота и канал"]
    F --> G["Приветствие и финальное сообщение"]
    G --> H["Проверка витрины и Telegram"]
```

### 1. Вход в админ-панель

Откройте админ-панель установленной языковой версии:

```
https://example.com/bloggers/ru/admin
```

Замените `ru` на нужную версию: `en`, `zh` или `ar`.

Логин и пароль задаются во время установки. Если доступ потерян, используйте серверную утилиту смены администратора.

### 2. Смена пароля после установки

Сразу после установки рекомендуется сменить пароль администратора на рабочий пароль владельца проекта.

{% columns %}
{% column %}

<div data-with-frame="true"><figure><img src="https://2999607467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuwCSpQuu1p5soxSClCET%2Fuploads%2F9155sPgSpIRXcDBSRZXS%2Fsystem-section.png?alt=media&amp;token=070db508-b2b5-41f2-a1c7-145f22237024" alt=""><figcaption><p>Раздел "Система"</p></figcaption></figure></div>
{% endcolumn %}

{% column %}

<div align="left" data-with-frame="true"><figure><img src="https://2999607467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuwCSpQuu1p5soxSClCET%2Fuploads%2FheemHhYnC600SmtusTGQ%2Fchange-password.png?alt=media&amp;token=d47be0ce-fc0c-4209-b992-40977b50378b" alt=""><figcaption><p>Смена пароля</p></figcaption></figure></div>
{% endcolumn %}
{% endcolumns %}

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

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

### 3. Telegram bot token

Telegram bot token подключает платформу к боту. Без него бот не сможет принимать сообщения, открывать Mini App, отправлять рассылки и публиковать посты.

Для каждой языковой версии нужен отдельный бот и отдельный token.

{% hint style="warning" %}
Один Telegram bot token нельзя использовать в нескольких языковых версиях. Кнопка Mini App и Telegram polling привязаны к конкретному боту и конкретной версии.
{% endhint %}

После сохранения токена проверьте бота командой:

```
/start
```

### 4. AI API для поиска и бота

AI настраивается в двух местах:

{% tabs %}
{% tab title="Агент поиска" %}
Используется на витрине. Пользователь пишет задачу в расширенном поиске, а агент возвращает подходящие карточки из базы.

<div data-with-frame="true"><figure><img src="https://2999607467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuwCSpQuu1p5soxSClCET%2Fuploads%2FKUeqa3bcBlOI2yQaLmCa%2Fai-search-section.png?alt=media&amp;token=128c0027-dd35-43c5-84ba-fe14adada82f" alt=""><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="Telegram-бот" %}
Используется в диалоге с пользователем. Бот задает уточняющие вопросы, подбирает блогеров и отправляет карточки.

<div data-with-frame="true"><figure><img src="https://2999607467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuwCSpQuu1p5soxSClCET%2Fuploads%2FyGMPw7Y1y0WvtFOQsHQG%2Fai-bot-section.png?alt=media&amp;token=b9eebf35-03f3-46ff-a5a3-22d8557e112e" alt=""><figcaption></figcaption></figure></div>
{% endtab %}
{% endtabs %}

Платформа поддерживает несколько OpenAI-совместимых провайдеров, но для релизной эксплуатации строго рекомендуется использовать `Groq`.

{% hint style="danger" %}
Рекомендуемый провайдер - `Groq`. Остальные провайдеры присутствуют в интерфейсе как совместимые варианты, но они не проходили полный цикл тестирования в этом релизе.
{% endhint %}

Рекомендуемые базовые значения:

```
Provider: groq
Model: llama-3.3-70b-versatile
```

API key хранится в настройках выбранной языковой версии. Для каждой версии можно использовать отдельные ключи.

### 5. Отстройка промптов

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

После установки стоит проверить стандартные промпты и адаптировать их под рынок:

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

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

Подробнее: [Примеры промтов.](/bloggers-showcase/prilozheniya/primery-promtov.md)

### 6. Администраторы Telegram-бота

Telegram-администраторы задаются через числовые Telegram ID. Это не username и не логин веб-админки.

<div data-with-frame="true"><figure><img src="https://2999607467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuwCSpQuu1p5soxSClCET%2Fuploads%2FwxuvBD5iwPIIk9V7TwdG%2Ftelegram-audience-1.png?alt=media&amp;token=9b37e13d-f636-45d5-8589-d54479f2136b" alt=""><figcaption></figcaption></figure></div>

Добавьте ID людей, которым можно управлять ботом из Telegram:

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

{% hint style="warning" %}
Не добавляйте username вместо ID. Username можно поменять, а Telegram ID остается постоянным.
{% endhint %}

### 7. Канал для публикаций

Чтобы бот публиковал посты в канал, нужно указать `CHANNEL_ID` и добавить бота администратором канала.

`CHANNEL_ID` может выглядеть как числовой ID канала. Для приватных и супергрупповых каналов часто используется формат с `-100`.

После настройки отправьте тестовый пост из админки или Telegram-админки.

### 8. Приветствие бота

Приветствие - первое сообщение после `/start`. Оно должно быстро объяснять пользователю:

* кто этот бот;
* что он умеет;
* как открыть каталог;
* что можно написать запрос обычным текстом.

<div data-with-frame="true"><figure><img src="https://2999607467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuwCSpQuu1p5soxSClCET%2Fuploads%2FYjGYhal3TthQwYG3q7SR%2Ftelegram-audience-2.png?alt=media&amp;token=00b920dc-d463-4024-a9c2-30e96dfe9be7" alt=""><figcaption></figcaption></figure></div>

К приветствию можно добавить медиа и кнопки.

### 9. Финальное сообщение после выдачи результатов

Финальное сообщение отправляется после AI-подбора блогеров. Его задача - перевести интерес пользователя в действие.

Обычно в нем размещают:

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

### 10. Финальная проверка

Перед показом платформы клиентам проверьте:

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

<details>

<summary>Если что-то не работает</summary>

Сначала проверьте правильность языковой версии и токенов. Затем смотрите раздел [Возможные ошибки](/bloggers-showcase/vozmozhnye-oshibki/o-razdele.md).

</details>


---

# 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/admin-panel/pervichnaya-nastroika.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.