Интеграция с MAX

Интеграция с мессенджером MAX позволяет обмениваться сообщениями с клиентами в АРМ «Диалоги».

Интеграция основана на API-шлюзе компании GREEN-API, предоставляющем доступ к API мессенджера MAX на платной основе (есть возможность протестировать работу бесплатно).

Настройка API-шлюза в сервисе GREEN-API

Для интеграции необходимо иметь телефон с тем номером, с которым планируется выполнить интеграцию. На телефоне должно быть установлено официальное приложение MAX и выполнен вход в аккаунт.

Зарегистрируйтесь в сервисе GREEN-API по ссылке. После регистрации будет выполнен вход в личный кабинет сервиса и предоставлен выбор тарифа для интеграции:

Создание инстанса

Выбор тарифа инстанса

После выбора тарифа будет создан инстанс, в котором необходимо авторизоваться. В созданном инстансе указаны «ID Instance» и «Токен» (они понадобятся для настройки интеграции в 1C:CRM).

Необходимо подключить учетную запись MAX к данному инстансу с помощью инструкции на сайте.

После успешной авторизации статус инстанса изменится на «Авторизован».

Подключение приложения MAX

Для подключения интеграции необходимо открыть окно «Приложения для 1С:CRM» и выбрать MAX.

Подключение приложения для интеграции с MAX

В форме настройки интеграции нужно нажать на кнопку «Подключить»

Настройка учетной записи

По этой кнопке откроется настройка с провайдером GREEN-API. В окне настройки указать полученные ранее «ID Instance» и «Токен».

Настройка учетной записи

Далее необходимо авторизовать инстанс, нажав на одноименную кнопку и указать в поле номер телефона, на который заведен мессенджер и запросить код.

Проверка авторизации инстанса

После подтверждения статуса инстанса выполнить команду «Проверить подключение» и «Готово».

Настройка завершена, можно переходить в АРМ «Диалоги» для работы с сообщениями. Для получения сообщений будет использоваться регламентное задание.

Настройка и работа через webhook

Webhook (Вебхук) — это механизм взаимодействия между сервисами. С помощью Webhook сайты или приложения обмениваются данными в реальном времени.

Настройка интеграции с MAX через webhook используется для того, чтобы увеличить скорость реакции на сообщения и не использовать регламентное задание для интеграции. В этом случае сообщения в систему 1С:CRM будут приходить без задержек.

Сами собой сообщения webhook не могут попасть в систему. Для их получения необходимо опубликовать HTTP-сервис «CRM_Messengers». Подробные описания доступны по ссылкам «Установка веб-сервера» и «Публикация HTTP сервиса CRM_Messengers».

Для использования интеграции с MAX через webhook необходимо в форме настройки выполнить команду «Подключить» при первоначальной настройке или «Заменить», если ранее уже было настроено.

В окне настройки указать (помимо полученных ранее «ID Instance» и «Токен») «Адрес webhook» и выполнить команду «Проверить подключение» и «Готово».

В поле «Адрес webhook» указывается путь к опубликованному HTTP-сервису. Путь должен заканчиваться на «Messengers». Пример: http://localhost/crm/hs/Messengers/.

Проверка авторизации инстанса

После указания адреса webhook и записи настроек он будет передан в GREEN-API.

Исправлять адрес в личном кабинете сервиса нельзя. Он должен указываться только в CRM.

Пример адреса webhook с идентификатором в личном кабинете GREEN-API:

Адрес webhook в GREEN-API

Если адрес webhook в CRM не указан, для получения сообщений будет использоваться регламентное задание.