Интеграция с WhatsApp через Wazzup24 сервис

Наш сервис интегрирован с WhatsApp для отправки уведомлений через сервис Wazzup24. Используйте данную инструкцию, чтобы настроить рассылку уведомлений вашим клиентам через WhatsApp.

Примечание

При выборе данного способа отправки уведомлений вашим клиентам учитывайте следующую информацию:

  1. Отправка уведомлений WhatsApp платная, так же как и отправка Sms.

  2. В отличие от Sms-уведомлений, в WhatsApp вы платите за 1 день переписки с вашим клиентом, а не за отдельные сообщения.

  3. Не все ваши клиенты имеют WhatsApp, поэтому не все клиенты будут получать уведомления. По статистике, примерно 12% клиентов не имеют WhatsApp.

Настройка Wazzup24

  1. Создайте личный кабинет Wazzup24 по ссылке: https://wazzup24.com/?utm_p=zGYFL7

  2. В личном кабинете настройте канал.

  3. Настройте интеграцию с CRM: требуется добавить «Использовать API».

  4. Скопируйте ключ API, которые будет добавлен в URL WebHook ниже.

  5. Скопируйте идентификатор канала из URL настройки канала.

  6. Оплатите подписку Pro и выше, чтобы была возможность писать первым в WhatsApp.

Если у вас будут вопросы по настройке, то напишите в техническую поддержку Torrow.

Параметры WebHook

WebHook для отправки WhatsApp сообщения через Wazzup24 имеет следующий URL: https://hooks.torrow.net/webhook/wazzup24

Для настройки WebHook используются следующие параметры:

  • key_api - ключ для подключения к Wazzup24 в формате строки, например f8f1955587ac4d8894cee95f92dcaca4.

  • channel_id - идентификатор канала в формате строки GUID, например: 3344fab4-b01b-4232-b9cb-a15ec3acc053.

  • chat_type - тип чата для указанного канала. В данный момент поддерживается значение whatsapp.

  • errorEmail - адрес электронной почты, на который отправлять уведомления об ошибках отправки WhatsApp сообщений.

  • message - сообщение, добавляемое к форматированному сообщению WhatsApp. Например: Вы записаны на услугу.

Пример WebHook:

https://hooks.torrow.net/webhook/wazzup24?key_api=f8f1955587ac6d7894cee95f92dcaca4&channel_id=3349fab8-b01b-4232-b9cb-a15ec3acc053&chat_type=whatsapp&errorEmail=test@test.ru&message=Вы%20записаны%20на%20услугу

Дополнительные параметры форматирования сообщения:

  • resource_name - название ресурсов, по умолчанию: Услуги/ресурсы

  • detail_section_name - название раздела с деталями заказа, по умолчанию: Детали заказа, Детали записи, Детали мероприятия.

  • case_type_name - название типа события, по умолчанию: заказ, запись, участие в мероприятии

  • hide_detail_section - признак сокрытия раздела с деталями заказа, по умолчанию: false.

  • hide_resource_description - признак сокрытия описания деталей ресурсов, по умолчанию: false.

  • hide_order_duration - признак сокрытия длительности заказа, по умолчанию: false.

  • hide_address - признак сокрытия адреса оказания услуги, по умолчанию: false.

  • hide_service_name - признак сокрытия названия услуги, по умолчанию: false.

  • hide_order_description - признак сокрытия описания заказа, по умолчанию: false.

  • hide_url - признак сокрытия ссылок на услугу и на заказ, по умолчанию: false.

  • hide_contact_info - признак сокрытия контактной информации, по умолчанию true.

  • date_locales - формат даты и времени, по умолчанию: ru-RU, другие значения: en-US

  • timezone - часовой пояс, по умолчанию: Europe/Moscow, другие значения: https://timezonedb.com/time-zones

  • timezone_name - название часового пояса, по умолчанию: Мск, другие значения: указываются при настройке.

    • sign_text - подпись в конце сообщения, по умолчанию: пусто.

Примечание

В текстовых сообщениях нужно использовать ASCII коды: вместо пробела нужно встравлять код %20, вместо переноса строки код %0A

Например: строка%20один%0Aстрока%20два

Проверка параметров WebHook:

Для проверки параметров WebHook нужно открыть сформированный URL в браузере и проверить результат выполнения.

Успешная проверка параметров URL

В ответе вызова WebHook вы получите статус проверки (Status):

  1. Success - вызов был успешным, все параметры корректны и WebHook можно подключать к Услуге Torrow.

  2. Error или Wrong parameters - есть ошибки в параметрах WebHook, которые нужно исправить. В поле “ErrorMessage” будет описание ошибок, которые нужно исправить. В поле “WarningMessage” - может находится информация, которая не влияет на работоспособность WebHook, но может быть полезна чтобы настроить WebHook полностью.

Некорректные параметры URL
Некорректные параметры URL

Подключение WebHook к услуге

  1. Откройте Услугу и раскройте раздел “Общие настройки”:

Общие настройки услуги

  1. В разделе “Общие настройки” выберите поле “Интеграции”:

Поле "Интеграции" в "Общих настройках"

  1. В интеграциях включите чекбокс WebHook:

Чекбокс WebHook

  1. Заполните поля для настройки WebHook:

  • Название интеграции - например “wazzup24”

  • URL - сформированный выше WebHook

  • Чекбоксы событий, по которым будет вызываться WebHook:

    • Действие по заказу/событию (CaseActionEvent) - уведомление, которое можно подключить в настройках Услуги в поле «Действия»

Настройки WebHook

  1. Откройте редактирование Услуги и выберите поле «Действия»:

Настройки WebHook

  1. В самом низу формы добавьте вид действия, на которое будет отправляться WhatsApp уведомление:

  • Добавьте вид действия «Сообщение участнику о записи»

Вид действия
Результат выбора действия

  1. В настройках Действия поменяйте «Тип действия» на «Интеграция по операции»:

Тип действия
Выбор действия из списка
Результат выбора действия

  1. Выберите WebHook «wazzup24», который будет вызываться при выполнении Действия:

Поле WebHook
Выбор WebHook

  1. После сохранения параметров можно проверять Услугу и отправку сообщений в WhatsApp по номеру телефона, указанному в контактной информации при записи на Услугу.

Сохранение параметров

Полезные инструменты для настройки и отладки