ThunderPhone v3 уже доступен.Самостоятельный запуск — от 2 ¢/мин.Читать анонс

Using the dashboard

Перевод звонков

Сохраните номера, на которые агент может переводить звонки, затем перенаправляйте звонящих с холодным переводом или оставайтесь на линии и представляйте их при тёплом переводе.

Агент переводит звонки только на свои номера для перевода: список имён и номеров телефонов, который вы сохраняете в агенте. В промпте каждый номер указан по имени, а также задано, когда переводить звонок и должен ли перевод быть холодным или тёплым. Агент видит только имена, но не номера. Агент без номеров для перевода не может переводить звонки.

РежимЧто происходитИспользуйте, когда
ХолодныйЗвонящий направляется напрямую получателю. Агент не представляет звонящего и не подтверждает, что кто-то ответит.Быстрая маршрутизация важнее представления или номер звонка не может совершать исходящие вызовы.
ТёплыйКак только кто-то отвечает, звонящий подключается, агент представляет звонящего в разговоре и отключается. Вместо этого можно настроить агента сначала спросить или сделать шёпот.Получатель должен знать, кто звонит и почему, или звонящий должен вернуться к агенту, если никто не отвечает.

Если агент не указывает режим, перевод выполняется как холодный.

Настройка переводов

В панели управления:

  1. Откройте Голосовые агенты, выберите агента и откройте Конфигурация.
  2. В разделе Номера для перевода добавьте для каждого назначения имя и номер телефона, например Выставление счетов и +1 415 555 2671. У агента может быть до 50 номеров для перевода.
  3. В промпте укажите каждое назначение по имени, а также когда его использовать и применять ли режим cold или warm, например «переводите вопросы по выставлению счетов в Выставление счетов». Создавать пользовательский инструмент не нужно.
  4. Для тёплых переводов выберите, что происходит Перед соединением и, при необходимости, что должно быть указано в Представлении. См. Перед соединением.
  5. При необходимости задайте Дополнительно → Длительность звонка от 5 до 120 секунд.
  6. Выберите Развернуть.

Через API выполните PATCH /v1/agents/{agent_id}, чтобы подготовить transfer_destinations, промпт и необязательные warm_transfer_style, warm_transfer_briefing и ring_duration_seconds, затем выполните POST /v1/agents/{agent_id}/deploy:

{
  "transfer_destinations": [
    {"name": "Billing", "number": "+14155552671"},
    {"name": "Front desk", "number": "+19375551234"}
  ],
  "warm_transfer_style": "introduce",
  "warm_transfer_briefing": "The caller's name and what they need."
}

Запись заменяет весь список, а [] удаляет все номера для перевода. Правила полей и ошибки валидации см. в API агентов.

Имена и номера

  • Имя: от 1 до 60 символов, уникальное для агента без учёта регистра. Это слово используется в подсказке.
  • Номер: полный номер телефона. Номера без кода страны интерпретируются как номера США, а каждый номер хранится в формате E.164. Добавочные номера и вымышленный диапазон от 555-0100 до 555-0199 отклоняются.
  • Переменный номер: вместо номера телефона — одна переменная звонка, например {{rep_phone}}. Она заполняется из переменных звонка при его начале. Если переменная отсутствует или не содержит допустимый номер для этого звонка, перевод на это имя отклоняется.
  • SIP-адрес: адрес sip: или sips: вместо номера телефона, например очередь контакт-центра. См. Перевод на SIP-адрес.
  • Возврат: без номера. Агент возвращает звонок в контакт-центр, из которого он поступил. См. Вернуть звонок в ваш контакт-центр.

Только тёплый

Установите warm_only: true для номера телефона или записи переменной, чтобы каждый перевод туда был тёплым, даже если агент запрашивает холодный перевод:

{"name": "Matthew", "number": "+14155552671", "warm_only": true, "answerer": "Matthew Ray"}
  • Если человек или линия там не принимает этот тёплый перевод (нет ответа, занято, голосовая почта, сброс вызова или при Сначала спросить отказ либо человека нет на месте), агент не пытается снова перевести на эту запись во время звонка — ни тёплым, ни холодным способом. Он сообщает об этом звонящему и предлагает другой вариант, например оставить сообщение.
  • Если вместо этого тёплый вызов не удаётся на стороне ThunderPhone или оператора связи (его не удаётся совершить либо соединение прерывается до того, как кто-либо примет решение), агент может снова перевести звонящего туда, и этот перевод будет холодным.
  • Для тёплых переводов нужен номер, с которого можно совершать исходящие вызовы (см. Требования, ограничения и тестирование). При звонке, с которого нельзя совершить исходящий вызов, например с номера без одобренных исходящих вызовов, из веб- или микрофонной сессии либо у полнодуплексного агента, перевод на запись только для тёплых переводов выполняется как холодный, а не отклоняется. То же относится к номеру, который недоступен для линии тёплого вызова, но доступен для оператора самого звонка: перевод будет холодным. Номер, недоступный ни для одного из них, отклоняется, как и для любой другой записи.
  • Когда агент переводит звонящего, который перестал отвечать (финальное действие после тишины, silence_final_action: "transfer"), перевод всегда холодный, включая запись только для тёплых переводов.
  • Это нельзя установить для SIP-адреса или возврата, которые всегда передают звонок без предварительного вызова кого-либо.

Установите это с помощью Agents API или попросите Zeus. Панель управления пока не показывает этот параметр и сохраняет его при сохранении других изменений, если только вы не измените имя или номер этой записи.

Перевод на SIP-адрес

Номером перевода может быть SIP-адрес, например sip:support@pbx.example.com, чтобы агент мог перенаправить звонящих обратно в ваш контакт-центр или PBX. Перевод выполняется как холодный: ThunderPhone отправляет SIP REFER с этим адресом, после чего ваша система принимает звонок.

SIP-адрес работает только в том случае, если звонок поступил из вашей собственной SIP-системы:

При любых других звонках, включая звонки на номера ThunderPhone и номера, подключённые через Twilio или Telnyx, перевод на SIP-адрес отклоняется: агенту сообщается, что он не может выполнить перевод туда, и он продолжает разговор со звонящим. Тёплый перевод на SIP-адрес выполняется как холодный перевод.

Адрес должен быть указан полностью; он не может быть {{variable}}. Его длина не должна превышать 255 символов, он должен содержать хост и не может включать пробелы, кавычки, запятые или угловые скобки. Параметры, такие как ;transport=tls, допустимы. Единственный заголовок, который может содержать сам адрес, — ?User-to-User= для платформ, считывающих информацию между пользователями из адреса перевода: sip:queue@sbc.example.com?User-to-User=00a1b2;encoding=hex.

SIP-заголовки при переводе

Для любого номера перевода также можно указать headers, которые отправляются вместе с REFER при холодном переводе, например идентификатор аккаунта звонящего, чтобы ваш контакт-центр мог найти его:

{
  "name": "Support queue",
  "number": "sip:support@pbx.example.com",
  "headers": {
    "X-Account-Id": "{{account_id}}",
    "User-to-User": "{{uui}}"
  }
}
  • Не более 10 заголовков. Имена начинаются с X- или равны User-to-User. Имена с X-TP- зарезервированы для ThunderPhone.
  • Значения имеют длину не более 256 байт и могут использовать переменные звонка, которые подставляются при начале звонка. Отсутствующая переменная остаётся пустой, переводы строк удаляются, а заголовок со значением после подстановки длиннее 256 байт не отправляется.
  • Заголовки добавляются только к REFER при холодном переводе и доходят до вашей системы, только если оператор связи передаёт их дальше. Они не отправляются при новом звонке во время тёплого перевода или когда ThunderPhone вынужден самостоятельно соединять отклонённый перевод.

Заголовки в адресе перевода

Некоторые контакт-центры считывают контекст только из адреса перевода (Refer-To в REFER), а не из отдельных заголовков. Twilio, Genesys Cloud и Talkdesk работают именно так, и большинство из них ожидают User-to-User в шестнадцатеричном формате. Задайте два параметра в записи SIP-адреса:

{
  "name": "Escalation",
  "number": "sip:escalation@talkdesk.example.com",
  "headers": {
    "User-to-User": "autopilot_result={{handoff_summary}}",
    "X-Call-ID": "{{handoff_id}}"
  },
  "headers_in_uri": true,
  "uui_encoding": "hex"
}
  • headers_in_uri: true отправляет заголовки внутри адреса, а не в REFER: sip:escalation@talkdesk.example.com?User-to-User=…&X-Call-ID=…. Значения экранируются для SIP-адреса, поэтому ; становится %3B, а пробел — %20.
  • Длина всего адреса ограничивается 254 символами, что укладывается в лимит Twilio в 256 символов с угловыми скобками. Сначала добавляется User-to-User, затем остальные заголовки в алфавитном порядке. Длинный User-to-User обрезается до допустимой длины, а не исключается, поэтому разместите нужную вашей платформе часть в его начале. Другой заголовок, который не помещается рядом с ним, исключается целиком, а перевод всё равно выполняется.
  • uui_encoding: "hex" отправляет User-to-User в шестнадцатеричном формате с ;encoding=hex. Указывайте значение в виде обычного текста: оно кодируется при переводе, после подстановки переменных и заполнителей. Текст, из-за которого закодированное значение превысило бы 256 байт, сначала обрезается. Это также работает при возврате.
  • headers_in_uri нельзя использовать вместе с ?User-to-User=, указанным непосредственно в адресе; вместо этого перенесите это значение в headers.

Добавляйте SIP-адреса и заголовки через API агентов (transfer_destinations) или во встроенной конфигурации звонка.

Верните звонок в контакт-центр

Если звонок поступил из вашего контакт-центра, агент может вернуть его обратно вместо перевода: он прощается, ThunderPhone завершает вызов, а отправляемый SIP BYE содержит данные маршрутизации, которые ваша платформа считывает, чтобы определить, куда звонящий будет направлен дальше. Добавьте номер для перевода с "action": "return" и без номера:

{
  "name": "Contact center",
  "action": "return",
  "headers": {
    "X-RouteType": "queue",
    "X-RouteValue": "{{queue_id}}",
    "User-to-User": "{{uui}}"
  }
}
  • В подсказке оно упоминается как любой другой номер для перевода, например: «когда звонящий просит соединить с человеком, переведи в контакт-центр».
  • BYE может содержать необязательные заголовки X-RouteType, X-RouteValue, X-RouteReason, X-CustomMetaData (четыре заголовка, которые считывает Five9) и User-to-User. Значения соответствуют правилам для SIP-заголовков при переводе: не более 256 байт, допускаются переменные вызова, переносы строк удаляются. BYE также содержит X-TP-Handoff-Id (см. Передача контекста в ваш контакт-центр). Возврат без заголовков просто завершает вызов, а ваша платформа обрабатывает его так же, как после любого другого завершения вызова.
  • Это работает для тех же вызовов, что и перевод на SIP-адрес: вызовов на SIP-адрес и вызовов на номер с ручным SIP-подключением. Для других вызовов этот вариант недоступен голосовому агенту, а Browser Talk и симуляции его отклоняют. Тёплый перевод на него выполняется как обычный возврат.
  • Ничего не набирается и REFER не отправляется. Вызов завершается с причиной завершения returned_to_platform.
  • Заголовки передаются в настройках вашего SIP-транка. Для SIP-адресов и ручных SIP-подключений, настроенных до появления этой возможности, требуется однократное обновление от ThunderPhone; обратитесь в поддержку, прежде чем использовать заголовки.

Добавьте возврат через Agents API (transfer_destinations) или во встроенной конфигурации вызова. Панель управления сохраняет добавленный вами возврат и его заголовки при редактировании других номеров для перевода.

Передавайте контекст в свой контакт-центр

При звонке, который может попасть в ваш контакт-центр (при переводе на SIP-адрес или возврате), агент может сообщить, что нужно звонящему, чтобы человек или сценарий, принимающий звонок, не начинал с нуля. Используйте три заполнителя в headers этой записи:

ЗаполнительЧто содержит
{{handoff_summary}}Что нужно звонящему и что агент уже сделал, записанное агентом при переводе. Не более 300 символов.
{{handoff_intent}}Короткая метка, которую выбирает агент, например billing_dispute. Не более 60 символов.
{{handoff_id}}Идентификатор этого перевода для поиска ниже.
{
  "name": "Support queue",
  "number": "sip:support@pbx.example.com",
  "headers": {
    "X-Summary": "{{handoff_summary}}",
    "X-Intent": "{{handoff_intent|general}}",
    "X-Handoff-Id": "{{handoff_id}}"
  }
}
  • Они заполняются в момент перевода, а не в начале звонка. Значение, которое агент не указал, остаётся пустым или принимает заданное вами значение |default.
  • Переносы строк удаляются, а заголовок, значение которого после подстановки превышает 256 байт, обрезается до 256 байт. Перевод выполняется в любом случае.
  • При возврате идентификатор всегда отправляется как X-TP-Handoff-Id в BYE, независимо от заголовков.
  • В записи с номером телефона или при звонке, который не может попасть в ваш контакт-центр, это обычные переменные звонка: они пусты, если у звонка нет переменных с такими именами. Другие звонки никогда не получают дополнительные поля, поэтому их агенты работают как раньше.

Чтобы получить полный контекст, вызовите GET /v1/calls/handoff, указав API-ключ вашей организации и либо идентификатор, либо собственный идентификатор звонка вашей платформы (external_call_id из заголовка call-id, который она отправила вместе со звонком). В ответе возвращаются идентификатор и статус звонка, сводка и намерение, SIP-заголовки и переменные, с которыми начался звонок, а после завершения звонка — его сводка и извлечённые данные.

Какие номера доступны для звонка

Доступность номера для перевода зависит от линии, по которой он выполняется. Перевод по линии ThunderPhone может быть выполнен только на номера США, кроме номеров с повышенной стоимостью и других номеров специальных служб. Перевод по вашему оператору может быть выполнен на любой сохранённый номер.

ПереводВыполняется через
Холодный перевод входящего звонкаОператора, через которого поступил звонок: линию ThunderPhone для номера ThunderPhone или вашего оператора для номера вашего оператора.
Холодный перевод исходящего звонкаЛинию, по которой был выполнен звонок.
Тёплый перевод (новое соединение с адресатом)Линию, по которой набирается новое соединение.

Номер вашего оператора выполняет исходящие звонки и новые соединения при тёплом переводе только через исходящий транк своего подключения: ручные SIP-подключения с исходящим транком, подключения Twilio с настроенными исходящими звонками и подключения Telnyx. Без этого транка номер вообще не может выполнять исходящие звонки, поэтому поддерживает только холодный перевод. Такие звонки никогда не переключаются на линию ThunderPhone.

Если у вашей организации нет номеров вашего оператора, сохранение номера, недоступного для линии ThunderPhone, завершается ошибкой. После подключения вашего оператора такие номера сохраняются и помечаются как работающие только для переводов через вашего оператора (platform_ok: false в API). Один агент может отвечать на обоих типах номеров, поэтому проверка выполняется для каждого звонка.

Перед подключением

Каждый агент выбирает, что происходит, когда человек у адресата отвечает при тёплом переводе. Настройка применяется ко всем тёплым переводам, которые выполняет агент.

НастройкаЗначение APIЧто происходитОжидание звонящего
Представить на линии (по умолчанию)introduceЗвонящий подключается, как только адресат отвечает, и слышит его приветствие. Когда ответивший заканчивает говорить, агент представляет звонящего одним или двумя предложениями, которые слышат оба, затем отключается. Никому не задаются вопросы.Только гудки.
Сначала спроситьask_firstАгент конфиденциально вводит в курс дела ответившего и спрашивает, может ли он принять звонок. Он может задавать вопросы, принять или отклонить звонок. Если он принимает звонок, подключается звонящий, агент представляет звонящего на линии и отключается.Гудки и конфиденциальный разговор, часто 15 секунд или больше.
ШёпотwhisperАгент конфиденциально сообщает ответившему одним коротким предложением, кто звонит и почему. Вопросы не задаются. Затем подключается звонящий, а агент отключается, ничего не говоря на линии.Гудки и одно конфиденциальное предложение.

Используйте Представить на линии, если только ответивший не должен иметь возможность отклонять звонки или узнать о звонящем до его подключения к линии. Сначала спросить позволяет отклонить звонок, но дольше удерживает звонящего на линии, а голосовая почта, молчание или отказ возвращают звонящего к агенту. Шёпот конфиденциально даёт контекст без вопросов; голосовая почта возвращает звонящего к агенту.

Представление

Настройка Представление определяет, что агент сообщает человеку, который отвечает на звонок, о звонящем. При Представить на линии это представление, которое оба слышат после соединения. По умолчанию оно очень короткое: кто звонит и почему, например: «Здравствуйте, у меня на линии Алекс по поводу заказа. Алекс, говорите». При Сначала спросить это одно конфиденциальное предложение перед соединением со звонящим, в конце которого говорится, может ли человек принять звонок; представление после согласия строится по тому же принципу. При Шёпот это одно конфиденциальное предложение перед соединением со звонящим, например: «Звонит Алекс по поводу задержанного заказа, сейчас соединяю». Это утверждение, а не вопрос.

Чтобы изменить текст, добавьте агенту инструкцию Представление (warm_transfer_briefing, до 300 символов), например: «Имя звонящего, номер его аккаунта и что ему нужно». Агент следует ей при составлении каждого представления или сообщения. Оставляйте только несколько важных фактов: представление или предложение Шёпот длиннее примерно 40 слов либо сообщение Сначала спросить длиннее примерно 25 слов заменяется короткой стандартной фразой. Оставьте поле пустым, чтобы использовать значение по умолчанию.

Что происходит при тёплом переводе

При Представить на линии (по умолчанию):

  1. Агент сообщает звонящему, что начинает перевод. Запись вызова прекращается, и ThunderPhone сразу начинает звонить по номеру назначения с номера, обслуживающего вызов, пока агент ещё говорит.
  2. Пока номер назначения звонит, звонящий недолго ждёт в тишине. В этом режиме музыка ожидания не используется.
  3. Как только на номер назначения отвечают, звонящий уже находится на линии, поэтому он слышит приветствие с первого слова.
  4. Когда ответивший закончил говорить и ждёт ответа, агент представляет звонящего в одном или двух предложениях, которые слышат оба, например: «Здравствуйте, у меня на линии Алекс по поводу заказа. Алекс, вам слово». Агент определяет это по сказанному, а не по паузе: уведомление о записи или «пожалуйста, подождите» не означает, что человек закончил говорить, а «Чем я могу помочь?» — означает. Если человек ничего не говорит, агент начинает примерно через 3 секунды. Если он начинает говорить во время представления, агент останавливается, даёт ему закончить и повторяет представление. Примерно через 15 секунд, например при длинном телефонном меню, агент всё равно представляет звонящего. Если представление отсутствует или слишком длинное, оно заменяется короткой стандартной фразой на языке вызова.
  5. Агент отключается автоматически; больше ничего не говорится.

Соединение устанавливается с тем, кто ответил. Если это приветствие голосовой почты, агент ничего не говорит и отключается, чтобы звонящий мог оставить сообщение. Если номер назначения не отвечает, занят, не удаётся совершить вызов или ответивший отключается до окончания представления, ThunderPhone завершает этот вызов, и звонящий возвращается к агенту. Агент получает результат и продолжает исходный разговор. Он может принять сообщение, предложить другой вариант или выполнить холодный перевод, если звонящий всё ещё этого хочет.

Сначала спросить

  1. Агент сообщает звонящему, что начинает перевод звонка, затем звонящий слышит музыку ожидания, пока вызываемый номер звонит.
  2. Когда вызываемый номер отвечает, агент сначала позволяет ответившему закончить приветствие, по тем же правилам, что описаны выше. Если у агента включено объявление о согласии, ответивший слышит его первым. Затем агент сообщает представление и спрашивает, может ли человек принять звонок. Звонящий, находящийся на удержании, этого не слышит.
  3. Человек может задавать вопросы, на которые агент отвечает на основе разговора к этому моменту. Если он соглашается, звонящего соединяют, агент представляет звонящего одним или двумя предложениями, которые слышат оба, и отключается.
  4. Если человек отказывается, не отвечает или звонок попадает на голосовую почту, ThunderPhone завершает этот звонок и снимает звонящего с удержания. Агент получает результат, включая любое сообщение, которое человек попросил передать, и продолжает разговор со звонящим.

В этом режиме перевод не останавливает запись звонка. Если агент записывает звонки, записываются и конфиденциальный разговор с ответившим, и соединённый звонок. Если запись звонков отключена для агента, не записывается ни один из них.

Подтвердите, кто отвечает

С Сначала спросить запись может указать человека, для которого предназначен перевод, с помощью answerer (до 60 символов), чтобы при ответе с общей линии или коллеги никто не услышал ничего о звонящем. Затем агент:

  1. Начинает только с «Здравствуйте, это Мэттью Рэй?», ничего не говоря о звонящем.
  2. После подтверждения сообщает вводную информацию и спрашивает, могут ли принять звонок, как описано выше.
  3. Если отвечает другой человек, всё равно ничего не говорит о звонящем и спрашивает, доступен ли нужный человек. Если телефон передают, агент снова спрашивает нового человека. Если нет, он вежливо завершает вызов, а звонящий возвращается к агенту, которому сообщается, что человек был недоступен.

Голосовая почта обрабатывается, как описано выше. Вопрос для подтверждения личности пока задаётся на английском. answerer игнорируется при Представиться на линии и Шёпот, которые ничего не спрашивают перед соединением. Установите его с помощью API или попросите Zeus, как для Только тёплый.

Шёпот

  1. Агент сообщает звонящему, что начинает перевод звонка, затем звонящий слышит музыку ожидания, пока вызываемый номер звонит.
  2. Когда вызываемый номер отвечает, агент ждёт, пока ответивший закончит приветствие. Если у агента включено объявление о согласии, ответивший слышит его первым. Затем агент одним коротким предложением сообщает, кто звонит и почему. Он не спрашивает, может ли человек принять звонок. Звонящий, находящийся на удержании, этого не слышит.
  3. Звонящего соединяют, и агент отключается. На линии ничего не говорится.
  4. Если звонок попадает на голосовую почту, агент завершает его и снимает звонящего с удержания. Если вызываемый номер не отвечает, занят или звонок невозможно совершить, звонящий также возвращается к агенту. Агент получает результат и продолжает разговор со звонящим.

Запись работает так же, как при Сначала спросить: если агент записывает звонки, записываются и конфиденциальное предложение, и соединённый звонок.

Настройте агента для корректного перевода звонков

Добавьте правила маршрутизации в промпт агента и укажите каждое направление точно так, как оно отображается в разделе Номера для перевода. Не указывайте номера телефонов в промпте; агент переводит звонки по названию. Укажите режим перевода для каждого маршрута и предусмотрите для агента резервный вариант на случай неудачного тёплого перевода.

Transfer policy
 
Confirm the caller's name and reason for calling before any transfer.
 
| Caller needs | Destination | Transfer mode |
| --- | --- | --- |
| A new purchase or plan change | Sales | warm |
| Help with an existing order | Order support | warm |
| The main office | Front desk | cold |
 
For a warm transfer:
- Keep the introduction to one or two short sentences: who is calling and
  why.
- Do not plan to speak after the introduction because you will be dropped.
- If the target does not answer or is busy, tell the caller what happened,
  then offer to take a message or try another route. Do not cold-transfer
  unless the caller asks.

Агент передаёт эти поля при вызове встроенного действия:

ПолеКогда используетсяНазначение
destinationВсегдаНазвание одного из номеров перевода агента.
modeНеобязательноcold или warm; по умолчанию — cold.
screen_messageОбязательно для тёплого переводаПри Представлении на линии — представление, которое звонящий и ответивший человек услышат после соединения. При Сначала спросить — приватный брифинг, который ответивший человек услышит перед принятием решения. При Шёпоте — приватная фраза, которую ответивший человек услышит до соединения со звонящим. Звонящий не слышит ни одну из приватных реплик.
introductionНеобязательно для тёплого переводаПри Сначала спросить — представление, которое оба услышат после принятия вызова ответившим человеком. При Представлении на линии используется только если screen_message пусто. Не предлагается при Шёпоте, поскольку на линии ничего не произносится.

Вам не нужно определять или подключать пользовательский инструмент с именем transfer_call. Описание действия соответствует настройкам агента Перед соединением и Брифинг, поэтому повторять их в промпте не нужно.

Когда перевод отклонён

ThunderPhone проверяет каждый перевод перед его выполнением. Он отклоняет перевод, если имя не соответствует ни одному из номеров перевода агента, если переменный номер не имеет допустимого значения в этом звонке, если перевод по линии ThunderPhone приведёт к номеру за пределами США или к номеру с повышенной стоимостью, а также если назначение — SIP-адрес или возврат, а звонок поступил не из вашей собственной SIP-системы (см. Перевод на SIP-адрес).

Отклонённый перевод не завершает звонок. Агент не сообщает о переводе, получает причину отказа (включая список допустимых имён, если имя не совпало) и продолжает разговор со звонящим. Укажите в промпте, что делать вместо этого, например принять сообщение. Отказ отображается как ошибка инструмента в истории звонка.

Переводы с предварительным уведомлением

«Перевод с подсказкой» — распространённое в отрасли название тёплого перевода, при котором принимающая сторона слышит конфиденциальный контекст до соединения со звонящим, без вопроса, принимать ли звонок. Это настройка Подсказка в разделе Перед соединением.

Это отличается от POST /v1/calls/{id}/whisper. Этот endpoint позволяет сотруднику или владельцу отправлять конфиденциальные текстовые инструкции ИИ-агенту во время активного звонка. Он не звонит получателю перевода и не предоставляет ему информацию.

Требования, ограничения и тестирование

ВопросОтвет
До каких направлений может дойти перевод?На номере, предоставленном ThunderPhone, поддерживаются только номера США, включая бесплатные номера; Канада, другие страны с кодом +1 и номера с повышенной тарификацией не поддерживаются. ThunderPhone отклоняет любое другое направление до набора номера: звонящий остаётся на линии, а агент получает причину и продолжает разговор (см. Когда перевод отклонён). Чтобы переводить вызовы в другие страны, подключите собственного оператора связи и принимайте вызовы на номере, импортированном через него. В этом случае перевод выполняется через вашего оператора связи, поэтому он должен поддерживать перевод вызовов и разрешать звонки в эту страну. На SIP-транке Twilio включите Переводы вызовов и Включить переводы вызовов в ТфОП.
Какие номера поддерживают тёплый перевод?Номер, с которого можно совершать исходящие звонки: подтверждённый номер, импортированный через VoIP-подключение с исходящими звонками, или номер, предоставленный ThunderPhone, после одобрения запроса на исходящие звонки вашей организации. Другие номера ThunderPhone поддерживают только холодный перевод. Если тёплый режим недоступен, действие переключается на холодный перевод. Подключите VoIP-провайдера.
Какие типы вызовов это поддерживают?Холодный перевод доступен в обычных телефонных вызовах. В Browser Talk, виджетах, симуляциях и тестовых вызовах нельзя проверить тёплую передачу. Realtime для сохранённого агента не включает transfer_call; встроенный Realtime с call_events может запрашивать холодный перевод.
Как насчёт вызовов без сохранённого агента?Исходящий вызов или ответ call.incoming со встроенным config, а также встроенная сессия Realtime принимают тот же список transfer_destinations. При наличии списка вызов переводится только на указанные в нём имена. Без него у агента остаётся действие перевода, принимающее номер телефона, а вызовы на номера ThunderPhone по-прежнему могут направляться только на номера США.
Как это протестировать?Проверьте формулировки маршрутизации в Browser Talk или симуляции: вы увидите, какое имя выбирает агент, или причину отказа. Оба варианта всегда отклоняют перевод на SIP-адрес или возврат вызова, поскольку они не поступают из вашей SIP-системы; такой отказ не означает, что запись настроена неправильно. Затем проверьте полную передачу реальным телефонным звонком на номер агента. Для холодного перевода подходит любой номер ThunderPhone или импортированный номер; для тёплого перевода нужен номер ThunderPhone с одобренным запросом на исходящие звонки либо импортированный номер с поддержкой исходящих звонков.
Как долго звонит номер назначения?ring_duration_seconds принимает значения от 5 до 120 секунд. null использует 45 секунд для тёплого перевода и значение по умолчанию оператора связи для холодного перевода. Для обычных исходящих вызовов по умолчанию используется 60 секунд, и они никогда не звонят менее 14 секунд. Эта настройка не изменяет звонок при входящих вызовах.
Что, если мой оператор связи отклоняет холодный перевод?Обычно ваш оператор связи передаёт вызов номеру назначения. Некоторые подключения операторов связи отклоняют переводы, например транк Twilio без включённого перевода вызовов (SIP REFER). Если номер вызова поддерживает исходящие звонки, ThunderPhone самостоятельно соединяет вызов: он набирает номер назначения, звонящий слышит гудки до ответа, а агент отключается без представления. Запись прекращается при переводе. Если никто не отвечает или номер не поддерживает исходящие звонки, вызов завершается. Отклонённый перевод на SIP-адрес всегда завершает вызов. Администраторы вашей организации получают письмо по email при первом отклонении перевода подключением. Когда вы подключаете аккаунт Twilio в панели управления, Разрешить переводы вызовов (включено по умолчанию) включает переводы для его SIP-транка. Для уже существующего подключения Twilio используйте Включить переводы вызовов на странице VoIP-подключений. У других операторов связи эта настройка находится в их собственном портале.
Как долго может длиться соединение между людьми?До 4 часов после того, как агент соединит двух людей. При использовании Представить на линии соединение не записывается: запись прекращается при начале перевода. При использовании Сначала спросить и Шёпот оно записывается, если агент записывает вызовы.
Что происходит при ошибке?При тёплом переводе, если получатель не отвечает, занят или исходящее соединение завершается ошибкой, звонящий возвращается к агенту с результатом. В инструкции должен быть определён следующий шаг. При холодном переводе часть вызова агента уже завершена, поэтому неудачный холодный перевод завершает вызов.
Сколько это стоит?За инструмент перевода плата не взимается. Обычная тарификация вызова включает процесс тёплого перевода до отключения агента. После того как ИИ отключается при тёплом переводе, ThunderPhone сохраняет соединение между двумя людьми и тарифицирует это время по поминутному тарифу за соединение; см. Тарифы. При холодном переводе тарификация прекращается в момент передачи. Когда ThunderPhone самостоятельно соединяет отклонённый холодный перевод, время соединения тарифицируется по тому же тарифу за соединение. Для импортированных VoIP-номеров ваш оператор связи может продолжать тарифицировать часть перевода, пока два человека остаются соединёнными.

Вебхуки и причины завершения

Полезная нагрузка завершения записывает номер назначения в transfer_number и использует одну из следующих причин завершения:

end_reasonЗначение
ai_transferАгент инициировал холодный перевод звонка.
ai_warm_transferПолучатель ответил на тёплый перевод, стороны были соединены, и агент отключился.
returned_to_platformАгент вернул звонок в ваш контакт-центр. transfer_number не задан.

Тёплая попытка без ответа, при занятости или сбое не считается завершённым переводом. Звонящий возвращается к агенту, поэтому итоговая причина завершения отражает то, чем завершается исходный звонок.

При успешном тёплом переводе событие завершения и причина завершения ИИ-звонка записываются, когда ИИ отключается, сразу после соединения участников. При Представиться на линии запись охватывает звонок до перевода и на этом заканчивается (recording_stopped_at); разговор между двумя людьми не записывается и не расшифровывается. При Сначала спросить и Шёпот запись (если агент записывает звонки) продолжается до завершения соединённого звонка.

Устаревший вебхук завершения

Устаревший вебхук с одним URL-адресом может задержать холодный перевод на срок до пяти минут, возвращая {"transfer_ready": false} и позднее обновляя состояние готовности звонка к переводу. Доставки на конечные точки вебхуков и тёплые переводы не используют эту координацию.

Полную полезную нагрузку и устаревшее поведение см. в разделе Вебхуки завершения.

Устранение неполадок

Звонок обрывается, когда агент выполняет перевод

Проверьте страну назначения. Звонки на номерах ThunderPhone поддерживают переводы только на номера США. Оператор связи может отклонить перевод в другую страну, из-за чего звонящий будет отключён, при этом звонок всё равно завершится с ai_transfer. Чтобы звонить в другие страны, подключите собственного оператора связи и направляйте звонок через импортированный от него номер. Оператор связи должен поддерживать переводы звонков и разрешать звонки в эту страну. Для SIP-транка Twilio включите Переводы звонков и Включить переводы звонков в PSTN.

Агент выполняет холодный перевод вместо тёплого

Проверьте, что звонок использует номер, с которого можно совершать исходящие вызовы: подтверждённый импортированный VoIP-номер с работающей маршрутизацией исходящих вызовов или номер ThunderPhone с одобренными исходящими вызовами. Режим тёплого перевода удаляется из параметров инструмента для других номеров и для сеансов без телефона. Также явно укажите режим в таблице маршрутизации промпта. Чтобы одно направление всегда использовало тёплый перевод, включите для него Только тёплый перевод.

Целевой абонент не отвечает

Убедитесь, что ваш VoIP-транк может совершать исходящие звонки на нужный номер, а его правила аутентификации и маршрутизации актуальны. Проверьте номер, сохранённый в разделе Номера перевода. Увеличьте ring_duration_seconds, если 45 секунд недостаточно для перевода с сопровождением.

Целевой абонент попадает на голосовую почту

При Представлении на линии звонящий соединяется с тем, кто ответит, включая голосовую почту. Агент распознаёт приветствие, ничего не говорит в почтовый ящик и отключается, а звонящий может оставить сообщение. При Сначала спросить и Шёпоте агент завершает вызов на голосовую почту, и звонящий возвращается к агенту. Если вызовы на номер часто попадают на голосовую почту, укажите для него в промпте другой маршрут.

Холодный перевод ожидает перед подключением

Если вы используете устаревший вебхук с одним URL, проверьте, вернул ли он {"transfer_ready": false}. Пока ThunderPhone ожидает, звонящий слышит музыку удержания. Обновите статус готовности перевода звонка, когда номер назначения будет подготовлен.

Агент говорит, что не может выполнить перевод

Убедитесь, что у агента есть номера перевода и что в промпте используются те же имена. У агента без номеров перевода вообще нет действия перевода. Если перевод выполняется по линии ThunderPhone (см. На какие номера может звонить звонок), номер назначения должен быть номером США без повышенной стоимости. Для номера из переменной проверьте, что переменные звонка содержат для него допустимый номер телефона.

Сбой развёртывания с ошибкой номера перевода

При каждом развёртывании повторно проверяются сохранённые номера перевода. Номер не из США, сохранённый, когда у вашей организации был номер у собственного оператора связи, не пройдёт проверку, если у организации больше нет такого номера. Удалите номер или снова подключите собственного оператора связи.

Подсказки сотрудникам не запускают перевод

Подсказки во время звонка только направляют AI. Добавьте инструкции по переводу в промпт агента и позвольте ему вызвать transfer_call. См. Мониторинг звонков в реальном времени.