Пример: Click to call

В этом небольшом руководстве будет показано, как при помощи платформы Carusto можно легко добавить виджет click-to-call на веб-сайт.

Итак, как это будет работать:

• Посетитель веб-сайта хочет связаться с вашей организацией. Он заполняет форму для обратной связи, указывая номер телефона.
• Веб-страница в свою очередь отправляет веб-форму на веб-сервер, где при помощи Carusto REST API идет обращение.
• Платформа Carusto принимает запрос и инициализирует новый звонок.
• Пользователь получает звонок на указанный номер.
• Платформа Carusto маршрутизирует (направляет) звонок.

Настройки окружения

Для нашего приложения ClickToCall необходимо для начала сконфигурировать API ключ. Кроме этого нам также необходимо узнать доменное имя для запроса, которое указано в настройках панели администратора (System - General).

Пример API ключа и доменного имени (realm)

Форма на веб странице

Первым делом что бы создать приложение click-to-call нам необходимо добавить форму на веб страницу. Цель этой формы получить от пользователя его номер телефона, после чего на него будет совершен звонок.

Пример формы

<form id="contactForm" role="form">
  <div class="form-group">
    <h3>Call Sales</h3>
    <p class="help-block">
      Are you interested in impressing your friends and
      confounding your enemies? Enter your phone number
      below, and our team will contact you right away.
    </p>
  </div>
  <div class="form-group">
    <input type="text" id="phoneNumber"
      placeholder="(651) 555-7889" class="form-control">
  </div>
  <button type="submit" class="btn btn-default">
  Contact Sales
  </button>
</form>

Новый звонок

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

Вариант 1: Звонок зарегистрированному пользователю Carusto

Для совершения звонка к пользователю для начала нам нужно будет узнать его уникальный идентификатор. Зная идентификатор пользователя мы можем сначала позвонить этому пользователю и после ответа звонить на номер указанный в веб-форме.

Пример

TODO
TODO
TODO
TODO
TODO

Вариант 2: Звонок в очередь

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

Наш CarustoML будет выглядеть следующим образом

TODO
TODO
TODO
TODO
TODO

После чего сформируем окончательный запрос к серверу через Carusto REST API

TODO
TODO
TODO
TODO
TODO

Вариант 3: Не рабочее время

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

Итак, нам нужно:

• Сделать звонок на указанный номер.
• Сообщить о том что сейчас не рабочее время.
• Добавить номер в исходящую очередь.

CarustoML который нам нужен

TODO
TODO
TODO
TODO
TODO