{ "componentChunkName": "component---src-templates-doc-page-js", "path": "/docs/ru/telephony/switch_to_operator/", "result": {"data":{"site":{"siteMetadata":{"title":"Gatsby-doc-engine"}},"markdownRemark":{"id":"24d22c0b-d69d-53e6-b9b5-2630a25dea58","excerpt":"Перевод на оператора Для перевода звонка на оператора используйте с типом . Синтаксис Параметры перевода на оператора для телефонного канала: Параметр Тип…","html":"

Перевод на оператора

\n
\n

Для перевода звонка на оператора используйте $response.replies с типом switch.

\n
\n

Синтаксис

\n
$response.replies\r\n     .push({\r\n        type: \"switch\",\r\n        phoneNumber: \"01234567\",                         // номер телефона для перевода\r\n        headers:{                                        // SIP заголовки\r\n             \"Remote-Party-ID\": remotePartyId ,\r\n             testheader:\"header\"\r\n             },\r\n        transferChannel : \"237-test-237-VDQ-28334674\",    // botId\r\n        continueCall: false,\r\n        continueRecording: false\r\n        });
\n
\n

Параметры перевода на оператора для телефонного канала:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ПараметрТипОписание
phoneNumberstringНомер телефона, на который будет переведен звонок.
headersоbjectПри переводе на оператора для телефонного канала можно установить SIP заголовки, которые будут передаваться в invite сообщении на указанный номер. Данная возможность, как правило, используется для передачи АОН информации клиента.
transferChannelstringУкажите в поле botId для перевода вызова через SIP-транк, который относится к данному каналу. При этом будут применены параметры подключенного SIP-транка.
continueCallbooleanПри true, абонент будет возвращен к диалогу с ботом после разговора со оператором, а также, если оператор недоступен.

По умолчанию false.
continueRecordingbooleanПри true, разговор продолжает записываться, в том числе с оператором и при повторном возвращении абонента в диалог с ботом.

Запись звонка будет доступна в логах диалогов.

По умолчанию false.
\n
\n

Подробнее о переводе на оператора

\n
\n

Статус перевода на оператора

\n

При помощи метода $dialer.getTransferStatus() вы можете отслеживать статус перевода абонента на оператора.

\n

Метод $dialer.getTransferStatus() возвращает объект с полями:

\n\n

Например:

\n
theme: /\r\n\r\n    state: Start\r\n        q!: *start\r\n        a: Start new call\r\n\r\n    state: SwitchStateContinue\r\n       q!: перевод на оператора\r\n       script:\r\n        $response.replies\r\n        .push({\r\n           \"type\":\"switch\",\r\n           \"phoneNumber\":\"12345\",\r\n           \"continueCall\":true,\r\n           \"continueRecording\":true\r\n            });\r\n\r\n    state: TransferEvent\r\n        event: transfer\r\n        script:\r\n            var status = $dialer.getTransferStatus();\r\n            log(status);
\n
\n

В лог будет добавлена запись формата:

\n
17:14:40.459 [main] INFO  js - {\"status\":\"SUCCESS\",\"hangup\":false,\"number\":\"12345\"}\r\n17:14:40.482 [main] INFO  js - {\"status\":\"FAIL\",\"hangup\":true,\"number\":\"12345\"}
\n
\n

Оператор недоступен

\n

При неуспешном переводе на оператора, например, номер для перевода занят, абонент может быть возвращен в диалог с ботом. Для этого укажите в $response.replies параметр continueCall: true и отслеживайте event: transfer в сценарии.

\n

Например:

\n
theme: /\r\n\r\n    state: Start\r\n        q!: *start\r\n        a: Start new call\r\n\r\n    state: SwitchStateContinue\r\n       q!: перевод на оператора\r\n       script:\r\n        $response.replies\r\n        .push({\r\n           \"type\":\"switch\",\r\n           \"phoneNumber\":\"12345\",\r\n           \"continueCall\":true,\r\n           \"continueRecording\":true\r\n            });\r\n\r\n    state: TransferEvent\r\n        event: transfer\r\n        script:\r\n            if ($dialer.getTransferStatus().status === 'FAIL') {\r\n                $reactions.answer(\"Оператор сейчас не может ответить на ваш вопрос. Мы обязательно свяжемся с вами позже\")\r\n            } else {\r\n                $reactions.answer(\"Спасибо, что связались с нами. Оцениите, пожалуйста, качество обслуживания\")\r\n            }
\n

Обратите внимание, что абонент будет возвращен в стейт, где отслеживается событие event: transfer. Здесь вы можете добавить реплики или реакции бота.

\n
\n

Отображение номера телефона при переводе на оператора

\n

При переводе звонка на оператора можно настроить отображение фактического номера клиента, а не номера бота. Для этого необходимо создать телефонное подключение и настроить SIP-транк без регистрации и пароля:

\n\n

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

","frontmatter":{"title":"","description":null},"headings":[{"value":"Перевод на оператора"}]}},"pageContext":{"slug":"/docs/ru/telephony/switch_to_operator/","previous":{"fields":{"slug":"/docs/ru/telephony/telephone_channel/"},"frontmatter":{"title":"","description":null}},"next":{"fields":{"slug":"/docs/ru/telephony/statistics/"},"frontmatter":{"title":"","description":null}}}}, "staticQueryHashes": ["1209419333"]}