DaData

Приложение DaData помогает агенту нормализовать и проверять российские адреса, реквизиты организаций и банков, ФИО, email и другие справочные данные. Интеграция работает через API DaData и относится к текущему рабочему пространству.

Для чего использовать

• подсказать и стандартизировать адрес по неполному вводу;
• найти организацию или ИП по ИНН или ОГРН;
• проверить реквизиты банка по БИК;
• получить варианты ФИО и email;
• определить адрес по координатам или приблизительное местоположение по IP;
• привести набор полей к стандартному виду через «Стандартизацию» DaData.

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

Подключение

1. Войдите в личный кабинет DaData.
2. Скопируйте API-ключ из профиля.
3. Если нужна платная стандартизация, там же скопируйте секретный ключ.
4. В Promto откройте приложение DaData и нажмите Подключить.
5. Вставьте API-ключ и, при необходимости, секретный ключ.
6. Дождитесь успешной проверки подключения.

API-ключ нужен для подсказок и поиска. Секретный ключ используется только методом стандартизации clean; его можно добавить позднее. Подключение проверяется безопасным запросом к API.

Интерфейс приложения

На главном экране находятся готовые задачи для агента и состояние подключения. Карточка сценария прикрепляет промпт к чату: проверьте входные данные, дополните задачу и отправьте её агенту.

В разделе Настройки видны:

• состояние интеграции;
• маска API-ключа;
• наличие секретного ключа и доступность стандартизации;
• кнопки обновления состояния и отключения.

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

Работа с агентом

Основной агент использует инструмент promto_dadata. Это встроенный инструмент чата, а не команда терминала.

Задача	Действия инструмента
Адреса	suggest_address, geolocate, iplocate
Компании и ИП	suggest_party, find_by_id, find_affiliated
Банки	suggest_bank
Люди и контакты	suggest_fio, suggest_email, find_by_email
Стандартизация	clean
Дополнительный метод API	request

Для точной проверки организации просите агента использовать find_by_id с ИНН или ОГРН. Подсказки suggest_* возвращают список кандидатов: первый вариант нельзя автоматически считать правильным, если запрос неоднозначен.

Практические сценарии

Проверить реквизиты контрагента

Передайте ИНН или ОГРН. Агент найдёт точную запись, покажет наименование, статус, адрес, руководителя и доступные реестровые признаки. Попросите отдельно отметить дату актуальности ответа.

Нормализовать адреса из файла

Загрузите таблицу через приложение Файлы, укажите колонку и желаемые выходные поля. Сначала попросите оценить число строк и стоимость, затем обрабатывайте данные порциями через clean.

Подготовить варианты при вводе

Сообщите неполный адрес, название компании, БИК или ФИО. Агент вернёт несколько кандидатов и попросит выбрать нужный, если совпадение не единственное.

Ограничения и безопасность

• clean требует секретного ключа и тарифицируется DaData отдельно. До массового запроса оцените объём и проверьте баланс.
• Подсказка — это кандидат, а не подтверждённое совпадение. Для компании используйте точный идентификатор.
• Статус из реестра описывает реестровую запись и сам по себе не доказывает, что компания фактически ведёт деятельность.
• Не отправляйте в чат лишние паспортные данные, адреса проживания и другие персональные сведения. Перед массовой обработкой проверьте правовое основание.
• Ключи доступны только серверному подключению. Не просите агента вывести их или вставить в код проекта.
• Учитывайте лимиты и баланс тарифа DaData; большие наборы разбивайте на контролируемые порции.

Если не работает

Симптом	Что проверить
dadata_not_connected	Откройте DaData и подключите аккаунт владельцем рабочего пространства
dadata_secret_key_required	Для clean добавьте секретный ключ в настройках приложения
Ничего не найдено	Уточните ИНН, ОГРН, БИК или расширьте исходный текст; не выбирайте случайную подсказку
Ошибка лимита или оплаты	Проверьте баланс и ограничения тарифа DaData, уменьшите размер партии
Неверный кандидат	Повторите запрос с точным идентификатором через find_by_id

Связанные материалы

• Настройки рабочего пространства
• Файлы
• Как получать лучший результат

Готовый промпт

Через promto_dadata проверь контрагента по ИНН <ИНН>. Используй find_by_id, не выбирай организацию только по первой подсказке. Покажи официальное наименование, статус, ОГРН, адрес и дату актуальности ответа. Отдельно укажи, какие выводы являются реестровыми сведениями, а какие нельзя подтвердить по DaData.