# Интеграция с CoMagic

**CoMagic** — это платформа для комплексной маркетинг-аналитики с широким функционалом и сервисом коллтрекинга. Система позволяет анализировать данные для повышения эффективности рекламы и увеличения продаж.

Подключение интеграции **MacroCRM** с **CoMagic** позволяет в режиме реального времени получать в MacroCRM информацию о звонках клиентов и данные о поступивших заявках из лидформ, а также раз в сутки выгружать в **CoMagic** заявки из **MacroCRM**, созданные за эти сутки, используя API-метод.

### Настройки экспорта

1\. Войдите в [**панель управления CoMagiс**](https://app.comagic.ru/)**,** используя учетные данные пользователя с правами администратора, нажмите на имя пользователя в верхнем правом углу экрана и выберите **Аккаунт***:*

![](https://help.macrodigital.ru/upload/pages/manual/integracii/marketing_i_analitika/162/cm1.png)

2\. В меню слева выберите **Правила и настройки безопасности.** На открывшейся странице переключитесь на вкладку **API.** 

Отредактируйте строку с типом **Data API** (если такая позиция отсутствует — создайте новую). 

В настройках выбранной позиции укажите значение IP/Маска **0.0.0.0/0** — это обеспечит возможность доступа к API со всех внешних ресурсов, сохраните изменения:

![](https://help.macrodigital.ru/upload/pages/manual/integracii/marketing_i_analitika/162/cm2.png)

3\. Нажмите на имя пользователя в верхнем правом углу экрана и выберите **Управление пользователями***:*

![](https://help.macrodigital.ru/upload/pages/manual/integracii/marketing_i_analitika/162/cm3.png)

4\. В списке пользователей найдите или добавьте пользователя, через которого хотите настроить интеграцию, и зайдите в редактирование:

![](https://help.macrodigital.ru/upload/pages/manual/integracii/marketing_i_analitika/162/cm4.png)

5\. В настройках пользователя в секции **Доступ к функциональности API** проставьте галочки напротив опций **Data API** и **Использовать ключ API,** установите срок жизни ключа **Вечно,** скопируйте ключ и сохраните настройки:

![](https://help.macrodigital.ru/upload/pages/manual/integracii/marketing_i_analitika/162/cm5.png)

6\. В соседней вкладке браузера откройте **MacroCRM**, перейдите в раздел <mark style="background-color:yellow;">**Интеграции**</mark>, в блоке **Маркетинг и аналитика** выберите **CoMagic** и выполните следующие действия:

* Вставьте скопированный ранее ключ доступа в поле **Токен доступа.**
* Укажите **Название воронки**, в которую требуется выгружать заявки из **MacroCRM** (воронка будет создана автоматически).
* При необходимости укажите UTM-источник, и нажмите кнопку **Создать воронку и выгрузить статусы:**

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FzkFIccGujjGlP2VLbAmf%2Fimage.png?alt=media&#x26;token=69c535cf-7e5d-41da-92a9-736971a164bb" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Важно!** \
Не теряйте ключ доступа!\
В панели управления CoMagiс нет возможности в дальнейшем просмотреть текущий ключ доступа пользователя.&#x20;

Его можно только сгенерировать заново.&#x20;

Если у вас подключены несколько интеграций с разными сервисами, то вам придется настраивать их заново, используя новый ключ.
{% endhint %}

### Настройки получения лидов

1\. Войдите в [**панель управления CoMagiс**](https://app.comagic.ru/), используя учетные данные пользователя с правами Администратора, в главном меню слева выберите **Уведомления:**

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FGAV8BvvLIF1Qavymrlov%2Fimage.png?alt=media&#x26;token=871c3278-5093-4566-ac27-b7f4223513c2" alt="" width="130"><figcaption></figcaption></figure>

2\. Добавьте новое уведомление со следующими параметрами:

* **Тип события** — Завершение звонка
* **Способы уведомлений** — HTTP
* **Метод** — POST
* **URL** — скопируйте со страницы настроек интеграции с **CoMagic** в **MacroCRM** в блоке **Настройки получения лидов**
* **Тело запроса\*** — скопируйте со страницы настроек интеграции с **CoMagic** в **MacroCRM** в блоке **Настройки получения лидов**

{% hint style="info" %}
\*Мы принимаем и формат запроса, который предоставляет CoMagic по умолчанию, но в нем отсутствуют UTM-метки, поэтому рекомендуем использовать наш формат запроса.
{% endhint %}

![](https://help.macrodigital.ru/upload/pages/manual/integracii/marketing_i_analitika/162/cm8.png)

### Настройки получения заявок из лидформ

1\. Войдите в [**панель управления CoMagiс**](https://app.comagic.ru/), используя учетные данные пользователя с правами администратора, в главном меню слева выберите **Уведомления:**

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FGAV8BvvLIF1Qavymrlov%2Fimage.png?alt=media&#x26;token=871c3278-5093-4566-ac27-b7f4223513c2" alt="" width="130"><figcaption></figcaption></figure>

2\. Добавьте новое уведомление со следующими параметрами:

* **Тип события** — Офлайн заявка
* **Способы уведомлений** — HTTP
* **Метод** — POST
* **URL** — скопируйте со страницы настроек интеграции с **CoMagic** в **MacroCRM** в блоке **Настройки получения заявок из лидформ**
* **Тело запроса\*** — скопируйте со страницы настроек интеграции с **CoMagic** в **MacroCRM** в блоке **Настройки получения заявок из лидформ.**

{% hint style="info" %}
**\***&#x41C;ы принимаем и формат запроса, который предоставляет CoMagic по умолчанию, но в нем отсутствуют UTM-метки, поэтому рекомендуем использовать наш формат запроса.
{% endhint %}

![](https://help.macrodigital.ru/upload/pages/manual/integracii/marketing_i_analitika/162/cm9.png)

### Настройки приема сообщений из чатов

1\. Войдите в [**панель управления CoMagiс**](https://app.comagic.ru/), используя учетные данные пользователя с правами администратора, в главном меню слева выберите **Уведомления:**

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FGAV8BvvLIF1Qavymrlov%2Fimage.png?alt=media&#x26;token=871c3278-5093-4566-ac27-b7f4223513c2" alt="" width="130"><figcaption></figcaption></figure>

2\. Добавьте новое уведомление со следующими параметрами:

* **Тип события** — Новый чат
* **Способы уведомлений** — HTTP
* **Метод** — POST
* **URL** — скопируйте со страницы настроек интеграции с **CoMagic** в **MacroCRM** в блоке **Настройки приема сообщений из чатов п.1.**
* **Тело запроса\*** — скопируйте со страницы настроек интеграции с **CoMagic** в **MacroCRM** в блоке **Настройки приема сообщений из чатов п.1.**

{% hint style="info" %}
**\***&#x41C;ы принимаем и формат запроса, который предоставляет CoMagic по умолчанию, но в нем отсутствуют UTM-метки, поэтому рекомендуем использовать наш формат запроса.
{% endhint %}

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FZLK7QxqwO6poSMCrxPhY%2Fimage.png?alt=media&#x26;token=d8842715-c51c-4ac3-b4e1-c87afcc55b37" alt=""><figcaption></figcaption></figure>

3\. Добавьте новое уведомление со следующими параметрами:

* **Тип события** — Новое сообщение в чате
* **Способы уведомлений** — HTTP
* **Метод** — POST
* **URL** — скопируйте со страницы настроек интеграции с **CoMagic** в **MacroCRM** в блоке **Настройки приема сообщений из чатов п.2.**
* **Тело запроса\*** — скопируйте со страницы настроек интеграции с **CoMagic** в **MacroCRM** в блоке **Настройки приема сообщений из чатов п.2.**

{% hint style="info" %}
**\***&#x41C;ы принимаем и формат запроса, который предоставляет CoMagic по умолчанию, но в нем отсутствуют UTM-метки, поэтому рекомендуем использовать наш формат запроса.
{% endhint %}

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2Fj5rBGW9vQoBfgmddxqC1%2Fimage.png?alt=media&#x26;token=8693e29a-36a0-449f-8e35-3756d84de2f5" alt=""><figcaption></figcaption></figure>

### Настройки получения тегов по заявкам

1\. Войдите в [**панель управления CoMagiс**](https://app.comagic.ru/), используя учетные данные пользователя с правами администратора, в главном меню слева выберите **Уведомления:**

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FGAV8BvvLIF1Qavymrlov%2Fimage.png?alt=media&#x26;token=871c3278-5093-4566-ac27-b7f4223513c2" alt="" width="130"><figcaption></figcaption></figure>

2\. Добавьте новое уведомление со следующими параметрами:

* **Тип события** — Проставления тега
* **Способы уведомлений** — HTTP
* **Метод** — GET
* **URL** — скопируйте со страницы настроек интеграции с **CoMagic** в **MacroCRM** в блоке **Настройки получения тегов по заявкам**
* **Тело запроса\*** — скопируйте со страницы настроек интеграции с **CoMagic** в **MacroCRM** в блоке **Настройки получения тегов по заявкам**

{% hint style="info" %}
**\***&#x41C;ы принимаем и формат запроса, который предоставляет CoMagic по умолчанию, но в нем отсутствуют UTM-метки, поэтому рекомендуем использовать наш формат запроса.
{% endhint %}

<figure><img src="https://2409287958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfkymnT1WRuXnrJRm6ZIO%2Fuploads%2FSDEuGSX3xPfh0KJ9epk0%2Fimage.png?alt=media&#x26;token=474ba388-28c6-4bd4-af21-43f6d20fb9af" alt=""><figcaption></figcaption></figure>