Настройка канала WhatsApp¶

Чтобы подключить WhatsApp Business к Онлайн-чату, нужно:

1. Создать приложение в Meta for Developers*;
2. Добавить канал WhatsApp в Онлайн-чат Roistat;
3. Получить ID аккаунта WhatsApp Business;
4. Сгенерировать токен системного пользователя Facebook** Business Manager;
5. Настроить Webhook в приложении;
6. Получить статус подтвержденной компании в Facebook** Business Manager;
7. Подключить номера в WhatsApp Business.

Шаг 1. Создание приложения в Meta for Developers¶

Зайдите в Meta for Developers*. Если у вас нет аккаунта разработчика Meta*, вам будет предложено его создать.

Перейдите в раздел Мои приложения. Нажмите Создать приложение.

Выберите Тип приложения: Компания.

Укажите название приложения, электронный адрес для отправки системных уведомлений, а также выберите бизнес-аккаунт своей компании. Если у вашей компании нет бизнес-аккаунта, вам будет предложено создать аккаунт. Нажмите Создание приложения.

В созданном приложении нажмите Добавить товар. Добавьте в приложение продукты WhatsApp и Webhooks.

Шаг 2. Подключение канала WhatsApp¶

На Главной странице проекта найдите инструмент Онлайн-чат и мессенджеры. Зайдите в Настройки, нажмите на кнопку Подключить канал WhatsApp:

В открывшемся окне введите Название канала WhatsApp.

Шаг 3. Получение ID аккаунта WhatsApp Business¶

Зайдите в приложение Meta for Developers*, созданное на Шаге 1. В левом меню нажмите на продукт WhatsApp и перейдите во вкладку Первые шаги. Скопируйте ID аккаунта WhatsApp Business из блока Обмен сообщениями.

Вставьте скопированный ID в поле WA business account ID в настройках канала WhatsApp в Онлайн-чате Roistat.

Шаг 4. Генерация токена системного пользователя¶

Зайдите на Главную страницу Facebook** Business Manager, перейдите в настройки бизнес-аккаунта, привязанного к приложению Meta*.

В настройках компании откройте вкладку Системные пользователи. Нажмите Добавить, создайте системного пользователя.

Перейдите во вкладку Аккаунты WhatsApp, выберите аккаунт, привязанный к приложению, созданному на Шаге 1. Нажмите Добавить людей. Выберите созданного ранее системного пользователя, активируйте переключатель Частичный доступ, нажмите Назначить.

Вернитесь на вкладку Системные пользователи. Выберите созданного ранее системного пользователя, нажмите Создать новый маркер.

Выберите приложение, созданное на Шаге 1. Выберите разрешения whatsapp_business_management и whatsapp_business_messaging. Если они уже активированы системой, дополнительных действий совершать не нужно. Нажмите Сгенерировать маркер.

Скопируйте сгенерированный маркер и добавьте его в поле Access token системного пользователя в настройках канала WhatsApp в Онлайн-чате Roistat.

Сохраните настройки канала WhatsApp.

Шаг 5. Настройка Webhook¶

После того, как вы сохраните настройки канала WhatsApp, на странице настроек в Roistat появятся адрес Webhook и ключ подтверждения. Эти данные необходимы для настройки Webhook в настройках приложения Meta*.

Вернитесь в настройки приложения Meta*, созданного на Шаге 1. Перейдите в настройки продукта Webhooks. Выберите объект WhatsApp Business Account и нажмите Subscribe to this object.

Скопируйте адрес Webhook в настройках канала WhatsApp в настройках Онлайн-чата и вставьте его в поле URL обратного вызова в настройках Webhooks в приложении Meta*.

Скопируйте Ключ подтверждения в настройках канала WhatsApp в настройках Онлайн-чата и вставьте его в поле Маркер подтверждения в настройках Webhooks в приложении Meta*. Нажмите Подтвердить и сохранить.

Нажмите Subscribe напротив вебхука messages.

Шаг 6. Подтверждение компании¶

Чтобы получить возможность отправлять и получать сообщения в WhatsApp с помощью API, необходимо пройти верификацию компании в Facebook** Business Manager. Если ваш бизнес-аккаунт уже верифицирован, пропустите этот шаг.

Перейдите во вкладку Центр безопасности, нажмите Начать подтверждение.

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

Ожидайте верификации вашей компании.

Шаг 7. Подключение номеров¶

Зайдите в Facebook Business Manager, перейдите в раздел Аккаунты WhatsApp. Нажмите Добавить.

Введите свой номер телефона и отображаемое имя. Это имя аккаунта увидят клиенты, когда вы будете отправлять им сообщения в WhatsApp.

Нажмите Далее. Появится подтверждение об отправке отображаемого имени на проверку.

Нажмите Готово.

После подключения по каждому новому диалогу с клиентом в приложении Roistat Chat будет создаваться чат в Неразобранном. Если клиент напишет напрямую в WhatsApp в аккаунт, подключенный к Онлайн-чату Roistat, чат также будет создан в приложении Roistat Chat.

Дополнительные настройки¶

Настройка времени работы¶

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

Если клиент напишет в WhatsApp в нерабочее время, он получит сообщение о том, что в данный момент операторов нет онлайн. Настроить текст этого сообщения можно по ссылке Редактировать тексты канала WhatsApp:

Настройка текстов и языка по умолчанию¶

Укажите, на каком языке будут отправляться автоматические сообщения о статусе чата. Если необходимо, адаптируйте стандартные тексты.

Настройка передачи номера визита¶

Чтобы настроить передачу номера визита в сделку, которую создает оператор чата:

1. В проекте Roistat перейдите в раздел Настройки → Мультивиджет:

   

2. Кликните по иконке шестеренки справа от ссылки WhatsApp:

   

3. Активируйте опцию Включить передачу номера визита. В поле ниже вы увидите текст первого сообщения клиента, установленный по умолчанию. При необходимости вы можете его изменить. Номер визита будет передаваться вместо {roistat_visit}. Нажмите Сохранить, чтобы применить изменения.

   

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

*Правообладателем Meta for Developers является запрещенная на территории РФ компания Meta Platforms, признанная судом экстремистской.

**Правообладателем Facebook является запрещенная на территории РФ компания Meta Platforms, признанная судом экстремистской.