> ## 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. # Телефония > Руководство по настройке телефонии в HubTalk AI v4. # Телефония Телефония подключает вашего голосового агента HubTalk AI v4 к реальным телефонным звонкам. Здесь описано, как привязать номера, проверить звонки и убедиться, что маршрутизация работает правильно. ## Почему телефония важна Агент может работать только если к нему подключён номер и настроен маршрут звонка. Настройка телефонии позволяет: * принимать входящие звонки * совершать исходящие звонки * направлять переводы на оператора * управлять голосовым каналом агента ## Что нужно настроить Сделайте эти шаги: 1. Привяжите номер или SIP-транк к агенту. 2. Определите, какой номер направляется к какому агенту. 3. Настройте правила перевода и поведение при ошибках. 4. Протестируйте входящие и исходящие звонки. Диалог правки SIP-транка: входящий и исходящий маршруты, подключение к SBC, caller ID Везде, где агент выбирается из списка — карточка входящей сабгруппы, диалог тестового звонка, форма кампании, правило правки фраз, — поле **со строкой поиска**: наберите несколько букв имени вместо того, чтобы листать. Это ровно те списки, которые растут вместе с организацией: в крупной нужного агента глазами не найти. ## С какого номера уходит звонок В исходящей сабгруппе обычно не один номер. Настройка **Выбор исходящего номера** в карточке сабгруппы определяет, какой из них возьмёт звонок, если номер не задан явно: * **Случайный из списка** — номер выбирается случайно для каждого звонка. Это значение по умолчанию. * **По кругу по списку** — номера используются по очереди, и пул расходуется равномерно. Политика действует везде, где звонок начинается без явного номера: кабинет, [Web API](/ru/v4/web-api) без указания номера, каждая попытка кампании. В формах звонка и кампании для этого есть вариант **По политике сабгруппы**, который возвращает выбор этой настройке. Кандидаты — пул сабгруппы **в пересечении с пулом, который разрешает маршрут**. Если пересечение пустое, звонок отклоняется понятной ошибкой, а не уходит с чужого номера. Выбранный номер закрепляется за звонком целиком: нога перевода уходит с того же номера, с которого набирали. **Проверьте, на чём построена ваша аналитика трафика.** Исходящие звонки уходят с разных номеров пула — политика выбирает номер на каждый звонок отдельно. Отчёт, который считает, что все исходящие идут с одного и того же номера, даст неверную картину. ## Входящий номер принадлежит одному агенту **Входящий номер привязывается только один раз.** Завести его дважды нельзя — ни на другом транке, ни повторно на этом: платформа отклоняет запись на всех путях, а не только в форме. ## Линия для переводов У транка есть третье направление рядом с входящим и исходящим — **перевод**. В настройках транка это блок **«Transfer-сабгруппы»**: карточка со своим набором номеров, лимитами и разрешёнными направлениями, ровно как у исходящей. По ней уходит звонок оператору, и именно её выбирают в узле перевода сценария — см. [Узел Transfer](/ru/v4/platform/agents/nodes). Что стоит знать: * **Префикс сабгруппы перевода — пять цифр**, у исходящей — четыре. Префикс уникален **среди сабгрупп одной организации на одном транке**: за префиксом стоит ровно одна ваша линия, поэтому два одинаковых означали бы две линии на одном правиле. * Префиксы должны быть заведены **на стороне телефонии раньше**, чем их выберут в сценарии. Иначе перевод не дойдёт до оператора. * **Форма адреса перевода** задаётся в карточке сабгруппы перевода; в карточках исходящих сабгрупп этого поля нет. Значение, сохранённое в исходящей сабгруппе, продолжает работать, пока вы не заведёте сабгруппу перевода. **Уже сохранённые префиксы не перепроверяются.** Проверка формата и уникальности применяется только к **новому или изменённому** значению: сабгруппа с нестандартным префиксом или с дублем не мешает сохранить транк, и платформа не переименовывает и не архивирует её за вас. ## Как проверить подключение Проведите несколько тестовых звонков, чтобы убедиться, что: * звонок доходит до нужного агента * звук чистый и стабилен * агент отвечает быстро * переводы идут по нужному направлению Панель тестового исходящего звонка: агент, caller ID и номер назначения ## Что проверить в первую очередь * корректную привязку номера * активность SIP-транка или привязки номера * правила перевода и контакты операторов * запись звонка и логирование, если требуется ## Если что-то не работает Если звонок не проходит, сначала проверьте привязку номера и настройки телефонии. Для помощи обращайтесь к команде телефонии или в поддержку HubTalk AI.