Dadata

Что это за документ

Этот документ нужен компании, которая хочет подключить Dadata к своей клиентской витрине, Telegram Mini App или Max мини-приложению и начать использовать адресные подсказки в оформлении заказа.

Если говорить совсем просто, Dadata помогает клиенту не печатать адрес полностью вручную, а выбирать его из готовых подсказок.

Для бизнеса это важно потому, что:

• клиенту проще заполнить адрес
• ошибок в адресе становится меньше
• оформление заказа идет быстрее
• менеджерам и службе доставки проще работать с более точными данными

В Omnis Dadata в первую очередь используется в сценарии доставки, когда клиент вводит адрес при оформлении заказа.

Что важно понять сразу

Для подключения Dadata в Omnis нужны два значения:

• API ключ подсказок
• Секретный ключ подсказок

Практически это выглядит так:

1. Вы получаете ключ и секрет в кабинете Dadata.
2. Вставляете оба значения в Omnis.
3. Сохраняете приложение.
4. Проверяете оформление заказа в клиентской витрине.

Очень важное правило:

• ключ и секрет должны быть заполнены парой
• если указать только одно значение, подсказки не будут считаться настроенными правильно

Релевантные разделы

• Блок страницы оформления заказа - если нужно посмотреть само поле адреса.
• Конструктор приложений - если ключи вносятся при создании нового приложения.
• Приложения - если ключи вносятся уже в существующее приложение.
• Клиентский опыт в приложении - если адресный ввод оценивается как часть общего пути покупки.

Что дает Dadata компании

После подключения Dadata компания получает:

• более удобный ввод адреса для клиента
• меньше опечаток и неточностей в заказах
• более понятный сценарий доставки
• меньше ручных уточнений по адресу после оформления

Практически это особенно полезно, если:

• доставка занимает важную часть бизнеса
• у клиентов длинные или сложные адреса
• компания работает по нескольким городам и регионам
• важно уменьшать ошибки в доставке и сборке заказов

Где Dadata реально используется в Omnis

В текущем клиентском сценарии Omnis Dadata особенно важна в оформлении заказа.

Когда клиент выбирает доставку, он видит поле:

• Адрес доставки

Это поле работает с подсказками адреса.

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

Если для оформления заказа настроены ограничения по разрешенным городам и регионам, подсказки тоже учитывают эти ограничения.

Подробнее сам сценарий оформления заказа разобран здесь:

• Блок страницы оформления заказа

Что нужно подготовить заранее

До подключения полезно подготовить:

• доступ к нужному приложению в Управление -> CMS
• аккаунт в Dadata
• понимание, в каком приложении или витрине будут работать адресные подсказки

Если у компании несколько витрин, лучше заранее решить, для каких именно приложений нужны подсказки адреса.

Что именно брать, копировать и куда вставлять

Во всем процессе чаще всего используются два значения.

Важно:

• не нужно вставлять только один ключ
• не нужно путать ключи Dadata с ключом Яндекс.Карт
• не нужно вставлять в Omnis ссылку на кабинет Dadata

1. Где взять ключ и секрет Dadata

В Конструкторе приложений Omnis прямо подсказывает, что эти данные можно взять в кабинете Dadata по адресу:

https://dadata.ru/profile/#info

Обычно порядок такой:

1. Откройте кабинет Dadata.
2. Перейдите в раздел с данными API.
3. Найдите API key.
4. Найдите Secret key.
5. Скопируйте оба значения.

2. Что важно знать про ключ и секрет

Для пользователя важно понимать простую разницу:

• API key нужен как основной ключ доступа
• Secret key нужен как дополнительная защита

В Omnis эти данные используются не по отдельности, а как связанная пара.

Если один из ключей отсутствует:

• валидация не пройдет
• подсказки не будут считаться подключенными корректно

3. Где вставить ключи в Omnis

В Omnis есть два основных варианта подключения Dadata.

Вариант 1. Во время создания нового приложения

Откройте:

Управление -> CMS -> Конструктор приложений

На шаге Аналитика, карты и подсказки адреса заполните поля:

• API ключ подсказок Dadata
• Секретный ключ подсказок Dadata

После этого Omnis автоматически проверяет введенные данные.

Если значения неверны, система покажет, что ключи не прошли проверку.

Вариант 2. В уже существующем приложении

Если приложение уже создано, откройте:

Управление -> CMS -> Приложения

И заполните поля:

• API ключ подсказок
• Секретный ключ API подсказок

Это удобно, если:

• приложение уже работает
• вы решили подключить адресные подсказки позже
• нужно заменить ключи

4. Что Omnis делает сам после сохранения ключей

После того как ключ и секрет сохранены:

• Omnis использует их в адресных подсказках клиентской витрины
• поле адреса доставки начинает работать с готовыми вариантами адреса
• ограничения по городам и регионам, если они настроены, учитываются и в подсказках

Для пользователя это означает:

• не нужно отдельно подключать подсказки в код
• не нужно вручную собирать список адресов
• поле доставки начинает работать удобнее для клиента

5. Как работает ввод адреса для клиента

В клиентской витрине сценарий обычно выглядит так:

1. Клиент выбирает доставку.
2. Начинает вводить адрес.
3. Через несколько символов появляются варианты.
4. Клиент выбирает подходящий адрес из списка.
5. Адрес попадает в заказ в более аккуратном и понятном виде.

Практически это значит:

• клиенту не нужно печатать весь адрес до конца без подсказок
• шанс ошибки снижается
• оформление проходит быстрее

6. Как ограничения по городам и регионам влияют на подсказки

Это важный бизнес-сценарий.

Если в компоненте оформления заказа настроены ограничения по доставке:

• по городам
• по регионам

то адресные подсказки тоже начинают учитывать эти рамки.

Это удобно, потому что:

• клиенту показываются более релевантные адреса
• снижается риск выбора адреса вне рабочей зоны
• форма оформления становится логичнее

Если говорить совсем просто, Omnis не просто показывает подсказки, а помогает подсказывать адрес в рамках разрешенной зоны доставки.

7. Как быстро начать использовать Dadata после подключения

После сохранения ключей сделайте короткую проверку.

Обычно сценарий такой:

1. Откройте клиентскую витрину, Telegram Mini App или Max мини-приложение.
2. Перейдите в корзину и оформление заказа.
3. Выберите доставку.
4. Начните вводить адрес.
5. Убедитесь, что появились подсказки.
6. Выберите один из вариантов.
7. Проверьте, что адрес корректно подставился в форму.

Если в вашем проекте заданы ограничения по городам и регионам, отдельно проверьте, что подсказки действительно не уводят клиента за пределы разрешенной зоны.

8. Что важно знать про лимиты и доступность

По официальным материалам Dadata у сервиса есть лимиты запросов и условия доступа, зависящие от вашего кабинета и тарифа.

Практически это означает:

• если лимит исчерпан, подсказки могут временно перестать работать
• если кабинет настроен не до конца, сервис тоже может не отвечать так, как ожидается

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

Поэтому в рабочей практике полезно:

• следить за состоянием кабинета Dadata
• проверять лимиты запросов
• не оставлять интеграцию без периодической проверки

Если нужны точные текущие условия, их лучше смотреть прямо в кабинете Dadata.

9. Что чаще всего делают неправильно

Ошибка 1. Заполняют только ключ или только секрет

В Omnis эти значения должны быть заполнены вместе.

Ошибка 2. Ждут, что подсказки появятся в любом поле адреса автоматически

В текущем клиентском сценарии Omnis подсказки особенно важны в оформлении заказа, в поле доставки.

Ошибка 3. Не проверяют ограничения по зоне доставки

Если в проекте настроены ограничения по городам и регионам, их тоже нужно проверить после подключения подсказок.

Ошибка 4. Считают, что отсутствие подсказок всегда означает поломку формы

На практике проблема может быть связана не только с формой, но и с ключами, лимитами, настройкой кабинета Dadata или рабочей зоной доставки.

10. Когда Dadata особенно полезна бизнесу

Dadata особенно полезна, если:

• компания активно работает с доставкой
• у клиентов часто бывают ошибки в адресе
• бизнес работает в нескольких городах
• важно ускорить оформление заказа на телефоне

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

11. Короткий чек-лист подключения

• есть рабочий аккаунт Dadata
• скопирован API key
• скопирован Secret key
• оба значения вставлены в Omnis
• приложение сохранено
• открыто оформление заказа
• в режиме доставки появилось поле адреса с подсказками
• адрес выбирается из списка без ошибок
• при наличии ограничений подсказки работают в нужной зоне доставки