# Действия «Вызывать внешние API»
Аналогично с другими архитипами действия, действия «Вызвать внешние API» могут использоваться в процессах Случая, и они используются когда Вам нужно автоматически обратиться к другой системе, передать ей данные и потенциально получить от внешней системы обновленные настраиваемые данные обратно в Enate.
Вы можете найти информацию о том, как настроить действия «Вызвать внешние API» в соответствующей секции в Конструкторе.
Иногда возможны задержки, когда Вы ожидаете ответ от внешней системы. Когда это происходит, то есть когда действие «Вызвать внешние API» ожидает приход информации обратно от внешней системы, инфокарта Действия в Менеджере работ покажет состояние «Ожидание».
Когда внешняя система наконец отвечает Enate обновленными данными, результат будет помечен специальным маркером, сообщаюшим успешно прошла операция ИЛИ нет:
#### **Ответ с успешным завершением**
Если система отвечает с успешным завершением, то Действие автоматически переходит в состоянии «Закрыто», с методом урегулирования «Выполнено успешно».
#### **Ответ с неуспешным завершением**
Если система отвечает с неуспешным завершением, то Действие будет переведено в состоянии «Задачи», с причиной «Обновлено интеграцией». Внешние API могут также ответить с дополнительной информацией касательно причин неуспешного завершения. Эта информация появится в инфокарте Действия в секции «Причина отклонения».
Если действие не было завершено успешно, потому что оно не смогло завершиться в рамках установленного для него времени ([это конфигурируется в ](https://docs.enate.net/enate-help/builder/builder-2021.1/case-configuration/info-section/external-api-action-info-tab)Конструкторе), тогда оно перейдет в состояние «Задачи» с причиной «Превышение времени ожидания» и оно будет распределено в Очередь / пользовать-человек, на основании сконфигурированных правил распределения.
Такие неуспешные Действия будут теперь представлять из себя стандартные действия для работы вручную.
{% hint style="info" %}
Пожалуйста, обратите внимание, что владелец Случая НЕ будет оповещен в таких ситуациях.
{% endhint %}
### **Автоматические повторные попытки**
Если действие не сможет подключиться ко внешней системе, то оно будет автоматически пытаться подключиться снова столько раз, сколько сконфигурировано в Конструкторе в Вашей системе ([больше информации Вы можете найти тут](https://docs.enate.net/enate-help/builder/builder-2021.1/system-wide-settings#automated-failure-retry-pattern)). Также Вы увидите сообщение об ошибке, которое покажет Вам:
* когда произошла ошибка
* когда система автоматически попробует установиться связь снова
* сколько раз система автоматически пыталась установить связь, и
* сколько раз система будет пытаться автоматически установить связь снова.
Тут Вы также можете вручную попытаться снова установить связь, нажав на кноку «Попробовать еще раз» в сообщении ошибки.
{% hint style="info" %}
Пожалуйста, обратите внимание на то, что когда Вы совершаете попытку подключиться вручную, это будет засчитано за осуществленную попытку и потому будет включено в счетчик попыток, который показывает, сколько раз система пыталась установить связь снова.
{% endhint %}
Если действие не сможет установить связь после автоматических попыток (например, если в настройках количество попыток установлено до 5 раз, и система не сможет установить связь за последующие 5 автоматических попыток), оно перейдет в состояние «Закрыто» с оповещением «Невозможно завершить».
{% hint style="info" %}
В этих обстоятельствах, когда Действие не может установить связь с внешней системой, оно будет переведено к Владельцу Случая, с пометкой в секции Действия на экране Случая, что это Действие «Закрыто – Выполнено неуспешно».
{% endhint %}
Когда Действие получит необходимую информацию, оно будет завершено автоматически.
#### **Отладка настроек повторных попыток в Конструкторе во время / после того, как повторные попытки начаты**
Если настройки автоматических попыток в Конструкторе были изменены *после* того, как система автоматически пыталась установить связь с внешней системой повторно, то произойдет следующее.
Если, например, настройки попыток были изначально установлены на «5» и система автоматически попыталась подключить 5 раз, но неудачно, действие перейдет в состояние «Закрыто» с сообщением об ошибке, которое покажет количество предпринятых попыток 5/5.
Если настройки попыток будут изменены на большее количество попыток, чем 5, например, на 7, то сообщение об ошибке покажет счетчик попыток 5/7, но система НЕ БУДЕТ автоматически пытаться установить связь в 6й и 7й раз, так как действие будет уже закрыто. Однако, если действие не было перемещено в состояние «закрыто», поскольку еще не было совершено максимальное количество автоматических попыток (например, было совершено только 4 из 5 попыток установить связь), тогда увеличение попыток до 7 в настройках будет означать, что действие будет автоматически пытаться установить связь повторно пока счетчик попыток не достигнет 7 попыток.
И наоборот, если Вы уменьшите количество повторных попыток в настройках после того, как попытки начаты, например, Вы сейчас находитесь на попытке 4 из 10, но затем Вы уменьшаете максимальное количество попыток до 4, система по-прежнему будет показывать 4 из 10, но по факту уже попытки будут закрыты.
---
# 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.enate.net/enate-help/ru/obrabotka-deistviya/deistviya-vyzyvat-vneshnie-api.md?ask=
```
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.