Чтение URL-ссылок
Last updated
Was this helpful?
Last updated
Was this helpful?
Данный функционал дорабатывается.
На текущий момент, чтение ботом обычных веб-страниц с использованием нижеприведённого способа может работать некорректно и сильно повышать стоимость диалога.
Что же такое чтение URL-ссылок?
Чтение URL-ссылок - это возможность бота получить нужную Вам информацию с любой веб-страницы какого-либо сайта.
Название действия
Название для отображения, по которому Вы легко сможете определить нужное действие в общем списке
Название функции
Должно описывать основной смысл данного действия.
Допускаются только символы английского алфавита и нижнее подчеркивание (_)
Описание функции
Описание того, что данное действие будет делать
Сообщение об ошибке
Какой текст будет возвращаться боту при ошибке. Рекомендуем вписать туда что-то вроде "Произошла ошибка"
Правила ответа боту
В рамках одного действия могут быть вызваны несколько вебхуков или выполнено несколько других функций. При помощи этой настройки у нас есть возможность выбрать, ответ из какого именно шага будет передан боту - из первого, из последнего, или из всех.
Аргумент - так как аргументом для функции у нас по задумке является любая URL-ссылка, то в поле Аргумент прописываем url_link.
Описание аргумента - это поле необязательно и служит для описания, чтобы не запутаться, если аргументов несколько.
Обратите внимание, что аргумент должен быть написан на английском языке и без пробелов. Допускается использование символов английского алфавита и нижнее подчеркивание (_)
Название
Название шага для отображения в списке. Может быть любым
URL
Конечный адрес для запроса. Это значение может быть как определённой ссылкой, которую бот будет исследовать по запросу, так и динамичным аргументом, передаваемым в функцию.
Метод запроса
HTTP-метод, используемый при выполнении запроса (GET, POST, PATCH, и т.д.)
Параметры, которые будут передаваться в URL
Параметры запроса, передающиеся в строке запроса. Например
?phone=123&type=passport
Заголовки запроса
Заголовки HTTP-запроса, такие как тип содержимого или токен авторизации
Тело запроса
Данные, передаваемые в запросе (для всех методов, кроме GET). Например:
{"phone": 123, "type": "passport"}
Статус коды, при которых вернется ответ от вебхука
Коды ответов (200, 404, 500 и другие), при которых ответ от вебхука будет считаться успешным и вернётся боту. В случае, если вебхук вернет код, отличный от заданных, вместо ответа вебхука, бот получит текст из настройки "Сообщение об ошибке". Если не указать ни одного кода, успешными будут считаться все.
Максимальная длина ответа в символах
Ограничение размера ответа. Если вебхук вернёт ответ, в котором будет больше заданного количества символов, бот получит сообщение об ошибке. Необходимо для предотвращения случайного использования большого количества токенов.
Нажимем на "+" в правом конце поля URL
Выбираем заданный ранее аргумент url_link
Правильно заполненная строка URL должна иметь такой вид (цвет аргумента может отличаться, он рандомный и ни на что не влияет):
Для корректной работы получения информации по ссылке, Метод запроса оставляем по умолчанию - GET.
Настройка завершена.
