# Внешний запрос

Source: https://docs.botman.pro/a/154-vneshniy-zapros

[Видео — Rutube](https://rutube.ru/video/a50d9c6b765319c81ae1ef1695b70c4a/)

---

В этой инструкции мы расскажем вам о функции «Внешний запрос». Это действие позволяет нам создавать интеграции с любыми сервисами, у которых есть открытое API. В этой инструкции будет пример интеграций с «SMS aero» и «Звонок» .

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/2a0394654b37b51408f64651179819ece650162ec80f59801ab45ad76731701f.png)

Для настройки любого запроса, нужно найти API-документацию сервиса.\
SMS aero - https://smsaero.ru/cabinet/settings/apikey/

На этой странице мы уже видим Api key (текущий ключ) и вашу почту в шапке страницы. Их нужно запомнить, т.к. они пригодятся в будущем.

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/af27e0a5d264afd87723acdf1e8cc8485e16ef6bfc091d11b82bf269b4df4fd6.png)

В документации пролистываем до нужного вам запроса. Мы приведем пример на отправке одного сообщения

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/b08e3252b41e2d41884598de34871cd352abecac97684cac52b5430d8d0be5dc.png)

https://email:api\_key@gate.smsaero.ru/v2/sms/send?number=79990000000&text=your+text&sign=SMS Aero

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/a423b1bd5d3579e16ea2069b71fabf80e204dbfd04ae4417aacafc2697cdc13c.png)

вам нужно будет заменить:

1. email - вашу почту, которую мы записали чуть раньше
2. api\_key - текущий ключ
3. 79990000000 - {%phone%} переменная в botman
4. your+text - ваш текст sms
5. SMS Aero - Имя отправителя

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/79073406f189c27e92c085e99ef3186163aee06424bb3fb331f9675409b1b8a8.png)

Далее вставляем получившийся url в настройки внешнего запроса

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/5890bacea373e46271ec1f84dc4f1d5be931c289fd93a7adec781073ec19ad25.png)

Сохраняем и можем тестировать.

У нас получилось отправить сообщение. Надпись "на модерации" означает, что сообщение скоро отправиться

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/4db9a3510a564fca83c06e2696d807a8cbd0840876af0b3554302bf9de6414eb.png)

**Звонок**

Далее настроим интеграцию с сервисом «Звонок»\
Документация: https://api-docs.zvonok.com

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/7f451a39de23f3950842d43afc57d4446c56a221b0f855cc8d6693a28f9dd294.png)

Простой пример url:

https://zvonok.com/manager/cabapi\_external/api/v1/phones/call/?public\_key=your\_public\_key&phone=customer\_phonenumber&campaign\_id=your\_campaign\_id

1. your\_public\_key - найдете в настройках (https://zvonok.com/manager/users/profile-settings/)
2. customer\_phonenumber - {%phone%} или любой номер телефона
3. your\_campaign\_id - id компании (https://zvonok.com/manager/phones/all/)

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/d13fd407240caaa86a4cb86e9f336e462dae07603cf6d7c9f2a27bc2f5bbde06.png)

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/6693a5db1c222900f58647625fc43e4bfe6419083fa53f7dafdcbe5b82c9fa6d.png)

Получившийся url вставляем в URL запроса.

Вы можете протестировать запрос прямо в действии. Ошибка будет обозначена так:

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/faa16e5e3bb8409f4390944b8d01a97df284ddbd9f952765e7f692e3963f15e5.png)

В теле ответа чаще всего будет выведено описание ошибки.

если запрос отправлен успешно, будет выведен код 200 в зеленом блоке

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/5477f3af53cdc23e8429d0be22bba15ec5051bdf1051205492949876fc763842.png)

**Заголовки**

В этом разделе задаются Заголовки для отправляемого запроса.

Вы можете:

- Добавлять/удалять заголовки
- Добавлять пользовательские поля в Value. При использовании переменных значение заголовка будет свое для каждого подписчика

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/c3bfdac500b4d29e02444fc29909a93a055c5f5fc84ab61cd940275284553a71.png)

**Тело**

В этом разделе описывается тело запроса. Код для раздела Тело нужно взять из настроек стороннего сервиса.

Тело должно быть описано в формате JSON.

При заполнении тела запроса можно использовать пользовательские поля.

В правой части "Предпросмотр" выполняется автоматическая валидация и форматирование введенного тела.

**ВАЖНО!** Данный раздел недоступен для запросов с типом GET

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/8e48da8c13980f258fe4f0a4852b33501845641b9c778a4d0e6aa1dfd44c0b16.png)

**Сопоставление ответов**

В этом разделе вы можете сохранить ответ сервера в пользовательские поля

Для этого нужно:

- Добавить правило сопоставления, нажав на кнопку «Добавить правило сопоставления»
- Указать JSON Path - путь в теле ответа, по которому можно получить конкретное значение ответа. Сайт JSON Path: [https://jsonpath.com/](https://jsonpath.com/)
- Указать пользовательское поле, в которое будет сохраняться полученное в ответе значение

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/0ab5b410cff8855010b40be8db90fa649517f2c6f4248e63fe8c1ce3dde1f497.png)

---

Если вы не нашли ответ на свой вопрос, то напишите нам в [техподдержку ВК](https://vk.com/im?sel=-218270967)

[**Зарегистрироваться в сервисе**](https://botman.pro/?utm_source=bz&utm_medium=footer&utm_campaign=vnesnii_zapros)