Привязка WhatsApp к Chat-API

Введение

Прежде чем приступить к настройке интеграции с WhatsApp, требуется авторизация на сервисе WhatsApp API.

Авторизация на WhatsApp API

Прямая ссылка для входа на сервис: https://app.chat-api.com/login

Для авторизации требуется ввести логин и пароль, можно установить галочку «Запомнить меня». Если учетная запись еще не создана, сначала требуется зарегистрироваться.

Для этого требуется указать e-mail и пароль, подтвердить пароль, поставить галочку «Я прочитал и согласен(а) условия и положения» и подтвердить, что Вы не робот. После этого станет активной кнопка «Создать учетную запись»

Далее требуется подтвердить e-mail. На указанный адрес электронной почты будет отправлено письмо. Его требуется открыть и нажать в нем кнопку «Закончите регистрацию». Произойдет переход на сайт в созданную учетную запись.

В правом верхнем углу отображается аватар пользователя и имя или адрес электронной почты. Можно задать имя аккаунта. Слева находится меню управления:

Внимание: «Добавить аккаунт» не нажимать – лишние аккаунты потом будет не удалить.

Но в случае необходимости можно создавать несколько аккаунтов, например, для разных подразделений организации, если оплата по ним будет происходить раздельно (т.к. каждый аккаунт оплачивается отдельно).

Далее требуется отсканировать QR-код. На сайте выходит сообщение:

«Внимание

Для подключения к API вам необходимо отсканировать QR код с устройства, на котором зарегистрирован WhatsApp. Если ваш аккаунт зарегистрирован менее месяца назад, вам необходимо пройти безопасную авторизацию, чтобы уменьшить вероятность блокировки.»

и две кнопки: «Обычная авторизация» и «Безопасная авторизация» (при выборе безопасной авторизации сервис предложит установить расширение для браузера).

Инструкция для сканирования QR-кода отображается в форме gif-инструкции и дублируется текстом.

В инструкции показано, что следует открыть WhatsApp на телефоне, нажать три точки, нажать «WhatsApp WEB», отсканировать QR-код.

И то же самое написано словами в сообщении:

«Для отправки и приема сообщений Вы должны авторизовать наш сервер как WhatsApp Web.

1. Откройте WhatsApp на телефоне
2. Нажмите Настройки -> WhatsApp WEB и добавить
3. Просканируйте код и подождите 1 минуту
4. Держите телефон подключенным к интернету

Код можно сканировать в течение 1 минуты* после загрузки.

Отправка сообщений будет доступна сразу после авторизации.»

*Примечание: по факту меньше минуты, затем код меняется.

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

Когда авторизация установлена (статус «Авторизован»), отображаются следующие рамки:

1. «Не отключайте свой телефон»

Рекомендуется подключить телефон к Wi-Fi, чтобы снизить трафик данных, а также регулярно заряжать батарею.

2. На сколько дней оплачен аккаунт

3 дня после регистрации сервисом можно пользоваться бесплатно, затем нужно будет платить.

Если аккаунт в статусе «Не оплачен», отображается сообщение: «Ваш аккаунт был остановлен <дата, время> из-за неуплаты. Прямо сейчас вы можете включить этот инстанс, просто продлив подписку.»

3. Настройки аккаунта

В настройках аккаунта должны быть включены все параметры:

• Уведомления о доставке/прочтении
• Уведомления об изменениях в чатах
• Уведомления об изменениях статуса
• Не загружать (прим.: не отправлять) старые сообщения после авторизации*
• Включить прием видео

*Примечание: «старые сообщения» – это сообщения, дата которых не текущая, т.е. настройка используется, чтобы не отправлялись неактуальные сообщения, когда связь появилась.

Возможные проблемы и способы их устранения

Рекомендуется регулярно (например, раз в неделю) проверять корректность работы механизма отправки сообщений: заходить в Мастер настройки и делать тест подключения по всем каналам.

Как понять, что отправка сообщений через WhatsApp не работает.

Открыть Список Чаты: Сообщения (CRM -> Сообщения -> Сообщения)

Установить отбор «Канал доставки равно WhatsApp».

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

Чтобы проверить корректность работы функционала, требуется зайти в «Мастер настройки», выбрать канал доставки WhatsApp, нажать «Тест подключения».

Статусы аккаунта (см. https://chat-api.com/ru/docs.html)

• init – «это начальный статус»
• loading – «загрузка, повторите через 30 секунд»
• got qr code – требуется отсканировать QR-код в приложении WhatsApp. QR-код действителен в течении одной минуты.
• authenticated – «авторизация пройдена успешно»

Статус «loading» говорить о том, что WhatsApp ждет выхода телефона на связь, если он отключен или ушел в спящий режим. WhatsApp может активизировать телефон, инициировать обмен данными.

Если статус аккаунта «got qr code», требуется зайти на сайт и проследовать инструкции, как отсканировать QR-код.

Такая проблема может возникнуть, если случайно перебить учетную запись – зайти с другого компьютера (или если нажать «Выйти из всех устройств» на телефоне, или отвязать свою учетную запись в Chat API от телефона). WhatsApp позволяет интеграцию только одного компьютера с телефоном: если зайти с другого компьютера – на первом отключится.

В программе в этом случае отображается статус «got qr» и выходит ошибка, сообщения перестают отправляться.

Также причиной того, что отправка через WhatsApp не работает, может быть то, что закончились деньги на балансе аккаунта: на сайте отобразится Статус авторизации «Не оплачен».

На сайте приводятся следующие причины, почему может не работать аккаунт:

«Топ-3 причины отключения WhatsApp ‘WEB’:

1. У Вашего телефона плохое соединение с интернетом или включен режим энергосбережения.
2. Вы открыли WhatsApp WEB на другом компьютере.
3. Вы только что оплатили аккаунт, который был ранее остановлен за неуплату. В течение 1 часа он снова запустится на нашем сервере и будет работать.»

Если после устранения возможных проблем статус аккаунта на сайте меняется на «Авторизован», а в программе (при тесте подключения) – authenticated, значит, проблема успешно устранена. Тогда все сообщения в программе будут в статусах «Прочитано», «Отправлено», «Доставлено».

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

Настройка прав параметров: типовые права.

Обработки -> Мастер настройки -> вкладка «Отправка сообщений» -> вкладка «Общие настройки» -> поле «Права» -> кнопки-ссылки «Активность значимых событий» (значение «да» для автоматической отправки сообщений) и «Время ожидания реакции клиента на отправленное сообщение, мин» (значение права по умолчанию: 10).

Т.е. если было отправлено сообщение по WhatsApp, а статус сообщения не сменился на «Прочитано» в течение указанного в настройке времени (10 минут), то отправка автоматически повторяется по другому каналу (Telegram, SMSC).

Вкладка «Для клиентов»: «открыть»

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

[[]]