====== ИНТЕГРАЦИЯ СОФТФОНА С КОНФИГУРАЦИЯМИ CRM ======
<note important>Руководство составлено для SIP софтфона версии 2.X.14.2 и **может быть не актуальным** для других версий.\\
Прежде чем приступить к выполнению действий из данного руководства, сделайте **РЕЗЕРВНУЮ КОПИЮ** информационной базы. Руководство содержит подробные пошаговые инструкции. Однако, если Вы не уверены в том, что делаете, то доверьте эту работу специалистам. Наша компания не несет ответственности за потерю данных вызванную неверными действиями пользователей.</note>

Данное практическое руководство демонстрирует процесс встраивания софтфона в конфигурацию не имеющую встроенного блока CRM. Инструкция одинаково подходит для:
  * 1С:CRM, редакция 2.0;
  * Управление торговлей и взаимоотношениями с клиентами (CRM), редакция 2.0.

Что дает интеграция в сравнении с без интеграционным режимом работы?
  - **Ведется журналирование** входящих и исходящих звонков.
  - Не нужно выполнять каких-либо дополнительных действий при запуске системы. Софтфон **начинает работу сразу** после запуска 1С в свернутом виде.
  - Работа продолжается даже после закрытия окна софтфона. Если **поступит** входящий **звонок, окно** софтфона **отобразиться на экране**.

===== Этап 1. Настройка правил поддержки =====

Для начала следует разблокировать головной объект конфигурации для внесения изменений.

Порядок действий следующий.
  - **Запустите** программу в режиме **"Конфигуратор"**.
  - Откройте окно **настройки поддержки**. {{ :doc:panel1ccrm20:support.png?nolink |}}
  - **Включите** возможность **изменения конфигурации**. На предупреждение программы ответьте утвердительно.
  - В появившемся окне укажите, что **объекты поставщика не редактируются**. {{ :doc:panel1ccrm20:rules.png?nolink |}}
  - Для интеграции понадобится внести изменения в следующие объекты конфигурации: \\ - общий модуль //"ОбщегоНазначенияКлиентПереопределяемый"//; \\ - команда //"ОткрытьСофтФон"// обработки //"сфпСофтФонВнешняяПанель"//. \\ Для указанных объектов следует установить правило поддержки на //"Объект поставщика редактируется с сохранением поддержки"//. {{ :sip:headerrules.png?nolink |}}

Теперь конфигурация готова к внесению изменений.

===== Этап 2. Встраивание софтфона =====

Необходимо встроить внешнюю обработку (софтфон) в конфигурации, настроить права доступа и автоматический запуск в фоновом режиме.
==== Изменение типовых объектов ====

Для работы софтфона в фоне и его автоматического запуска внесем изменения в модуль управляемого приложения.
  - Откройте общий модуль //"ОбщегоНазначенияКлиентПереопределяемый"//.
  - Перейдите к процедуре //"ПриНачалеРаботыСистемы"//.
  - Сразу после текста <code 1c>
//+СофтФон
Если НЕ ПользователиКлиентСервер.ЭтоСеансВнешнегоПользователя() И сфпСофтФонПроСервер.сфпИспользоватьСофтФон() Тогда
</code> вставьте код приведенный ниже. <code 1c>
// SP1C / Инициализация софтфона / Начало
НазваниеПанелиТелефонии = "Софтфон (МИКО)";
МИКО_Софтфон.ВыполнитьПервичнуюУстановку(НазваниеПанелиТелефонии);

//#Если НЕ ВебКлиент Тогда
Если МИКО_Софтфон.Использовать(НазваниеПанелиТелефонии) Тогда
		
	Попытка
		// Получим форму инциализации софтфона
		ОткрытьФорму("Обработка.МИКО_СофтФон.Форма", Новый Структура("Интегрирован", Истина));
	Исключение
		// Нет прав на обработку
	КонецПопытки;
			
//#КонецЕсли
</code> Также следует изменить условие следующие непосредственно ниже вставленного кода <code 1c>
// Исходынй код / Если сфпСофтФонПроСервер.сфпПолучитьЗначениеПоУмолчаниюПользователя("ИспользоватьСофтФон") Тогда
ИначеЕсли сфпСофтФонПроСервер.сфпПолучитьЗначениеПоУмолчаниюПользователя("ИспользоватьСофтФон") Тогда
// SP1C / Инициализация софтфона / Конец
</code>
  - Перейдите к процедуре //"ПередЗавершениемРаботыСистемы"//. В конец процедуры вставьте код приведенный ниже. <code 1c>
// SP1C / Завершение работы софтфона / Начало
Если Отказ = Ложь И сфпФормаТелефонВнешняяПанель <> Неопределено Тогда
	сфпФормаТелефонВнешняяПанель.ЗавершитьРаботу();
КонецЕсли;
// SP1C / Завершение работы софтфона / Конец
</code>
  - Создайте общий модуль //"МИКО_Софтфон"//. Установите параметры модуля как показано на рисунке. {{ :doc:panel1ccrm20:moduleproperties.png?nolink |}}
  - Скопируйте [[astpanel:designer:crm2:modulesrc|текст, расположенный по данной ссылке]], и вставьте его в модуль.

==== Добавление обработки в конфигурацию ==== 
  - **Вставьте внешнюю обработку**, которая идет в поставке, в конфигурацию. Назовите ее //"МИКО_СофтФон"//.
  - **Откройте** команду //"ОткрытьСофтФон"// обработки //"сфпСофтФонВнешняяПанель"//.
  - В начало процедуры //"ОбработкаКоманды"// вставьте код <code 1c>
// SP1C / Откроем тот софтон, который испольуется в данный момент
	Если Тип(сфпФормаТелефонВнешняяПанель) = Тип("УправляемаяФорма") И сфпФормаТелефонВнешняяПанель.ИмяФормы = "Обработка.МИКО_СофтФон.Форма.Форма" Тогда
		Если сфпФормаТелефонВнешняяПанель.Открыта() Тогда
			сфпФормаТелефонВнешняяПанель.Активизировать();
		Иначе
			сфпФормаТелефонВнешняяПанель.Открыть();
		КонецЕсли;
		
		Возврат;
	КонецЕсли;
	// SP1C / Откроем тот софтон, который испольуется в данный момент
</code>

==== Настройка ролей ====

  - **Добавьте** в конфигурацию новую **роль** //"МИКО_ИспользованиеСофтфона"//.
  - **Снимите** все **отметки** о правах выставляемые **по умолчанию**.
  - Для обработки //"МИКО_СофтФон"//, обработки //"сфпСофтФонВнешняяПанель"//, а также для команды //"ОткрытьСофтФон"// **отметьте все** доступные **права**.
  - Обновите конфигурацию базы данных. {{ :doc:panel1ccrm20:confupd.png?nolink |}}

===== Этап 3. Создание журнала звонков =====

История совершенных звонков хранится в периодическом регистре сведений. Каждой записи присваивается уникальный идентификатор, по которому ее можно однозначно идентифицировать и связать с документом "Событие".

**Создайте** новый **регистр** //СофтФон_ИсторияЗвонков//. В параметре **Периодичность** укажите значение **В пределах секунды**.

Структура регистра показана на рисунке слева. {{:sip:registr_svedenij.png? |}}
       * Измерение **Пользователь**. Тип **СправочникСсылка.Пользователи**. Индексировать.
       * Ресурс **НомерТелефона**. Тип **Строка**, длина **20**, допустимая длина **Переменная**.
       * Ресурс **Входящий**. Тип **Булево**.
       * Ресурс **Аккаунт**. Тип **Строка**, длина **25**, допустимая длина **Переменная**.
       * Ресурс **Продолжительность**. Тип **Число**, длина **6**, точность **0**, неотрицательное **Истина**.
       * Реквизит **id**. Тип **Строка**, длина **36**, допустимая длина **Фиксированная**.

**Настройте** ранее созданную **роль** //"МИКО_ИспользованиеСофтфона"// для чтения и записи в регистр. Однако, интерактивное редактирование записей следует запретить. Также следует **создать форму** записи регистра и установить ее свойство //"Доступность"// в //"Ложь"//. В противном случае пользователи с полными правами смогут изменять записи журнала звонков.

Обновите конфигурацию базы данных и запустите программу в режиме //"Предприятие"//.

===== Этап 4. Предварительная настройка CRM =====

{{page>astpanel:designer:crm2:userconfig}}

===== Первый запуск типового решения =====

При первом запуске будет автоматически открыт **“Помощник первоначальной настройки”**. Вам необходимо следовать шагам, указанным ниже.