Помогает отличать полезные клиентские письма в сделке от нерелевантной переписки и быстрее запускать правильный сценарий обработки.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Робот полезен для менеджера, который разбирает почтовые обращения сделки. Полезные заявки смешиваются с нерелевантной перепиской. Робот анализирует доступные письма указанной сделки с помощью AI и возвращает категорию и пояснение для выбора дальнейшей ветки.
Что делает и когда применять
Робот полезен, когда в сделке накапливаются письма и нужно быстро понять, относится ли переписка к реальному запросу клиента или нет.
Что подготовить
Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. В приложении должно быть настроено AI-подключение. При подключении через приложение нужен достаточный AI-баланс; для собственного подключения используются его модель, доступ и лимиты.
Подключите почту к CRM и проверьте доступ к письмам сделки. Для разбора входящих включите соответствующий флаг. AI-подключение должно быть настроено; параметры собственного сервиса заполняйте согласованно.
Как настроить и использовать
- Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Классификация писем сделки: заказ или спам (AI)». В шаблоне бизнес-процесса добавьте одноимённое действие.
- Подключите почту к CRM и проверьте доступ к письмам сделки. Для разбора входящих включите соответствующий флаг. AI-подключение должно быть настроено; параметры собственного сервиса заполняйте согласованно.
- Заполните ID сделки, Только входящие письма, Удалить HTML теги. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
- Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
- Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.
Параметры робота
Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.
| Поле в настройках | Что передать | Обязательность и исходное значение |
|---|---|---|
ID сделки (deal_id) |
{{ID}} Формат: строка. | Обязательно. По умолчанию: {{ID}} |
Только входящие письма (incoming_only) |
Если включено, анализируются только входящие письма (рекомендуется). Формат: да/нет. | Необязательно. Значение по умолчанию в настройках не задано |
Удалить HTML теги (delete_html) |
Удалить HTML-разметку из писем перед отправкой в ИИ. Формат: да/нет. | Необязательно. Значение по умолчанию в настройках не задано |
API Key (опционально) (apiKey) |
Ключ для кастомного OpenAI-совместимого сервиса. Формат: строка. | Необязательно. Значение по умолчанию в настройках не задано |
API URL (опционально) (apiUrl) |
Базовый URL кастомного OpenAI-совместимого сервиса. Формат: строка. | Необязательно. Значение по умолчанию в настройках не задано |
Модель ИИ (опционально) (modelName) |
Например openai/gpt-4o-mini или другой OpenAI-совместимый идентификатор. Формат: строка. | Необязательно. Значение по умолчанию в настройках не задано |
Учебный пример
Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.
- ID сделки (
deal_id):501. - Только входящие письма (
incoming_only):Y. - Удалить HTML теги (
delete_html):Y.
В учебной сделке с письмом «Прошу рассчитать 10 панелей» возможен вывод о заказе. Это вероятностная классификация: основание, уверенность и число разобранных писем нужно проверить до отклонения обращения.
Какие данные возвращает и что делать дальше
| Результат | Какое значение получает следующий шаг |
|---|---|
Результат (JSON) (parsed) |
текст |
Категория (category) |
строка |
Это заказ (is_order) |
да/нет |
Это спам (is_spam) |
да/нет |
Уверенность (confidence) |
строка |
Причина (reason) |
текст |
Текст писем для анализа (conversation_text) |
текст |
Количество писем (mail_count) |
целое число |
Сырой ответ ИИ (raw_output) |
текст |
Ошибка (error) |
строка |
Статус (status) |
да/нет |
Используйте категорию вместе с пояснением и признаками заказа/спама. Сомнительные письма направляйте сотруднику; успешное выполнение AI-шага не разрешает автоматически удалять обращение.
Ошибки и ограничения
AI-вывод требует проверки сотрудником и не является подтверждённым решением о клиенте. Робот не отправляет результат клиенту и не обучается на ваших сделках. Проверьте исходный текст, число найденных писем, если оно возвращается, и пояснение ошибки. Для работы нужны настроенный AI-доступ и применимый к нему баланс или лимиты. Неполные или недоступные материалы нельзя трактовать как доказательство спама, низкого качества или отсутствия интереса клиента.