На текущий момент, чтение ботом обычных веб-страниц с использованием нижеприведённого способа может работать некорректно и сильно повышать стоимость диалога.
В разработке находится новый, более дешёвый и корректный способ для чтения ссылок. Ожидайте
Что же такое чтение URL-ссылок?
Чтение URL-ссылок - это возможность бота получить нужную Вам информацию с любой веб-страницы какого-либо сайта.
Создание действия просмотра URL-ссылок.
1
Перейдите в раздел "Действия" и нажмите кнопку "Создать"
2
Выбираем тип шага "Чтение ссылок"
3
Попадаем в Настройки действия
Название действия
Название для отображения, по которому Вы легко сможете определить нужное действие в общем списке
Название функции
Должно описывать основной смысл данного действия.
Допускаются только символы английского алфавита и нижнее подчеркивание (_)
Описание функции
Описание того, что данное действие будет делать
Сообщение об ошибке
Какой текст будет возвращаться боту при ошибке. Рекомендуем вписать туда что-то вроде "Произошла ошибка"
Правила ответа боту
В рамках одного действия могут быть вызваны несколько вебхуков или выполнено несколько других функций.
При помощи этой настройки у нас есть возможность выбрать, ответ из какого именно шага будет передан боту - из первого, из последнего, или из всех.
4
Заполняем поля
Для того, чтобы автоматически сгенерировать Название функции, заполните поле Название действия и нажмите кнопку автоматической генерации справа от поля с названием функции.
5
Добавляем Аргумент действия, нажав плюс в поле ниже
6
Заполняем появившиеся поля
Аргумент - так как аргументом для функции у нас по задумке является любая URL-ссылка, то в поле Аргумент прописываем link.
Описание аргумента - это поле необязательно и служит для описания, чтобы бот лучше понимал зачем аргумент нужен и что туда передавать.
Обратите внимание, что аргумент должен быть написан на английском языке и без пробелов. Допускается использование символов английского алфавита и нижнее подчеркивание (_)
7
Добавляем шаг, нажав на кнопку "Добавить шаг"
8
Выбираем тип шага - Вебхук
9
Видим меню для настройки шага
Название
Название шага для отображения в списке. Может быть любым
URL
Конечный адрес для запроса. Это значение может быть как определённой ссылкой, которую бот будет исследовать по запросу, так и динамичным аргументом, передаваемым в функцию.
Метод запроса
HTTP-метод, используемый при выполнении запроса (GET, POST, PATCH, и т.д.)
Параметры, которые будут передаваться в URL
Параметры запроса, передающиеся в строке запроса. Например
?phone=123&type=passport
Заголовки запроса
Заголовки HTTP-запроса, такие как тип содержимого или токен авторизации
Тело запроса
Данные, передаваемые в запросе (для всех методов, кроме GET). Например:
{"phone": 123, "type": "passport"}
Статус коды, при которых вернется ответ от вебхука
Коды ответов (200, 404, 500 и другие), при которых ответ от вебхука будет считаться успешным и вернётся боту.
В случае, если вебхук вернет код, отличный от заданных, вместо ответа вебхука, бот получит текст из настройки "Сообщение об ошибке".
Если не указать ни одного кода, успешными будут считаться все.
Максимальная длина ответа в символах
Ограничение размера ответа. Если вебхук вернёт ответ, в котором будет больше заданного количества символов, бот получит сообщение об ошибке.
Необходимо для предотвращения случайного использования большого количества токенов.
10
Заполняем поля Название и URL
Нажимем на шестеренку в правом конце поля URL
Выбираем заданный ранее аргумент link
Правильно заполненная строка URL должна иметь такой вид (цвет аргумента может отличаться, он рандомный и ни на что не влияет):
Для корректной работы получения информации по ссылке, Метод запроса оставляем по умолчанию - GET.
11
Нажимаем на кнопку Сохранить, чтобы сохранить шаг
12
После нажатия на кнопку "Сохранить" само действие сохраняется автоматически: