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

Интеграция позволяет боту находить и сохранять контакты, создавать сделки и задачи, менять разрешённые статусы, добавлять заметки и возвращать ссылки на карточки ELMA365.

Для подключения нужны права администратора ELMA365, модуль ChatRex AI Connector, доступ к API и выбранным приложениям, а также подписка на интеграцию в ChatRex. Подписка оформляется отдельно в ChatRex. Штатные приложения CRM могут требовать отдельную лицензию ELMA365. Можно выбрать собственные приложения компании с совместимыми полями и связями.

Интеграция работает с CRM-данными. Канал «Линии» и запуск бота по событиям ELMA365 в этой версии не подключаются.

# Установка и OAuth-клиент

1. Установите ChatRex AI Connector в нужную компанию ELMA365. Для полученного от ChatRex файла .e365 откройте Администрирование → Модули → + Модуль → Загрузить файл. Выберите архив и нажмите Далее. Проверьте название модуля, дождитесь завершения проверок и продолжите установку. После сообщения об успешной установке нажмите Перейти в Модуль. Перед обновлением сохраните резервную копию конфигурации компании.
2. В ChatRex откройте Интеграции → Подключить интеграцию → Источники данных → ELMA365. Скопируйте Адрес возврата в ChatRex.
3. В ELMA365 откройте настройки модуля через значок шестерёнки, затем вкладку Внешнее приложение. Включите внешнее приложение и используйте шаблон ChatRex CRM API с разрешением api.
4. В модуле раскройте раздел Токены и нажмите Создать клиент OAuth2/OIDC. Выберите внешнее приложение ChatRex CRM API. В поле URI перенаправления вставьте скопированный адрес возврата. Сохраните идентификатор и секрет клиента.
5. Для авторизации используйте отдельного пользователя ELMA365 с доступом только к нужным приложениям и записям. Для действий записи потребуются права создавать и изменять записи, менять разрешённые статусы и добавлять комментарии в ленту.

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

Пароль пользователя ELMA365 не передаётся в ChatRex. Секрет OAuth-клиента вводится только в настройке подключения; не включайте его в промпт бота или текст обращения клиента.

# Подключение компании

1. В настройке ELMA365 в ChatRex введите HTTPS-адрес компании, Идентификатор OAuth-клиента и Секрет OAuth-клиента.
2. Нажмите Подготовить подключение, затем Открыть авторизацию ELMA365.
3. Войдите в нужную компанию и разрешите доступ. Вернитесь в ChatRex.
4. Нажмите Проверить подключение. После успешной авторизации станет доступно сопоставление приложений.
5. Если открывается выбор подписки, оформите подходящую подписку штатным способом.

Ссылка авторизации действует 10 минут. Если она истекла или доступ отклонён, подготовьте подключение заново. Если адрес возврата не отображается, обратитесь в поддержку ChatRex.

# Сопоставление CRM

Выберите приложения вашей компании; их названия могут отличаться от стандартных «Контакты», «Сделки» и «Задачи».

Ключ защиты от дублей — отдельное доступное для поиска поле, куда ChatRex записывает идентификатор запроса. Не меняйте его вручную у созданных ботом записей. Для точного поиска контактов требуется телефон или email; поиск только по имени не выполняется.

Выберите воронку, начальный статус, разрешённые статусы и ответственных. Добавьте каждый разрешённый переход Из статуса → В статус. В выбранной группе ELMA365 должна быть разрешена ручная смена статуса. Без настроенных переходов бот не сможет менять статус сделки.

Нажмите Проверить и сохранить. ChatRex проверит поля, связи, доступные статусы, сотрудников и чтение приложений. Успешное сохранение также синхронизирует сопоставление с модулем ELMA365.

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

# Настройка бота и проверка

Создайте бота по шаблону ELMA365 или добавьте действия в разделе Интеграции и действия. Выберите подключённую компанию и допустимые для бота параметры. Подробности — в статье ELMA365: действия бота.

Сначала выполните предпросмотр с ID существующих тестовых записей. Затем в тестовом диалоге попросите бота найти контакт, получить согласие на сохранение, создать заявку, добавить заметку и связанную задачу. Откройте полученные ссылки и проверьте данные, статус, срок и ответственного в ELMA365.

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

# Диагностика подключения

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

Если доступ к CRM есть, но модуль требует внимания, проверьте установку ChatRex AI Connector и внешнюю авторизацию его методов API в ELMA365. Ошибка доступа только к модулю не отключает действующее подключение CRM. При изменении структуры или прав устаревшее сопоставление потребуется сохранить заново.

В самом модуле ELMA365 поле Диагностика / Connection check показывает, разрешены ли действия, выбран ли пользователь и синхронизировано ли сопоставление. Это состояние на момент открытия формы: после изменений обновите страницу. Если модуль просит проверить сопоставление, выполните Проверить и сохранить в ChatRex.

Диагностика не создаёт записи в CRM и не проверяет выполнение действий записи. Для этого проведите отдельный тест бота и проверьте полученные карточки в ELMA365.

# Ошибки и отключение

• Модуль выключен или недоступен: включите ChatRex AI Connector, разрешите действия, выберите пользователя OAuth-подключения и сохраните настройки. Затем проверьте сопоставление в ChatRex.
• Модуль связан с другим подключением: сначала отключите прежнее подключение ChatRex. Если оно уже отключено, сохраните настройки модуля в ELMA365, чтобы сбросить оставшуюся привязку, и проверьте новое сопоставление.
• Нет доступа к приложению: проверьте права подключённого пользователя и лицензию ELMA365.
• Сопоставление устарело: повторно выберите изменившиеся поля или статусы и нажмите Проверить и сохранить.
• Авторизация недействительна: проверьте OAuth-клиент и повторите подключение.
• Переход недоступен: проверьте текущий статус, разрешённые переходы и ручную смену статуса в ELMA365.

Для отключения нажмите Отключить в карточке интеграции ChatRex: это прекращает использование подключения ботами. В ELMA365 откройте меню пользователя → Настройки → Внешние приложения и отзовите разрешение ChatRex, если оно есть в списке. Если OAuth-клиент больше не нужен, удалите его в разделе Токены модуля.

Удаление OAuth-клиента само по себе не гарантирует немедленного прекращения доступа по уже выданному токену. Токен доступа ELMA365 действует 10 минут, поэтому сначала отключайте интеграцию в ChatRex. Повторное подключение требует повторной проверки сопоставления.