# Підключити Telegram-бота

Створіть бота в @BotFather, вставте токен у Happ, і агент почне відповідати клієнтам у Telegram.

> Full REST + WebSocket API reference: https://api.happ.tools/reference

## Що знадобиться [#що-знадобиться]

* Акаунт Telegram.
* Агент у Happ, який відповідатиме в боті. Немає агента? [Створіть з шаблону](/guides/create-agent).

<Steps>
  <Step>
    ### Створіть бота в @BotFather [#створіть-бота-в-botfather]

    Відкрийте [@BotFather](https://t.me/BotFather), надішліть `/newbot`, задайте назву й username бота. BotFather надішле **токен** вигляду `123456789:AA...`.
  </Step>

  <Step>
    ### Підключіть бота в Happ [#підключіть-бота-в-happ]

    Відкрийте **Інтеграції**, знайдіть **Telegram Bot** і натисніть на картку. Вставте токен і підтвердіть. Бот з'явиться в **Моїх інтеграціях**.
  </Step>

  <Step>
    ### Призначте агента [#призначте-агента]

    Відкрийте агента, вкладка **Інтеграції**, і прив'яжіть до нього бота. Без цього кроку бот приймає повідомлення, але не відповідає.
  </Step>

  <Step>
    ### Перевірте [#перевірте]

    Напишіть боту з особистого Telegram. Діалог з'явиться в **Чатах**, а агент відповість за кілька секунд.
  </Step>
</Steps>

<Callout type="warn" title="Токен = доступ до бота">
  Не надсилайте токен у чати і не публікуйте його. Якщо токен потрапив до чужих рук, згенеруйте новий у @BotFather командою `/revoke` і перепідключіть бота.
</Callout>

## Якщо не працює [#якщо-не-працює]

| Симптом                                       | Що зробити                                                                |
| --------------------------------------------- | ------------------------------------------------------------------------- |
| Бот не відповідає                             | Перевірте, що бот прив'язаний до агента, а в чаті увімкнено **Режим AI**. |
| Помилка при підключенні                       | Перекопіюйте токен повністю, без пробілів на початку і в кінці.           |
| Відповідає в групах, а треба лише в особистих | Вимкніть боту доступ до груп у @BotFather: `/setjoingroups`.              |

## Далі [#далі]

* [Інбокс](/guides/inbox): як менеджер перехоплює діалог у агента.
* [Telegram](/docs/integrations/messengers/telegram): підключення особистого акаунта замість бота.