Советы по развертыванию

Вот список вещей, которые следует помнить при размещении на хостинге большого бота.

Вас также могут заинтересовать наши инструкции по размещению ботов. Просмотрите Хостинг / Туториалы в верхней части страницы, чтобы увидеть некоторых хостинг-провайдеров, которые уже имеют специальные руководства.

Ошибки

1. Установите обработчик ошибок с помощью bot.catch для long polling или в вашем серверном фреймворке для вебхуков.
2. Используйте await для всех Promise и установите линтинг с правилами, которые гарантируют, что вы никогда об этом не забудете.

Отправка сообщений

1. Отправляйте файлы, передавая путь или Buffer вместо потока (stream), или по крайней мере убедитесь, что вы знаете о возможных подводных камнях.
2. Используйте bot.on("callback_query:data") в качестве резервного обработчика для реагирования на все callback_query.
3. Используйте плагин auto-retry для автоматической обработки ошибок, вызванных превышением лимита количества запросов, и повторной отправки таких запросов.

Масштабирование

Это зависит от типа развертывания.

Long Polling

1. Используйте плагин runner.
2. Используйте sequentialize с той же функцией для получения ключа сессии, что и в плагине сессий.
3. Просмотрите параметры конфигурации run (документация API) и убедитесь, что они соответствуют вашим потребностям, или даже рассмотрите возможность собрать собственный runner со своим источником обновлений и их поглотителем (sink). Главное, что нужно учитывать — это максимальная нагрузка, которую вы хотите применить к вашему серверу, то есть сколько обновлений может быть обработано одновременно.
4. Подумайте о реализации корректного завершения работы, чтобы завершить обработку текущих обновлений прежде чем вы остановите бота, например, для его обновления.

Вебхуки

1. Убедитесь, что вы не выполняете долговременные операции в middleware: например, передача больших файлов. Это приводит к ошибкам таймаута для вебхуков и дублированию обработки обновлений, поскольку Telegram будет повторно отправлять неподтвержденные обновления. Вместо этого рассмотрите возможность использования очереди задач.
2. Ознакомьтесь с конфигурацией webhookCallback (документация API).
3. Если вы изменяли параметр getSessionKey для плагина сессий, используйте sequentialize с той же функцией для получения ключа сессии, что и в плагине сессий.
4. Если вы работаете на бессерверной платформе или платформе с автоматическим масштабированием, установите информацию о боте, чтобы предотвратить чрезмерное количество вызовов getMe.
5. Подумайте об использовании ответов вебхука.

Сессии

1. Подумайте об использовании lazySessions, как описано здесь.
2. Используйте опцию storage для настройки вашего адаптера хранения данных, иначе все данные будут потеряны, когда процесс бота остановится.

Тестирование

Пишите тесты для своего бота. Это можно сделать с помощью grammY следующим образом:

1. Имитируйте исходящие запросы API с помощью трансформирующих функций.
2. Определите и отправьте образцы объектов обновления вашему боту с помощью bot.handleUpdate (документация API). Воспользуйтесь этими объектами обновления, предоставленными командой Telegram, для вдохновения.

Предложите собственный плагин для тестирования

Хотя grammY предоставляет необходимые хуки для начала написания тестов, было бы очень полезно иметь плагин для тестирования ботов. Это новая территория, т. к. таких плагинов для тестирования практически не существует. Мы с нетерпением ждем вашего вклада!

Пример того, как можно провести тестирование, можно найти здесь.