Помогает на этапе лида быстро отделять реальные обращения от спама и лишней переписки.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Робот полезен для менеджера первичной обработки почтовых лидов. На входе смешиваются заявки и нерелевантные письма. Робот анализирует доступную переписку выбранного лида с AI и возвращает признаки категории с основанием для последующей проверки.
Что делает и когда применять
Робот особенно полезен в потоковых воронках, где важно быстро очищать входящие обращения и передавать в работу только ценные лиды.
Что подготовить
Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. В приложении должно быть настроено AI-подключение. При подключении через приложение нужен достаточный AI-баланс; для собственного подключения используются его модель, доступ и лимиты.
Передайте ID лида и проверьте связанную почту. Для первичной обработки можно ограничиться входящими письмами. AI-подключение и применимый к нему баланс или лимиты должны быть доступны.
Как настроить и использовать
- Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Классификация писем лида: заказ или спам (AI)». В шаблоне бизнес-процесса добавьте одноимённое действие.
- Передайте ID лида и проверьте связанную почту. Для первичной обработки можно ограничиться входящими письмами. AI-подключение и применимый к нему баланс или лимиты должны быть доступны.
- Заполните ID лида, Только входящие письма, Удалить HTML теги. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
- Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
- Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.
Параметры робота
Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.
| Поле в настройках | Что передать | Обязательность и исходное значение |
|---|---|---|
ID лида (lead_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 лида (
lead_id):501. - Только входящие письма (
incoming_only):Y. - Удалить HTML теги (
delete_html):Y.
По учебному письму с просьбой рассчитать заказ возможна категория заказа с объяснением. Это вывод модели, который зависит от текста и числа доступных писем; уверенность не делает его доказанным фактом о клиенте.
Какие данные возвращает и что делать дальше
| Результат | Какое значение получает следующий шаг |
|---|---|
Результат (JSON) (parsed) |
текст |
Категория (category) |
строка |
Это заказ (is_order) |
да/нет |
Это спам (is_spam) |
да/нет |
Уверенность (confidence) |
строка |
Причина (reason) |
текст |
Текст писем для анализа (conversation_text) |
текст |
Количество писем (mail_count) |
целое число |
Сырой ответ ИИ (raw_output) |
текст |
Ошибка (error) |
строка |
Статус (status) |
да/нет |
Передайте неопределённые результаты сотруднику. Прежде чем отклонять лид, прочитайте основание и проверьте исходное письмо; техническая ошибка AI не должна становиться признаком спама.
Ошибки и ограничения
AI-вывод требует проверки сотрудником и не является подтверждённым решением о клиенте. Робот не отправляет результат клиенту и не обучается на ваших сделках. Проверьте исходный текст, число найденных писем, если оно возвращается, и пояснение ошибки. Для работы нужны настроенный AI-доступ и применимый к нему баланс или лимиты. Неполные или недоступные материалы нельзя трактовать как доказательство спама, низкого качества или отсутствия интереса клиента.