Вы когда-нибудь оказывались разъединенными во время перевода звонка в службу поддержки на другого специалиста?
Теплый трансфер решает эту проблему. С помощью теплых трансферов на базе Twilio ваши агенты смогут подключать другого агента в реальном времени.
Вот как это работает на высоком уровне:
— Первый агент становится доступным, когда подключается через веб-клиент.
— Второй агент также становится доступным, когда подключается через веб-клиент.
— Клиент звонит на линию поддержки.
— Клиент остается на удержании, пока первый агент подключается к звонку.
— Во время разговора с клиентом первый агент может подключить второго агента к звонку.
— Как только второй агент подключается, первый может отключиться. Клиент и второй агент остаются на связи.
Давайте начнем! Клонируйте пример приложения с GitHub.
Сначала настроим вебхук для голосовых вызовов на Twilio-номер, который будут набирать клиенты для связи с агентом поддержки.
Это должен быть публичный URL вашего приложения в продакшене: `http://***.ngrok.io/conference/connect/client`
Отлично, теперь у вас настроен вебхук. Далее рассмотрим часть кода.
Здесь вы можете увидеть весь фронтенд-код, необходимый для подключения агента с помощью Twilio Voice Web Client.
Нам, по сути, нужны три вещи для работы живого веб-клиента:
— Токен возможностей (предоставляется нашим приложением)
— Уникальный идентификатор (строка) для каждого агента
— Слушатели событий для обработки различных событий, инициированных Twilio
На следующем шаге мы более подробно рассмотрим генерацию токена возможностей.
Для подключения Twilio Voice Web Client необходим токен возможностей.
Чтобы разрешить входящие соединения через веб-клиент, при генерации токена должен быть предоставлен идентификатор.
Далее посмотрим, как обрабатывать входящие звонки.
В этом руководстве мы использовали фиксированные строки идентификаторов, такие как `agent1` и `agent2`, но вы можете использовать любую сгенерированную строку для клиентов вашего колл-центра. Эти идентификаторы будут использоваться для создания исходящих звонков указанному агенту с помощью Twilio REST API.
Когда клиент звонит на наш Twilio-номер, приложение получает POST-запрос с просьбой дать инструкции. Мы будем использовать TwiML, чтобы дать клиенту инструкцию присоединиться к конференц-залу, и Twilio REST API клиент для начала звонка первому агенту, чтобы он мог присоединиться к той же конференции.
При предоставлении инструкций клиенту мы также указываем callback `waitUrl`, который в нашем случае является другим эндпоинтом нашего приложения. Он возвращает дополнительный TwiML, чтобы поприветствовать пользователя и воспроизвести музыку во время ожидания. Посмотрите код здесь.
Мы используем `CallSid` клиента в качестве идентификатора конференции. Поскольку всем участникам нужен этот идентификатор для присоединения к конференции, нам нужно сохранить его в базе данных, чтобы мы могли использовать его позже при подключении второго агента.
Теперь посмотрим, как предоставить инструкции TwiML клиенту.
Здесь мы создаем `VoiceResponse` с помощью его билдера, и он будет содержать глагол `Dial` с существительным `Conference`, который даст клиенту инструкцию присоединиться к определенной конференц-комнате.
Далее рассмотрим, как подключить первого агента к звонку.
Для нашего приложения мы создали метод `callAgent` для обработки подключения наших агентов. Этот метод использует класс `Call` из Twilio SDK для создания нового звонка. Статический метод `create` принимает следующие параметры:
`To`: Идентификатор веб-клиента агента (`agent1` или `agent2`)
`From`: Ваш Twilio-номер
`Url`: URL для запроса инструкций TwiML при подключении звонка
Метод `create` возвращает объект, который содержит метод `execute`, и вызов к API Twilio происходит только при вызове этого метода `execute`.
Как только агент отвечает на звонок в веб-клиенте, отправляется запрос на callback URL с инструкцией присоединиться к конференц-залу, где уже ожидает клиент.
С учетом этого давайте посмотрим, как добавить второго агента к звонку.
Когда клиент и первый агент находятся на связи, мы готовы выполнить *теплый трансфер* ко второму агенту. Первый агент отправляет запрос, и мы ищем его `conferenceId`, необходимый для подключения второго агента. Поскольку у нас уже есть метод `callAgent`, мы можем просто вызвать его для подключения второго агента.
Далее рассмотрим, как обработать уход первого агента из звонка.
Когда все три участника присоединились к одному звонку, первый агент выполнил свою задачу. Теперь он может завершить звонок, оставив второго агента и клиента для приятного разговора.
Важно отметить различия в TwiML, который получают участники при подключении к звонку. У обоих агентов, первого и второго, установлен параметр `startConferenceOnEnter` в значение `true`. Это означает, что конференция начнется, когда любой из них присоединится. Для клиента и второго агента параметр `endConferenceOnExit` установлен в значение `true`. Это приводит к завершению звонка, когда любой из этих двух участников завершает вызов.
Вот и все! Мы только что реализовали теплые трансферы с использованием Java Servlets. Теперь ваши клиенты не будут разъединяться во время перевода звонков в службу поддержки.
Если вы Java-разработчик, работающий с Twilio, вам также могут понравиться эти руководства:
Click-to-call позволяет вашей компании конвертировать веб-трафик в телефонные звонки одним нажатием кнопки. Узнайте, как реализовать это за несколько минут.
Узнайте, как реализовать автоматизированные опросы в вашем веб-приложении на Spring с помощью Twilio.
#### Помогло ли это?
Спасибо за ознакомление с этим руководством! Дайте нам знать в Twitter, что вы создали… или что создаете.