# Чтение URL-ссылок

{% hint style="warning" %}
**Данный функционал дорабатывается.**

\
На текущий момент, чтение ботом обычных веб-страниц с использованием нижеприведённого способа может работать некорректно и сильно повышать стоимость диалога.

В разработке находится новый, более дешёвый и корректный способ для чтения ссылок. Ожидайте
{% endhint %}

**Что же такое чтение URL-ссылок?**

**Чтение URL-ссылок** - это возможность бота получить нужную Вам информацию с любой веб-страницы какого-либо сайта.

## Создание действия просмотра URL-ссылок.

{% stepper %}
{% step %}

### Перейдите в раздел "Действия" и нажмите кнопку "Создать"

<figure><img src="/files/m002ghppVvFJJxvELmTV" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Выбираем тип шага "Чтение ссылок"

<figure><img src="/files/yEis3Epz4Kg7nZ1u5Ob7" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Попадаем в Настройки действия

<figure><img src="/files/jRgUUZPXhLmlzRnmQW4l" alt=""><figcaption></figcaption></figure>

| **Название действия**   | Название для отображения, по которому Вы легко сможете определить нужное действие в общем списке                                                                                                                                                                        |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Название функции**    | <p>Должно описывать основной смысл данного действия.</p><p>Допускаются только символы английского алфавита и нижнее подчеркивание (<code>\_</code>)</p>                                                                                                                 |
| **Описание функции**    | Описание того, что данное действие будет делать                                                                                                                                                                                                                         |
| **Сообщение об ошибке** | Какой текст будет возвращаться боту при ошибке. Рекомендуем вписать туда что-то вроде "Произошла ошибка"                                                                                                                                                                |
| **Правила ответа боту** | <p>В рамках одного действия могут быть вызваны несколько вебхуков или выполнено несколько других функций.<br><br>При помощи этой настройки у нас есть возможность выбрать, ответ из какого именно шага будет передан боту - из первого, из последнего, или из всех.</p> |
| {% endstep %}           |                                                                                                                                                                                                                                                                         |

{% step %}

### Заполняем поля

<figure><img src="/files/Z3wS2RulVoIPrWG84h9v" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Для того, чтобы автоматически сгенерировать **Название функции**, заполните поле **Название действия** и нажмите **кнопку** автоматической генерации справа от поля с названием функции.
{% endhint %}
{% endstep %}

{% step %}

### Добавляем Аргумент действия, нажав плюс в поле ниже

<figure><img src="/files/wNV1X9STgTQn9F3zQc7I" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Заполняем появившиеся поля

<figure><img src="/files/fA0tGLdvm8ND1hRnKAuG" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Аргумент** - так как аргументом для функции у нас по задумке является любая **URL-ссылка**, то в поле **Аргумент** прописываем **`link`**.

**Описание аргумента** - это поле необязательно и служит для описания, чтобы бот лучше понимал зачем аргумент нужен и что туда передавать.
{% endhint %}

{% hint style="warning" %}
Обратите внимание, что **аргумент** должен быть написан на английском языке и без пробелов. Допускается использование символов английского алфавита и нижнее подчеркивание (`_`)
{% endhint %}
{% endstep %}

{% step %}

### Добавляем шаг, нажав на кнопку "Добавить шаг"

<figure><img src="/files/pdV7wCqNUO1yG57cn7AH" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Выбираем тип шага - Вебхук

<figure><img src="/files/tJNn5EKy6BUHrAla0p0U" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Видим меню для настройки шага

<figure><img src="/files/1Fg8UnxfQXda3XfHBZu4" alt=""><figcaption></figcaption></figure>

| **Название**                                           | Название шага для отображения в списке. Может быть любым                                                                                                                                                                                                                                                                                                |
| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **URL**                                                | Конечный адрес для запроса. Это значение может быть как определённой ссылкой, которую бот будет исследовать по запросу, так и динамичным аргументом, передаваемым в функцию.                                                                                                                                                                            |
| **Метод запроса**                                      | HTTP-метод, используемый при выполнении запроса (GET, POST, PATCH, и т.д.)                                                                                                                                                                                                                                                                              |
| **Параметры, которые будут передаваться в URL**        | <p>Параметры запроса, передающиеся в строке запроса. Например</p><p><code>?phone=123\&type=passport</code></p>                                                                                                                                                                                                                                          |
| **Заголовки запроса**                                  | Заголовки HTTP-запроса, такие как тип содержимого или токен авторизации                                                                                                                                                                                                                                                                                 |
| **Тело запроса**                                       | <p>Данные, передаваемые в запросе <em>(для всех методов, кроме GET)</em>. Например:<br><code>{"phone": 123, "type": "passport"}</code></p>                                                                                                                                                                                                              |
| **Статус коды, при которых вернется ответ от вебхука** | <p>Коды ответов (200, 404, 500 и другие), при которых ответ от вебхука будет считаться успешным и вернётся боту.<br><br>В случае, если вебхук вернет код, отличный от заданных, вместо ответа вебхука, бот получит текст из настройки "<strong>Сообщение об ошибке</strong>".<br><br>Если не указать ни одного кода, успешными будут считаться все.</p> |
| **Максимальная длина ответа в символах**               | <p>Ограничение размера ответа. Если вебхук вернёт ответ, в котором будет больше заданного количества символов, бот получит сообщение об ошибке.<br><br>Необходимо для предотвращения случайного использования большого количества токенов.</p>                                                                                                          |
| {% endstep %}                                          |                                                                                                                                                                                                                                                                                                                                                         |

{% step %}

### Заполняем поля Название и URL

<figure><img src="/files/fmqgvothhbc2dZ0sKQyE" alt=""><figcaption></figcaption></figure>

1. Нажимем на шестеренку в правом конце поля URL
2. Выбираем заданный ранее аргумент `link`

Правильно заполненная строка URL должна иметь такой вид (цвет аргумента может отличаться, он рандомный и ни на что не влияет):

<figure><img src="/files/cdHcSpItuEgabortpgm1" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Для корректной работы получения информации по ссылке, **Метод запроса** оставляем по умолчанию - **GET.**
{% endhint %}
{% endstep %}

{% step %}

### Нажимаем на кнопку Сохранить, чтобы сохранить шаг

<figure><img src="/files/BfozXtnTCJLL2u4hlQRh" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### После нажатия на кнопку "Сохранить" само действие сохраняется автоматически:

<figure><img src="/files/qEBM352z0uxc3cRmnBU9" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

Настройка завершена.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.suvvy.ai/ru/deistviya/chtenie-url-ssylok.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.