---
title: Что такое Telegram bot
description: Telegram bot — канал для отправки текста, фото, видео, аудио и документов
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://docs.mydialogi.ru/llms.txt). Append `.md` to any page URL for its markdown version.



> **Коротко:** Telegram bot — канал для отправки сообщений от вашего бота. Поддерживает текст, фото, видео, аудио, голосовые и документы.

## Кому подходит

- Роль: Клиент, Менеджер рассылок, Разработчик
- Уровень: Новичок / Опытный

## Что это

**Telegram bot** — канал для отправки сообщений через вашего бота в Telegram. Работает от имени бота.

Пользователь должен сначала **начать диалог с ботом** — только после этого бот может отправлять ему сообщения. Это особенность Telegram, связанная с политикой приватности.

## Перед началом

- [ ] У вас есть имя отправителя Telegram bot со статусом **Активно** — [Имя отправителя для Telegram →](https://docs.mydialogi.ru/05-channels/07-telegram/sender-id).
- [ ] Ваш бот создан в Telegram и подключён к платформе.
- [ ] У вас есть контакты или таргет.

## Что содержит

Канал поддерживает **6 типов сообщений**:

| Тип | Что содержит |
|---|---|
| **Текст** | Только текст — до **2000 знаков** |
| **Фото** | Изображение + подпись (опционально) |
| **Видео** | Видео + подпись (опционально) |
| **Аудио** | Аудиофайл + подпись (опционально) |
| **Голосовое** | Голосовое сообщение + подпись (опционально) |
| **Документ** | Файл + подпись (опционально) |

<Note>
Для каждого медиа-типа обязателен параметр **`link`** — URL файла. Параметр **`caption`** — опционально: описание под медиа.
</Note>

## Как настроить

### 1. Откройте настройки Telegram

В форме создания рассылки выберите канал **Telegram bot**.

### 2. Выберите тип сообщения

Один из шести: **Текст**, **Фото**, **Видео**, **Аудио**, **Голосовое** или **Документ**.

### 3. Настройте содержимое

**Текст:**

1. Введите текст — максимум **2000 знаков**.
2. При необходимости используйте персонализацию через атрибуты.

**Медиафайл** (фото, видео, аудио, голосовое, документ):

1. Нажмите на плейсхолдер медиа.
2. Загрузите с устройства или выберите из базы **Медиа**.
3. Введите подпись.
4. При необходимости добавьте персонализацию.

### 4. Выберите имя отправителя

В поле **Отправитель** выберите имя со статусом **Активно**.

### 5. Настройте статус и таймаут

| Статус | Что означает |
|---|---|
| **Доставлено** | Доставлено на устройство получателя |
| **Отправлено** | Отправлено в Мессенджер |

### 6. Сохраните

Нажмите **Сохранить**.

## Поддерживаемые форматы

| Тип | Форматы |
|---|---|
| **Изображения** | JPG, PNG, GIF |
| **Видео** | MP4 |
| **Аудио** | MP3, OGG |
| **Документы** | PDF, DOC, DOCX и другие |

## Результат

Сообщение через Telegram bot настроено и готово к отправке в рассылке.

- [Что такое Telegram Gateway →](https://docs.mydialogi.ru/05-channels/07-telegram/telegram-gateway)
- [Имя отправителя для Telegram →](https://docs.mydialogi.ru/05-channels/07-telegram/sender-id)

> **Сколько это стоит?**
> Telegram bot тарифицируется за сообщение.
> Подробнее: [Обзор тарифов →](https://docs.mydialogi.ru/06-reference/02-pricing/pricing-overview).

## Частые проблемы

### Сообщение не доставляется

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

**Решение:** дождитесь первого сообщения от получателя. Бот может писать только тем, кто сам начал с ним диалог.

### Файл не загружается

**Причина:** превышен размер файла.

**Решение:** сократите размер. Точные лимиты зависят от типа файла — уточните в поддержке сервиса.

[Контакты поддержки →](https://docs.mydialogi.ru/06-reference/03-troubleshooting/ts-support-contacts)

### Ошибка senderId

**Причина:** неверный ID бота или имя отправителя не имеет статуса **Активно**.

**Решение:** проверьте настройки имени отправителя.

[Имя отправителя для Telegram →](https://docs.mydialogi.ru/05-channels/07-telegram/sender-id)

### Медиа без ссылки не отправляется

**Причина:** не указан URL файла — параметр `link`.

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

[Как загрузить медиафайл →](https://docs.mydialogi.ru/04-mydialogi/06-assets/md-801-media)

### Персонализация не подставляется

**Причина:** неверный ключ атрибута.

**Решение:** проверьте формат — например, `{{attribute.name}}`.

[Управление атрибутами →](https://docs.mydialogi.ru/04-mydialogi/03-contacts/md-504-attributes)

### Текст обрезается

**Причина:** превышен лимит в 2000 знаков.

**Решение:** сократите текст.

## См. также

<Columns cols={2}>
  <Card title="Что такое Telegram Gateway" icon="shield-halved" href="/05-channels/07-telegram/telegram-gateway">
    Отправка кодов верификации через API
  </Card>
  <Card title="Имя отправителя для Telegram" icon="id-card" href="/05-channels/07-telegram/sender-id">
    Регистрация имени отправителя
  </Card>
  <Card title="Что такое SMS" icon="message" href="/05-channels/01-sms/sms">
    Классический канал для сравнения
  </Card>
  <Card title="Что такое каскад" icon="arrow-progress" href="/05-channels/00-overview/cascade">
    Автоматическое переключение между каналами
  </Card>
</Columns>

## Нужна помощь?

- **OTP-коды:** support@otpcod.ru
- **Multi API:** support@multiapi.ru
- **Мой диалог:** support@mydialogi.ru
