> For the complete documentation index, see [llms.txt](https://doc.nextbot.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.nextbot.ru/questions-answers/errors-description/channels/telegram.md).

# Telegram

Ошибки при отправке сообщений через Telegram.

***

### `TELEGRAM_SEND_MESSAGE_UNKNOWN` — неизвестная ошибка

**Описание:** Неизвестная ошибка при отправке сообщения в Telegram, обратитесь в техподдержку Nextbot для уточнения причины

**Причина:** Ошибка не распознана.

**Решение:** Обратитесь в техподдержку Nextbot с кодом и деталями.

***

### `TELEGRAM_SEND_MESSAGE_BUSINESS_PEER_INVALID` — бот не привязан к личному профилю

**Описание:** Ошибка при отправке сообщения в Telegram, бот не привязан к личному профилю

**Причина:** Для работы в бизнес-режиме бот должен быть привязан к личному аккаунту Telegram.

**Решение:** Убедитесь, что бот привязан к вашему Telegram-аккаунту через настройки бизнес-профиля.

***

### `TELEGRAM_SEND_MESSAGE_BUSINESS_CONNECTION_NOT_ALLOWED` — бот не в бизнес-режиме

**Описание:** Ошибка при отправке сообщения в Telegram, бот не переведен в бизнес-режим в BotFather

**Причина:** Бот не настроен для работы в режиме Business.

**Решение:** Используйте **BotFather**, включите режим **Business** для бота.

***

### `TELEGRAM_SEND_MESSAGE_BUSINESS_CONNECTION_INVALID` — бизнес-соединение недействительно

**Описание:** Ошибка при отправке сообщения в Telegram, бизнес-соединение c ботом недействительно или неактивно

**Причина:** Соединение с бизнес-аккаунтом разорвано или отозвано.

**Решение:** Переподключите бота к бизнес-профилю через BotFather.

***

### `TELEGRAM_SEND_MESSAGE_BUSINESS_PEER_USAGE_MISSING` — пользователь не связывался недавно

**Описание:** Ошибка при отправке сообщения в Telegram, вы не можете отправить сообщение пользователю через бизнес-подключение, если пользователь недавно с вами не связывался

**Причина:** Правила Telegram: первое сообщение может отправить только пользователь.

**Решение:** Дождитесь, пока пользователь сам напишет боту. Не инициируйте диалог первым.

***

### `TELEGRAM_SEND_MESSAGE_BOT_BLOCKED` — бот заблокирован пользователем

**Описание:** Ошибка при отправке сообщения в Telegram, бот заблокирован пользователем

**Причина:** Пользователь заблокировал бота.

**Решение:** Пользователь должен разблокировать бота в настройках Telegram.

***

### `TELEGRAM_SEND_MESSAGE_VOICE_MESSAGES_FORBIDDEN` — голосовые сообщения запрещены

**Описание:** Ошибка при отправке сообщения в Telegram, пользователь запретил отправлять себе голосовые сообщения

**Причина:** В настройках приватности пользователь запретил получение голосовых сообщений.

**Решение:** Отправьте текстовое сообщение вместо голосового или попросите пользователя разрешить голосовые.

***

### `TELEGRAM_SEND_MESSAGE_USER_DEACTIVATED` — аккаунт получателя деактивирован

**Описание:** Ошибка при отправке сообщения в Telegram, аккаунт получателя деактивирован

**Причина:** Пользователь удалил или деактивировал аккаунт Telegram.

**Решение:** Отправка невозможна. Убедитесь, что пользователь активен.

***

### `TELEGRAM_SEND_MESSAGE_CANT_INITIATE` — бот не может инициировать диалог

**Описание:** Ошибка при отправке сообщения в Telegram, бот не может инициировать диалог с пользователем

**Причина:** Пользователь ещё не начал диалог с ботом.

**Решение:** Пользователь должен первым написать боту (нажать /start или отправить сообщение).

***

### `TELEGRAM_SEND_MESSAGE_PEER_FLOOD` — ограничение из-за спама

**Описание:** Telegram ограничил исходящие сообщения бота: сработала антиспам-защита при массовых первых контактах, подозрительной активности или слишком частых обращениях к разным пользователям.

**Причина:** Сработали антиспам-ограничения Telegram из-за массовых первых контактов, подозрительной активности или слишком частых обращений к разным пользователям.

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

***

### `TELEGRAM_SEND_IMAGE_WRONG_FORMAT` — неподдерживаемый формат изображения

**Описание:** Ошибка при отправке изображения в Telegram, формат изображения не поддерживается

**Причина:** Формат файла не поддерживается Telegram.

**Решение:** Используйте поддерживаемые форматы (JPG, PNG и т.п.).

***

### `TELEGRAM_SEND_IMAGE_FAILED_TO_GET_HTTP_URL` — не удалось получить изображение по ссылке

**Описание:** Ошибка при отправке изображения в Telegram, не удалось получить изображение по ссылке, возможно изображение слишком большое или имеет недопустимый формат

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

**Решение:** Проверьте ссылку, размер и формат изображения. Убедитесь, что файл доступен по HTTP/HTTPS.

***

### `TELEGRAM_SEND_MESSAGE_NOT_ENOUGH_RIGHTS` — недостаточно прав в чате

**Описание:** Ошибка при отправке сообщения в Telegram, недостаточно прав для отправки текстовых сообщений в этот чат

**Причина:** У бота нет прав на отправку сообщений в групповой чат.

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

***

### Групповой чат был обновлён до супергруппового чата

**Описание:** Ошибка при отправке сообщения или отчёта в Telegram: группа была преобразована в супергруппу.

**Причина:** Telegram изменил идентификатор чата (`chat_id`). Nextbot может пытаться отправить сообщение в старый чат, который больше не используется.

**Решение:** Заново добавьте бота в группу и отправьте одноразовый пароль администратора, чтобы обновить привязку чата.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://doc.nextbot.ru/questions-answers/errors-description/channels/telegram.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
