Какотправлятьиполучатьданныеизвнешнихисточников

АвтоматизироватьпроцесссталоещепрощесAPIзапросами。Cпомощьюэтогофункционалавысможет,енапримерпоназваниюгородасообщатьпогоду,поназваниютовараосуществлятьпоискивыводитьрезультатвчат——бот,поданнымподписчикарегистрироватьегонамероприятиеилисоздаватьзаказ。

Этоработаеттак:выотправляетезапросыданныхвовнешниесистемыолюбойинформаци,икоторойинтересуетсявашпользовательилисоздаетеновыйобъект。Вответвыполучаетеданные,которыеможносразувыдаватьвсообщениипользователюилизаписыватьвпеременнуючат——бота。

Как отправить запрос на получение данных

Перетащитеэлемент«ЗапросAPI»нарабочееполе,соединитеегосэлементом,послекотороговамнужнополучитьинформацию。

Выберите тип запроса:

• 得到запрособычноиспользуютдляполученияужесуществующихданных;
• 帖子запрособычноиспользуютдлясозданияновогообъектавсистемеиполученияинформациионем。

Введите url， на который отправится запрос。В запросе можете использоватьпользовательскиеиглобальныепеременные вашего чат-бота。

Выможетедобавлятьзаголовкизапроса,напримердляавторизациизапросов。Такжевыможетеиспользоватьпеременныеботавзаголовкахзапроса。

ЕслииспользуетеPOSTзапрос,внужномполевведитетелозапросавJSONспараметрами。

Нажмите«Проверитьзапрос»дляпроверкиотправкиданных。Такжепроверкапригодитсядляраспознаванияданныхприпоследующейнастройке。

Как использовать полученные данные

Вслучаеуспешногозапросавыполучитетелоответа,ипользовательпройдетповетке«Выполнено»。Полученныеданныеможноиспользоватьодинразвследующемтекстовомблоке,записатьвпеременнуючат——ботадлямногократногоиспользованияилиотправитькарточкисообщенийнаосновеуказанногомассива。

Поветке«Выполнено»будутидтивсеответызапросовсостатусом2хх。Ответызапросовсдругимистатусамипойдутповетке«Ошибка»иданныенельзябудетиспользовать。Читайте подробнее:«Как продолжить цепочку， случае ошибки запроса»。

Использование данных * сохранением * переменную

Чтобысохранитьданныевпеременныедлядальнейшегоиспользования,вэлементе«ЗапросAPI»перейдитевовкладку«Сохранятьзначения»ивнастройкахсоответствийнажмите«Добавить»。

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

Выберитепеременную,вкоторуюсохранятьзначение。

Когдавысохранилинеобходимоеколичествопеременных,нажмите«Применить»иперейдитексозданиюследующегоблока。

Вэтомпримеремысоздализаказ,получилиданныевответизнашейCRM,сохранилиихвпеременныеисообщаемпользователюдлябыстройидентификациизаказаннойуслугиилитовара。

Пользователюобщениесвашимчат——ботомвыглядитвоттак:

Использование данных Использование данных виде выражения JSON路径

Есливамненужнозаписыватьданныевпеременны,еможетеиспользоватьполученнуюинформациювставкойвыражения пути json структуры．

Дляэтогопослепроверкизапросаиполученияуспешногоответанажмите«Добавить»,найдитевашупеременнуюископируйтеJSON路径изполяответа。

Затемнажмите«Применить»иперейдитексозданиюследующегоэлемента。

Обратитевнимание,чтоданные,которыевынезаписывает,еможноиспользоватьтолькоодин з з з следующем текстовом блоке。

В тексте сообщения добавьте JSON路径{{$ (' somekey '] [' nestedkey ']}}．

Пользователюобщениесвашимчат——ботомэтогопримеравыглядитвоттак:

Использование для отправки карточки

Наплатномтарифедоступнатакжеотправкакарточек。сформированныхизданных,которыебудутполученывответназапрос。Дляэтогоперейдитевовкладку«Отправлятьсообщения»изаполнитеполяформыданнымиизполученногомассива。

Читайте подробнее:«Как отправлять карточки сообщений， чат-ботах»。

Как продолжить цепочку， случае ошибки запроса

ТакжевыможетеразветвитьсценарийивслучаенеуспешногоAPIзапросапродолжитьцепочкуповетке«Ошибка。”Кпримеру,выможетесообщитьобошибкеипереспроситьнеобходимыеданные,еслионинесовпадаю,тилипозватьменеджера。

Обновлено:15.03.2023