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

# Telegram

> Підключіть Telegram до CostCare AI, щоб ваші AI-агенти могли відповідати на повідомлення клієнтів у Telegram.

# Telegram

Підключіть Telegram-бота до CostCare AI, щоб ваші AI-агенти могли отримувати повідомлення від клієнтів у Telegram та відповідати на них. Ви можете підключити бота, якого вже створили через [BotFather](https://t.me/botfather), або створити нового з нуля.

## Підключення наявного Telegram-бота

<Steps>
  <Step title="Відкрийте BotFather">
    У Telegram знайдіть **BotFather** і відкрийте його. Переконайтеся, що це офіційний, верифікований акаунт BotFather.
  </Step>

  <Step title="Знайдіть свого бота">
    У BotFather оберіть свого бота в розділі **My Bots**, потім відкрийте екран налаштувань/токена.
  </Step>

  <Step title="Скопіюйте токен бота">
    Скопіюйте HTTP API токен. Він виглядає так:

    ```
    1234567890:ABCDefGhIJKlmnoPQRstuVWxyz...
    ```

    <Warning>
      Не діліться цим токеном публічно. Будь-хто з цим токеном може керувати вашим ботом.
    </Warning>
  </Step>

  <Step title="Відкрийте дашборд CostCare">
    Перейдіть до **Dashboard → Channels** і натисніть **Add new channel**.
  </Step>

  <Step title="Оберіть Telegram">
    У вікні, що з'явиться, оберіть **Telegram**, потім натисніть **Connect Telegram**.
  </Step>

  <Step title="Вставте токен">
    Вставте токен з BotFather у поле **Bot Token**, потім натисніть **Connect Bot**.
  </Step>

  <Step title="Перевірте, що канал створено">
    Канал Telegram має з'явитися у списку каналів ліворуч, приблизно так:

    ```
    @your_bot_name
    Type: telegram
    Status: Disabled / AI inactive
    ```
  </Step>

  <Step title="Увімкніть AI для каналу">
    * **Channels → канал Telegram → Enable AI for this channel**
  </Step>

  <Step title="Оберіть агента">
    На сторінці **Channels** відкрийте блок **Agent** для каналу та оберіть агента у списку **Assigned agent**.
  </Step>

  <Step title="Перевірте роботу бота">
    Відкрийте свого бота в Telegram і надішліть `/start`, а потім введіть своє повідомлення. У CostCare перейдіть до **Dashboard → Chats** — має з'явитися новий чат Telegram з вашим повідомленням.
  </Step>
</Steps>

<Frame caption="Підключення наявного Telegram-бота">
  <iframe src="https://www.loom.com/embed/5bb1f0aa0aef4ce883b44652a5b46ede" title="Підключення наявного Telegram-бота" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" className="w-full aspect-video rounded-xl" allowFullScreen />
</Frame>

## Створення та підключення нового Telegram-бота

<Steps>
  <Step title="Відкрийте BotFather">
    У Telegram знайдіть **@BotFather** і відкрийте офіційного бота.
  </Step>

  <Step title="Почніть створення бота">Надішліть `/newbot`.</Step>

  <Step title="Введіть назву бота">
    Коли BotFather запитає "Alright, a new bot. How are we going to call it?",
    введіть публічну назву, наприклад `CostCare Bot`. Цю назву бачитимуть
    ваші клієнти.
  </Step>

  <Step title="Введіть ім'я користувача бота">
    Введіть ім'я користувача для бота. Воно має бути унікальним, містити лише
    латинські літери, цифри або підкреслення та закінчуватися на `bot` —
    наприклад, `cool_costcare_bot`.
  </Step>

  <Step title="Скопіюйте згенерований токен">
    BotFather відповість повідомленням "Use this token to access the HTTP API:"
    з токеном після нього. Скопіюйте його.
  </Step>

  <Step title="Підключіть бота в CostCare">
    Перейдіть до **Dashboard → Channels → Add new channel**, оберіть **Telegram**,
    вставте токен у поле **Bot Token**, потім натисніть **Connect Bot**.
  </Step>

  <Step title="Увімкніть AI">
    Перемкніть **Disable AI in all chat**, потім підтвердіть **Yes, enable**.
    Надішліть повідомлення з Telegram і перевірте, що AI відповідає.
  </Step>

  <Step title="Оберіть агента">
    На сторінці **Channels** відкрийте блок **Agent** для каналу та оберіть агента у списку **Assigned agent**.
  </Step>
</Steps>

<Frame caption="Створення та підключення нового Telegram-бота">
  <iframe src="https://www.loom.com/embed/99d11c1ae205400d9c9ecc4952e781f5" title="Створення та підключення нового Telegram-бота" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" className="w-full aspect-video rounded-xl" allowFullScreen />
</Frame>