Общее руководство по Web-интеграции - История изменений

Oktell Support в 08:46, 31 августа 2022

2022-08-31T08:46:51Z

Oktell Support: /* Использование телефона */

2019-12-10T12:23:34Z

‎Использование телефона

Oktell Support: /* Софтфон */

2019-12-10T12:18:56Z

‎Софтфон

Oktell Support в 08:08, 8 декабря 2014

2014-12-08T08:08:27Z

Oktell Support в 13:45, 14 ноября 2014

2014-11-14T13:45:32Z

Oktell Support в 10:13, 1 апреля 2014

2014-04-01T10:13:41Z

Oktell Support: /* Софтфон */

2013-12-26T12:02:42Z

‎Софтфон

Oktell Support: /* Схема интеграции */

2013-12-25T08:58:27Z

‎Схема интеграции

Oktell Support в 10:40, 24 декабря 2013

2013-12-24T10:40:09Z

Oktell Support в 10:38, 24 декабря 2013

2013-12-24T10:38:00Z

@@ Строка 78: / Строка 78: @@
 * Второй динамический метод позволяет сохранить “активность/звонок” в CRM-системе. При завершении звонка, '''Oktell''' передает идентификатор клиента, имя менеджера, который совершал звонок, время и длительность разговора и ссылку на запись.
-Подробнее про динамические методы вы узнаете по этой [http://wiki.oktell.ru/Oktell_Web-Socket_Protocol#.D0.94.D0.B8.D0.BD.D0.B0.D0.BC.D0.B8.D1.87.D0.B5.D1.81.D0.BA.D0.BE.D0.B5_.D0.B2.D0.B7.D0.B0.D0.B8.D0.BC.D0.BE.D0.B4.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D0.B5 ссылке].
+Подробнее про динамические методы вы узнаете по этой [//wiki.oktell.ru/Oktell_Web-Socket_Protocol#.D0.94.D0.B8.D0.BD.D0.B0.D0.BC.D0.B8.D1.87.D0.B5.D1.81.D0.BA.D0.BE.D0.B5_.D0.B2.D0.B7.D0.B0.D0.B8.D0.BC.D0.BE.D0.B4.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D0.B5 ссылке].
 '''Web-сервер''' по данному соединению может обратиться к серверу '''Oktell''' за получением данных по звонку (время ожидания, длительность разговора, время звонка), получения записи разговора (как самого файла, так и ссылки на этот файл). Также, '''WebCRM''' может запускать служебные сценарии в '''Oktell'''. Сценарии совершают необходимые действия, например, производят рассылку электронных писем.
@@ Строка 101: / Строка 101: @@
 Для передачи запросов от '''WebCRM к Oktell''' используется тот же '''TCP'''-канал, поэтому этот канал называется двунаправленным. '''WebCRM''' может выполнять предустановленные методы (получать номерной план, запускать задачи и др.), выполнять служебные сценарии и получать от них результат. Протокол также позволяет выполнять хранимые процедуры в базе данных '''Oktell''' и получать результат выполнения.
-Полное описание протокола вы можете прочитать по ссылке [http://wiki.oktell.ru/Oktell_Web-Socket_Protocol#.D0.A1.D0.BF.D0.B8.D1.81.D0.BE.D0.BA_.D0.BC.D0.B5.D1.82.D0.BE.D0.B4.D0.BE.D0.B2_.D0.BE.D0.B1.D1.89.D0.B5.D0.B3.D0.BE_.D0.B8.D0.BD.D1.82.D0.B5.D1.80.D1.84.D0.B5.D0.B9.D1.81.D0.B0 Oktell Web-Socket Protocol].
+Полное описание протокола вы можете прочитать по ссылке [//wiki.oktell.ru/Oktell_Web-Socket_Protocol#.D0.A1.D0.BF.D0.B8.D1.81.D0.BE.D0.BA_.D0.BC.D0.B5.D1.82.D0.BE.D0.B4.D0.BE.D0.B2_.D0.BE.D0.B1.D1.89.D0.B5.D0.B3.D0.BE_.D0.B8.D0.BD.D1.82.D0.B5.D1.80.D1.84.D0.B5.D0.B9.D1.81.D0.B0 Oktell Web-Socket Protocol].
@@ Строка 118: / Строка 118: @@
 Для каждого запроса требуется базовая авторизация под учетной записью пользователя, имеющего привилегии исполнять методы '''Web-API'''. Удобнее всего, создать отдельного пользователя и выполнять от его имени все '''web-запросы'''.
-Полное описание вы можете прочитать по ссылке [http://wiki.oktell.ru/Серверный_HTTP_интерфейс Серверный HTTP интерфейс]
+Полное описание вы можете прочитать по ссылке [//wiki.oktell.ru/Серверный_HTTP_интерфейс Серверный HTTP интерфейс]
@@ Строка 132: / Строка 132: @@
 В отличие от '''WebSocket''' и '''HTTP''' соединение происходит опосредованно через '''СУБД'''.
-Подробнее вы можете прочитать по ссылке: [http://wiki.oktell.ru/Общие_компоненты_сценариев#SQL Запрос SQL в БД]
+Подробнее вы можете прочитать по ссылке: [//wiki.oktell.ru/Общие_компоненты_сценариев#SQL Запрос SQL в БД]

← Предыдущая		Версия 12:23, 10 декабря 2019
Строка 230:		Строка 230:

	Также вы можете использовать любые другие приложения, выполняющие роль '''софтфона'''. '''Софтфон''' — приложение, которое устанавливается на компьютер и позволяет совершать/принимать звонки с использованием гарнитуры. Подключение '''софтфона''' производится аналогично настройке '''IP-телефона'''.		Также вы можете использовать любые другие приложения, выполняющие роль '''софтфона'''. '''Софтфон''' — приложение, которое устанавливается на компьютер и позволяет совершать/принимать звонки с использованием гарнитуры. Подключение '''софтфона''' производится аналогично настройке '''IP-телефона'''.
		+
		+	<br/>

	=Пример интеграционного решения=		=Пример интеграционного решения=

← Предыдущая		Версия 12:18, 10 декабря 2019
Строка 230:		Строка 230:

	Также вы можете использовать любые другие приложения, выполняющие роль '''софтфона'''. '''Софтфон''' — приложение, которое устанавливается на компьютер и позволяет совершать/принимать звонки с использованием гарнитуры. Подключение '''софтфона''' производится аналогично настройке '''IP-телефона'''.		Также вы можете использовать любые другие приложения, выполняющие роль '''софтфона'''. '''Софтфон''' — приложение, которое устанавливается на компьютер и позволяет совершать/принимать звонки с использованием гарнитуры. Подключение '''софтфона''' производится аналогично настройке '''IP-телефона'''.
−
−	Рекомендуется использовать софтфон '''Oktell Miniphone'''. Данный софтфон имеет функционал автоподнятия трубки и представляет собой голосовой канал для оператора контакт-центра. '''Miniphone''' не имеет собственного интерфейса. Это позволяет не беспокоиться о том, что настройки будут сброшены, либо приведены в неверное состояние. Программа расположена в трее и не занимает места на экране. Исходящие звонки совершаются при команде из браузера, например, с помощью '''oktell-panel.js'''.
−
−	~~Подробнее прочитать про '''Oktell Miniphone''' можно по ссылке [http://oktell.ru/utilites/miniphone/ http://oktell.ru/utilites/miniphone/]~~

	=Пример интеграционного решения=		=Пример интеграционного решения=

@@ Строка 209: / Строка 209: @@
 '''Решение 1.''' На веб-странице используется фрейм, растянутый на 100% высоты и 100% ширины страницы. Внутри фрейма происходит переход по ссылкам, внешние веб-страницы полностью подгружаются на текущую. Таким образом переход между ссылками не перезагружает текущую страницу.
-'''Решение 2.''' Сервер WebCRM присылает все необходимые данные, которые динамически отрисовываются веб-страницей. При переходе с одного раздела на другой, веб-страница запрашивает данные для отрисовки, которые при получении отображает в браузере. Перезагрузки самой веб-страницы не происходит. Примером такого решения является '''Oktell Web-клиент'''.
+'''Решение 2.''' Сервер WebCRM присылает все необходимые данные, которые динамически отрисовываются веб-страницей. При переходе с одного раздела на другой, веб-страница запрашивает данные для отрисовки, которые при получении отображает в браузере. Перезагрузки самой веб-страницы не происходит. Примером такого решения является веб-приложение '''Okapp'''.
-Подробнее вы можете прочитать в статье [[Oktell Web Клиент]].
+Подробнее вы можете прочитать в статье [[Okapp]].

@@ Строка 209: / Строка 209: @@
 '''Решение 1.''' На веб-странице используется фрейм, растянутый на 100% высоты и 100% ширины страницы. Внутри фрейма происходит переход по ссылкам, внешние веб-страницы полностью подгружаются на текущую. Таким образом переход между ссылками не перезагружает текущую страницу.
-'''Решение 2.''' Сервер WebCRM присылает все необходимые данные, которые динамически отрисовываются веб-страницей. При переходе с одного раздела на другой, веб-страница запрашивает данные для отрисовки, которые при получении отображает в браузере. Перезагрузки самой веб-страницы не происходит. Примером такого решения является '''Oktell Web-Оператор'''.
+'''Решение 2.''' Сервер WebCRM присылает все необходимые данные, которые динамически отрисовываются веб-страницей. При переходе с одного раздела на другой, веб-страница запрашивает данные для отрисовки, которые при получении отображает в браузере. Перезагрузки самой веб-страницы не происходит. Примером такого решения является '''Oktell Web-клиент'''.
-Подробнее вы можете прочитать в статье [[Oktell_Web_Оператор]].
+Подробнее вы можете прочитать в статье [[Oktell Web Клиент]].

← Предыдущая		Версия 10:13, 1 апреля 2014
Строка 1:		Строка 1:
		+	[[Заглавная_страница\|Наверх]]
		+
	__TOC__		__TOC__

@@ Строка 229: / Строка 229: @@
 Также вы можете использовать любые другие приложения, выполняющие роль '''софтфона'''. '''Софтфон''' — приложение, которое устанавливается на компьютер и позволяет совершать/принимать звонки с использованием гарнитуры. Подключение '''софтфона''' производится аналогично настройке '''IP-телефона'''.
-Рекомендуется использовать софтфон '''Oktell Miniphone'''. Данный софтфон имеет функционал автоподнятия трубки и представляет собой голосовой канал для оператора контакт-центра. '''Miniphone''' позволяет принимать звонки, однако совершить исходящий звонок c помощью интерфейса не получится. Такую возможность можно реализовать в браузерном приложении, например, с помощью '''oktell-panel.js.'''
+Рекомендуется использовать софтфон '''Oktell Miniphone'''. Данный софтфон имеет функционал автоподнятия трубки и представляет собой голосовой канал для оператора контакт-центра. '''Miniphone''' не имеет собственного интерфейса. Это позволяет не беспокоиться о том, что настройки будут сброшены, либо приведены в неверное состояние. Программа расположена в трее и не занимает места на экране. Исходящие звонки совершаются при команде из браузера, например, с помощью '''oktell-panel.js'''.
 Подробнее прочитать про '''Oktell Miniphone''' можно по ссылке [http://oktell.ru/utilites/miniphone/ http://oktell.ru/utilites/miniphone/]
 =Пример интеграционного решения=

← Предыдущая		Версия 08:58, 25 декабря 2013
Строка 59:		Строка 59:

	'''Oktell''' позволяет работать одновременно с сервером '''WebCRM''' и с клиентскими (браузерными) приложениями. Интеграция '''Oktell''' и '''WebCRM-системы''' проводится в два этапа:		'''Oktell''' позволяет работать одновременно с сервером '''WebCRM''' и с клиентскими (браузерными) приложениями. Интеграция '''Oktell''' и '''WebCRM-системы''' проводится в два этапа:
−	~~1. '''Серверная интеграция''' — настройка канала обмена данными между '''WebCRM-системой''' и '''сервером Oktell'''.~~
−	2. '''Клиентская интеграция''' — организация интерфейса для передачи команд телефонии от браузерного приложения к серверу '''Oktell'''.

		+	'''1.''' '''Серверная интеграция''' — настройка канала обмена данными между '''WebCRM-системой''' и '''сервером Oktell'''.
		+
		+	'''2.''' '''Клиентская интеграция''' — организация интерфейса для передачи команд телефонии от браузерного приложения к серверу '''Oktell'''.

	= Серверная интеграция =		= Серверная интеграция =

@@ Строка 6: / Строка 6: @@
 '''Интеграция''' - процесс объединения одного приложения c другим с целью увеличения функциональности и уменьшения времени обработки запроса. Интеграцию проводят для облегчения работы операторам и автоматизации бизнес-процессов.
 == Что мы имеем до интеграции? ==
@@ Строка 25: / Строка 26: @@
 * предоставление информации о KPI сотрудника, расчет их показателей эффективности
 * управление бизнес-процессами в компании
 == Что мы должны получить после интеграции? ==
@@ Строка 31: / Строка 33: @@
 При входящем звонке '''Oktell''' идентифицирует абонента по его номеру телефон ('''CallerId'''), телефону, который он набрал ('''CalledId'''), время поступившего звонка. Затем, происходит обращение к серверу '''WebCRM''', в котором сообщается полученная информация, по которой определяется тип клиента, ответственный менеджер, дополнительные данные. После получения необходимых данных, '''Oktell''' маршрутизирует звонок нужному сотруднику, а в браузере у этого сотрудника открывается карточка клиента.
 === Исходящие звонки ===
 Чтобы совершить звонок на номер клиента, менеджеру необходимо открыть карточку клиента в '''CRM-системе''' и нажать на кнопку "'''Позвонить'''". Выбор линий и направлений для совершения звонка настраивается в '''Oktell'''. В случае, если абонент не доступен или занят, менеджеру должна быть выведена соответствующая информация о статусе звонка.
 === Внутренние звонки ===
@@ Строка 41: / Строка 45: @@
 Также должны быть доступны статусы всех сотрудников. Статусы могут быть: свободен, занят (т.е. находится в разговоре), в перерыве или недоступен. Менеджер видит кто из коллег занят в данный момент и подождать, пока он освободится, для совершения звонка.
 === Статистика / история звонков. ===
@@ Строка 81: / Строка 86: @@
 Задача серверной интеграции - организовать канал связи между '''WebCRM''' и сервером '''Oktell''' для выполнения различных запросов. При этом запросы могут идти, как от '''Oktell''' к '''WebCRM''', так и наоборот. Для каждой технологии ниже приведено краткое описание, преимущества и недостатки использования.
 ===Соединение по протоколу WebSocket===
@@ Строка 152: / Строка 158: @@
 Задача клиентской интеграции — передача команд телефонии в браузерное приложение. Подключение  происходит с помощью специально разработанных Javascript-библиотек. Соединение с '''Oktell''' устанавливается при загрузке '''Web-страницы'''. Следует отметить, что во время разговора  Web-страницу нельзя перезагружать или закрывать, так как соединение будет потеряно, а значит и разговор будет тут же разорван. Для корректной работы используйте только одностраничные сайты.
 ===Oktell.js===
@@ Строка 184: / Строка 191: @@
 Во время работы в браузере менеджер для совершения звонков может использовать как стационарный '''IP-телефон''', так и '''софтфон''' или '''гарнитуру'''. В данной части рассматривается подключение данных устройств.
 ===Гарнитура===
@@ Строка 192: / Строка 200: @@
 Если для навигации внутри '''CRM-системы''' используется полная перезагрузка страницы или открытие окон в новых вкладках, то в '''Oktell''' постоянно будет происходить регистрация/разрегистрация устройств, что повысит нагрузку на сервер в целом, так как это трудоемкая операция. При работе десяти пользователей, количество регистраций линий может превышать 800-1000 раз в день.
 Решением является использование одностраничных сайтов. При переходе между вкладками, страница не должна перезагружаться. Предлагаем следующие решения:
@@ Строка 200: / Строка 209: @@
 Подробнее вы можете прочитать в статье [[Oktell_Web_Оператор]].
 ===IP-телефон===
@@ Строка 212: / Строка 222: @@
 После авторизации менеджера в браузерном приложении, телефон автоматически закрепляется за сотрудником, и при звонке будет использоваться именно это устройство.
 ===Софтфон===
@@ Строка 220: / Строка 231: @@
 Подробнее прочитать про '''Oktell Miniphone''' можно по ссылке [http://oktell.ru/utilites/miniphone/ http://oktell.ru/utilites/miniphone/]
 =Пример интеграционного решения=
 Приведенный ниже пример не является готовым решением, а предоставлен как демонстрационный материал. Обратите внимание на взаимосвязанность процессов, зоны ответственности серверной и клиентской интеграции.
 ==Входящий звонок==
@@ Строка 239: / Строка 252: @@
 [[Файл:интеграция-013.png |500px | center]]
 ==Исходящий звонок==

@@ Строка 75: / Строка 75: @@
-[[Файл:интеграция-001n.png | center | 400 px ]]
+[[Файл:интеграция-001n.png | center | 500 px ]]
@@ Строка 95: / Строка 95: @@
-[[Файл:интеграция-006.png | center | 400 px ]]
+[[Файл:интеграция-006.png | center | 500 px ]]
@@ Строка 112: / Строка 112: @@
-[[Файл:интеграция-008.png | center | 400 px ]]
+[[Файл:интеграция-008.png | center | 500 px ]]
@@ Строка 126: / Строка 126: @@
-[[Файл:интеграция-010.png | center | 400 px ]]
+[[Файл:интеграция-010.png | center | 500 px ]]
@@ Строка 136: / Строка 136: @@
-[[Файл:интеграция-003n.png | center | 400 px ]]
+[[Файл:интеграция-003n.png | center | 500 px ]]
@@ Строка 164: / Строка 164: @@
-[[Файл:интеграция-007.png | center | 400 px ]]
+[[Файл:интеграция-007.png | center | 500 px ]]
@@ Строка 178: / Строка 178: @@
-[[Файл:интеграция-012.png | center | 400 px ]]
+[[Файл:интеграция-012.png | center |500 px ]]
@@ Строка 208: / Строка 208: @@
-[[Файл:Oktelljs-004.png | center |400px]]
+[[Файл:Oktelljs-004.png | center |500px]]
@@ Строка 238: / Строка 238: @@
-[[Файл:интеграция-013.png |400px | center]]
+[[Файл:интеграция-013.png |500px | center]]
 ==Исходящий звонок==
@@ Строка 249: / Строка 249: @@
-[[Файл:интеграция-014.png |400px | center]]
+[[Файл:интеграция-014.png |500px | center]]