{ "componentChunkName": "component---src-templates-doc-page-js", "path": "/docs/ru/telephony/script_voice_bot/", "result": {"data":{"site":{"siteMetadata":{"title":"Gatsby-doc-engine"}},"markdownRemark":{"id":"819efa9b-f627-531b-999d-fe61b894a7c3","excerpt":"Сценарий бота для голосовой рассылки В голосовых рассылках используются синтез и распознавание речи.?> Синтез речи — процесс генерирования речи по печатному…","html":"

Сценарий бота для голосовой рассылки

\n
\n

В голосовых рассылках используются синтез и распознавание речи.

\n

Синтез речи — процесс генерирования речи по печатному тексту.

\n

Распознавание речи — процесс преобразования речи в текст.

\n

В связи с этим написание сценария бота имеет свои особенности. В этой статье рассмотрим:

\n\n
\n

Адаптация сценария для телефонного канала

\n
\n

Распознавание

\n

При адаптации сценария бота для телефонного канала следует отлавливать и обрабатывать событие speechNotRecognized. Событие возникает, если в течение 5 секунд запрос клиента невозможно распознать или на распознавание ничего не пришло.

\n

Например:

\n\n
    state: speechNotRecognized || noContext = true\n        event: speechNotRecognized\n        a: Повторите, пожалуйста, Вас плохо слышно.\n        go!: {{$session.lastState}}
\n
\n\n
    state: CatchAll\n        event!: speechNotRecognized\n        q!: *\n        random:\n            a: Не могли бы вы повторить?\n            a: Я не расслышала.\n            a: Повторите, пожалуйста.\n            a: Извините. я не смогла расслышать ваш ответ.
\n
\n
Автоответчик
\n

При попадании бота на автоответчик, расходуются минуты телефонии.

\n

Так как при попадании бота на автоответчик, расходуются минуты телефонии, предусматривайте это в сценарии. Например, бот просит клиента повторить реплику, если в ответ тишина или не удалось распознать фразу. После пяти попыток бот завершит звонок.

\n
    state: NoInput || noContext=true\n        event: speechNotRecognized\n        script:\n            $session.noInputCounter = $session.noInputCounter || 0;\n            $session.noInputCounter++;\n        \n        if: $session.noInputCounter >= 5\n            a: Кажется какие-то проблемы со связью. Перезвоню позднее.\n            script:\n                $dialer.hangUp('(Бот повесил трубку)');\n        else:\n            a: Вас плохо слышно, повторите, пожалуйста!
\n

Другие event для телефонного канала

\n
\n

Завершение вызова ботом

\n

Бот может сам завершать вызов с помощью метода $dialer.hangUp('(Бот повесил трубку)').

\n

Фраза Бот повесил трубку будет отображаться в не голосовом канале, который вы используете для отладки бота.

\n

Например:

\n
    state: HangUp\n        a: Всего доброго. До свидания.\n        script:\n            $dialer.hangUp('(Бот повесил трубку)');
\n

Аргумент для $dialer.hangUp() можно не передавать.

\n

Используйте event: botHangup, чтобы отследить событие, когда разговор окончен по запросу бота.

\n

Например:

\n
  state: BotHangUp\n    event: botHangup\n    script:\n        log(\"Got event botHangup\");
\n
\n

Завершение вызова клиентом

\n

Используйте event: hangup, чтобы отследить событие, когда клиент завершил вызов.

\n

Например, чтобы определять в каком стейте находился клиент, перед тем как был завершен вызов:

\n
    state: ClientHungUp\n        event!: hangup\n        script:\n            getClientHangUpReaction($session.lastState);
\n

При этом, если бот сам завершает вызов, событие hangup не возникает.

\n

Вы можете определить прерывание фразы бота клиентом в сценарии. При этом фраза бота будет прервана сразу при появлении речи клиента.

\n
\n

Тоновый режим

\n

Бот также может запрашивать и обрабатывать отправку dtmf-сообщения (цифры/символы в тоновом режиме).

\n

Запрос dtmf-сообщения:

\n
script:\n    $response.replies = $response.replies || [];\n    $response.replies.push({\n        type: 'dtmf',\n        max: 4,            //максимальное количество цифр, которое ожидается от абонента.\n        timeout: 15000     //интервал ожидания ввода от абонента в миллисекундах, число.\n     });
\n

Далее отлавливается запрос, например, с цифрами:

\n
state: Digits\n    q: $regexp<\\d+>\n    a: вы набрали {{$parseTree.text}}!
\n

Событие noDtmfAnswerEvent возникает, если абонент не ввел dtmf-сообщение:

\n
    state: noDTMF || noContext = true\n        event: noDtmfAnswerEvent\n        a: Вы ничего не выбрали.\n        go!: {{$session.lastState}}
\n

Подробнее о тоновом режиме

\n
\n

Сессии

\n

Подробнее о сессиях в платформе JAICP

\n

В голосовых рассылках сессия стартует в момент, когда клиент поднял трубку либо сам позвонил. Окончание диалога считается завершением сессии.

\n

При этом, если вы используете этот же сценарий для других каналов, сессия для них будет стартовать в момент первого обращения клиента, когда для него нет другой активной сессии.

\n

Не рекомендуется для голосовых рассылок искусственно разбивать сессии с использованием реакции newSession.

\n
\n

Настройка голосового синтеза

\n

При оформлении реплик бота вы можете при помощи разметки тоньше управлять синтезируемыми звуками.

\n\n
    a: Это система автоматического обзв+она.
\n\n
    a: Мн+ого пр+офильный проект.
\n\n
    a: Приветствуем {{$dialer.getPayload().name}}! Ответьте на вопрос: - - - - да, нет или наверное
\n

Не стоит создавать таким образом большие паузы. Длинная последовательность дефисов может привести к звуковым артефактам при синтезе.

\n
\n

Использование аудиофайлов

\n

Вы можете использовать в качестве ответа бота предзаписанный аудиофайл. Платформа позволяет использовать аудио в формате PCM, формат файла .wav. Настройки PCM:

\n\n

В реплику бота добавьте тег audio со ссылкой на аудиофайл с расширением .wav.

\n

Например:

\n
    state: audio\n        audio: https://example.wav   // ссылка на аудиофайл (любое хранилище)
\n
\n

Работа со списком номеров

\n

Управление списками номеров

\n

При создании списка номеров для голосовой рассылки вы можете добавить в список дополнительные поля. Например Имя, Фамилия, Город. Валидация таблицы будет проводиться только по первому столбцу с номерами, остальные будут загружены как текстовые поля.

\n

Вы можете использовать информацию из дополнительных полей в сценарии при рассылке.

\n

Метод $dialer.getPayload() возвращает json-объект с заполненными полями списка номеров.

\n

Например, мы загружаем список номеров:

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
phonenameaddress
79990000000ᅠᅠИван ᅠᅠ ᅠᅠМосква
\n
\n

Вызов метода $dialer.getPayload() вернет json-объект:

\n
{\n  \"phone\": \"79990000000\",\n  \"name\": \"Иван\",\n  \"address\": \"Москва\"\n}
\n
\n

Использование в сценарии:

\n
    state: Hello\n        a: Привет!\n        if: $dialer.getPayload().name\n            a: Вас зовут {{$dialer.getPayload().name}}\n        else:\n            a: Я не знаю вашего имени.
\n
\n

Если список загружен без заголовков, то вызов метода $dialer.getPayload() вернет json-объект:

\n
{0: \"79990000000\", 1: \"Иван\", 2: \"Москва\"}
\n

В таком случае var name = $dialer.getPayload()[1].

\n

Если значение в колонке пустое, то при вызове функции $dialer.getPayload().address будет возвращено пустое значение.

\n
{\n  \"phone\": \"79990000000\",\n  \"name\": \"Иван\",\n  \"address\": \"\"\n}
\n
\n

Метод $dialer.getCaller() возвращает строку с телефоном пользователя в том виде, в котором его присылает телефонная станция.

\n

Использование в сценарии:

\n
    state: Hello\n        a: Привет!\n        a: Ваш номер {{getCaller()}}.\n        if: $dialer.getPayload().name\n            a: Вас зовут {{$dialer.getPayload().name}}\n        else:\n            a: Я не знаю вашего имени.
\n
\n

Планирование звонка из сценария

\n

Во время разговора бота с клиентами может потребоваться запланировать новый звонок. Например, когда клиент просит перезвонить попозже.

\n

При помощи метода $dialer.redial() вы можете запланировать новый звонок и переопределить политику звонков на данный номер из сценария.

\n

Параметры метода соответствуют параметрам CallJobParametersList Calls API.

\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\n\n\n\n\n\n\n\n
ПараметрПримерОписание
startDateTime2020-03-23T00:00:00ZНачальная дата звонка. Принимает объект Date.

Звонок будет совершен в интервале
[startDateTime, finishDateTime].
finishDateTime2020-03-23T00:00:00ZКонечная дата звонка. Принимает объект Date.

Звонки после finishDateTime совершаться не будут.
allowedTime\"mon\": [{\"localTimeFrom\": \"10:00\", \"localTimeTo\": \"11:30\"}]Для каждого дня недели может быть указан один или несколько рекомендованных интервалов для звонков.

localTimeFrom — самое раннее время для звонка. Время не абсолютное, для звонка будет учитываться локальное время абонента.

localTimeTo — самое позднее время для звонка. Время не абсолютное, для звонка будет учитываться локальное время абонента.
allowedDays[\"sun\"]Разрешенные дни недели для звонка.
maxAttempts1Количество попыток дозвониться.
retryIntervalInMinutes120Пауза между попытками дозвониться, указывается в минутах.
gmtZone\"+03:00\"Часовой пояс. Принимает значения от \"-18:00\" до \"+18:00\" или согласно ID часовых поясов, установленных IANA TZBD.
\n
\n

Обратите внимание, что метод $dialer.redial() не используется без параметров. Для корректной работы метода необходимо обязательно задать параметр startDateTime или allowedTime. Если остальные параметры не будут указаны, то значения будут взяты из настроек голосовой рассылки.

\n

Например, задаем параметры для повторного звонка:

\n
state:\n    q!: Сall back\n    script:\n        $dialer.redial({\n            allowedTime: {\n                \"mon\": [{\"localTimeFrom\": \"10:00\", \"localTimeTo\": \"11:30\"},\n                        {\"localTimeFrom\": \"13:00\", \"localTimeTo\": \"14:30\"}],\n                \"fri\": [{\"localTimeFrom\": \"12:30\", \"localTimeTo\": \"15:00\"}],\n                \"default\": [{\"localTimeFrom\": \"10:00\", \"localTimeTo\": \"18:00\"}]\n            },\n            retryIntervalInMinutes: 120,\n            maxAttempts: 3\n         })\n    a: ok
\n

Для рекомендуемого интервала должны быть указаны обе границы localTimeFrom и localTimeTo. Если одна из границ не указана, то возвращается ошибка.

\n

В данном примере повторный звонок будет совершен в понедельник в промежутках с 10:00 до 11:30 и с 13:00 до 14:30, в пятницу с 12:30 до 15:00. Рекомендации для других не явно указанных дней задаются в параметре allowedTime с ключом default.

\n
\n

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

\n
state:\n    q!: Сall back\n    script:\n        $dialer.redial({\n            allowedDays: [\"sat\", \"sun\"],\n            allowedTime: {\n                \"fri\": [{\"localTimeFrom\": \"12:30\", \"localTimeTo\": \"15:00\"}],\n                \"default\": [{\"localTimeFrom\": \"10:00\", \"localTimeTo\": \"18:00\"}]\n            },\n             retryIntervalInMinutes: 120,\n            maxAttempts: 3\n         })\n    a: ok
\n

В этом примере, несмотря на то, что для пятницы интервал указан явно, вызов может состояться только в субботу или в воскресенье.

\n

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

\n

Примеры пересечений:

\n
\"mon\": [{\"localTimeFrom\": \"10:00\", \"localTimeTo\": \"13:30\"}, \n        {\"localTimeFrom\": \"13:00\", \"localTimeTo\": \"14:30\"}],\n\"tue\": [{\"localTimeFrom\": \"10:00\", \"localTimeTo\": \"18:30\"}, \n         {\"localTimeFrom\": \"13:00\", \"localTimeTo\": \"14:30\"}],
\n
\n

Если в заданном интервале параметр localTimeFrom больше, чем localTimeTo, то считается, что интервал указан корректно. Он начинается в указанный день, а завершается на следующий день. Повторные звонки в следующем примере будут проходитть с 8 часов вечера в понедельник до 3 ночи во вторник:

\n
\"mon\": [{\"localTimeFrom\": \"20:00\", \"localTimeTo\": \"03:00\"}],
\n
\n

Задаем параметры для повторного звонка из реплики клиента. Для этого используем заполненый слот $parseTree._Date.timestamp для определения начальной даты звонка:

\n
state: Перезвоните\n        intent!: /Перезвоните\n        a: Ок, перезвоню!\n        script:\n            $dialer.redial({startDateTime: new Date($parseTree._Date.timestamp)})\n            $dialer.hangUp();
\n
\n

Задаем параметры для повторного звонка по просьбе клиента с дополнительными параметрами:

\n
state: \n    q!: перезвоните через час \n\tscript:\n\t   var redialTimeFrom = moment().add(60, \"m\").toDate();\n       var redialTimeTo = moment().add(75, \"m\").toDate();\n\t   $dialer.redial({\n          startDateTime: redialTimeFrom, finishDateTime: redialTimeTo,   // будем звонить в интервал [now + 1h, now + 1h 15m]\n          localTimeFrom: \"00:00\", localTimeTo: \"00:00\",                  // игнорируем ограничения на время звонков по времени абонента\n          maxAttempts: 2,                                                // сделаем 2 попытки дозвониться\n          retryIntervalInMinutes: 5                                      // с паузой 5 минут между попытками\n       })\n\ta: хорошо, я перезвоню вам через час
\n
\n

В рамках одного диалога можно запланировать только один звонок. Например, клиент просит перезвонить бота. При обработке последующих реплик клиента вызовы $dialer.redial() игнорируются, так как параметры для повторного звонка были заданы ранее.

\n

Обратите внимание, что параметры $dialer.redial() могут быть переопределены, если не последовало ответа бота. Например, в postProcess или в другом стейте, если был совершен переход по go! без ответа бота.

\n

Для одной голосовой рассылки из сценария можно задать максимум 5 повторных звонков для каждого номера.

\n

Подробнее о приоритете выполнения и политике звонков

\n
\n

Проставление результатов обзвона

\n

Проставляя результаты обзвона в сценарии, вы добавляете пользовательские метрики в статистику.

\n

Подробнее о статистике

\n

Метод $dialer.setCallResult позволяет проставлять результат обзвона для более развернутой статистики.

\n

Например, рассмотрим сценарий:

\n
        state: Yes\n            q: Да\n            a: Спасибо за доверие! До свидания!\n            script:\n                $dialer.setCallResult(\"YES\");\n                $dialer.hangUp();\n            \n        state: No\n            q: Нет\n            a: Очень жаль, что вы отказались. До свидания!\n            script:\n               $dialer.setCallResult(\"NO\");\n               $dialer.hangUp();\n            \n        state: Maybe\n            q: Наверное\n            a: Мы вам перезвоним попозже. До связи!\n            script:\n                $dialer.setCallResult(\"MAYBE\");\n                $dialer.hangUp();
\n

Теперь в таблице с метриками при попадании в определенный стейт будут отображаться результаты обзвона: YES, NO, MAYBE.

\n

Если в сценарии не требуются расширенные метрики, используйте методы, проставляющие результаты о принятии или отклонении предложения, но при этом не требующие заполнения названия.

\n

Методы $dialer.setCallResultAccepted и $dialer.setCallResultRejected позволяют проставлять результаты как ACCEPTED и REJECTED соответственно.

\n

Сценарий:

\n
        state: Yes\n            q: Да\n            a: Спасибо за доверие! До свидания!\n            script:\n                $dialer.setCallResultAccepted();\n                $dialer.hangUp();\n            \n        state: No\n            q: Нет\n            a: Очень жаль, что вы отказались. До свидания!\n            script:\n               $dialer.setCallResultRejected();\n               $dialer.hangUp();
\n

В таблице с метриками при попадании в определенный стейт будут отображаться результаты обзвона ACCEPTED и REJECTED.

\n
\n

Расширение отчета по рассылке

\n

Метод $dialer.reportData($header, $value, $order) позволяет добавить колонки с произвольными данными в отчет .xls по рассылке.

\n

Параметры метода:

\n\n

Разработчик сценария может добавить колонки в отчет, которые требуются для определенной рассылки, например:

\n
    \n
  1. Для получения данных в ходе звонка:\n\n
    2. \n
  2. Для фиксирования фразы и факта прохождения по этапу:\n\n
    3. \n
\n

Параметр $order указывать необязательно, при этом по умолчанию передается значение 0. Колонки в отчете сортируются по убыванию значений $order, а при их совпадении — по алфавиту.

\n

Рассмотрим сценарий:

\n
theme: /\n\n    state:\n        q!: *start\n        a: Привет! Как тебя зовут?\n\n        state: Name\n            q: *\n            a: Здравствуй, {{$parseTree.text}}!\n            script:\n                $dialer.reportData(\"Имя\", $parseTree.text);\n            a: Как ты относишься к курению?\n\n            state: Smoking\n                q: *\n                a: Так и запишем: \"{{$parseTree.text}}\".\n                script:\n                    $dialer.reportData(\"Отношение к курению\", $parseTree.text, 1);
\n
\n

Здесь колонка Отношение к курению будет первой среди пользовательских колонок, так как явно указан $order, равный 1. Колонка Имя будет второй, так как здесь $order не передан и равен 0.

\n

В сценарии с большим числом колонок в зависимости от значений $order они будут расположены так:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ПолИмяОтчествоФамилияОтношение к курению
1000-1
\n

Обратите внимание, что количество колонок в отчете по рассылке ограничено. Обратитесь к администратору аккаунта за подробной информацией.

\n
\n

Получение записей звонков

\n

Если для телефонного канала включен параметр Записывать звонки, вы можете формировать в сценарии ссылки на скачивание файлов с записями разговоров. Для этого используйте метод $dialer.getCallRecordingPath().

\n

Метод возвращает относительный путь следующего вида:

\n
242829491/2019-06-18/79313365671/16:56:31.55-1P
\n

Ссылка на полный путь соответствует шаблону:

\n
https://{{host}}/restapi/download/{{projectId}}/recordings/call/{{callRecordingPath}}
\n

Здесь:

\n","frontmatter":{"title":"","description":null},"headings":[{"value":"Сценарий бота для голосовой рассылки"}]}},"pageContext":{"slug":"/docs/ru/telephony/script_voice_bot/","previous":{"fields":{"slug":"/docs/ru/telephony/recognition_synthesis_settings/"},"frontmatter":{"title":"","description":null}},"next":{"fields":{"slug":"/docs/ru/telephony/own_telephony/"},"frontmatter":{"title":"","description":null}}}}, "staticQueryHashes": ["1209419333"]}