Интеграция с DADATA — Все сервисы¶

Набор роботов для бизнес-процессов, которые обращаются к сервису DADATA и стандартизируют или проверяют данные в карточках CRM: паспорт, email, адрес, телефон, ФИО, компания по email, данные по IP. Роботы устанавливаются по отдельности — берите только те, что нужны.

Для кого¶

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

Шаг 1. Ключи DADATA¶

Зарегистрируйтесь на сервисе dadata.ru и в личном кабинете получите API-ключ и секретный ключ.
Откройте приложение. Вверху в поля «API key» и «Secret key» вставьте ключи и нажмите «Сохранить ключи».

Зачем два ключа

DADATA использует пару ключей: обычный API-ключ и секретный токен. Оба нужны для работы роботов. Каждый робот принимает на вход обрабатываемое значение, API-ключ и секретный токен.

Шаг 2. Установка роботов¶

На главном экране приложения — карточки всех доступных роботов. У каждого есть кнопка «Описание» (раскрывает входные и выходные данные) и кнопки «Установить робота» / «Удалить робота».

Установите нужные роботы — они появятся в конструкторе бизнес-процессов и в роботах CRM.

Доступные роботы¶

Проверка паспорта на действительность¶

Вход: серия и номер паспорта одной строкой.
Результат: source (исходная строка), series (серия), number (номер), qc — код проверки действительности по данным ФМС.

Расшифровка qc:

Код	Значение	Проверить вручную?
`0`	Действующий паспорт	нет
`2`	Исходное значение пустое	нет
`1`	Неправильный формат серии или номера	да
`10`	Недействительный паспорт	да

Стандартизация email¶

Вход: email.
Результат: source (исходный), email (стандартизованный), local (часть до «собачки»), domain (после «собачки»), type, qc.

Тип адреса type: PERSONAL — личный (@mail.ru, @yandex.ru), CORPORATE — корпоративный, ROLE — ролевой (info@, support@), DISPOSABLE — одноразовый (@temp-mail.ru).

Стандартизация адресов¶

Вход: адрес одной строкой.
Результат: разобранный и стандартизованный адрес. Полный перечень полей — в документации DADATA по адресам.

Информация о компании по email¶

Вход: email.
Результат: данные об адресе (source, type, local, domain) и о компании: домен, краткое наименование, ИНН, ОГРН, основной код ОКВЭД и его расшифровка, среднесписочная численность, доходы за прошлый год, город регистрации, часовой пояс.

Полнота данных о компании

Численность сотрудников и доходы DADATA заполняет примерно у 65 % компаний — по остальным эти поля могут быть пустыми.

Данные по IP¶

Вход: IP-адрес.
Результат: индекс, страна, федеральный округ, регион (со всеми кодами ФИАС/КЛАДР) и город.

Стандартизация ФИО¶

Вход: строка с ФИО.
Результат: source (исходное), result (стандартизованное), ФИО в родительном / дательном / творительном падежах, отдельно фамилия, имя, отчество, пол и код проверки qc.

Стандартизация телефонов¶

Вход: номер телефона.
Результат: source, тип телефона, стандартизованный номер, код страны, код города (DEF-код), локальный номер, добавочный, оператор связи (для России), страна, регион, город (для стационарных), часовой пояс.

Как использовать в бизнес-процессе¶

Установите нужный робот (Шаг 2).
В роботах или бизнес-процессе нужной сущности добавьте робот DADATA.
Передайте на вход значение из карточки (например, телефон клиента) и ключи DADATA.
Результаты робота используйте в следующих шагах — запишите стандартизованное значение обратно в поле карточки, поставьте условие (например, если паспорт qc = 10 — задача менеджеру) и т. д.

Пример

Робот «Стандартизация телефонов» на событии создания лида → записать поле phone (стандартизованный номер) и provider (оператор) обратно в карточку. Или «Стандартизация email» → если type = DISPOSABLE, пометить лид как некачественный.

Тарификация и требования¶

Оплата запросов — на стороне DADATA

Каждый запрос робота — это платная запись в DADATA: 10 копеек за запись, первые 100 записей бесплатно. Оплата идёт по вашему тарифу DADATA, а не через приложение.

Приложение работает на тарифах Битрикс24, где доступна функциональность «Роботы и триггеры» и «Бизнес-процессы в CRM».

Готово

Ключи сохранены, нужные роботы установлены. Теперь данные в карточках можно проверять и приводить к стандарту автоматически. 🎉