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

Business Messaging for WbizTool — официальный плагин для WordPress. Он отправляет сообщения WhatsApp с вашего подключённого номера, когда на сайте что-то происходит: меняется заказ WooCommerce, переносится или отменяется бронирование WP Amelia или отправляется форма Contact Form 7.

Перед началом работы#

• Аккаунт Wbiztool с подключённым номером WhatsApp в настройках WhatsApp.
• Ваши Client ID и API key (API-ключ) из раздела Настройки → API ключи.
• ID клиента WhatsApp номера, с которого будут отправляться сообщения, — он указан в настройках WhatsApp.

Установка плагина#

1. Установите из WordPress

   В админке WordPress перейдите в Plugins → Add New (в русской версии WordPress — «Плагины → Добавить новый»), найдите Business Messaging for WbizTool, нажмите Install Now («Установить»), а затем Activate («Активировать»). Плагин также можно скачать из каталога плагинов WordPress и загрузить zip-архив в разделе Plugins → Add New → Upload Plugin («Плагины → Добавить новый → Загрузить плагин»). Если загрузка не удалась (например, из-за ограничения размера файла), распакуйте архив и скопируйте папку business-messaging-for-wbiztool в /wp-content/plugins/ по FTP, затем активируйте плагин в разделе Plugins («Плагины»).

2. Откройте настройки плагина

   В боковом меню админки появится новое меню WbizTool с четырьмя страницами: Settings, Templates, Test Messages и Logs.

Настройка плагина#

1. Введите учётные данные API

   На странице WbizTool → Settings в разделе API Configuration заполните Client ID, API Key и WhatsApp Client ID, затем нажмите Test Connection.

   При правильных учётных данных Test Connection ставит в очередь настоящее тестовое сообщение на номер-заполнитель 10000000000, поэтому оно появляется в истории сообщений Wbiztool. Доставить его невозможно, и там оно отображается как неудачное; его можно игнорировать. Если вы видите Unable to connect to WbizTool API. Please check your internet connection. (Не удалось подключиться к API WbizTool, проверьте подключение к интернету), скорее всего, неверны Client ID, API-ключ или WhatsApp Client ID либо в вашем тарифе закончились сообщения. Проблема с подключением к интернету — редкая причина.

2. Задайте общие параметры

   В разделе General Settings:

   • Default Country Code: используется, если по стране в платёжных данных заказа WooCommerce не удаётся определить телефонный код. По умолчанию 1, поэтому укажите код своей основной страны, например 91.
   • Test Mode: когда включён, сообщения записываются в журнал, но не отправляются.
   • Admin Notifications: в версии 1.0.3 этот флажок ни на что видимо не влияет, потому что на странице настроек нет поля для номера телефона администратора, который он использует. Для оповещений администратора об отправке форм используйте описанные ниже настройки Contact Form 7.

3. Включите интеграции и события

   В разделе Integration Settings включите каждый используемый плагин и отметьте события, при которых нужно отправлять сообщение. Параметры интеграции отображаются, только когда соответствующий плагин активен на вашем сайте. Нажмите Save Settings.

4. Отредактируйте шаблоны сообщений

   На странице WbizTool → Templates выберите вкладку WooCommerce, Amelia или Contact Form 7, выберите событие и отредактируйте его текст. На странице перечислены доступные переменные и показан предпросмотр в реальном времени. Reset восстанавливает текст по умолчанию.

5. Отправьте тестовое сообщение

   На странице WbizTool → Test Messages отправьте сообщение на свой номер, чтобы убедиться, что всё работает, затем проверьте WbizTool → Logs.

WooCommerce#

Сообщения отправляются на платёжный телефон (billing phone) заказа. Код страны определяется по стране в платёжных данных; если страна не распознана, используется Default Country Code.

Переменные шаблона:

Пример шаблона:

Hi {customer_first_name},

Thank you for your order #{order_number}.
Total: {order_total}

Track your order: {order_url}

{store_name}

WP Amelia#

Сообщения отправляются на телефон клиента, указанный в бронировании. На странице настроек перечислены шесть событий:

• Booking Added (Frontend bookings)
• Booking Rescheduled
• Booking Cancelled
• Appointment Added (Backend)
• Event Booking Saved
• Event Booking Updated

Переменные, доступные в шаблонах Amelia:

Contact Form 7#

При отправке формы плагин может написать вам (администратору), человеку, заполнившему форму, или обоим.

Плагин находит в форме имя, email, телефон и сообщение по названиям полей. Используйте распространённые названия, например your-name, your-email, your-phone (или phone, mobile, whatsapp), your-subject и your-message. Автоответ клиенту отправляется, только если найдено поле телефона. Запрашивайте номер с кодом страны: плагин распознаёт лишь некоторые коды стран, а в остальных случаях использует Default Country Code.

Переменные шаблона:

Каждое поле формы также доступно по собственному названию, в котором дефисы заменены символами подчёркивания. Например, поле с названием your-city доступно как {your_city}.

Пример уведомления администратору:

New enquiry from {contact_name} ({contact_phone}) on {form_title}:
{message}

Переносы строк в сообщении посетителя удаляются, поэтому {message} приходит одной строкой.

Журнал#

WbizTool → Logs содержит сообщения, которые плагин пытался отправить, с датой, типом события, интеграцией, телефоном, сообщением и статусом. С его помощью можно проверить, сработало ли событие и было ли отправлено сообщение. Причину неудачной отправки журнал не показывает.

Устранение неполадок#

Чтобы увидеть ошибки PHP от плагина, включите журнал отладки WordPress в wp-config.php. Ошибки записываются в wp-content/debug.log. Когда закончите, снова отключите его.

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);