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

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

Важно! Данная интеграции  доступна при наличие активного действующего  договора «1С:ИТС Отраслевой».

Важно! На текущий момент у мессенджера WhatsApp нет открытого официального API.  Поэтому интеграцию можно выполнить только через специальные платные сервисы, так называемые API‑шлюзы. В 1С:CRM для этого используется сервис ChatApi.

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

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

Зарегистрируйтесь в сервисе ChatApi по ссылке https://app.chat-api.com/login. После регистрации будет выполнен вход в личный кабинет сервиса и предоставлен один аккаунт для интеграции:

Аккаунт для интеграции

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

Выбор способа авторизации

После успешной авторизации статус авторизации изменится на «Авторизован» и будут предоставлены Api URL и Токен (данные параметры понадобятся для настройки интеграции в 1C:CRM):

Параметры Api URL и Токен

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

Важно! Поскольку авторизация выполняется через  приложение WhatsApp, установленное на телефоне, его необходимо держать включенным. Приложение WhatsApp нельзя закрывать. Телефон должен быть подключен к сети интернет.

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

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

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

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

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

В окне настройки указать полученные ранее Api URL и Токен и нажать «Готово».

При установке настройки «Загружать видео» в систему будет загружаться видео.

Выполнить команду Проверить подключение и Готово.

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

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

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

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

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

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

В окне настройки указать полученные ранее Api URL и Токен, Адрес webhook и выполнить команду Проверить подключение и Готово.

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

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

После указания адреса webhook он будет передан в Chat-api, где будет отличаться окончанием. Исправлять адрес в кабинете нельзя. Он должен указываться только в CRM.

Адрес webhook в Chat-api

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