Техническое задание участникам

Основной задачей соревнования является создание и проверка робота рекрутёра для исследовательских компаний. Мы дозваниваемся до респондента по случайно сгенерированной базе, спрашиваем его несколько вводных вопросов и при готовности нам отвечать – переводим на оператора КЦ, который продолжает наш опрос.

Общая схема взаимодействия

  1. Вызовы инициирует система управления контакт-центрами SURVEYSTUDIO/DEX. На стороне SURVEYSTUDIO/DEX обработкой телефонии занимается ПО Asterisk. АТС расположена по адресу voip-robot.dialerex.ru (78.155.222.74).
  2. У SURVEYSTUDIO/DEX настроено SIP-соединение с АТС участника соревнований. SURVEYSTUDIO/DEX отправляет INVITE в это соединение (вызов #1).  В INVITE добавлен заголовок «X-SIIS-Callid», который содержит цифробуквенный идентификатор вызова. Этот идентификатор вызова необходимо прочитать и использовать позже при передаче результатов работы робота на сервера SURVEYSTUDIO/DEX.
  3. АТС участника Спартакиады отвечает временным кодом «100 Ringing» и одновременно с этим создает новый вызов (вызов #2) на тот же номер телефона, который отправляет на voip-robot.dialerex.ru.
  4. АТС SURVEYSTUDIO/DEX получив запрос на создание вызова #2 обеспечивает его обработку в соответствии с планами маршрутизации и доступными провайдерами связи и устанавливает соединение с респондентом. Все данные по звонку включая Early Media передаются на АТС участника Спартакиады для корректного и полноценного определения автоответчиков.
  5. Робот на АТС участника соревнований работает с респондентом в рамках вызова #2. В это время вызов #1 так и остается в состоянии «Ringing».
  6. Если респондент или робот в процессе предобработки прерывает соединение, вызов #1 тоже должен быть прерван.
  7. Если респондент проходит все вопросы робота, то АТС участника Спартакиады соединяет вызов #1 и вызов #2.
  8. После ответа на вызов #1 АТС SURVEYSTUDIO/DEX переводит звонок на оператора контакт-центра.
  9. После завершения обработки вызова АТС участника соревнований передаёт данные по нему через POST-запрос к серверу SURVEYSTUDIO/DEX, где отображает результат звонка и (если есть) ответы респондента.

Передача данных звонка

Возврат результатов: POST https://voip-robot.dialerex.ru/call-handler

Формат данных (JSON):

{"login": "robot”, "password": "SKridh92837djAS", "x-siis-callid": "XXXXXX", "call_result": 204, answers": ["1", "2"]}
  • login и password – имя пользователя и пароль, выдаваемые SURVEYSTUDIO/DEX участнику соревнований;
  • x-siis-callid – цифробуквенный идентификатор из заголовка INVITE вызова #1;
  • call_result – результат звонка (таблица возможных результатов звонка приведена ниже);
  • answers – массив ответов на вопросы в анкете.

Пример:

curl -i -H "Content-Type: application/json" -X POST -d '{"login":"robot", "password": "SKridh92837djAS", "x-siis-callid": "XXXXXX", "call_result": 204, "answers": ["1", "2"]}' https://voip-robot.dialerex.ru/call-handler

Процедура тестирования

Для тестирования работы системы участникам соревнований предлагается метод, инициирующий вызов так, как если бы его создавала система SURVEYSTUDIO/DEX.

Возврат результатов: POST https://voip-robot.dialerex.ru/call

Формат данных (JSON):

{"login": "robot”, "password": "SKridh92837djAS", "phone": "79219998877"}
  • phone – номер телефона, на который надо отправить вызов.

Пример:

curl -i -H "Content-Type: application/json" -X POST -d '{"login":"robot", "password": "SKridh92837djAS", "phone": "79219188912"}' https://voip-robot.dialerex.ru/call

Таблица кодов результатов звонка

Коды результатов звонка делятся на две группы: 1XX и 2XX. Группа 1XX – это результаты вызов, которые прошли без установки телефонного соединения. Группа 2XX – это результаты вызовов, где установка телефонного соединения была.

Общий список кодов:

  • 100 - нет ответа
  • 101 - автоответчик
  • 102 - занято
  • 103 - номер не существует
  • 104 - остальные ошибки
  • 201 - соединение было: автоответчик
  • 202 - соединение было: респондент бросил трубку
  • 203 - соединение было: отказ
  • 204 - соединение было: согласие
  • 205 - соединение было: иное

Анкета

Робот на соревновании представляется российской исследовательской компанией, которая проводит опрос о жизни в стране. Надо упомянуть, что опрос займет около 5-10 минут. Запрещено обещать вознаграждение за прохождение опроса.

Часто встречаются уточняющие вопросы «откуда у вас мой номер?», «кто вы такие?» и «почему вы мне звоните?». Участники соревнований сами определяют необходимость и политику ответов на эти вопросы исходя их экономической целесообразности и эффективности.

Вопрос 1. Пол. Робот не задает этот вопрос, если может – определяет по голосу, если не может – ставит код 99.

  • 1. Мужской
  • 2. Женский
  • 99. Не можем определить

Вопрос 2. Возраст. Чаще всего вопрос формулируется как «Сколько Вам полных лет исполнилось?», однако участник соревнований может выбрать свои варианты формулировки. В качестве результата важно получить именно категорию.

  • 1. Меньше 18 лет
  • 2. От 18 до 20 лет
  • 3. 21-35
  • 4. 36-45
  • 5. 46-55
  • 6. Больше 55
  • 7. Отказ отвечать
  • 99. Не распознано

При ответах 1 и 6 – завершаем опрос.

Вопрос 3. В какой области, республике или крае Вы проживаете в течение последних трех месяцев?

  1. Республика Хакасия
  2. Архангельская область
  3. Алтайский край
  4. Белгородская область
  5. Брянская область
  6. Новгородская область
  7. Приморский край
  8. Владимирская область
  9. Волгоградская область
  10. Вологодская область
  11. Воронежская область
  12. Свердловская область
  13. Удмуртская Республика
  14. Республика Марий Эл
  15. Иркутская область
  16. Республика Татарстан
  17. Калининградская область
  18. Калужская область
  19. Кемеровская область
  20. Кировская область
  21. Костромская область
  22. Краснодарский край или Республика Адыгея
  23. Красноярский край
  24. Курская область
  25. Липецкая область
  26. Москва или Московская область
  27. Мурманская область
  28. Нижегородская область
  29. Новосибирская область
  30. Омская область
  31. Орловская область
  32. Оренбургская область
  33. Пензенская область
  34. Пермский край
  35. Республика Карелия
  36. Камчатский край
  37. Псковская область
  38. Ростовская область
  39. Рязанская область
  40. ЯНАО (Тюменская область)
  41. Самарская область
  42. Санкт-Петербург или Ленинградская область
  43. Республика Мордовия
  44. Саратовская область
  45. Смоленская область
  46. Республика Коми
  47. Тамбовская область
  48. Тверская область
  49. Томская область
  50. Тульская область
  51. Тюменская область
  52. Республика Бурятия
  53. Ульяновская область
  54. ХМАО – Югра (Тюменская область)
  55. Чувашская республика
  56. Челябинская область
  57. Сахалинская область
  58. Курганская область
  59. Республика Тыва
  1. Еврейская АО
  2. Магаданская область
  3. Ивановская область
  4. Ярославская область
  5. Республика Алтай
  6. Хабаровский край
  1. Другой регион
  2. Отказ от ответа / Затрудняюсь ответить
  3. Не распознано

После завершения вопроса 3, респондент переключается на оператора КЦ.

Контакты и вопросы для подключения

support@survey-studio.com
+7 (812) 389-42-42