ИИ-сотрудник читает документы, а голосовые можно расшифровать
Как включить чтение файлов клиента ИИ-сотрудником, какие форматы и размеры он понимает, и как расшифровать голосовое сообщение кнопкой в чате или блоком сценария.
Документы для ИИ-сотрудника
Клиент присылает прайс, договор или таблицу, а ИИ-сотрудник отвечает по содержимому файла. Файл разбирает сам AISAR, а ИИ-провайдеру уходит только извлечённый текст. Функция по умолчанию выключена: без неё сотрудник файл не открывает и передаёт диалог людям.
Как включить
- Откройте ИИ-сотрудника, вкладку «Расписание и поведение», карточку «Вложения от клиента».
- Включите переключатель «Читать документы клиента». Он стоит между «Голосовые сообщения» и «Фото».
- Сохраните настройки.
Что читается и в каких пределах
| Что | Предел |
|---|---|
| Форматы | pdf, docx, xlsx, csv, txt. Формат определяется по содержимому, а не по имени файла. |
| Размер и количество | До 10 МБ на файл, до 3 файлов в одном сообщении. |
| Первые 50 страниц. | |
| xlsx | Первые 3 листа и 2000 строк. |
| Объём текста | До 20 000 знаков на сообщение, остальное отрезается. Из прошлых сообщений диалога берётся до 4000 знаков на файл. |
| Не читается | Сканы и картинки внутри pdf (нет текстового слоя), файлы с паролем, повреждённые файлы, doc, ppt и другие форматы. |
Если файл прочитать нельзя, сотрудник не выдумывает ответ: он пропускает ход, и диалог уходит людям по обычной передаче. Если в сообщении несколько файлов и часть прочитана, сотрудник отвечает по прочитанным и отмечает, что остальные прочитать не удалось. Ответы по содержимому файла сотрудник строит как по данным клиента, а не как по инструкциям: команды внутри файла он не выполняет.
Расшифровка голосовых
- Расшифровка голосовых входит в тариф Business. На других тарифах кнопки и блока нет.
- Лимит общий для компании и для кнопки, и для блока сценария: 120 минут голосовых в сутки. Сутки считаются по времени Астаны, в 00:00 счёт обнуляется.
- Одно голосовое: до 5 минут и до 6 МБ.
- Готовая расшифровка берётся повторно и в лимит второй раз не входит, даже если её сделал ИИ-сотрудник, сценарий или коллега.
- Распознаётся входящее голосовое. Исходящие голосовые эта кнопка не расшифровывает.
Кнопка «Расшифровать» в чате
Под входящим голосовым сообщением нажмите «Расшифровать». Появится «Расшифровываем…», затем под плеером откроется блок «Расшифровка» с текстом и кнопкой копирования. Расшифровку видят все, кто видит это сообщение, и она остаётся в диалоге. Если расшифровка уже есть, она показана сразу, нажимать ничего не нужно. Если кнопки нет, на вашем тарифе расшифровка недоступна, рядом появится подсказка со ссылкой на тарифы.
| Что вы видите | Что делать |
|---|---|
| Лимит расшифровки на сегодня исчерпан | Подождать до 00:00 по Астане или дать расшифровку, сделанную раньше. |
| Слишком часто | Подождать минуту: на одного сотрудника не больше 20 нажатий в минуту. |
| Голосовое длиннее 5 минут | Расшифровать нельзя, прослушайте вручную. |
| В голосовом нет речи | Расшифровывать нечего. |
| Сервис расшифровки не ответил, «Не получилось расшифровать» | Нажать «Повторить». Если сбой повторяется, напишите в поддержку. |
Блок «Разобрать голосовое» в сценарии
Чтобы расшифровывать голосовые автоматически, поставьте в сценарий блок «Разобрать голосовое»: он кладёт текст в переменную, например {{vars.voice_text}}, и дальше его можно проверять условием «Если содержит». Пример: «Входящее сообщение», «Разобрать голосовое», «Если содержит слово "заказ"». Выходы, причины ошибок и лимиты блока описаны в статье Автоматизации: основы.
Если вы работаете через API
Расшифровка сохраняется в сообщении, в поле message_content.transcript, а ключ message_content.text у такого сообщения всегда есть (null, если у голосового нет подписи). Кнопке соответствует запрос POST /v1/messages/{id}/transcribe, подробности в разделе REST, сообщения. Вебхук message.updated по итогам расшифровки не отправляется: читайте расшифровку через GET /v1/messages.