Оператор и регион телефона

Робот «Оператор и регион телефона» определяет текущего оператора и регион российского номера через Voxlink.

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

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

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

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

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

Поле	Как заполнить
Телефон (phone)	Обязательное поле

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

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

1. Передайте один российский номер без добавочного. Допустимы десять цифр без плюса либо одиннадцать с начальной 7 или 8; + допустим с 7.
2. Уберите комментарии и второй номер. Пробелы, скобки, точки и дефисы допускаются как оформление номера.
3. После выполнения проверьте статус, provider и region. В этом действии значение phone возвращается десятью цифрами без кода страны.
4. Не переносите пустые дополнительные результаты как подтверждённые сведения. Для сохранения или дальнейшего звонка используйте отдельное действие и нужное форматирование.

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

Для учебного российского телефона в формате 8 (код) номер робот сначала готовит запрос с кодом 7. Если внешний справочник подтвердит тот же номер и оператора или регион, результат phone будет десятизначной национальной частью. Конкретные оператор и регион в примере не выдумываются.

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

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

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

Основные заполненные выходы: phone, city_code, number, provider, region. Другие объявленные телефонные поля этим источником не заполняются и остаются пустыми. Не делайте вывод об отсутствии добавочного, страны или часового пояса только по этим пустым результатам.

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

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

Нужен один российский телефон без добавочного. Для успешного результата сервис должен подтвердить номер и оператора либо регион. Возвращаемый phone содержит десять цифр без 7. Заполняются только номер, код, локальная часть, оператор и регион; остальные объявленные справочные поля пустые.

Это действие только для российского номера без добавочного. Оно не подтверждает владельца, доступность и возможность доставки сообщения. Если внешний сервис не подтвердил номер и хотя бы оператора или регион, робот вернёт ошибку.