MDSoft: Модуль стандартизации полей сущности (активити)

CRM постоянно пополняется городскими и мобильными номерами клиентов, адресами и ФИО  — одни из них вводят менеджеры, другие подгружаются из форм на сайтах, третьи попадают в систему из писем, приходящих на почту.

Телефоны выглядят абсолютно по-разному: со скобками, дефисами, пробелами, плюсами, кодами, запятыми и т. п. — чтобы разобраться, где мобильный, а где городской номер, часто приходится тратить уйму времени. Особенно, когда клиенты из разных регионов.

Та же проблема с адресами, где-то забыли или поленились ввести индекс, где-то сократили название города или улицы. Неверно указали координаты на карте и т.д.

С ФИО в контактах та же беда. Путают имена и фамилии, делают ошибки в именах, неправильно склоняют по падежам и неверно указывают пол.

Модуль предназначен для стандартизации данных Вашей компании. Неполные, или заполненные с ошибкой, данные переводит в полный стандартизированный формат. Активити работает на основе сервиса Dadata и в данный момент работает со следующими данными (на входе и выходе):

Фамилия Имя Отчество

1. Отформатированные данные

2. ФИО в дательном падеже

3. ФИО в родительном падеже

4. Пол

5. Фамилия

6. Имя

7. Отчество

8. Весь массив в JSON

Адрес

1. Регион

2. Индекс

3. Код страны в международном формате

4. Код региона в международном формате

5. Адрес в пределах кольцевой?

6. GPS широта

7. GPS долгота

8. Средняя стоимость кв.м.
   

9. Оценочная стоимость помещения

10. Площадь помещения

11. Весь массив в JSON

Телефон

1. Тип (мобильный или стационарный)

2. Страна

3. Отформатированные данные

4. Оператор абонента

5. Часовая зона абонента

6. Весь массив в JSON

Кейсы:

1. Сотрудники спешат и заполняют данные в системе, путая местами имя с отчеством, забывают указать пол. Настраиваем БП, который будет при добавлении приводить все в порядок

2. Активити может помочь сформировать данный для рассылки писем. Правильно просклоняет ФИО и в зависимости от пола, заполнить обращение в заголовке

3. При неполных данных адреса сформирует полные данные в общепринятом формате с определением страны и индекса. Незаменимо если у вас автоматизирована отправка бумажных писем.

4. При автоматизированной отправки СМС определит часовой пояс абонента и оператора, стандартизирует номер телефона и выполнит отправку в удобное время для абонента

Так же есть возможность получить весь массив данных в формате JSON и другим нашим активити из маркетплейс обработать ответ. Это поможет сократить количество запросов к сервису Dadata

Для работы модуля необходима библиотека Curl

1) Устанавливаем модуль

2) Создаем на сайте php-файл, в который добавляем следующий код

<?
 require($_SERVER["DOCUMENT_ROOT"]."/bitrix/modules/main/include/prolog_before.php");
 
 $APPLICATION->IncludeComponent("mdsoft:crmstandart.connector",
    "",
    array(),
    false
 );
 ?>

3)  Файл будет являться коннектором и если файл находится на домене CRM-системы, то устанавливаем права доступа к нему неавторизованным пользователям (иначе система будет запрашивать пароль и активити не сможет обработать данные)

4) Регистрируемся и получаем ключи доступа в сервисе Dadata (Стандартизация — это платный метод, стоит 10 коп. за запись. Первые 100 записей можно обработать бесплатно.)

5) В настройках настройки модулей –> Стандартизация данных (активити) указываем ключи доступа Dadata и абсолютный путь к созданному файлу-коннектору

6) В дизайнере БП активити находится в разделе “Прочее”

7) Активити передает результаты проделанной работы в указанную переменную из настроек шаблона БП (см. скриншоты)