В этой статье мы расскажем, как подключить CRM-интеграцию Microsoft Dynamics 365 к IP-АТС 3CX.
В данный момент 3CX завершает поддержку интеграций на стороне клиента 3CXPhone и переводит все CRM-интеграции на сторону сервера АТС по технологии REST API. Это позволяет настроить интеграцию один раз для всех пользователей в интерфейсе управления 3CX. Администратору не нужно обходить все рабочие места и даже устанавливать какое-либо приложение на компьютеры пользователей — достаточно использовать браузерный веб-клиент 3CX.
При входящем вызове, в интерфейсе веб-клиента открывается мини-карточка контакта из CRM с именем, фамилией и номером телефона. В карточке есть небольшая кнопка, нажав на которую вы откроете полную карточку непосредственно в интерфейсе CRM Microsoft Dynamics 365.
Напомним, что все CRM-интеграции включены бесплатно в лицензию 3CX Pro.
Зайдите в аккаунт Microsoft Dynamics 365, а затем перейдите на портал Azure для создания приложения, необходимого для аутентификации. Перейдите в раздел Azure Active Directory > App registrations, кнопка New application registration.
![](https://habrastorage.org/getpro/habr/post_images/457/67b/464/45767b4642cdbaf79c6435be77b0aad4.png)
Укажите параметры приложения:
![](https://habrastorage.org/getpro/habr/post_images/e4f/dbb/d72/e4fdbbd722542c7b2afed3d45e176584.png)
После нажатия кнопки Create вы увидите данные приложения, в частности, Application ID, который затем указывается на стороне 3CX.
![](https://habrastorage.org/getpro/habr/post_images/1f9/2c4/3c8/1f92c43c8778c104c5754a6bf53ef215.png)
Далее нужно указать разрешения на доступ к информации в Microsoft Dynamics 365. Перейдите в Settings > Required permissions, кнопка Add.
![](https://habrastorage.org/getpro/habr/post_images/f21/5cd/61e/f215cd61ebc574bf5cebb01d4b4e79db.png)
Нажмите Select an API и выберите Dynamics CRM Online API.
![](https://habrastorage.org/getpro/habr/post_images/ecf/e40/692/ecfe40692c5b16ce098f06927b00e821.png)
Установите все доступные разрешения, а затем нажмите Select и Done.
![](https://habrastorage.org/getpro/habr/post_images/a64/393/e93/a64393e93df217a8c9142268b5d2c4b3.png)
Вы можете удалить разрешение Windows Azure Active Directory, т.к. оно не требуется для работы интеграции. Приложение аутентификации создано.
Теперь следует получить Tenant ID, который также используется на стороне сервера 3CX. Перейдите в раздел Azure Active Directory > App registrations, кнопка Endpoints.
![](https://habrastorage.org/getpro/habr/post_images/ff7/0a8/66f/ff70a866fb7e40b9407591203567ea28.png)
Зафиксируйте строку тенанта, которая присутствует в URL конечной точки. Например, OAUTH 2.0 AUTHORIZATION ENDPOINT имеет URL login.microsoftonline.com/dedc4ebb-183f-42e2-9192-92eb425a027d/oauth2/authorize. Здесь строка тенанта dedc4ebb-183f-42e2-9192-92eb425a027d.
Перейдите в раздел Параметры > CRM-интеграция, вкладка На стороне сервера и загрузите интеграцию Microsoft Dynamics 365.
![](https://habrastorage.org/getpro/habr/post_images/d0b/dde/443/d0bdde443b000091b3835400439eac89.png)
Затем в выпадающем списке выберите DynamicsCRM.
![](https://habrastorage.org/getpro/habr/post_images/563/879/e72/563879e7290dc6c03a0a22318333c04a.png)
Укажите параметры Application ID и Tenant, скопированные в предыдущих шагах. Здесь Domain — веб-адрес вашего портала Dynamics 365. Затем нажмите Авторизовать. Откроется новая вкладка с запросом разрешений для приложения.
![](https://habrastorage.org/getpro/habr/post_images/d37/4cf/391/d374cf391bc57a8eba9510a8513e0cff.png)
Нажмите Accept — под кнопкой Авторизовать появится токен авторизации. Сохраните изменения.
В конце вы можете протестировать работу интеграции, нажав кнопку Тест.
В данный момент 3CX завершает поддержку интеграций на стороне клиента 3CXPhone и переводит все CRM-интеграции на сторону сервера АТС по технологии REST API. Это позволяет настроить интеграцию один раз для всех пользователей в интерфейсе управления 3CX. Администратору не нужно обходить все рабочие места и даже устанавливать какое-либо приложение на компьютеры пользователей — достаточно использовать браузерный веб-клиент 3CX.
При входящем вызове, в интерфейсе веб-клиента открывается мини-карточка контакта из CRM с именем, фамилией и номером телефона. В карточке есть небольшая кнопка, нажав на которую вы откроете полную карточку непосредственно в интерфейсе CRM Microsoft Dynamics 365.
Напомним, что все CRM-интеграции включены бесплатно в лицензию 3CX Pro.
Настройка Microsoft Dynamics 365
Зайдите в аккаунт Microsoft Dynamics 365, а затем перейдите на портал Azure для создания приложения, необходимого для аутентификации. Перейдите в раздел Azure Active Directory > App registrations, кнопка New application registration.
![](https://habrastorage.org/getpro/habr/post_images/457/67b/464/45767b4642cdbaf79c6435be77b0aad4.png)
Укажите параметры приложения:
- Name: 3CX Server Side
- Application type: Native
- Redirect URI: https://3CX_URL/api/oauth2crm. 3CX_URL — веб-адрес сервера 3CX
![](https://habrastorage.org/getpro/habr/post_images/e4f/dbb/d72/e4fdbbd722542c7b2afed3d45e176584.png)
После нажатия кнопки Create вы увидите данные приложения, в частности, Application ID, который затем указывается на стороне 3CX.
![](https://habrastorage.org/getpro/habr/post_images/1f9/2c4/3c8/1f92c43c8778c104c5754a6bf53ef215.png)
Далее нужно указать разрешения на доступ к информации в Microsoft Dynamics 365. Перейдите в Settings > Required permissions, кнопка Add.
![](https://habrastorage.org/getpro/habr/post_images/f21/5cd/61e/f215cd61ebc574bf5cebb01d4b4e79db.png)
Нажмите Select an API и выберите Dynamics CRM Online API.
![](https://habrastorage.org/getpro/habr/post_images/ecf/e40/692/ecfe40692c5b16ce098f06927b00e821.png)
Установите все доступные разрешения, а затем нажмите Select и Done.
![](https://habrastorage.org/getpro/habr/post_images/a64/393/e93/a64393e93df217a8c9142268b5d2c4b3.png)
Вы можете удалить разрешение Windows Azure Active Directory, т.к. оно не требуется для работы интеграции. Приложение аутентификации создано.
Теперь следует получить Tenant ID, который также используется на стороне сервера 3CX. Перейдите в раздел Azure Active Directory > App registrations, кнопка Endpoints.
![](https://habrastorage.org/getpro/habr/post_images/ff7/0a8/66f/ff70a866fb7e40b9407591203567ea28.png)
Зафиксируйте строку тенанта, которая присутствует в URL конечной точки. Например, OAUTH 2.0 AUTHORIZATION ENDPOINT имеет URL login.microsoftonline.com/dedc4ebb-183f-42e2-9192-92eb425a027d/oauth2/authorize. Здесь строка тенанта dedc4ebb-183f-42e2-9192-92eb425a027d.
Настройка серверной CRM-интеграции 3CX
Перейдите в раздел Параметры > CRM-интеграция, вкладка На стороне сервера и загрузите интеграцию Microsoft Dynamics 365.
![](https://habrastorage.org/getpro/habr/post_images/d0b/dde/443/d0bdde443b000091b3835400439eac89.png)
Затем в выпадающем списке выберите DynamicsCRM.
![](https://habrastorage.org/getpro/habr/post_images/563/879/e72/563879e7290dc6c03a0a22318333c04a.png)
Укажите параметры Application ID и Tenant, скопированные в предыдущих шагах. Здесь Domain — веб-адрес вашего портала Dynamics 365. Затем нажмите Авторизовать. Откроется новая вкладка с запросом разрешений для приложения.
![](https://habrastorage.org/getpro/habr/post_images/d37/4cf/391/d374cf391bc57a8eba9510a8513e0cff.png)
Нажмите Accept — под кнопкой Авторизовать появится токен авторизации. Сохраните изменения.
В конце вы можете протестировать работу интеграции, нажав кнопку Тест.