> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hubtalk.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Transfer

> Нода Transfer переводит звонок на оператора или другого агента.

# Нода Transfer

Нода **Transfer** переводит звонок на оператора или другого агента. Она поддерживает прямой холодный перевод и тёплый перевод, при котором агент сначала передаёт получателю краткую информацию о разговоре.

![Открытая панель ноды Transfer: вид перевода и назначение](https://mintcdn.com/hubtalk/a331JpdbHdrN3bAm/images/v4_node_transfer.png?fit=max\&auto=format\&n=a331JpdbHdrN3bAm\&q=85\&s=7d8e71df943f2792f0ff6dfed9e2d6da)

* **Название ноды** — определяет имя шага перевода в сценарии.
* **«Сразу (слепой перевод)» / «С предупреждением (со сводкой)»** — соединить напрямую или сначала дать получателю краткий брифинг. При тёплом переводе абонент ставится на удержание, агент дозванивается назначению, передаёт сводку и уходит. Сводка приватная — в ней может быть имя абонента, суммы и условия, — поэтому агент произносит её **только после того, как подтверждено, что абонент отключён от голоса агента**. Если подтвердить не удалось, оператора соединяют без брифинга, а событие перевода в [карточке звонка](https://docs.hubtalk.ai/ru/v4/platform/campaign-history/call-details) показывает **«брифинг оператору пропущен»**.
* **«Кто слышит сводку»** — при тёплом переводе: **«Только оператор»** (по умолчанию) или **«Оператор и абонент»**. Во втором режиме абонента соединяют с оператором сразу после ответа, и сводку слышат оба; перебить её нельзя, и она попадает в запись. Выбирайте его, когда сводку можно слышать абоненту, например «Соединяю Марию по поводу её записи на завтра». В этом режиме длительность звонка и запись включают время дозвона. Если сводку не удалось сгенерировать, она пропускается, и карточка звонка об этом говорит.
* **Назначение** — задаёт, куда перевести звонок: на номер телефона, агента или URI. Перевод **на другого агента** работает во всех каналах: телефонный звонок, звонок с сайта, голосовой тест в кабинете, чат и WhatsApp.
* **Переменные перевода** — позволяют использовать значения `{{transfer_status}}` и `{{transfer_success}}` для отслеживания результата.
* **Метод сигнализации** — выбирает **SIP INVITE** или **SIP REFER** для передачи звонка.
* **Длительность ожидания ответа** — задаёт, сколько секунд платформа ждёт ответа назначения. Допустимый диапазон — 1–120 секунд.
* **«Номер перевода»** — какой номер видит принимающий: **«Номер клиента (по умолчанию)»**, **«Номер транка»** или **«Свой номер»**. У своего номера есть отдельное поле — номер или переменная; значение обязано входить в пул исходящих номеров сабгруппы перевода, иначе перевод уйдёт по запасной связи. При методе **SIP REFER** номер уходит подсказкой для SBC в заголовках `P-Asserted-Identity` и `Referred-By` — применит ли её оператор связи к номеру на аппарате принимающего, решает сам оператор.
* **SIP-заголовки** — позволяют добавить пользовательские заголовки `X-*`. В значениях можно использовать переменные и секреты окружения.
* **Transfer-сабгруппа** — выбирает линию транка, по которой уйдёт нога или REFER: её пул номеров, лимиты, разрешённые направления и форму REFER. «По умолчанию» означает прежнее поведение — сабгруппа звонка, иначе дефолт транка. Если выбранный пятизначный префикс не заведён на транке звонка, набор идёт через сабгруппу по умолчанию, а причина видна в Истории. Сами сабгруппы заводятся в [Телефонии](https://docs.hubtalk.ai/ru/v4/platform/telephony.md).
* **Фраза перед переводом** — тумблер **«Говорить фразу перед переводом»**: узел сам произносит «Соединяю вас с оператором…», отдельный узел разговора перед ним не нужен. Текст либо фиксированный, с подстановкой переменных, либо генерируется по вашей инструкции. Перевод стартует только после того, как фраза прозвучала целиком; вне графика операторов она не звучит. Галочка **«Не перебивать эту фразу»** относится ко всем репликам узла, а не только к этой.
* **График работы операторов** — тумблер **«Переводить только в рабочее время»** ограничивает перевод расписанием. Укажите **часовой пояс операторов** (подставляется зона организации; измените, если операторы работают в другой) и хотя бы одну строку с днями и часами: включённый график без строк не публикуется, а интервал через полночь задаётся двумя строками. Галочка **«Не переводить за 5 минут до закрытия»** не даёт отдать абонента, которого уже никто не возьмёт.
* **Что сказать вне графика** — фиксированный текст или инструкция для сгенерированной реплики. Пустое поле означает, что нода промолчит. В реплике доступны `{{transfer_next_open_time}}` и `{{transfer_next_open_date}}`.
* **Запись разговора** — галочка **«Продолжать запись после перевода»**, по умолчанию выключена. По умолчанию запись заканчивается там же, где длительность звонка, — на конце разговора с агентом: при тёплом переводе это удержание, при слепом — начало дозвона. Включите её, чтобы записать и разговор абонента с оператором: тогда запись будет длиннее звонка — учитывайте требования к записи разговоров. После неуспешного перевода продолжение разговора агента с абонентом тоже записывается и дописывается в тот же файл — см. [запись разговора](https://docs.hubtalk.ai/ru/v4/platform/campaign-history/call-details/recording.md) в деталях звонка.
* **Переменные ошибки** — после неудачного перевода `{{transfer_status}}` хранит причину (`no_answer`, `busy`, `rejected`, `transfer_ring_timeout` или `error`), а `{{transfer_success}}` равна `false`. Вместе с ними заполняется `{{transfer_failure_reason}}` — технический код причины, по которой перевод не удался. Их можно использовать в условиях резервных переходов.
* **Переходы** — задают резервные направления после неудачного перевода. После успешного перевода они не выполняются, поскольку успешный перевод завершает работу AI.
* **Global node** — делает перевод доступным для перехода из любой точки сценария.
* **Удалить ноду** — удаляет шаг перевода из сценария агента.

Вне графика перевод **не начинается вовсе**: `{{transfer_status}}` принимает значение `out_of_hours`, `{{transfer_success}}` равна `false`, ближайшее открытие попадает в `{{transfer_next_open_time}}`, `{{transfer_next_open_date}}`, `{{transfer_next_open_iso}}` и `{{transfer_next_open_epoch}}`, реплика произносится, если вы её задали, и нода уходит по своим переходам. Дайте такой ноде переход Default или условие `{{transfer_status}} == "out_of_hours"` — иначе валидатор предупредит, что звонку вне окна некуда идти.

В истории звонка событие перевода помечено как пропущенное с причиной **«Вне графика работы»** — то есть закрытое окно не попадает в число переводов, которые не доехали до оператора.

> [!NOTE]
>
> **Перевод на другого агента меняет и голос.** Если адресат перевода — агент, продолжение разговора идёт на настройках **целевого** агента: его голос и модель синтеза, его языки, его напоминания о тишине и слова поддакивания, его ограничения управления звонком. Таймеры тишины отсчитываются заново, от первой реплики нового агента.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.