Блок Запрос к серверу позволяет боту общаться с внешней или внутренней системой через API. Робот может искать/получать информацию о клиенте и сохранять новые данные, полученные в диалоге. Также блок позволяет использовать сетевые сервисы через API, такие, как калькулятор, конвертер величин, прогноз погоды и другие. Описание методов API смотрите на странице.
Например, от клиента поступает входящий вызов. Робот определяет номер и обращается к CRM-системе для получения данных. Узнав, что у клиента есть активный заказ, спрашивает, не интересует ли его статус. При положительном ответе предоставляет информацию о заказе до того, как клиент озвучит свою цель звонка.
Блок не может быть последним в сценарии, должна быть хотя бы стрелка в пустой блок.
Свойство | Описание | |
¶ Основное |
||
Подпись | Название блока, которое отображается в блоке в редакторе сценария, но не используется в диалоге с клиентом. Служит для удобства создающего сценарий пользователя. | |
Маркер | Условное обозначение блока, произвольный текст. Может использоваться при аналитике в отчетах как маркер прохождения блока – с его помощью можно проследить, какие блоки прошел робот. | |
Сообщение | Текст, который будет воспроизведен роботом после перехода в блок. Отображается в блоке в редакторе сценария, если не задана Подпись, а также высвечивается как всплывающая подсказка при наведении на блок. | |
Задержка | Период времени, по истечении которого будет отправлено сообщение после перехода в блок. С помощью задержки перед отправкой можно эмулировать набор сообщения – как будто с клиентом общается не бот, а реальный человек. Задается в секундах. | |
Немедленная отправка | Позволяет отправить сообщения до полного формирования очереди в связке с блоком запроса к серверу. | |
Как часто говорить еще подождать | Время в секундах, через которое робот будет воспроизводить повторное сообщение до тех пор, пока не будет получен ответ от сервера. Сообщение заполняется ниже в поле Сообщение еще подождать. | |
Сообщение еще подождать | Текст с просьбой подождать, который будет воспроизведен роботом. Данный текст можно использовать, чтобы заполнить паузу, во время которой система выполняет обращение к API стороннего сервиса или CRM-системы. | |
¶ Запрос |
||
Метод |
Способ, как клиент (например, веб-браузер) взаимодействует с сервером.
|
|
URL | Адрес страницы, на который отправляется запрос, представляет собой основной параметр запроса. Этот адрес привязан к странице, с которой взаимодействует робот, и позволяет использовать переменные в строке адреса для передачи информации в сервис, обеспечивая эффективное взаимодействие между роботом и сервисом. | |
¶ Парметры |
||
Ключ |
Строка, которая идентифицирует конкретный параметр. Ключ обычно является именем или меткой, которая описывает, что именно передается в запросе. Для добавления ключа нажмите Добавить, для удаления нажмите . . |
|
Значение | Конкретное значение, связанное с ключом. Значение представляет собой данные, которые передаются в запросе и соответствуют указанному ключу. | |
¶ Авторизация |
||
Тип авторизации |
Тип авторизации в запросе к серверу:
Набор следующих заполняемых полей определяется после указания типа авторизации. |
|
Отсутствует | Используется, если для работы со страницей не требуется проходить авторизацию. Например, если сервис находится в защищенном контуре. | |
Логин и пароль | Используется, если для работы со страницей требуется выполнить авторизацию по логину и паролю. | |
Заголовок с токеном |
Используется, если для работы со страницей требуется использовать авторизационный токен. Тип токена – схема аутентификации: BASIC, DIGEST, BEARER, MUTUAL, HOBA, AWS4-HMAC-SHA256. Подробнее читайте в статье HTTP-аутентификация. Значение токена – значение ключа. Например, для |
|
¶ Заголовки
|
||
Ключ |
Название определенного аспекта или свойства запроса. Для добавления ключа нажмите Добавить и удаляется по клику на . |
|
Значение | Конкретное значение, связанное с указанным ключом. | |
¶ cURLПозволяет импортировать и экспортировать запросы в формате cURL. При вставке полного cURL-запроса в текстовое поле вкладки cURL, все параметры, такие как метод, URL, заголовки и тело запроса, автоматически распознаются и переносятся на соответствующие вкладки редактора (Метод, URL, Параметры, Авторизация, Заголовки, Тело запроса). Если вручную настроить параметры запроса на других вкладках (например, Параметры, Авторизация) cURL-код автоматически генерируется на вкладке cURL. Это дает возможность легко скопировать запрос в формате cURL для его последующего использования в командной строке или других инструментах, поддерживающих cURL. |
Свойство | Описание | ||
Подпись | Название стрелки, которое отображается над стрелкой в редакторе сценария. | ||
Тип выходных данных |
Тип принятия решения. Переход к следующему блоку сценария осуществляется при достижении определенного результата запроса (успешен или не успешен) или по умолчанию. Следующие поля отобразятся в зависимости от выбранного типа. Если для стрелки не задана подпись и она является стрелкой по умолчанию, в качестве названия стрелки будет отображаться «По умолчанию». |
||
По умолчанию | Данный тип используется для перехода по ветке в случае, если условия во всех остальных стрелках данного блока не будут соблюдены. Настройка дополнительных параметров не требуется. | ||
Успешный ответ | Переход по ветке будет произведен, если ответ от сервера является успешным. | ||
Код ответа | Код успешного ответа, который система будет ожидать после выполнения запроса. Например, 200, 201. Все коды ответа считаются успешными, даже 500 и 404. Ответ считается неуспешным, если вообще не был получен. | ||
Условия |
Набор условий, по которым принимается решение. Переход по ветке будет произведен, если код ответа от сервера совпадет с указанным в свойствах стрелки и если указанные условия будут выполнены. Результат ответа от сервера будет сохранен в переменную Для условий заполняются поля:
|
||
Переменные |
Каждая переменная добавляется в отдельном поле по кнопке Добавить и удаляется по клику на . В полях Название и Поле из ответа указываются названия и значения переменных. В названиях переменных разрешено использовать: кириллические буквы, латинские буквы, цифры, точку (.), нижнее подчеркивание (_), дефис (-), квадратные скобки ([]). Пробел использовать не рекомендуется. Для извлечения данных из ответа сервера используйте поле |
||
Ошибка | Переход по ветке будет произведен, если ответ от сервера получить не удалось. Настройка дополнительных параметров не требуется. |