Помогает извлечь из письма контактные данные и имя, чтобы быстрее обогатить карточку и продолжить работу с клиентом.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Робот полезен для менеджера, извлекающего контактные сведения из свободного текста письма. Имя и контакты указаны в подписи, а карточка ещё не заполнена. Робот обращается к указанной модели для извлечения телефона, email и ФИО из доступного письма.
Что делает и когда применять
Робот полезен, когда контактные данные есть в тексте письма, но не вынесены в отдельные поля CRM.
Что подготовить
Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.
Запускайте действие в карточке с нужным письмом. В форме обязательны ключ вашего AI-сервиса, его базовый URL и имя доступной модели. Эти значения получите в своём подключении, не используйте чужие ключи.
Как настроить и использовать
- Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Получить телефон, почту, фио из письма». В шаблоне бизнес-процесса добавьте одноимённое действие.
- Запускайте действие в карточке с нужным письмом. В форме обязательны ключ вашего AI-сервиса, его базовый URL и имя доступной модели. Эти значения получите в своём подключении, не используйте чужие ключи.
- Заполните API Key, API URL, Название модели. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
- Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
- Выполните пробный запуск на отдельном учебном элементе. Проверьте статус и возвращённые данные; если действие не завершилось, разберите ошибку в журнале процесса до использования результата.
Параметры робота
Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.
| Поле в настройках | Что передать | Обязательность и исходное значение |
|---|---|---|
API Key (apiKey) |
API ключ для доступа к сервису. Формат: строка. | Обязательно. Значение по умолчанию в настройках не задано |
API URL (apiUrl) |
API URL для доступа к сервису. Формат: строка. | Обязательно. Значение по умолчанию в настройках не задано |
Название модели (modelName) |
Имя модели для парсинга. Формат: строка. | Обязательно. Значение по умолчанию в настройках не задано |
Учебный пример
Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.
- API Key (
apiKey): подставьте собственный ключ настроенного AI-сервиса. - API URL (
apiUrl): подставьте базовый URL вашего совместимого AI-подключения. - Название модели (
modelName): подставьте доступное в вашем подключении имя модели.
Если в подписи учебного письма указаны Анна, client@example.com и номер телефона, результаты могут выделить эти сведения. AI-извлечение нужно сверять с текстом; оно не подтверждает личность и не гарантирует полноту данных.
Какие данные возвращает и что делать дальше
| Результат | Какое значение получает следующий шаг |
|---|---|
Результат парсинга номера телефона (result_phone) |
строка, несколько значений |
Результат парсинга почты (result_email) |
строка, несколько значений |
Результат парсинга ФИО (result_fio) |
строка, несколько значений |
Статус (status) |
да/нет |
Перед записью проверьте ФИО, email и телефон. Ошибка доступа или модели не означает отсутствия контактов; сначала исправьте подключение, а исходное письмо не отправляйте стороннему сервису без соответствующего права.
Ошибки и ограничения
Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.