Инструкция по подключению и настройке интеграции UniTalk с NCRM

API токен указан в личном кабинете NCRM в разделе “Профиль” в поле “Ваш API токен”. В случае отсутствия отображения поля “Ваш API токен” в разделе “Профиль” обратитесь в тех поддержку NCRM.

Настройка

Для внесения основных настроек необходимо перейти на страницу личного кабинета “NCRM” и выполнить следующие шаги:

• Если флажок «Создавать контакты» выключен, то при включенном флажке «Создавать сделки» сделки будут создаваться только при наличии существующих контактов.
• При включении флажка “Создавать сделки, если нет открытых” новая сделка будет создана, только если последняя созданная сделка контакта имеет закрытый статус.
• При включении флажка “Создавать сущности при исходящих звонках” в CRM-системе будут созданы контакты и сделки при совершении исходящих звонков на мобильные номера контактов. 
• При включении флажка “Создавать сущности только для отвеченных звонков” в CRM-системе будут созданы контакты и сделки только по тем телефонным звонкам, на которые ответили.
• При включении флажка “Отображать ответственного при входящих звонках в SIP клиенте” необходимо дополнительно в личном кабинете UniTalk в разделе Пользователи для каждого пользователя в блоке “Настройка SIP” включить флажок “Отображать имя абонента”.
• Для добавления ссылки на прослушивание аудио в комментарий к карточкам клиента и сделки включите флажок “Отправлять записи звонков”.
• Для создания задач на перезвон при неотвеченных входящих звонках включите флажок “Создавать задачи при пропущенных входящих звонках” и укажите тип задачи.

2. Выберите ответственных пользователей NCRM в блоке “Распределение ответственных по умолчанию”;

Блок настроек “Распределение ответственных по умолчанию” указывает кто из пользователей интегрируемой системы будет указан в качестве ответственного в случаях, когда ответственного определить не удалось, а именно:

• Операторами пропущен входящий звонок от нового клиента;
• Звонок от нового клиента обработан без участия оператора;
• Номер оператора, ответившего на звонок от нового клиента, не закреплен ни за одним из пользователей интегрируемой системы в блоке настроек “Номера телефонов операторов”.

Настройка

В блоке попарно отображены дни недели и соответствующие выпадающие списки пользователей интегрируемой системы:

3. Укажите внутренние линии и номера телефонов пользователей NCRM в блоке “Номера телефонов операторов”;

Блок настроек “Номера телефонов операторов” позволяет установить соответствие между пользователями интегрируемой системы и номерами внутренних линий или телефонных номеров, которые они используют.

Настройка

В блоке попарно отображены имена пользователей интегрируемой системы и соответствующие текстовые поля:

В случае когда при обработке звонка необходимо создать или изменить сущность интегрируемой системы, ответственный выбирается на основании номера оператора, который получил или осуществил данный звонок. Если такое соответствие установить не удалось, ответственный выбирается на основании настройки блока “Распределение ответственных по умолчанию”.

При обработке входящего звонка по входящему сценарию и использованию перенаправления “На ответственного менеджера” с опцией “В CRM системе” осуществляются запросы к интегрированным системам на предмет присутствия в них соответствующих номеру абонента записей и ответственного менеджера в них. Если такая запись найдена, звонок перенаправляется на первый указанный в блоке “Номера телефонов операторов” номер:

4. Если в блоке “Настройки” включена опция “Создавать сделки”, необходимо выбрать в каких воронках и этапах будут создаваться сделки в блоке “Распределение сделок с источников по воронкам”:

Блок настроек “Распределение сущностей с источников по сегментам” позволяет указать в каких сегментах интегрированной системы будут создаваться сущности.

Сегменты — внутренние категории сущностей интегрированной системы, например воронки, этапы, статусы и прочее

Сегменты и сущности варьируются в зависимости от интегрированной системы и полноты интеграции и отражены в названии блока.

Настройка

В общем случае, в блоке в несколько столбцов отображены источники проекта и соответствующие им поля выбора различных сегментов сущностей интегрируемой системы:

Каждое из полей является выпадающим списком, перечень допустимых значений соответствует тому, что представлен для конкретного сегмента в интегрируемой системе:

Некоторые сегменты могут быть связанными. Так, например, выбранная воронка сделок может определять перечень допустимых этапов

В рамках подключенной интеграции с NCRM доступно заполнение полей Сделок и Контактов.

Блок настроек “Заполнение полей сущности” позволяет указать значения, которыми будут заполняться поля сущности при создании. В рамках настройки интеграции могут присутствовать несколько таких блоков, каждый из которых соответствует одной из сущностей интегрируемой системы. Сущность, к которой применяется настройка, указана в названии блока. Блоки скрываются, если подходящие для заполнения поля не были найдены в сущностях интегрируемой системы.

Настройка

В блоке в несколько столбцов отображены названия доступных к заполнению полей соответствующей сущности интегрируемой системы:

В поле допускается введение значения из перечня, определенным самой интегрируемой системой;

• Поле заполняется одним из динамических значений UniTalk;
• Поле заполняется статическим значением, которое указывается вручную.

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

Например, при создании сущности на основании входящего звонка отсутствуют значения связанные с обзвонами

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

Требования NCRM к заполнению полей:

• Значение поля типа “Флаг” может быть или “0” (Выключено) или “1” (Включено);
• Значение поля типа “Дата” необходимо вводить в формате “гггг-мм-дд“ (Например, 2024-01-01).
  

Для автоматического исполнения обработчика события при создании сделки или изменении ее статуса на указанный выберите соответствующий обработчик события.

На каждое событие можно настроить выполнение максимально одного вебхука или не указывать его вообще. 

Статусы сделки отображаются по всем существующим воронкам в СРМ.

В появившейся форме заполните необходимые поля:

• тип процесса: “Веб хук”;
• условие: “Сделка создана”, “Сделка: смена этапа”; 
• URL: укажите заранее скопированный URL адрес со страницы настройки интеграции с NCRM. URL содержит в себе поддомен (subdomain), который необходим для подключения интеграции и служит для определения, в каком проекте необходимо выполнить действия.