Что агент шлёт клиенту и что принимают каналы: лимиты по форматам и размеру картинок, голосовых, документов и видео, разница Авито и персонального API.
Агент отправляет клиенту файл из базы знаний как сообщение, голосовое или картинку, а кружок в Телеграме — только если ролик короче минуты, квадратный и в .mp4. Лимит зависит от типа: 20 МБ на изображение и документ, 25 МБ на аудио, 7 МБ на кружок. Персональный канал API принимает вложения только двух типов — изображения и аудио, до 15 МБ.
Клиент пишет в переписке: «пришлите прайс картинкой, мне так удобнее». Дальше начинается техническая часть, о которой обычно не думают заранее: что можно приложить к ответу, в каком формате и какого размера файл дойдёт без потерь.
Вложение в чат-боте — это файл, который агент отправляет клиенту или получает от него: картинка, документ, голосовое сообщение или видео.
Файл сначала загружается в базу знаний, и при загрузке отмечается один из четырёх чекбоксов: отправить вместе с текстовым сообщением, отправить как голосовое, отправить как картинку, отправить как телеграм-кружок. Чекбокс определяет, в каком виде клиент увидит вложение, — прайс с отметкой «картинка» откроется превью в переписке, тот же файл без отметки уйдёт документом на скачивание.
Для запроса «пришлите прайс картинкой» это ровно тот случай: PNG или JPEG до 20 МБ, прикреплённый к файлу базы знаний с чекбоксом «Отправлять как картинку», — и агент присылает его как изображение при первом же совпадении вопроса.
Есть второй путь — структурированные ответы, доступные на подписке «Интегратор». Они позволяют агенту разбивать ответ на несколько сообщений и отправлять файлы по прямой ссылке, даже если файл заранее не загружен в базу знаний, а ссылка появилась в переменной или в самой инструкции.
Проверьте на своих диалогах.Регистрация без карты, 500 ₽ на тест по промокоду BLOG500
Собрать агентаОграничения разные для каждого типа файла, и путаница чаще всего в том, что лимит документа принимают за общий лимит на любое вложение.
| Тип файла | Форматы | Предел | Особенности |
|---|---|---|---|
| Изображение | .png, .jpeg, .gif | 20 МБ | отмечается чекбоксом «Отправлять как картинку» |
| Аудио, голосовое | .ogg, .mpeg, .wav, .x-wav, .webm, .mp4, .m4a, .x-m4a | 25 МБ | тот же список форматов для голосовых от клиента и агента |
| Телеграм-кружок | только .mp4 | 7 МБ, до 1 минуты, 1:1, не больше 640×640 | нарушение любого условия, и файл уйдёт обычным видео |
| Видео | .mp4, .avi, .mov, .webm, .wmv | 20 МБ | Битрикс24 конвертирует любое видео в .mp4 сам |
| Текстовый документ | .doc, .pdf, .txt, .md | 20 МБ | те же форматы, что агент читает и извлекает из них текст, когда документ присылает клиент |
| Персональный канал (API) | image/png, jpeg, gif; audio ogg, mpeg, wav, x-wav, webm, mp4, m4a, x-m4a | 15 МБ | документы канал пока не принимает, только изображение и аудио |
| Авито, изображение от агента | JPEG, HEIC, GIF, BMP, PNG | 24 МБ, 75 Мп | в ответ агент отправляет только текст и изображение |
Кружок в Телеграме — формат с четырьмя условиями сразу, и достаточно промахнуться по одному, чтобы получить обычное видео вместо кружка: размер до 7 МБ, длительность не длиннее минуты, квадратное соотношение сторон, разрешение не больше 640×640, формат только .mp4. Записанный на телефон вертикальный ролик почти никогда не проходит без обрезки кадра.
Прежде чем прикреплять ролик как кружок, откройте его свойства и сверьте четыре параметра разом: вес, длительность, соотношение сторон и формат. Один параметр вне нормы — и клиент получит присланный файл как рядовое видео, без предупреждения об ошибке.
Голосовое устроено проще: список форматов один и тот же для сообщений от клиента и от агента, лимит 25 МБ. Токен и сам чат-бот для Телеграма подключаются отдельно от этой настройки, а здесь тема другая: что агент присылает клиенту сам.
При импорте объёмного документа в базу знаний включается галочка «Оставить изображения (ссылками)», и тогда картинки в тексте заменяются на прямые ссылки на них. Агент видит только ссылку, содержимое картинки для него закрыто, поэтому смысл изображения стоит описать текстом отдельно, если он важен для ответа.
Дальше с этой ссылкой можно поступить по-разному. Обычная прямая ссылка на .jpg способна уйти клиенту и как текст со ссылкой, и как изображение — это зависит от того, каким способом её отправляет агент: обычным текстом или через структурированный ответ с прямой ссылкой на файл. Ссылка на облачное хранилище (Google Диск, Яндекс.Диск) остаётся ссылкой в любом случае, потому что за прямым адресом файла там стоит страница просмотра, а не сам файл.
Три блока базы знаний для ИИ-агента устроены отдельно от этого вопроса. За судьбу конкретной картинки отвечает одна галочка при импорте документа, и именно её стоит проверить в первую очередь.
Каналы отличаются друг от друга набором форматов, и сравнивать их лимиты в отрыве от направления передачи — частая ошибка.
От клиента на Авито приходят текст, ссылка, карточка прикреплённого объявления, локация, изображение и голосовое сообщение. В обратную сторону агент отправляет заметно меньше: только текст и изображение форматов JPEG, HEIC, GIF, BMP, PNG до 24 МБ и 75 мегапикселей — ни документа, ни голосового Авито от бота не примет.
Персональный канал через API устроен ещё строже: вложение поддерживается ровно двух типов, изображение (image/png, image/jpeg, image/gif) или аудио (audio/ogg, audio/mpeg, audio/wav, audio/x-wav, audio/webm, audio/mp4, audio/m4a, audio/x-m4a), лимит 15 МБ на файл. Формат для документов в этом канале пока не предусмотрен: счёт или договор туда можно передать текстом или ссылкой на файл, но не вложением.
Нарисуйте у себя на листе три колонки: канал, что клиенты просят прислать чаще всего, и предел, с которым это упирается. Для розницы в Авито это обычно фото товара крупным планом, для услуг в Телеграме: прайс картинкой или голосовое с ответом на вопрос.
По каждой строке проверьте формат файла, который сейчас лежит в базе знаний агента, и отмеченный чекбокс отправки. Половина жалоб «бот прислал не то» решается на этом шаге — без переписывания инструкции и без обращения в поддержку.
Да. Файл загружается в базу знаний, у него отмечается чекбокс «Отправлять как картинку», и агент прикладывает его к ответу как изображение, а не как документ на скачивание. Формат: .png, .jpeg или .gif, размер до 20 МБ.
25 МБ для форматов .ogg, .mpeg, .wav, .x-wav, .webm, .mp4, .m4a, .x-m4a. Это лимит и для голосовых, присланных клиентом, и для тех, что агент отправляет в ответ, если файл в базе знаний отмечен как голосовое сообщение.
Кружок требует одновременного соблюдения четырёх условий: файл до 7 МБ, длительность не больше минуты, соотношение сторон 1:1, разрешение не выше 640×640, формат только .mp4. Нарушение любого из них — и Телеграм отправляет файл как обычное видео.
От клиента приходят текст, ссылка, карточка объявления, геолокация, изображение и голосовое сообщение. В обратную сторону агент может отправить только текст и изображение — форматы JPEG, HEIC, GIF, BMP, PNG, до 24 МБ и 75 мегапикселей.
Вложения в виджете пока не поддерживаются платформой. Рабочий обход — кнопка перехода в Telegram, WhatsApp или Max прямо в окне чата: диалог продолжается в канале, где вложения работают, а клиент не переписывает вопрос заново.
При импорте с галочкой «Оставить изображения» картинки заменяются прямыми ссылками на них. Агент видит только ссылку, а не содержимое картинки, и может передать эту ссылку клиенту как текст или, при включённых структурированных ответах, как файл по прямой ссылке.
Хотите сразу к продукту: Конструктор ботов ТГ