# 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, недостаточно прав для отправки текстовых сообщений в этот чат

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

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


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.
