Проверка телефона в DaData

Робот «Проверка телефона в DaData» упорядочивает номер телефона и возвращает сведения об операторе, регионе и качестве распознавания.

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.

Для кого и какую задачу решает

Менеджеру CRM и администратору, который нормализует телефон и получает доступные сведения о его типе, операторе и регионе через DaData.

Номер в свободной форме неудобно использовать в дальнейших действиях. Робот возвращает стандартизованный телефон и отдельные признаки качества. Сведения внешнего справочника помогают подготовить данные, но не доказывают доступность абонента.

Параметры и подготовка

Поле	Как заполнить
Ключ API DaData (apiKey)	Необязательное поле
Секретный ключ DaData (secretKey)	Необязательное поле
Телефон (phone)	Обязательное поле

Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.

Как использовать

1. Передайте один телефон в phone, строкой до 100 символов. Не объединяйте несколько номеров в одно значение.
2. Укажите apiKey и secretKey либо используйте заранее настроенные ключи приложения, если они доступны для этого действия.
3. После успешного статуса проверьте qc и нужные поля. Если сервис не вернул значение, соответствующий результат будет пустым.
4. Используйте phone и extension раздельно. Оператор, регион и часовой пояс подставляются только если они действительно получены; сохранение и звонок выполняются другими действиями.

Учебный пример и ожидаемый результат

В учебном сценарии передайте разрешённый тестовый телефон и собственные тестовые ключи. Ожидается стандартизованная запись, если DaData распознала номер, и полученные признаки качества. Оператор и город не заданы инструкцией заранее: они зависят от ответа внешнего сервиса.

Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.

Что возвращает и как продолжить процесс

• «Тип телефона» (type).
• «Стандартизованный телефон» (phone).
• «Код страны» (country_code).
• «Код города или оператора» (city_code).
• «Локальный номер» (number).
• «Добавочный номер» (extension).
• «Оператор связи» (provider).
• «Страна» (country).
• «Регион» (region).
• «Город» (city).
• «Часовой пояс» (timezone).
• «Признак конфликта телефона и адреса» (qc_conflict).
• «Код качества» (qc).

Выход type описывает тип телефона, provider оператора, extension добавочный. Не считайте пустой city ошибкой всего номера: отдельные сведения могут отсутствовать. Для решения об использовании номера анализируйте общий статус и качество согласно вашим правилам.

Выход «Статус выполнения» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Пояснение ошибки» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.

Ограничения и разбор ошибок

Строка телефона до 100 символов. Ключи берутся из явных параметров либо настроенного доступа приложения. Возвращаются полученные сервисом телефонные поля; отсутствующие значения пустые. Это справочные данные без подтверждения связи с абонентом.

Робот не звонит, не подтверждает владельца и согласие на коммуникацию. Внешний сервис должен быть доступен выбранным ключам. При отказе или пустом ответе действие завершится ошибкой; повторять его следует после уточнения исходного телефона и доступа.