Настройка интеграции с WhatsApp: различия между версиями

Материал из База знаний 5S AUTO
Перейти к навигации Перейти к поиску
м (Настройка интеграции)
м (Тест подключения)
 
(не показано 14 промежуточных версий этого же участника)
Строка 1: Строка 1:
<span style="color:red;">Статья редактируется</span>
 
 
= Введение =
 
= Введение =
 
<p>В системе предусмотрена интеграция с мессенджером WhatsApp для отправки сообщений клиентам или пользователям системы. Для интеграции с WhatsApp используются Веб-сервисы [https://chat-api.com/ru/ Chat API].</p>
 
<p>В системе предусмотрена интеграция с мессенджером WhatsApp для отправки сообщений клиентам или пользователям системы. Для интеграции с WhatsApp используются Веб-сервисы [https://chat-api.com/ru/ Chat API].</p>
 +
<p><b>Внимание!</b> Перед настройкой интеграции необходимо зарегистрироваться на сайте https://app.chat-api.com/login и получить ключ API. Подробную инструкцию см. в статье [[Привязка WhatsApp к Chat-API]].</p>
  
= Предварительная настройка =
+
= Настройка =
 
 
 
 
= Настройка интеграции =
 
<p><b>Внимание!</b> Перед настройкой интеграции необходимо зарегистрироваться на сайте https://chat-api.com и получить ключ API.</p>
 
 
<p>Для настройки интеграции перейдем в справочник «Интеграции»: [[Файл:Справочник Интеграции.png|none|class=pic]]
 
<p>Для настройки интеграции перейдем в справочник «Интеграции»: [[Файл:Справочник Интеграции.png|none|class=pic]]
 
</p>
 
</p>
Строка 14: Строка 10:
 
</p>
 
</p>
 
<p>Выберем обработчик «WhatsApp (через chat-api.com)»: [[Файл:Chat-API-Интеграция Выбор обработчика.jpg|none]]</p>
 
<p>Выберем обработчик «WhatsApp (через chat-api.com)»: [[Файл:Chat-API-Интеграция Выбор обработчика.jpg|none]]</p>
<p>После выбора обработчика отображаются параметры для интеграции: [[Файл:Параметры обработчика WhatsApp.png|none|class=pic]]</p>
+
<p>''Примечание: в описании обработчика (вкладка «Параметры сервиса») дается краткая инструкция подключения.''</p>
<p>Введите URL сервиса, который присвоили вам при регистрации на сайте https://chat-api.com в <i>параметр «Адрес сервиса»</i>.</p>
+
<p>После выбора обработчика отображаются параметры для интеграции: [[Файл:Chat-API-Интеграция Параметры.jpg|none]]</p>
 +
<p>Введите URL сервиса, который присвоили вам при регистрации на сайте https://app.chat-api.com/login в <i>параметр «Адрес сервиса»</i>.</p>
 
<p>Введите ключ API, который вы получили при активации API, в <i>параметр «Token»</i>.</p>
 
<p>Введите ключ API, который вы получили при активации API, в <i>параметр «Token»</i>.</p>
 
<p>Введите URL, где размещена страница Webhook, в <i>параметр «URL для webhook»</i>. {{doc|Текст=Webhook – php-обработчик поступающих сообщений через API мессенджера с целью сохранения их в Базе 1С. Для настройки и получения адреса данной страницы обратитесь в техническую поддержку компании «Пять систем».}}</p>
 
<p>Введите URL, где размещена страница Webhook, в <i>параметр «URL для webhook»</i>. {{doc|Текст=Webhook – php-обработчик поступающих сообщений через API мессенджера с целью сохранения их в Базе 1С. Для настройки и получения адреса данной страницы обратитесь в техническую поддержку компании «Пять систем».}}</p>
<p>Готово! Все настройки внесены. Теперь запишем изменения, нажав кнопку «Записать», и протестируем соединение. Для теста соединения перейдем на вкладку «Тест подключения» и нажмем кнопку «Тест подключения»: [[Файл:Тест соединения WhatsApp.png|none|class=pic]]</p>
+
<p>Готово! Все настройки внесены. Теперь запишем изменения, нажав кнопку «Записать», и протестируем соединение. </p>
<p>При успешном подключении отобразится информация о статусе аккаунта Chat API: {"accountStatus":<значение статуса>}.</p>
+
 
 +
= Тест подключения =
 +
<p>Для теста соединения перейдем на вкладку «Тест подключения» и нажмем кнопку «Методы интеграции» -> «Тест подключения»: [[Файл:Chat-API-Тест подключения.jpg|none]]</p>
 +
<p>При успешном подключении отобразится информация о статусе аккаунта Chat API: {"accountStatus":"authenticated"}.</p> [[Файл:Chat-API-Успешное подключение.jpg|none]]
 
<p>Если все успешно настроено, активируйте интеграцию, установив флажок у параметра «Включено», и нажмите на кнопку «ОК».</p>
 
<p>Если все успешно настроено, активируйте интеграцию, установив флажок у параметра «Включено», и нажмите на кнопку «ОК».</p>
<p>''Примечание: О привязке WhatsApp к номеру телефона и о снятии блокировки WhatsApp см. статью [[Практика работы с WhatsApp]].''</p>
+
<p>''Примечание: О том, как привязать WhatsApp к номеру телефона и о снятии блокировки WhatsApp см. статью [[Практика работы с WhatsApp]]. Об учете и обработке звонков по WhatsApp см. соответствующую [[Учет и обработка звонков по WhatsApp|статью]].''</p>

Текущая версия на 13:22, 28 декабря 2020

Введение

В системе предусмотрена интеграция с мессенджером WhatsApp для отправки сообщений клиентам или пользователям системы. Для интеграции с WhatsApp используются Веб-сервисы Chat API.

Внимание! Перед настройкой интеграции необходимо зарегистрироваться на сайте https://app.chat-api.com/login и получить ключ API. Подробную инструкцию см. в статье Привязка WhatsApp к Chat-API.

Настройка

Для настройки интеграции перейдем в справочник «Интеграции»:

Справочник Интеграции.png

Создадим новую интеграцию:

Создание интеграции.png

В форме создания интеграции заполним наименование и выберем вид интеграции «WhatsApp»:

Интеграция WhatsApp.png

Выберем обработчик «WhatsApp (через chat-api.com)»:

Chat-API-Интеграция Выбор обработчика.jpg

Примечание: в описании обработчика (вкладка «Параметры сервиса») дается краткая инструкция подключения.

После выбора обработчика отображаются параметры для интеграции:

Chat-API-Интеграция Параметры.jpg

Введите URL сервиса, который присвоили вам при регистрации на сайте https://app.chat-api.com/login в параметр «Адрес сервиса».

Введите ключ API, который вы получили при активации API, в параметр «Token».

Введите URL, где размещена страница Webhook, в параметр «URL для webhook». Webhook – php-обработчик поступающих сообщений через API мессенджера с целью сохранения их в Базе 1С. Для настройки и получения адреса данной страницы обратитесь в техническую поддержку компании «Пять систем».

Готово! Все настройки внесены. Теперь запишем изменения, нажав кнопку «Записать», и протестируем соединение.

Тест подключения

Для теста соединения перейдем на вкладку «Тест подключения» и нажмем кнопку «Методы интеграции» -> «Тест подключения»:

Chat-API-Тест подключения.jpg

При успешном подключении отобразится информация о статусе аккаунта Chat API: {"accountStatus":"authenticated"}.

Chat-API-Успешное подключение.jpg

Если все успешно настроено, активируйте интеграцию, установив флажок у параметра «Включено», и нажмите на кнопку «ОК».

Примечание: О том, как привязать WhatsApp к номеру телефона и о снятии блокировки WhatsApp см. статью Практика работы с WhatsApp. Об учете и обработке звонков по WhatsApp см. соответствующую статью.