Отображение информации о клиенте из 1С (8.3.21 и выше)

Softphone.Pro легко интегрируется с 1С "Управление торговлей". Все данные о клиентах, хранящиеся в 1С "Управление торговлей", становятся доступны при звонке через софтфон.

Интеграция с 1С доступна в Softphone.Pro начиная с версии 4.11.

Если вы используете версию платформы 1С 8.3.20 и ниже, пожалуйста, используйте данную инструкцию.

1. Добавление расширения в конфигурацию 1С

Мы рекомендуем привлекать к работам квалифицированных специалистов 1С, которые хорошо знакомы с конфигурацией 1С, в которую устанавливается расширение.

1.1. Откройте базу 1С «Управление торговлей» версии 11 под пользователем с правами Администратора.

Если вы пользуетесь другой конфигурацией, другой версией конфигурации «Управление торговлей» или другой версией платформы 1С, то алгоритм действий и внешний вид экранов могут значительно отличаться.

1.2. Выберите в главном меню Сервис - Параметры:

Открыть окно Параметры в 1С

1.3. В открывшемся окне включите опцию Отображать команду - Все функции, нажмите кнопки Применить и OK:

Включение отображения Всех функций

1.4. В основном меню 1С откройте пункт меню Все функции:

Открыть Все функции

1.5. В окне Все функции перейдите в самый низ списка, в пункт Стандартные, и выберите пункт Управление расширениями конфигурации:

Открыть Управление расширениями

1.6. Скачайте расширение конфигурации softphoneContact_8.3.21.cfe.

1.7. В открывшемся окне Управление расширениями конфигурации нажмите кнопку Добавить. Выберите файл расширения softphoneContact_8.3.21.cfe, скачанный в пункте 1.6.

Открыв расширение конфигурации первый раз, вы увидите несколько предупреждений. Ответьте на все вопросы так, как показано ниже:

Вопрос при добавлении расширения

Вопрос при добавлении расширения

Если после закрытия окон с вопросами расширение не появилось в окне Управление расширениями конфигурации, повторите действия пункта 1.7 с самого начала.

Вы увидите, что расширение добавлено:

Добавленное расширение

Перезапустите 1С после добавления расширения конфигурации.

1.8. Для работы интеграции между 1С и Softphone.Pro вам необходимо:

  • создать пользователя для работы HTTP-сервиса расширения;
  • опубликовать HTTP-сервис расширения;
  • указать пользователя сервиса в vrd файле публикации.

Как это сделать, вы можете узнать из документации по настройке 1С или у вашего специалиста по 1С.

Опубликованный сервис должен быть доступен с внешних ресурсов по HTTPS.

Для работы с расширением у пользователя, которого вы указали в vrd файле, должна быть роль Полные права или Softphone: Поиск контакта.

2. Настройка расширения

2.1. После публикации HTTP-сервиса откройте 1С.

2.2 Перейдите к настройкам расширения, настройки расширения расположены в разделе Softphone: Поиск контакта:

Откройте настройки расширения

2.3. Откроется форма, в которой вам необходимо указать настройки для взаимодействия с вашей 1С:

Откройте настройки расширения

Адрес веб сервера – адрес опубликованной базы 1С. Параметр необходим для того, чтобы кликнув по имени контакта в окне входящего звонка в софтфоне вы смогли перейти в карточку контакта в 1С (база 1С будет открыта в браузере). Обратите внимание, что адрес публикации базы не обязательно должен совпадать с адресом публикации HTTP-сервиса расширения.

Секретное слово - используется для подписи токена, задайте любое значение.

Base64 - зашифрованное секретное слово. Укажите это значение в vrd-файле опубликованного расширения, в секции настроек <accessTokenAuthentication>, в поле issuer.keyInformation. Подробную информацию о параметрах публикации вы можете узнать из документации по настройке 1С или у вашего специалиста по 1С.

Token – введите Секретное слово и кликните в любом поле настроек интеграции, после этого поле заполнится автоматически. Скопируйте полученный токен, он понадобится вам для выполнения настроек на стороне Softphone.Pro.

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

Если вы включили Подробное логирование работы расширения, вы можете просмотреть лог работы в Разделе Журнал регистрации. В режиме 1С Предприятие журнал операций можно найти в разделе меню Администрирование — Настройки программы — Обслуживание:

Расширенное логирование

3. Настройка софтфона

3.1. В окне настроек перейдите на страницу Интеграция – 1С:

Настройки интеграции в Softphone.Pro

В открывшемся окне укажите:

Сервер – адрес опубликованного ранее расширения (без префикса https://), добавьте в конце адреса строку /hs;

Ключ авторизации – значение параметра Token из настроек расширения 1С, которое вы скопировали на шаге 2.3.

3.2. После указания необходимых настроек нажмите кнопку Подключить. Если всё настроено корректно, вы увидите сообщение Аккаунт подключен и кнопка изменится на Отключить.

При возникновении ошибок при подключении интеграции, пожалуйста, проверьте правильность установки и настройки расширения конфигурации 1С (пункты 1.7, 2.3), а также публикации HTTP-сервиса этого расширения (пункт 1.8). Мы рекомендуем привлекать к работам квалифицированных специалистов 1С, которые хорошо знакомы с конфигурацией 1С, в которую устанавливается расширение.

4. Проверка работы интеграции

4.1. Сделайте тестовый звонок и проверьте, что в окне Входящего звонка отобразились данные из 1С:

Уведомление о звонке в Softphone.Pro

4.2. Проверьте, что информация о контакте отображается в окне Активные звонки:

Активные звонки в Softphone.Pro

4.3. Проверьте, что информация о контакте отображается в окне Журнал звонков:

Журнал звонков в Softphone.Pro