Dadata

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

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

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

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

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

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

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

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

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

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

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

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

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

При этом Dadata остается необязательным помощником для ввода адреса. Клиент может указать адрес вручную, а отсутствие или временная недоступность подсказок не блокирует оформление заказа.

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

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

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

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

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

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

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

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

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

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

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

Если Dadata подключена и доступна, это поле показывает подсказки адреса.

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

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

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

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

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

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

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

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

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

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

Важно:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

В группе CMS откройте страницу Конструктор приложений.

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

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

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

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

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

Если приложение уже создано, откройте в группе CMS страницу Приложения.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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