Подключение DaData к Albato. Пример интеграции
Сервиса DaData может быть полезен в самых разных бизнес-областях, поскольку работает с клиентскими данными, которые помогут оптимизировать маркетинговые, логистические или аналитические процессы.
Чтобы использовать сервис DaData в своих интеграциях и решать с их помощью бизнес-задачи, сервис следует сначала подключить к Albato.
В Albato можно использовать DaData в качестве сервиса, в который передаются данные из других источников. Для этого доступны два действия:
Получить данные организации по ИНН
Получить информацию по адресу
Чтобы начать создавать связки, использующие эти действия, сначала нужно выполнить подключение.
Как подключить сервис
Зайдите в раздел «Подключения» и выберите «Добавить подключение».
Из списка категорий сервисов выберите «Другое» и кликните по иконке сервиса или воспользуйтесь поисковой строкой.
![](https://storage.crisp.chat/users/helpdesk/website/3e037e2eeb97fa00/fc39faab-e505-4348-aaaf-382faf_1ondo0k.png)
Задайте уникальное название для подключения или оставьте стандартное и заполните поля, используя данные из DaData. Не закрывайте настройки подключения в Albato и перейдите в личный кабинет DaData. Зайдите во вкладку API в верхнем меню. Скопируйте ключи подключения:
![](https://storage.crisp.chat/users/helpdesk/website/52a5218951010400/a8189e42-764b-428b-bc81-d50722_11a9evj.png)
Вставьте их в соответствующие поля в настройках Albato:
![](https://storage.crisp.chat/users/helpdesk/website/f1a449c9698fa00/f58718a6-106c-4786-ad08-e9ae08_1x9k9ts.png)
Значение из поля «секретный ключ» вставьте в поле «API Secret».
Готово! Теперь подключение можно использовать в любых интеграциях Albato.
DaData не может использоваться в качестве первого шага, поэтому рассмотрим, какие поля и действия доступны при выборе сервиса, в качестве точки входа для данных. Для примера мы будем использовать Битрикс24 в качестве источника данных и заполняем нужные поля, используя его данные.
При выборе действия «Получить данные организации по ИНН», поля для передачи будут выглядеть следующим образом:
![](https://storage.crisp.chat/users/helpdesk/website/26f3271272e7b400/6d1b81c0-4dee-4c9f-af6b-74ea8b_ut013h.png)
![](https://storage.crisp.chat/users/helpdesk/website/b9f1eb2893b3580/83a554e3-c04b-49ae-a96e-ac70bc_p3lo8x.png)
На этом экране только ИНН является обязательным полем, поэтому дальше по настройке пройти нельзя, если поле останется пустым. Выберите ИНН сервиса, который используется в качестве источника данных.
![](https://storage.crisp.chat/users/helpdesk/website/9d7d2e3dec9c8800/9ce2ee85-b33d-4467-b2eb-8faa81_fue8es.png)
В поле «Тип подразделения» укажите главный офис или филиал будет использоваться.
В поле «Тип организации» нужно выбрать юридическое или физическое лицо. Минимальная связка будет выглядеть следующим образом:
![](https://storage.crisp.chat/users/helpdesk/website/a8beadddd708d800/ba0fae40-f3e8-43bc-b5b5-6bde67_ufsabo.png)
При выборе действия «Получить информацию по адресу».
![](https://storage.crisp.chat/users/helpdesk/website/e1fb216ac6c8d000/fc367db8-c33b-4218-84e6-0c5f6b_1bk7p8f.png)
С этим действием работает только одно поле:
![](https://storage.crisp.chat/users/helpdesk/website/4f0520c9c02db800/bf975de6-7b25-423c-a79f-403bc4_hdal7h.png)
В него мы можем передавать данные о компаниях по адресу: укажем два значения, чтобы получить более подробную информацию по адресу компании.
Минимальная связка будет выглядеть следующим образом:
![](https://storage.crisp.chat/users/helpdesk/website/5c359d3ae6980c00/0c681051-59a7-4dca-b544-2a6ea7_ha81ki.png)
Чтобы добавить в к вашей интеграции какой-либо новый шаг или инструмент, нажмите кнопку “+”. Обратите внимание, что вы можете добавить действие или инструмент как в конце связки, так и между уже созданными шагами.
![](https://storage.crisp.chat/users/helpdesk/website/2b4ece1b7362b400/e7899428-f79e-4f92-bd8c-f7ff17_1owgnpc.png)
Чтобы получать из сервиса-источника данные только определенного типа, настройте фильтр входящих данных.
Для этого кликните по иконке в настройках связки:
![](https://storage.crisp.chat/users/helpdesk/website/d4de46253d854800/b1254942-1bb5-4f46-9c25-87bad7_7dlvfv.png)
О том, как работают фильтры можно почитать здесь.
Чтобы использовать сервис DaData в своих интеграциях и решать с их помощью бизнес-задачи, сервис следует сначала подключить к Albato.
В Albato можно использовать DaData в качестве сервиса, в который передаются данные из других источников. Для этого доступны два действия:
Получить данные организации по ИНН
Получить информацию по адресу
Чтобы начать создавать связки, использующие эти действия, сначала нужно выполнить подключение.
Как подключить сервис
Зайдите в раздел «Подключения» и выберите «Добавить подключение».
Из списка категорий сервисов выберите «Другое» и кликните по иконке сервиса или воспользуйтесь поисковой строкой.
![](https://storage.crisp.chat/users/helpdesk/website/3e037e2eeb97fa00/fc39faab-e505-4348-aaaf-382faf_1ondo0k.png)
Задайте уникальное название для подключения или оставьте стандартное и заполните поля, используя данные из DaData. Не закрывайте настройки подключения в Albato и перейдите в личный кабинет DaData. Зайдите во вкладку API в верхнем меню. Скопируйте ключи подключения:
![](https://storage.crisp.chat/users/helpdesk/website/52a5218951010400/a8189e42-764b-428b-bc81-d50722_11a9evj.png)
Вставьте их в соответствующие поля в настройках Albato:
![](https://storage.crisp.chat/users/helpdesk/website/f1a449c9698fa00/f58718a6-106c-4786-ad08-e9ae08_1x9k9ts.png)
Значение из поля «секретный ключ» вставьте в поле «API Secret».
Готово! Теперь подключение можно использовать в любых интеграциях Albato.
Настройка связок
DaData не может использоваться в качестве первого шага, поэтому рассмотрим, какие поля и действия доступны при выборе сервиса, в качестве точки входа для данных. Для примера мы будем использовать Битрикс24 в качестве источника данных и заполняем нужные поля, используя его данные.
При выборе действия «Получить данные организации по ИНН», поля для передачи будут выглядеть следующим образом:
![](https://storage.crisp.chat/users/helpdesk/website/26f3271272e7b400/6d1b81c0-4dee-4c9f-af6b-74ea8b_ut013h.png)
![](https://storage.crisp.chat/users/helpdesk/website/b9f1eb2893b3580/83a554e3-c04b-49ae-a96e-ac70bc_p3lo8x.png)
На этом экране только ИНН является обязательным полем, поэтому дальше по настройке пройти нельзя, если поле останется пустым. Выберите ИНН сервиса, который используется в качестве источника данных.
![](https://storage.crisp.chat/users/helpdesk/website/9d7d2e3dec9c8800/9ce2ee85-b33d-4467-b2eb-8faa81_fue8es.png)
В поле «Тип подразделения» укажите главный офис или филиал будет использоваться.
В поле «Тип организации» нужно выбрать юридическое или физическое лицо. Минимальная связка будет выглядеть следующим образом:
![](https://storage.crisp.chat/users/helpdesk/website/a8beadddd708d800/ba0fae40-f3e8-43bc-b5b5-6bde67_ufsabo.png)
При выборе действия «Получить информацию по адресу».
![](https://storage.crisp.chat/users/helpdesk/website/e1fb216ac6c8d000/fc367db8-c33b-4218-84e6-0c5f6b_1bk7p8f.png)
С этим действием работает только одно поле:
![](https://storage.crisp.chat/users/helpdesk/website/4f0520c9c02db800/bf975de6-7b25-423c-a79f-403bc4_hdal7h.png)
В него мы можем передавать данные о компаниях по адресу: укажем два значения, чтобы получить более подробную информацию по адресу компании.
Минимальная связка будет выглядеть следующим образом:
![](https://storage.crisp.chat/users/helpdesk/website/5c359d3ae6980c00/0c681051-59a7-4dca-b544-2a6ea7_ha81ki.png)
Дополнительные настройки связки
Чтобы добавить в к вашей интеграции какой-либо новый шаг или инструмент, нажмите кнопку “+”. Обратите внимание, что вы можете добавить действие или инструмент как в конце связки, так и между уже созданными шагами.
![](https://storage.crisp.chat/users/helpdesk/website/2b4ece1b7362b400/e7899428-f79e-4f92-bd8c-f7ff17_1owgnpc.png)
Чтобы получать из сервиса-источника данные только определенного типа, настройте фильтр входящих данных.
Для этого кликните по иконке в настройках связки:
![](https://storage.crisp.chat/users/helpdesk/website/d4de46253d854800/b1254942-1bb5-4f46-9c25-87bad7_7dlvfv.png)
О том, как работают фильтры можно почитать здесь.
Обновлено на: 18/10/2022
Спасибо!