# ClubIS

{% embed url="<https://www.youtube.com/watch?v=wNXBNd9OBCE>" %}

Наш адрес: 162.55.134.176. Необходимо добавить в белый список

## Подключение

ВАЖНО! Подключение служб нужно производить ТОЛЬКО на сервере, ни в коем случае нельзя использовать для подключения интеграции случайную машину с установленным на ней CRM ClubIS.

Проверка версии CRM ClubIS, должна быть минимум 16676:

![](https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FYq3MUJE1ezRfperfZzQq%2Fimage.png?alt=media\&token=b14630f9-d842-4aba-9ba0-da389834b1e8)

Подключение:

1. Переходим в пункт меню “Администратор“

![](https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FMyyuwenp2jC13W2pJEhj%2Fimage.png?alt=media\&token=249e9305-e93c-480f-aa54-34db34a6ae4a)

2\. Переходим в раздел “Справочники“, раскрываем выпадающий список, находим пункт “Операторы рассылок”:

![](https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FlpwUZCWToxNTMcFWYURb%2Fimage.png?alt=media\&token=eb51d6c3-6827-4fab-8a46-af158d16bc0d)

3\. Кликаем 2 раза на IntellectDialog, открывается окно “Свойства оператора рассылок”.

![](https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FUEkNrvZ77EbTarItMRda%2Fimage.png?alt=media\&token=831a788e-2786-47de-9410-0f92cc2fa607)

4\. В окно на скрине выше вводим API Key из платформы IntellectDialog, для этого на платформе заходим в раздел “Организации”, проваливаемся в организацию и копируем API Key

&#x20;

![](https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FI8S8hkZXE6LHrbA6vVfT%2Fimage.png?alt=media\&token=f601b8d3-7a17-4932-ad3c-45e3ef0a3765)

5\. Во избежание снижения скорости отправки сообщений рекомендуем прописать вебхук на платформе IntellectDialog.

Внимание! Необходимо активировать web-service в разделе “Настройка служб”.

![](https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FEAArIDTCwnqbkHvTePN0%2Fimage.png?alt=media\&token=61701d71-ed3d-4b42-89dd-daa6186072ae)

![](https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FXEPlLzFQ8HLHzUDWMcFN%2Fimage.png?alt=media\&token=348a63e0-e896-427b-a29c-a1720a020c3a)

Вебхук составляется следующим образом:

<http://внешний> IP:номер порта/intellectdialog

При этом правильность составления вебхука можно проверить следующим образом:

вместо /Intellectdialog подставляем /api и вставляем в новой вкладке в браузере. Если ответ будет: not authorized, то вебхук прописан верно.

![](https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FgwTyxEzDyG1nALMLU2CE%2Fimage.png?alt=media\&token=a323ed88-635d-4fa5-9836-6b62db1f37b9)

Вебхук на платформе IntellectDialog прописывается в разделе “Организации”:

![](https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FrJAQ7B0ZZiMVGp7Cvj4Y%2Fimage.png?alt=media\&token=dd136ba2-0d1b-4a49-99ca-6d13fd2281ff)

Здесь же в строке Webhook Events необходимо прописать: new\_message

![](https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FS9Lk5s3Vn4ekgfQo8aLO%2Fimage.png?alt=media\&token=48f16795-9325-42aa-9aac-ab27e61941e0)

## Работа с чатом

6\. Далее для работы с чатом в ClubIS переходим в раздел “Менеджер“ через “Отчеты”

![](https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2Fdjl5SM9O8OiqXrYp1z0V%2Fimage.png?alt=media\&token=4b9a5cd6-6f4d-48f9-a117-0e0008f3f81e)

7\. Переходим во вкладку “Чат“

![](https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FwOi8r4E13Q7PnpuNnXhU%2Fimage.png?alt=media\&token=901b56ef-0949-443d-a0ca-1fc822227398)

![](https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FScfxSSNr8peR0UG8OiDu%2Fimage.png?alt=media\&token=c0aa2d94-f88b-4e37-a5f2-0bbaef2ab502)

* Анкета - поиск анкеты клиента для привязки мессенджера

![](https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2Fhv92RUkEhSEEkYf3gsuC%2Fimage.png?alt=media\&token=047b9a30-227b-48b7-bc10-860364ab88ac)

Доступные фильтры:

![](https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2Fqinu85bMHjooCJKu4GjF%2Fimage.png?alt=media\&token=c60e0b8b-baaa-4ce3-a58d-59b19dfbcf97)

Назначить сотрудника - привязываем к чату с клиентом нужного нам сотрудника

![](https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2F3SpNwgJ76QfBGlWXOF6u%2Fimage.png?alt=media\&token=0194a7c9-974a-4026-9219-e0855c2bdaa1)

## Запуск триггерных рассылок <a href="#triggernye-rassylki" id="triggernye-rassylki"></a>

Внимание: для корректной работы триггерных рассылок необходимо активировать event-service:

![](https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FGNaGnGrhZQug94Jn0O2e%2Fimage.png?alt=media\&token=96ba9c9c-2f9a-4062-b207-900abc87d567)

1. Переходим в раздел “Настройки“, далее пункт меню “Триггеры“

![](https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FLqVoSxWDXoY3DzKug4nn%2Fimage.png?alt=media\&token=7b725a8a-c74a-437c-a775-d8c3c901f724)

2\. Нажимаем кнопку “Добавить“

![](https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2F9rEpHrwMNLkN0ptft2uK%2Fimage.png?alt=media\&token=e6ce1651-135d-42a8-b64c-7c7253a23bdf)

![](https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FAQ0POfmJbZzm2mPfWXmd%2Fimage.png?alt=media\&token=2e9a973e-9b28-4177-abd3-d09e22a2b2ee)

### Параметры триггерных рассылок:

* Название - Просто название триггера чтобы его можно было легко отличить от остальных
* Условие - Условие срабатывания триггера. Настраивается на двух отдельных вкладках в диалоге редактирования триггера. На вкладке "Основные настройки" выбирается тип и подтип условия. Если у типа условия есть дополнительные настройки, то их можно изменить на другой вкладке диалога "Условие триггера". Типы условий сгруппированы в подгруппы связанные по смыслу чтобы нужное условие можно было легче найти.
* Отмена события - Данное свойство определяет разрешена ли автоматическая отмена события. Автоматическая отмена событий будет подробно описана позднее.
* Описание - Произвольное описание триггера
* Порядок - Определяет порядок сортировки триггеров в справочнике "Триггеры"
* Активно - Активен ли данный триггер. Если триггер не активен, то при срабатывании условия триггера событие триггера не будет создано и соответственно никакие действия выполнены не будут.

### Условие триггера <a href="#uslovie-triggera" id="uslovie-triggera"></a>

Содержимое данной вкладки зависит от выбранного типа триггера. На этой вкладке всегда есть короткое описание условия срабатывания триггера. Если у выбранного типа условия триггера есть дополнительных настройки, то они будут расположены на этой вкладке. Например, у типа условия "При внесении депозита" можно настроить минимальную сумму при которой сработает триггер и типы оплаты при которых сработает триггер.

### Параметры отбора <a href="#parametry-otbora" id="parametry-otbora"></a>

На данной вкладке можно настроить фильтры которые определяют к каким из клиентов применим данный триггер. Фильтры на данной вкладке аналогичны фильтрам применимости задач и рассылок. Фильтровать клиентов можно по следующим параметрам:

* По типу анкеты
* По шаблону контракта
* По состоянию контракта
* По этапу воронки
* По полу
* По признаку новый это клиент или продленный

### Время срабатывания <a href="#vremya-srabatyvaniya" id="vremya-srabatyvaniya"></a>

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

* Задержка выполнения - С помощью этого параметра можно отсрочить выполнение триггера. Например если указана задержка выполнения два дня, то при срабатывании триггера событие триггера будет обработано не сразу, а через два дня после срабатывания триггера. Пока событие не будет обработано сервисом никакие действия также не будут запланированы и выполнены. Например если нужно послать клиенту сообщение по смс через 2 месяца после создания анкеты, то можно создать триггер с условием создание анкеты и указать задержку срабатывания 2 месяца.
* Ограничение по давности - Позволяет указать срок давности у триггера. Если у триггера указан срок давности 1 день и за этот день событие триггера не было обработано (Может быть сервис триггеров был выключен в это время), то истечения после этого срока это событие не уже не будет обработано, а будет просто удалено.
* Ограничение по времени исполнения - Указывает временной промежуток когда разрешено обрабатывать события триггера.
* Ограничение по периоду исполнения - Указывает промежуток дат когда разрешено обрабатывать события триггера.
* Ограничить дни недели - Указывает дни недели когда разрешено обрабатывать события триггера

### Использование пользовательских переменных. Маркеры <a href="#markery" id="markery"></a>

На данной вкладке можно выбрать какие из маркеров доступны для действий. Маркеры это флажки в тексте, которые будут заменены на соответствующую информацию о клиенте, контракте или событии. Например этот маркер будет заменен на фамилию клиента: %firstname%. Маркеры могут использоваться в тексте рассылок, задач, сообщений и заметок создаваемых триггером. При срабатывании действия будут заменены только те маркеры которые включены на данной вкладке. После выбора маркеров нажмите Сохранить.

### Назначние аккаунта мессенджера для триггера <a href="#deistviya" id="deistviya"></a>

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

Редактирование данной вкладке возможно только если триггер сохранен.

#### Настройки действия <a href="#nastroiki-deistviya" id="nastroiki-deistviya"></a>

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

![](https://support.club-is.ru/support/fitness/wiki/images/thumb/1/1b/%D0%A1%D0%BA%D1%80%D0%B8%D0%BD%D1%88%D0%BE%D1%82_15-10-2020_115359.jpg/800px-%D0%A1%D0%BA%D1%80%D0%B8%D0%BD%D1%88%D0%BE%D1%82_15-10-2020_115359.jpg)

Вкладка "Основные настройки" содержит настройки следующих параметров:

![](https://support.club-is.ru/support/fitness/wiki/images/thumb/e/e4/%D0%A1%D0%BA%D1%80%D0%B8%D0%BD%D1%88%D0%BE%D1%82_15-10-2020_115624.jpg/500px-%D0%A1%D0%BA%D1%80%D0%B8%D0%BD%D1%88%D0%BE%D1%82_15-10-2020_115624.jpg)

* Отмена действия - Данное свойство определяет разрешена ли автоматическая отмена действия. Автоматическая отмена действий будет подробно описана позднее.
* Описание - Произвольное описание действия
* Порядок - Определяет порядок сортировки действия на вкладке "Действия" в настройках триггера.
* Активно - Активно ли данное действие. Если действие не активно, то при обработке события триггера выполнение этого действия не будет запланировано и выполнено.

Вкладка "Время срабатывания"

![](https://support.club-is.ru/support/fitness/wiki/images/thumb/0/0d/%D0%A1%D0%BA%D1%80%D0%B8%D0%BD%D1%88%D0%BE%D1%82_15-10-2020_115632.jpg/500px-%D0%A1%D0%BA%D1%80%D0%B8%D0%BD%D1%88%D0%BE%D1%82_15-10-2020_115632.jpg)

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

#### Возможные действия <a href="#vozmozhnye-deistviya" id="vozmozhnye-deistviya"></a>

* Создать задачу - данное действие создает задачу при срабатывании триггера. Почти все настройки аналогичны настройкам обычного шаблона задачи и любой шаблон задачи может быть привязан к триггеру и конвертирован в действие. У действия создания задачи в отличие от шаблона задачи недоступна вкладка "Параметры отбора", так как аналогичные фильтры есть в настройках триггера к которому привязано действие. В тексте задачи можно использовать включенные в триггере маркеры.

  &#x20;
* Создать рассылку - данное действие создает рассылку при срабатывании триггера. Рассылка может быть смс, e-mail или IntellectDialog. Почти все настройки аналогичны настройкам обычного шаблона рассылок и любой шаблон рассылок может быть привязан к триггеру и конвертирован в действие. У действия создания рассылки в отличие от шаблона задачи недоступна вкладка "Параметры отбора", так как аналогичные фильтры есть в настройках триггера к которому привязано действие. Также в отличие от обычного шаблона рассылок в настройках действия создания рассылки нужно указать тип сообщения. Еще одним отличием от обычных рассылок является то что у действия создания рассылки можно указать кто именно является получателем сообщения. Например получателем сообщения может быть либо сам клиент, либо его менеджер, либо родственник и т.д. Подробнее получатели будут описаны позднее. В тексте рассылки можно использовать включенные в триггере маркеры.

&#x20;

&#x20;

&#x20;

## Загрузка новых заявок в Clubis через IntellectDialog <a href="#title-text" id="title-text"></a>

### Подключение провайдера “ClubIS“ внутри IntellectDialog

1. Перейдите в раздел “Провайдеры“, нажмите кнопку “Добавить“
2. Выберите “ClubIS“ и нажмите на него
3. Укажите следующие параметры
   * Наименование - любое значение

   * domain - опубликованный веб-сервис ClubIS с указанным портом, инструкция публикации в [основном разделе ClubIS](https://intellectdialog.atlassian.net/l/c/U3kHx21Y). Пример: [http://XX.XX.XXX.XXX:XX/](http://46.23.155.173:81/intellectdialog)

   * user\_id - это созданный пользователь в ClubIS через который происходит интеграция

     * Заходим в ClubIS
     * Администратор - Сотрудники - Создать сотрудника

       <img src="https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2Ft4eyBL3IpwN2s86bUZon%2Fimage.png?alt=media&#x26;token=a6e9afef-30ae-492d-8fcd-d88b4d55da19" alt="" data-size="original">
     * В карточке создания сотрудника “в разделе Общие“ указываем:

       <img src="https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FyJeNhoYJoGBa8ehzFb9d%2Fimage.png?alt=media&#x26;token=5045279d-e783-418e-8cac-baccb7427b85" alt="" data-size="original">
     * После сохранения, нажимаем правой кнопкой мыши на ранее созданного нам пользователя и задаем пароль

     <img src="https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FvHjnaBn9yQlnR2ysdYhZ%2Fimage.png?alt=media&#x26;token=4d79c6e6-e073-4eb6-b74c-b159ef37af34" alt="" data-size="original">

   * user\_hash - это **ХЕШ** в ранее созданном пользователе в ClubIS через который происходит интеграция

     * Для его получения еще раз в ClubIS заходим в настройки пользователя, переходим в раздел “Прочее“ и копируем **ХЕШ**

     ![](https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FSfz7NzXc5tquvBvARClo%2Fimage.png?alt=media\&token=9a67338f-c9c7-4f06-81a5-746e877dad27)
4. Проверяем введенные настройки и нажимаем кнопку “Сохранить“

![](https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FwAkh8KLv2SVYahaKAwpN%2Fimage.png?alt=media\&token=4c25fdbe-81ad-4773-9090-43739d0d2d4b)

Интеграция завершена

Далее переходи в раздел “Связки” и создаем нужные интеграции для загрузки заявок из внешних источников, таких как: сайт, лендинг, марквиз, лид-формы в Instagram и ВК.

<br>

&#x20;

&#x20;
