# S2

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

Интеграция включает:

* Обмен сообщениями (входящие/исходящие) через чаты
* Отправку данных о создании и изменении **сделок** и **контактов** из S2 CRM в IntellectDialog

Возможности интеграции

| Функциональность       | Описание                                                     |
| ---------------------- | ------------------------------------------------------------ |
| Чаты                   | Общение с клиентами в одном интерфейсе через IntellectDialog |
| Автосоздание контактов | Новый клиент создается автоматически в системе               |
| Поддержка сделок       | Передача событий CRM через вебхуки                           |
| Унификация каналов     | Поддержка WhatsApp, Telegram, Нельзяграмм, VK и тд           |
| История диалогов       | Хранение переписки по каждому клиенту                        |

#### Предварительные требования

* Аккаунт в IntellectDialog
* Аккаунт в S2 CRM (salesap.ru) с правами администратора
* Подключенные каналы сообщений в IntellectDialog (например, WhatsApp или Telegram)
* Доступ к разделу **Автоматизации** в S2 CRM

### Настройка интеграции чатов

#### Шаг 1. Получение API ключа в S2 CRM

1. Авторизуйтесь в S2 CRM
2. Откройте меню → **Настройки**
3. Перейдите в раздел **API**
4. Нажмите **Добавить ключ**
5. Введите название ключа и сохраните
6. Скопируйте сгенерированный ключ

<figure><img src="https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FufA18Ylb5cm6GflC7xkh%2Fimage.png?alt=media&#x26;token=e61d340c-a7cf-469c-81c2-805dccca1f23" alt=""><figcaption></figcaption></figure>

#### Шаг 2. Добавление интеграции в IntellectDialog

1. Войдите в **IntellectDialog → Настройки → Провайдеры**
2. Нажмите **Добавить провайдера**
3. Выберите из списка **S2 CRM**
4. Вставьте ранее скопированный **API ключ**
5. Сохраните провайдер

<figure><img src="https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FzidlOFlwdAR4Vk635L9s%2Fimage.png?alt=media&#x26;token=4aa9c50b-4052-4205-9745-4da1fd407417" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FO82rxyxoxV1Th9OtSU57%2Fimage.png?alt=media&#x26;token=e363fc75-bf9b-4726-8caf-f39a43ce382e" alt=""><figcaption></figcaption></figure>

#### Шаг 3. Проверка работы чатов

1. Отправьте тестовое сообщение в подключенный канал (например, WA Web или
2. &#x20;Телеграм)
3. Сообщение должно появиться в разделе Непрочитанные чаты S2
4. Ответьте клиенту через интерфейс — сообщение уйдет через выбранный канал

<figure><img src="https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FVD0k78aeyDnrdExsP0CR%2Fimage.png?alt=media&#x26;token=6c942fc2-3450-4019-926e-b6905c042201" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2Fv04xhkOzYdE1olZa8pIx%2Fimage.png?alt=media&#x26;token=e741a4ac-52c2-4f52-912e-d2c359adcfbd" alt=""><figcaption></figcaption></figure>

### Настройка вебхуков (создание/изменение сделок и контактов)

> Эта настройка позволяет передавать события CRM обратно в IntellectDialog — для синхронизации контактов и сделок.

#### Шаг 1. Откройте раздел автоматизаций в S2 CRM

1. Войдите в **Настройки → Автоматизации**
2. Нажмите **+ Добавить автоматизацию**

<figure><img src="https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FEpxVVtLhicosIt4dUTy2%2Fimage.png?alt=media&#x26;token=a9e124d4-c8d9-4a90-b7ba-045929d870a9" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FqjEoIWTwegAH34SizsiZ%2Fimage.png?alt=media&#x26;token=e9626460-4075-4a1e-83a4-9bc001c7e59a" alt=""><figcaption></figcaption></figure>

#### Шаг 2. Добавьте 4 автоматизации вебхуков

Создайте следующие автоматизации (по очереди):

| Тип события | Событие   | Метод | Данные | URL                                                          |
| ----------- | --------- | ----- | ------ | ------------------------------------------------------------ |
| Контакт     | Создание  | POST  | JSON   | `https://connect.intellectdialog.com/api/s2/{ID_провайдера}` |
| Контакт     | Изменение | POST  | JSON   | `https://connect.intellectdialog.com/api/s2/{ID_провайдера}` |
| Сделка      | Создание  | POST  | JSON   | `https://connect.intellectdialog.com/api/s2/{ID_провайдера}` |
| Сделка      | Изменение | POST  | JSON   | `https://connect.intellectdialog.com/api/s2/{ID_провайдера}` |

{% hint style="info" %}
{ID\_Провайдера} необходимо взять с Личного кабинета IntellectDialog > Провайдер S2 > ID
{% endhint %}

<figure><img src="https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2F1KetUAtYJ6wVsdmct6W7%2Fimage.png?alt=media&#x26;token=34749872-0026-46c1-8b3e-76a229590849" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1141222632-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvdtSkqUDuO5XM96AcLMV%2Fuploads%2FmNvpH1c1hCdM9CIyixYG%2Fimage.png?alt=media&#x26;token=4b82b5ee-1f81-44c4-8e78-957e64d2d8e2" alt=""><figcaption></figcaption></figure>

### Частые ошибки и решения

| Проблема                | Причина                 | Решение                          |
| ----------------------- | ----------------------- | -------------------------------- |
| Вебхуки не отправляются | Неверный URL            | Проверьте ID провайдера в ссылке |
| Чаты не отображаются    | Каналы не подключены    | Активируйте хотя бы 1 канал      |
| Ошибка авторизации      | Некорректный API ключ   | Сгенерируйте новый в S2 CRM      |
| Дубли контактов         | Нет проверки дубликатов | Настройте правила в CRM          |