> ## Documentation Index
> Fetch the complete documentation index at: https://aitextura.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Связь с агентом

> Подключение Telegram и других мессенджеров к автономному агенту: бот создаётся без токена, писать агенту смогут только те, кого вы укажете.

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

<Frame>
  <img src="https://mintcdn.com/aitextura/IcbjYavKcdIF3mMS/assets/images/ru/agents/connect-channels.jpg?fit=max&auto=format&n=IcbjYavKcdIF3mMS&q=85&s=ede51d87bf588e1d4e88342ea508bb38" alt="Вкладка «Связь»: карточки Telegram, Discord, Slack, Mattermost, IRC, Nostr, WhatsApp со статусом «Не подключено»" width="1054" height="748" data-path="assets/images/ru/agents/connect-channels.jpg" />
</Frame>

| Мессенджер                               | Комментарий                                                            |
| ---------------------------------------- | ---------------------------------------------------------------------- |
| **Telegram**                             | Основной способ. Бота можно создать прямо из платформы, токен не нужен |
| **Discord** · **Slack** · **Mattermost** | Для команд, которые уже там работают                                   |
| **IRC** · **Nostr**                      | Для тех, кто знает, зачем они им                                       |
| **WhatsApp**                             | Подключается по тому же принципу                                       |

<Note>Это каналы агента, а не [каналы ИИ-сотрудника](/ru/channels). Здесь общаетесь вы, а не ваши клиенты, и настраиваются они отдельно у каждого агента.</Note>

## Что понадобится

* Аккаунт в Telegram — на телефоне или в десктопном приложении.
* Ваш Telegram ID, если подключаете бота своим токеном. Узнать: напишите боту `@userinfobot`, он ответит числом.
* Ничего больше: сервер, домен и токен от платформы не нужны.

## Подключите Telegram

Нажмите карточку **Telegram** — откроется панель с двумя вкладками.

<Frame>
  <img src="https://mintcdn.com/aitextura/IcbjYavKcdIF3mMS/assets/images/ru/agents/telegram-panel.jpg?fit=max&auto=format&n=IcbjYavKcdIF3mMS&q=85&s=300c30e286ba8abc625ce18e044c6681" alt="Панель Telegram с вкладками «Создать через нас» и «Свой токен»" width="1054" height="748" data-path="assets/images/ru/agents/telegram-panel.jpg" />
</Frame>

<Tabs>
  <Tab title="Создать через нас">
    <Steps>
      <Step title="Нажмите «Создать Telegram-бота»">
        Платформа откроет `t.me`. Браузер спросит разрешение открыть приложение Telegram — разрешите.
      </Step>

      <Step title="Придумайте боту имя">
        В Telegram откроется служебный экран **Создание бота**: **НАЗВАНИЕ БОТА** — как он будет подписан в переписке, **ИМЯ ПОЛЬЗОВАТЕЛЯ** — уникальный адрес, обязан заканчиваться на `bot`. Нажмите **Создать**.
      </Step>

      <Step title="Нажмите «Начать» в чате с ботом">
        Откроется чат с новым ботом. Обязательно нажмите **Начать** (команда `/start`) — без этого платформа не свяжется с ботом.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Свой токен">
    Подходит, если бот уже создан у `@BotFather`.

    <Frame>
      <img src="https://mintcdn.com/aitextura/IcbjYavKcdIF3mMS/assets/images/ru/agents/telegram-token.jpg?fit=max&auto=format&n=IcbjYavKcdIF3mMS&q=85&s=95238a077378047e28ec296f6bfb2364" alt="Форма «Свой токен»: поля «Токен бота» и «Ваш Telegram ID», кнопка «Подставить мой ID»" width="1054" height="748" data-path="assets/images/ru/agents/telegram-token.jpg" />
    </Frame>

    <Steps>
      <Step title="Вставьте токен">
        Поле **Токен бота** — строка вида `123456789:AA...` от `@BotFather`. Токен уходит прямо в настройки агента, не сохраняется в переписке и в браузер больше не возвращается.
      </Step>

      <Step title="Укажите, кто может писать">
        Поле **Ваш Telegram ID** — числовые ID через запятую. Кнопка **Подставить мой ID** вписывает ваш автоматически. Чужой ID узнаётся тем же `@userinfobot`.
      </Step>

      <Step title="Нажмите «Подключить»">
        Статус карточки Telegram сменится на **Подключено**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Кто может писать агенту

Отвечать агент будет только тем, чьи Telegram ID перечислены в настройке. Все остальные, кто найдёт бота, получат тишину.

<Warning>Это единственный барьер между вашим агентом и посторонними. У агента есть доступ к вашим файлам, почте и командной строке — не добавляйте ID людей, которым не доверяете этот доступ целиком. Подробнее — [Безопасность и доступы](/ru/agents/security).</Warning>

Чтобы подключить коллегу — узнайте его ID через `@userinfobot` и допишите через запятую в то же поле.

## Проверьте

Напишите боту «Привет». Свежий агент ответит знакомством — спросит, как к вам обращаться, и предложит себе имя. Уже настроенный ответит по делу.

Если вы ещё не проходили [первый запуск](/ru/agents/first-run), сейчас самое время: то, что вы расскажете о себе, он запишет в свои файлы.

## Если не заработало

| Симптом                              | Причина и что сделать                                                                |
| ------------------------------------ | ------------------------------------------------------------------------------------ |
| Бот молчит на любое сообщение        | Не нажата кнопка **Начать** в чате с ботом. Откройте чат и нажмите её                |
| Бот молчит только у коллеги          | Его Telegram ID не добавлен в поле **Ваш Telegram ID**                               |
| «Токен недействителен»               | Токен скопирован с лишним пробелом или уже отозван в `@BotFather` — выпустите новый  |
| Бот отвечает, но не тому агенту      | Один бот работает с одним агентом. Для второго агента создайте отдельного бота       |
| Ответы приходят с задержкой в минуты | Контейнер перезапускался. Проверьте статус агента и [Журнал](/ru/agents/maintenance) |

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

<AccordionGroup>
  <Accordion title="Можно обойтись без мессенджера?">
    Да. Кнопка **Чат** в кабинете открывает тот же диалог с агентом. Telegram нужен ради телефона: ставить задачи по дороге и получать [плановые сводки](/ru/agents/schedule) вы будете именно там.
  </Accordion>

  <Accordion title="Где взять Telegram ID?">
    Напишите боту `@userinfobot` — он ответит числом. Это не `@имя`, а именно цифры. Свой ID можно не искать: кнопка **Подставить мой ID** вписывает его сама.
  </Accordion>

  <Accordion title="Несколько человек в одном чате с агентом">
    Добавьте их ID через запятую. Каждый пишет агенту лично; общий групповой чат — это другой сценарий, и для клиентских групп есть [ИИ-сотрудник](/ru/channels/telegram-groups).
  </Accordion>

  <Accordion title="Как отключить канал?">
    Откройте карточку мессенджера на вкладке **Связь** и очистите поле токена. Пустое поле отключает подключение.
  </Accordion>

  <Accordion title="Что с остальными мессенджерами?">
    Discord, Slack, Mattermost, IRC, Nostr и WhatsApp подключаются по тому же принципу: карточка → панель подключения → данные доступа. Ограничение «кто может писать» работает и там.
  </Accordion>
</AccordionGroup>

## Что дальше

<CardGroup cols={2}>
  <Card title="Первый запуск" icon="comments" href="/ru/agents/first-run">
    Первый разговор с агентом в подключённом мессенджере
  </Card>

  <Card title="Расписание" icon="clock" href="/ru/agents/schedule">
    Сводки, которые будут приходить в этот же чат
  </Card>

  <Card title="Безопасность и доступы" icon="shield-halved" href="/ru/agents/security">
    Кому давать доступ к агенту, а кому нет
  </Card>

  <Card title="Команда" icon="users" href="/ru/agents/team">
    Отдельный бот для каждой персоны агента
  </Card>
</CardGroup>