====== Настройка интеграции с amoCRM ======

[[:module-amo-crm|обратно к списку инструкций...]]

===== Системные требования =====
  * Для использования модуля необходимо [[https://telefon.miko.ru/contacts/ | приобрести лицензии]]
  * АТС должна быть доступна на белом адресе из интернет
  * Адреса должен быть доступен по **https** протоколу, необходимо получить SSL сертификат (см. [[:module-get-ssl|lets encrypt модуль]])
  * Работа виджета проверена на браузерах семейства Chrome: **Google Chrome**, **Yandex браузер**

===== Настройка =====
  - Откройте web интерфейс MikoPBX
  - Перейдите в раздел "**Модули**" - "**Маркетплейс модулей**"
  - Установите "**Модуль интеграции с amoCRM**" {{ :module-amo-crm:amocrm-v2-1.png |}}
  - Перейдите к редактированию настроек модуля
  - На вкладке "**Настройка подключения**" заполните поле "**Адрес портала**" 
  - Сгенерируйте новый «Ключ доступа к API MikoPBX» 
  - Выполните действие "Сохранить"
  - Включите модуль
  - Выполните авторизацию на портале amoCRM. Это действие выполнит установку модуля на портал. {{ :module-amo-crm:amocrm-v2-2.png |}}
  - Модуль автоматически заполнит настройка на вкладке "Создание сущностей"  {{ :module-amo-crm:amocrm-v2-3.png |}}
  - Перейдите в интерфейс портала amoCRM
  - Откройте **amoМаркет**
  - Перейдите на вкладку "**Установленные**"
  - Откройте настройки виджета MikoPBX
  - Укажите «**Адрес сервера MikoPBX**» - публичный адрес, на котором доступна АТС
  - Заполните «**Токен**», его значение следует взять из настроек АТС «**Ключ доступа к API MikoPBX**» {{ :module-amo-crm:amocrm-v2-4.png |}}
  - Назначьте внутренние номера в разделе: «**Пользователи АТС**»
  - Сохраните настройки


===== Web hooks =====

  - Откройте **amoМаркет**
  - Перейдите по кнопке  "**WEB HOOKS**"
  - Добавьте новое правило для адреса <code>https://АДРЕС_АТС_MIKOPBX/pbxcore/api/amo-crm/v1/entity-update</code>
  - Выберите события "контакт удален" / "сделка удалена" / "компания удалена"
  - Сохраните настройки


<note tip>Web hooks позволят более оперативно синхронизировать сущности с MikoPBX</note>

<note tip>Если возникают сложности при настройке, Вы можете [[https://www.mikopbx.ru/support/ | обратиться к нам]] за помощью. </note>

===== Создание сущностей =====

Модуль может автоматически создавать следующие сущности:
  * **Контакт** - карточка клиента
    * Шаблон имени нового контакта - к примеру <code>Новый контакт <PhoneNumber></code>Параметр **<PhoneNumber>** будет заменен на номер телефона клиента. 
  * **Неразобранное**
  * **Сделка** 
    * "**Шаблон наименования**" - к примеру <code>Новая сделка <PhoneNumber></code>
    * "**Воронка**" - к ней будет отнесена сделка, 
    * "**Этап воронки**" - статус сделки в воронке
    * "**Ответственный**" - "первый, кто ответил на вызов", "последний, кто ответил на вызов"
  * **Задача** - будет создана задача с крайним сроком выполнения, срок назначается в часах, относительно даты создания задачи
    * **Наименование задачи** - можно задать в виде шаблона <code>Перезвонить по номеру <PhoneNumber></code>
    * **Ответственный по задаче** - задача будет создана только в том случае, если удалось определить ответственного. Варианты: "первый, кто ответил на вызов", "последний, кто ответил на вызов", "ответственный по умолчанию"

  * Отвеченный входящий с неизвестного номера
  * Отвеченный входящий с известного номера
  * Отвеченный исходящий на известный номер
  * Отвеченный исходящий на неизвестный номер
  * Пропущенный с неизвестного номера
  * Пропущенный с известного номера
  * Не отвеченный исходящий на известный номер

Для каждого типа звонка можно описать свое правило создания сущностей:
{{ :module-amo-crm:amocrm-v2-5.png |}}

Для каждого DID (номер компании, на который позвонил клиент). Можно создать уникальные правила создания сущностей. 

  * [[:module-amo-crm:manual| Описание функционала.. ]]
  * [[:module-amo-crm|Обратно к списку инструкций...]]