Oktell - Вклад участника [ru]

Oktell и amoCRM

2014-07-15T12:44:45Z

91.144.142.107:

[[Интеграции_с_CRM_системами | Наверх]]

__TOC__

'''amoCRM''' — это простая и понятная система учета потенциальных клиентов и сделок, которая поможет контролировать и увеличивать Ваши продажи. Она не требует установки или настройки — достаточно зарегистрироваться на этом сайте и ваша персональная CRM система готова к работе.

'''Сайт компании:''' [https://www.amocrm.ru/ https://www.amocrm.ru/]

 ВНИМАНИЕ: Интеграция возможна, начиная с версии '''Oktell''' не ниже 2.9 131002 (от 2 октября 2013 года).

== Подготовка к интеграции ==

=== Настройка Web-сервера Oktell ===

Чтобы '''amoCRM''' связалась с '''Oktell''', необходимо настроить '''web-сервер'''.

Для настройки '''web-сервера''' воспользуйтесь статьей: [[Настройка_Web-сервера_Oktell | Настройка Web-сервера Oktell]].

=== Подключение оператора с привязкой к телефону ===

Чтобы сотрудник мог совершать и принимать звонки в карте сети необходимо закрепить телефон за сотрудником.

Зайдите в '''Администрирование''' -> '''Карта сети''' -> '''Настройки телефона'''. Выберите сотрудника в поле '''Пользователь WebCRM'''.

[[Файл:Amocrm-011.png | center]]

ВНИМАНИЕ: Интеграция не позволяет использовать гарнитуру в работе. Вы можете использовать софтфоны в качестве IP-телефона. Настройка идентична вышеописанной.

== Настройка amoCRM ==

'''Шаг 1.''' Откройте '''Настройки''' и перейдите на вкладку '''Виджеты'''. В виджете '''Oktell''' нажмите кнопку "'''Установить'''".

[[Файл:Amocrm-002.png |800 px| center]]

'''Шаг 2.''' В настройках вам надо внести параметры телефонии: '''адрес сервера Oktell''' с указанием порта web-сервера, а также данные для авторизации - логины и пароли пользователей '''Oktell'''. Нажмите "'''Сохранить'''"

ВНИМАНИЕ: Во избежание проблем рекомендуется вводить IP-адрес как '''ws://12.34.56.78:4055'''

[[Файл:Amocrm-001.png | center]]

ВНИМАНИЕ: Для каждого пользователя на вкладке "'''Доступ'''" необходимо разрешить "'''Возможность исполнять методы Web-API'''". 
* Перейдите в '''Администрирование''' - '''Пользователи'''.
* Выберите конкретного пользователя и перейдите на вкладку '''Доступ'''.
* Поставьте галочку напротив "'''Возможность исполнять методы Web-API'''".
* Нажмите '''Сохранить'''.
* Затем нажмите '''Применить'''.

[[Файл:Amocrm-003.png |600px| center]]

== Прием и совершение звонка ==

=== Совершение звонка ===

Для совершения звонка используйте кнопку [[Файл:Amocrm-004.png]]. Запустится сервис автодозвона, отменить не получится.

[[Файл:Amocrm-005.png |800px| center]]

В сервисе автодозвона, по умолчанию, количество попыток на автодозвон до внешнего номера равно '''50'''. Рекомендуется установить количество попыток равное '''1'''.
* Для этого перейдите в '''Общие настройки''' - '''Автодозвон'''
* Установите "'''Количество попыток на автодозвон до внешнего номера'''" равное 1.

[[Файл:Amocrm-013.png | center]]

=== Прием звонка ===

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

'''Шаг 1.''' Импортируйте сценарий для работы с amoCRM.
* Для этого перейдите в '''Администрирование''' - '''Сценарии'''. В контекстном меню выберите "'''Импортировать сценарий'''" и выберите сценарий "'''Работа с AMO CRM'''".
'''Скачать сценарий:''' [http://wiki.oktell.ru/images/c/c9/%D0%98%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F_%D1%81_AMO_CRM.oscr Работа с amoCRM.oscr]

[[Файл:Amocrm-006.png | 600px|center]]

'''Шаг 2.''' Настройте параметры подключения к amoCRM.

Откройте импортированный сценарий "'''Работа с AMO CRM'''". Введите в компоненты "'''Ваш аккаунт AMO'''" и "'''Пользователь'''" значения из настроек виджета "'''Oktell'''".

ВНИМАНИЕ: Когда вы будете вставлять выражение в компонент "'''Пользователь'''", уберите перенос строки. Значение должно быть введено в одну строку.

[[Файл:Amocrm-007.png |800px|center]]

'''Шаг 3.''' Модифицируйте главный сценарий входящей маршрутизации.

* Добавьте 2 переменные в главный сценарий:
:#'''CRM_Number''' (строковая) - номер ответственного менеджера
:#'''CRM_INFO''' (строковая) - имя контакта
:Возможен вывод другой информации по абоненту (ID контакта, название компании, ID компании, ответственный менеджер)

* Добавьте следующие элементы:

:# Компонент "'''AMO CRM'''" - запуск сценария "'''Работа с AMO CRM'''".
:# Компонент "'''Есть номер?'''" - проверяет на наличие номера оператора
:# Компонент "'''Номер из CRM'''" - присваивает номер сотрудника в переменную сценария.

* По желанию, вы можете добавить '''CallerId''' и '''CallerName''' в компоненты переключения на сотрудников.

[[Файл:Amocrm-010.png |600px|center]]

[[Файл:Amocrm-009.png |1000px|center]]

'''Шаг 4.''' При входящем звонке в '''amoCRM''' отправляется запрос на получение ответственного менеджера по этому контакту. '''amoCRM''' возвращает имя пользователя, на которого происходит переключение. Параллельно открывается карточка у данного ответственного менеджера.

[[Файл:Amocrm-012.png |center]]

'''Скачать сценарий:''' [http://wiki.oktell.ru/images/c/c9/%D0%98%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F_%D1%81_AMO_CRM.oscr Работа с amoCRM.oscr]

'''Скачать пример главного сценария:''' [http://wiki.oktell.ru/images/1/17/%D0%9C%D0%B0%D1%80%D1%88%D1%80%D1%83%D1%82%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F_%D0%B2%D1%85%D0%BE%D0%B4%D1%8F%D1%89%D0%B8%D1%85_%28amocrm%29.zip Маршрутизация_входящих_(amocrm).zip] (для версий от 2.10.140313)

== Возможные проблемы ==

ВНИМАНИЕ: Если у вас некорректно работает система, проверьте как в Oktell определяется CallerID. Используйте компонент уведомление в главном сценарии. Проверить определение '''CallerId''' в '''amoCRM''' можно с помощью web-запроса:

{Ваш аккаунт AMO}?{Ваш пользователь}&caller_number=89041112233&transliterate=Y

где '''Ваш аккаунт AMO''' и '''Ваш пользователь''' берутся из настроек виджета '''Oktell''', а номер можно определить с помощью уведомления в главном сценарии.

Например, '''https://test.amocrm.ru/private/acceptors/oktell/index.php?admin@oktell.ru&caller_number=89041112233&transliterate=Y'''

ВНИМАНИЕ: Если у вас некорректно определяется '''CallerId''' в '''Oktell''' выполните следующее:
* Перейдите в '''Администрирование''' - '''Параметры аппаратуры''' - {Выберите шлюз}.
* В поле "'''Источник определения CallerID'''" выберите, например, '''From: DisplayName'''
* Нажмите "'''Сохранить'''"

[[Файл:Amocrm-014.png |600px |center]]

Oktell и amoCRM

2014-07-15T12:42:17Z

91.144.142.107:

[[Интеграции_с_CRM_системами | Наверх]]

__TOC__

'''amoCRM''' — это простая и понятная система учета потенциальных клиентов и сделок, которая поможет контролировать и увеличивать Ваши продажи. Она не требует установки или настройки — достаточно зарегистрироваться на этом сайте и ваша персональная CRM система готова к работе.

'''Сайт компании:''' [https://www.amocrm.ru/ https://www.amocrm.ru/]

 ВНИМАНИЕ: Интеграция возможна, начиная с версии '''Oktell''' не ниже 2.9 131002 (от 2 октября 2013 года).

== Подготовка к интеграции ==

=== Настройка Web-сервера Oktell ===

Чтобы '''amoCRM''' связалась с '''Oktell''', необходимо настроить '''web-сервер'''.

Для настройки '''web-сервера''' воспользуйтесь статьей: [[Настройка_Web-сервера_Oktell | Настройка Web-сервера Oktell]].

=== Подключение оператора с привязкой к телефону ===

Чтобы сотрудник мог совершать и принимать звонки в карте сети необходимо закрепить телефон за сотрудником.

Зайдите в '''Администрирование''' -> '''Карта сети''' -> '''Настройки телефона'''. Выберите сотрудника в поле '''Пользователь WebCRM'''.

[[Файл:Amocrm-011.png | center]]

ВНИМАНИЕ: Интеграция не позволяет использовать гарнитуру в работе. Вы можете использовать софтфоны в качестве IP-телефона. Настройка идентична вышеописанной.

== Настройка amoCRM ==

'''Шаг 1.''' Откройте '''Настройки''' и перейдите на вкладку '''Виджеты'''. В виджете '''Oktell''' нажмите кнопку "'''Установить'''".

[[Файл:Amocrm-002.png |800 px| center]]

'''Шаг 2.''' В настройках вам надо внести параметры телефонии: '''адрес сервера Oktell''' с указанием порта web-сервера, а также данные для авторизации - логины и пароли пользователей '''Oktell'''. Нажмите "'''Сохранить'''"

ВНИМАНИЕ: Во избежание проблем рекомендуется вводить IP-адрес как ws://12.34.56.78:4055

[[Файл:Amocrm-001.png | center]]

ВНИМАНИЕ: Для каждого пользователя на вкладке "'''Доступ'''" необходимо разрешить "'''Возможность исполнять методы Web-API'''". 
* Перейдите в '''Администрирование''' - '''Пользователи'''.
* Выберите конкретного пользователя и перейдите на вкладку '''Доступ'''.
* Поставьте галочку напротив "'''Возможность исполнять методы Web-API'''".
* Нажмите '''Сохранить'''.
* Затем нажмите '''Применить'''.

[[Файл:Amocrm-003.png |600px| center]]

== Прием и совершение звонка ==

=== Совершение звонка ===

Для совершения звонка используйте кнопку [[Файл:Amocrm-004.png]]. Запустится сервис автодозвона, отменить не получится.

[[Файл:Amocrm-005.png |800px| center]]

В сервисе автодозвона, по умолчанию, количество попыток на автодозвон до внешнего номера равно '''50'''. Рекомендуется установить количество попыток равное '''1'''.
* Для этого перейдите в '''Общие настройки''' - '''Автодозвон'''
* Установите "'''Количество попыток на автодозвон до внешнего номера'''" равное 1.

[[Файл:Amocrm-013.png | center]]

=== Прием звонка ===

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

'''Шаг 1.''' Импортируйте сценарий для работы с amoCRM.
* Для этого перейдите в '''Администрирование''' - '''Сценарии'''. В контекстном меню выберите "'''Импортировать сценарий'''" и выберите сценарий "'''Работа с AMO CRM'''".
'''Скачать сценарий:''' [http://wiki.oktell.ru/images/c/c9/%D0%98%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F_%D1%81_AMO_CRM.oscr Работа с amoCRM.oscr]

[[Файл:Amocrm-006.png | 600px|center]]

'''Шаг 2.''' Настройте параметры подключения к amoCRM.

Откройте импортированный сценарий "'''Работа с AMO CRM'''". Введите в компоненты "'''Ваш аккаунт AMO'''" и "'''Пользователь'''" значения из настроек виджета "'''Oktell'''".

ВНИМАНИЕ: Когда вы будете вставлять выражение в компонент "'''Пользователь'''", уберите перенос строки. Значение должно быть введено в одну строку.

[[Файл:Amocrm-007.png |800px|center]]

'''Шаг 3.''' Модифицируйте главный сценарий входящей маршрутизации.

* Добавьте 2 переменные в главный сценарий:
:#'''CRM_Number''' (строковая) - номер ответственного менеджера
:#'''CRM_INFO''' (строковая) - имя контакта
:Возможен вывод другой информации по абоненту (ID контакта, название компании, ID компании, ответственный менеджер)

* Добавьте следующие элементы:

:# Компонент "'''AMO CRM'''" - запуск сценария "'''Работа с AMO CRM'''".
:# Компонент "'''Есть номер?'''" - проверяет на наличие номера оператора
:# Компонент "'''Номер из CRM'''" - присваивает номер сотрудника в переменную сценария.

* По желанию, вы можете добавить '''CallerId''' и '''CallerName''' в компоненты переключения на сотрудников.

[[Файл:Amocrm-010.png |600px|center]]

[[Файл:Amocrm-009.png |1000px|center]]

'''Шаг 4.''' При входящем звонке в '''amoCRM''' отправляется запрос на получение ответственного менеджера по этому контакту. '''amoCRM''' возвращает имя пользователя, на которого происходит переключение. Параллельно открывается карточка у данного ответственного менеджера.

[[Файл:Amocrm-012.png |center]]

'''Скачать сценарий:''' [http://wiki.oktell.ru/images/c/c9/%D0%98%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D1%8F_%D1%81_AMO_CRM.oscr Работа с amoCRM.oscr]

'''Скачать пример главного сценария:''' [http://wiki.oktell.ru/images/1/17/%D0%9C%D0%B0%D1%80%D1%88%D1%80%D1%83%D1%82%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F_%D0%B2%D1%85%D0%BE%D0%B4%D1%8F%D1%89%D0%B8%D1%85_%28amocrm%29.zip Маршрутизация_входящих_(amocrm).zip] (для версий от 2.10.140313)

== Возможные проблемы ==

ВНИМАНИЕ: Если у вас некорректно работает система, проверьте как в Oktell определяется CallerID. Используйте компонент уведомление в главном сценарии. Проверить определение '''CallerId''' в '''amoCRM''' можно с помощью web-запроса:

{Ваш аккаунт AMO}?{Ваш пользователь}&caller_number=89041112233&transliterate=Y

где '''Ваш аккаунт AMO''' и '''Ваш пользователь''' берутся из настроек виджета '''Oktell''', а номер можно определить с помощью уведомления в главном сценарии.

Например, '''https://test.amocrm.ru/private/acceptors/oktell/index.php?admin@oktell.ru&caller_number=89041112233&transliterate=Y'''

ВНИМАНИЕ: Если у вас некорректно определяется '''CallerId''' в '''Oktell''' выполните следующее:
* Перейдите в '''Администрирование''' - '''Параметры аппаратуры''' - {Выберите шлюз}.
* В поле "'''Источник определения CallerID'''" выберите, например, '''From: DisplayName'''
* Нажмите "'''Сохранить'''"

[[Файл:Amocrm-014.png |600px |center]]

Распознавание речи с помощью Google Speech API

2014-07-11T07:28:47Z

91.144.142.107:

[[Практики|Наверх]]

'''Google Speech API''' - сервис распознавания голоса Google.

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

Система: Здравствуйте. Куда вы хотите лететь?
Абонент: Казань
Система: Откуда вы хотите лететь?
Абонент: Москва
Система: Назовите дату вылета
Абонент: 10 апреля

Общение с таким голосовым порталом становится приближенным к обслуживанию оператором.

Система распознавания голосовых запросов применяется во многих системах, например, для:
* Голосовой навигации в многоуровневых меню IVR и автоматического соединения с нужным сотрудником
* Распознавания адреса для доставки
* Автоматической голосовой аутентификации пользователей при запросе персонализированной или конфиденциальной информации по телефону или через интернет
* Справочной системы информационного обслуживания
* Корпоративной системы голосового самообслуживания клиентов (запрос баланса, проверка лицевого счета, бронирование билетов)

Система распознавания речи, как правило, состоит из следующих частей:
* Запись сообщения от абонента
* Распознавание голоса и прием текстовых данных от сервиса
* Анализ полученной информации и выполнение необходимых действий

Для использования '''Google Speech API''' в вашей системе выполните следующие действия:

'''Шаг 1.''' Скачайте и импортируйте сценарии в вашу систему '''Oktell'''.

'''Скачать сценарий:''' [http://wiki.oktell.ru/images/0/05/Google_Speech_API.zip Google_Speech_API.zip] (для версий '''Oktell''' старше 2.10)

В архиве располагаются два сценария:
*'''Google_Speech_API_main''' - сценарий для записи голосового сообщения, является примером правильного использования сервиса распознавания в главном сценарии.
*'''Google_Speech_API''' - сценарий для отправки записи на сервис Яндекса и приема распознанного сообщения.

После импорта сценариев в '''Oktell''', сохраните их "'''На сервер'''"

'''Шаг 2.''' В модуле "'''Администрирование'''" - "'''Внутренние номера'''" добавьте внутренний номер с типом "'''Запуск IVR'''". Выберите IVR-сценарий '''Google_Speech_API_main'''.

[[Файл:Google Speech API-001.png|center]]

Нажмите "'''Сохранить'''". Затем "'''Применить'''".

'''Шаг 3.''' При звонке на заданный номер (в примере, '''456'''), проговорите сообщение. В конце нажмите "'''*'''". Через несколько секунд появятся уведомления с распознанным текстом.

[[Файл:Google Speech API-002.png|center]]

Полученный текст передается в переменной '''text''', которую затем можно проанализировать и выполнить необходимые действия. Используйте пример '''Google_Speech_API_main''' для использования сервиса распознавания в главном сценарии.