# Подключение telegram-бота
Telegram можно подключить к Swarmica при помощи telegram-бота, в том числе и в [качестве группового телеграм-бота](https://support.swarmica.com/article/ru/1551-podklyuchenie-gruppovogo-telegram-bota.html). Подключение канала или личного аккаунта на данный момент невозможно. 

Суть работы интеграции с telegram-ботом такова: клиент подписывается на бота, отправляет в него сообщение. Сообщение передаётся в Swarmica в качестве заявки, и на неё может отвечать агент. Агент не может инициировать переписку с клиентом, который пока не подписался на бота и ничего не написал.

<br />

> Telegram работает по принципу одно подключение \= 1 бот, поэтому, если ваш бот уже подключен к какому-либо сервису, необходимо [отключить бота от этого сервиса](https://support.swarmica.com/article/ru/338-ne-rabotaet-telegram-bot.html) или создать нового бота.

<br />

# Создание telegram-бота

Для создания нового бота перейдите по ссылке [https://t.me/botfather](https://t.me/botfather) в официальный бот Telegram, который создаёт новых ботов.

Запустите бота и введите или выберите /newbot

![](https://support.swarmica.com/attachments/5/E/5Eeb-sAcDjJxSKaT_a/image.png)

Введите и отправьте имя вашего бота. Это имя будут видеть ваши клиенты.

![](https://support.swarmica.com/attachments/E/Y/EY2UVgWe8iEnfE7s_a/image.png)

Затем задайте никнейм бота, по которому его можно будет найти в Telegram. Никнейм должен быть уникальным и заканчиваться на bot. Если никнейм уже занят, Telegram сообщит об этом в ответ.

![](https://support.swarmica.com/attachments/W/u/WuOyUBoLKsiQnwXG_a/image.png)

Если никнейм не занят, бот будет успешно создан, и Telegram выдаст такое сообщение:

![](https://support.swarmica.com/attachments/E/S/ESP34z51-_tMX_bS_a/image.png)

В первом сообщении BotFather, которое вы получили после запуска бота, можно найти список команд для редактирования бота:

![](https://support.swarmica.com/attachments/R/V/RV7ayNPo2V7yldxI_a/image.png)

Можно нажимать на эти команды или вводить в поле сообщения и отправлять.

**/setuserpic** позволит вам установить аватар вашего бота. Картинку нужно будет прикрепить к ответному сообщению:

![](https://support.swarmica.com/attachments/_/G/_GJzxYQCei7vJv6J_a/image.png)

**/setdescription** позволит добавить боту описание, которое увидят ваши клиенты при подключении к боту:

![](https://support.swarmica.com/attachments/O/K/OKMNHyAgEu0VmPY3_a/image.png)

Описание тоже нужно будет отправить ответным сообщением:

![](https://support.swarmica.com/attachments/w/q/wq0HfH8IayQaz2A5_a/image.png)

После завершения необходимых настроек подключите бот к Swarmica.

# Подключение telegram-бота

Перейдите в Swarmica в раздел **Настройки - Каналы** и выберите **Telegram**. На открывшейся странице нажмите **Создать**:

![](https://support.swarmica.com/attachments/i/y/iywqmSVdfb_4Jl8k_a/image.png)

Введите название канала, на которое вам удобно будет ориентироваться при обработке заявок и нажмите !["Сохранить"](https://support.swarmica.com/attachments/P/F/PFSNQ5jDqxYe0BaJ_a/image.png)

![](https://support.swarmica.com/attachments/s/g/sg9LDA5S920ljco0_a/image.png)

Откроется страница настроек:

![](https://support.swarmica.com/attachments/3/T/3TvQTCz90AU3q8ZU_a/image.png)

Прежде всего, сюда нужно ввести токен вашего бота. Его можно найти в сообщении, которое пришло вам в ответ на успешно добавленный никнейм бота. Найдите его в чате с BotFather и нажмите на токен (сочетание букв и цифр) чтобы его скопировать:

![](https://support.swarmica.com/attachments/A/2/A2vepRMzH5wVZZJ__a/image.png)

Вставьте его в соответствующее поле настроек Swarmica.

Выберите, куда будут попадать сообщения, полученные из Telegram-бота: в заявки или в чаты:

![](https://support.swarmica.com/attachments/M/7/M7Fp1PDGW0Kr7mIb_a/image.png)

Про отличие специфик заявок и чатов мы написали [в отдельной статье](https://support.swarmica.com/article/ru/452-rezhimy-omnikanalnosti.html).

Активируйте бегунок "Включен", чтобы активировать канал, и сохраните настройки:

![](https://support.swarmica.com/attachments/g/T/gTsvQXHy3zUYmqj9_a/image.png)

## Действия на сервере

После сохранения настроек бота зайдите на сервер Swarmica по SSH:

1 - Проверьте, что в `/root/swarmica/docker-compose.yml `контейнер telegram раскоментирован и выглядит следующим образом:

```txt
  telegram:
    <<: *django
    depends_on:
      django:
        condition: service_healthy
    command: /start-telegram
    labels:
      - "traefik.enable=false"
```

:::caution
В предыдущих версия Свормики может быть:



```txt
  telegram:
    <<: *django
    depends_on:
      - postgres
      - redis
    command: /start-telegram
    labels:
      - "traefik.enable=false"
```


:::

При необходимости контейнер раскоментируйте контейнер.

2 - Если вносились изменения в `/root/swarmica/docker-compose.yml`, то выполните команду, чтобы пересоздать все контейнеры:

```txt
docker compose down && docker compose up -d
```

Иначе выполните

```bash
docker compose restart telegram
```

:::note
Для облачных инсталляций или в случае возникновения трудностей обратитесь в службу поддержки Swarmica для его активации!
:::