---
title: "Деплой приложения vkbottle"
---

# Деплой приложения vkbottle

> Полный индекс документации для ИИ-агентов: [llms.txt](https://timeweb.cloud/llms.txt).

В App Platform вы можете развернуть бота для VK на [vkbottle](https://vkbottle.readthedocs.io/ru/latest/high-level/bot/). Бот может получать сообщения с помощью long polling или вебхуков (Callback API).

## Сборка приложения

При сборке используется Python. Версию можно выбрать при создании приложения. Убедитесь, что она совместима с используемой версией vkbottle.

Сборка выполняется в корне репозитория или в директории, которую вы укажете в поле «Путь до директории проекта».

Убедитесь, что в файле `requirements.txt` указан vkbottle и остальные зависимости проекта.

В расширенных настройках проверьте команды сборки и запуска. Для установки зависимостей из `requirements.txt` используется команда сборки:

```shell
pip install --upgrade -r requirements.txt
```

Если основной файл бота называется `main.py`, для запуска используйте команду:

```shell
python3 main.py
```

Если ваш проект собирается или запускается по-другому, скорректируйте команды.

## Переменные

При выборе vkbottle App Platform по умолчанию добавит переменную `BOT_TOKEN`. Укажите в ней ключ доступа сообщества VK, от имени которого будет работать бот.

Если в вашем проекте переменная для токена называется иначе, создайте ее вручную в блоке «Переменные» и укажите значение.

## Деплой приложения

После настройки приложения нажмите «Запустить деплой». Ход сборки и запуска можно отслеживать на вкладке «Деплой».

Когда бот запустится, отправьте ему команду, для которой в проекте настроен обработчик, и проверьте ответ в VK.

## Настройка вебхуков

Вы можете использовать вебхуки (Callback API) для получения событий от VK. Для этого подойдет бесплатный технический домен App Platform или собственный домен, привязанный к приложению.

Получить технический домен или привязать собственный можно только после первого деплоя. Поэтому пока для настройки вебхуков нужно выполнить первый деплой с незаполненным доменом в переменной. Деплой завершится ошибкой. После этого укажите домен в переменной и запустите деплой повторно:

1.  Настройте проект так, чтобы он считывал домен вебхука из переменной окружения — например, `WEBHOOK_DOMAIN`. Секрет для проверки запросов можно передавать через `WEBHOOK_SECRET`. Добавьте эти переменные в панели управления при создании приложения. Названия должны совпадать с теми, которые используются в коде.
    
2.  Нажмите «Запустить деплой». Дождитесь его завершения с ошибкой из-за незаполненного домена.
    
3.  Откройте вкладку «Дашборд» приложения и скопируйте выданный технический домен. Если хотите использовать собственный домен, сначала подключите его к приложению по [инструкции](https://timeweb.cloud/docs/apps/domain).
    
4.  На вкладке «Настройки» откройте редактирование настроек деплоя и для переменной `WEBHOOK_DOMAIN` укажите домен, установленный для приложения.
    
5.  Сохраните изменения. Запустится повторный деплой приложения. С заполненным доменом приложение сможет запустить обработчик событий Callback API.
    

Если бот использует long polling, он сам запрашивает новые события у VK. В этом случае настраивать вебхуки и домен не требуется.

## Устранение неполадок

### Не удается выполнить развертывание

В первую очередь проверьте лог деплоя. Убедитесь, что все зависимости указаны в `requirements.txt`, а команда запуска указывает на существующий файл. Также проверьте совместимость версии Python с используемой версией vkbottle.

### Бот не отвечает на сообщения

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

Проверьте разрешения ключа доступа и настройки получения событий в сообществе VK. Если используется Callback API, убедитесь, что сервер подтвержден и получение нужных событий включено.

Если используются вебхуки, проверьте значение `WEBHOOK_DOMAIN` и секрет. Убедитесь, что HTTP-сервер слушает `0.0.0.0`, а не `127.0.0.1`, иначе внешние подключения работать не будут. Если после первого неуспешного деплоя домен еще не указан, укажите его и запустите повторный деплой, как описано в разделе «Настройка вебхуков».
