Конструктор MaviBot также поддерживает официальный WhatsApp Business API.

Как подключить WhatsApp Business

Чтобы подключить WhatsApp Business API (WABA) к вашему проекту, перейдите в раздел Messengers и выберите WhatsApp Business API.

Подключение WhatsApp Business API

В открывшемся окне войдите в свой аккаунт Facebook. Затем нажмите кнопку «Connect via Facebook».

При необходимости введите пароль от Facebook, чтобы продолжить.

На этом настройка завершена. Вам не нужно держать телефон онлайн постоянно; бот будет работать стабильно и автономно.

Шаблоны сообщений для WhatsApp Business API

При использовании WhatsApp Business API пользователи не могут писать клиентам в любое время суток и отправлять неограниченное количество сообщений при создании бота, как в сером WhatsApp, вне 24-часового окна обслуживания клиентов.

Вне 24-часового окна можно использовать только шаблоны сообщений WhatsApp (или шаблонные сообщения WhatsApp), в рамках которых общение происходит бесплатно в пределах выбранной категории.

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

Meta установила следующие категории сообщений для WhatsApp Business API:

1. Полезные шаблоны (содержат конкретную информацию о транзакциях, счетах, платежах и т. д.);

2. Шаблоны для маркетинга (информация о компании, организации, стратегиях, рекламе и продвижении);

3. Шаблоны для проверки и аутентификации.

Созданные для WABA шаблоны проходят модерацию.

Основные причины отклонения шаблонов

Значительное количество шаблонов не проходит модерацию WhatsApp по нескольким причинам:

  1. Чрезмерная реклама: WhatsApp Business отклоняет шаблоны, перегруженные рекламой и промо-контентом. Если модераторы или ИИ платформы определят, что реклама затмевает основное сообщение, шаблон будет заблокирован.
  2. Нарушение Политики в отношении продуктов: шаблоны, продвигающие запрещенные товары, такие как наркотики, психотропные вещества, алкоголь, табак, интимные услуги или любой контент, унижающий человеческое достоинство, будут отклонены.
  3. Двусмысленность, упущение или ложь: если модераторы WhatsApp обнаружат скрытый подтекст, вводящую в заблуждение информацию или отсутствие четких деталей о вашей компании или услуге, шаблон не будет одобрен.
  4. Сбор конфиденциальной информации: шаблоны, предназначенные для сбора чувствительных данных пользователей (например, номеров паспортов, данных банковских карт, личных идентификационных номеров, домашних адресов), не пройдут модерацию.
  5. Оскорбительный контент: любое сообщение, содержащее информацию, которая может оскорбить пользователей по признаку расы, национальности, пола, идентичности или другим критериям, будет отклонено.
  6. Отклонение по усмотрению: модераторы WhatsApp оставляют за собой право отклонять шаблоны без указания конкретной причины.

Как установить шаблоны сообщений

Поскольку шаблоны создаются из блоков, сначала необходимо создать блок в вашем потоке, прежде чем использовать его для шаблона WhatsApp Business API.

  • Стоимость и первое сообщение: отправка шаблонных сообщений бесплатна в течение 24-часового окна диалога. Первое сообщение клиенту может быть только шаблоном, одобренным Meta (Facebook).
  • Через 24 часа: после того как с момента открытия чата прошло 24 часа, вы можете отправить только другой одобренный шаблон, чтобы снова привлечь пользователя.
  • Примечание по модерации: шаблоны могут не пройти модерацию, если они содержат переменные (в кириллице или латинице).

Создание шаблонов в MaviBot

  1. Перейдите в раздел Channels, выберите WhatsApp Business API, а затем Message templates.

  1. Нажмите кнопку «Create template». Откроется страница создания шаблона.
  2. Шаблоны привязаны к блокам в вашем потоке. По умолчанию содержимое шаблона берется из блока, но вы можете указать свой текст и кнопки.

  1. Шаблон сообщения будет отправлен на модерацию после создания. Вы можете использовать только одобренные шаблоны. Модерация обычно занимает около 8 часов, максимум 48 часов.

Типы шаблонов

Доступны 3 типа шаблонов на выбор.

Вы можете прикрепить изображение к шаблону MARKETING в следующих форматах: SVG, PNG, JPG и GIF.

Как передавать переменные в шаблонах

Переменные в шаблонах обрабатываются так же, как и во всем MaviBot, а не в соответствии с нативным форматом WhatsApp.

Наша система адаптирована для переменных MaviBot и не поддерживает переменные в формате {{1}}

Использование переменных в шаблонных сообщениях WhatsApp

Если вам нужно использовать переменные в шаблонах сообщений, следуйте этому правилу: всегда пишите имена переменных только латинскими буквами, например, #{example}. После отправки проверьте, что переменные обрабатываются корректно, проверив сообщение по предоставленной ссылке.

Если шаблон содержит переменную, но бот не присваивает ей значение или значение отсутствует, сообщение не будет отправлено!

Как работают кнопки в шаблонах

Шаблоны сообщений поддерживают кнопки. В MaviBot кнопки задаются аналогично синтаксису

Facebook API. Вы можете ознакомиться с ним по ссылке:

Кнопки задаются в формате JSON-массива.

Параметры создания кнопок:

Параметр Обязательный Описание
type Да Значения: PHONE_NUMBER, URL и QUICK_REPLY
text Да Текст кнопки
url Нет

URL-адрес, который будет открыт

при нажатии кнопки. Вы можете использовать переменные для

создания динамических ссылок.
phone_number Нет

Номер телефона, на который

будет совершен звонок при нажатии кнопки
example Нет

Предоставляет пример возможных данных для вашего шаблона. Это помогает в процессе проверки и одобрения, чтобы вы могли

понять, какое сообщение планируете отправить. Убедитесь,

что это примеры и они не содержат конфиденциальной или личной информации.

Например: Сообщение с двумя кнопками: [{"type":"QUICK_REPLY", "text": "Yes, convenient"}, {"type":"QUICK_REPLY", "text": "Inconvenient"}]

Особенности кнопок в шаблонах

В шаблонных сообщениях доступны два типа кнопок:

  1. Call-To-Action (CTA): кнопка для ссылки или номера телефона (отображается со значком ссылки или трубки рядом с текстом).
  2. Quick Reply: стандартные текстовые кнопки с ограничением в 20 символов.

Ограничения:

  • Один шаблон может содержать до 3 кнопок Quick Reply и до 2 кнопок Call-to-Action. Однако нельзя использовать две ссылки или два номера телефона одновременно.
  • Кнопки не могут содержать переменные, переносы строк, эмодзи или символы форматирования.

Поведение:

  • Нажатие кнопки Quick Reply отправляет ее текст как ответное сообщение от пользователя.
  • Кнопка Call-to-Action может открывать ссылку на файл.
  • Нажатие кнопки Call-to-Action для телефонного звонка открывает стандартный набор номера. В WhatsApp Web появится уведомление о том, что звонки нельзя совершать с десктопной версии.

Как работает модерация шаблонов

Каждый шаблон отправляется на модерацию сразу после создания. Процесс обычно занимает около 8 часов, максимальное время проверки — 48 часов.

Вы можете отслеживать статус модерации в списке шаблонов.

Если шаблон отклонен, будет указана причина отклонения.

Шаблоны с высокой вероятностью одобрения обычно:

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

Важно: Текст курсивом может быть переменным и настраиваемым.

Здравствуйте, мы не смогли до вас дозвониться. Удобно ли вам продолжить общение здесь?

Здравствуйте, вы оставили сообщение на сайте и попросили связаться с вами. (может быть изменено)

Здравствуйте, я Джон Смит из MaviBot. Ранее вы подавали заявку на создание чат-бота. Мы рады сообщить вам, что у нас есть для вас новости.

Шаблоны, которые не пройдут модерацию:

любой рекламный текст

Как проверить, находитесь ли вы в 24-часовом окне

Вы можете определить, сколько дней прошло с момента последнего сообщения клиента, используя функцию days_from_last_message() в условии триггера.

Пример проверки 24-часового окна:

days_from_last_message() == 0

Ограничения для непроверенных аккаунтов

Непроверенные бизнес-аккаунты Facebook имеют следующие ограничения:

  • 50 шаблонных сообщений в день (включено в ежемесячную плату).
  • Без ограничений на входящие сообщения.

Чтобы снять эти ограничения, ваша компания должна пройти процесс Business Verification, который обычно занимает 2–3 недели.

Платежные системы

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

Оплата производится напрямую в 360dialog.

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

Возможные причины сбоя доставки:

  1. Номер телефона получателя не зарегистрирован в WhatsApp.
  2. Попытка отправить шаблон из категории «Authentication» пользователю WhatsApp с кодом страны +91 (Индия). В настоящее время шаблоны категории Authentication не могут быть доставлены пользователям в Индии.
  3. Получатель не принял обновленные Условия предоставления услуг и Политику конфиденциальности.
  4. Сообщение не было доставлено для поддержания высокого качества пользовательского опыта (это общая блокировка политики).

Конверсии рекламы Click-to-WhatsApp

Дополнение к документации для функции fb_pixel_event().

Meta* помечает каждый клик по рекламе Click-to-WhatsApp идентификатором клика ctwa_clid. Он получается вместе с первым сообщением клиента в WhatsApp и используется для атрибуции конверсии из диалога к конкретному объявлению — аналогично тому, как события пикселя атрибутируются к клику на сайте.

Сигнатура

fb_pixel_event(
    event_name,
    pixel_id,
    access_token,
    event_source_url,
    action_source,
    fbc,
    test_event_code,
    data,
    ctwa_clid,
    messaging_channel
)

Новые параметры

Параметр Описание
ctwa_clid Идентификатор клика для рекламы Click-to-WhatsApp. Если этот параметр не указан, используется клиентская переменная ctwa_clid, которая сохраняется ботом автоматически. Необязательный.
messaging_channel Канал обмена сообщениями, в котором произошла конверсия. По умолчанию — whatsapp. Необязательный.

Новое значение action_source

В таблицу значений action_source добавляется следующая строка:

Значение Описание
business_messaging Конверсия произошла в диалоге после того, как клиент нажал на рекламу Click-to-WhatsApp.

Событие отправляется как конверсия в обмене сообщениями, если выполняется хотя бы одно из следующих условий:

  • указано action_source="business_messaging";
  • указан ctwa_clid;
  • указан messaging_channel.

В этом случае Meta* получает комбинацию action_source + messaging_channel + ctwa_clid. Без этой комбинации клик по рекламе не будет атрибутирован к конверсии.

Значение website не должно использоваться для конверсий в обмене сообщениями: событие достигнет пикселя, но не будет атрибутировано к рекламе.

Клиентские переменные

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

Переменная Описание
ctwa_clid Идентификатор клика. Автоматически добавляется к событию.
ctwa_clid_time Время получения идентификатора в формате Unix time. Его можно использовать для определения того, сколько времени прошло с момента клика.
wa_ads_data Данные о рекламе в формате JSON: URL рекламы, ID рекламы (source_id), заголовок, описание, тип креатива и URL креатива.

Идентификатор клика автоматически берется из клиентской переменной, поэтому вам не нужно передавать его в функцию явно.

Номер телефона клиента автоматически добавляется к событию, если он не указан в data.

Параметр event_source_url не используется для конверсий в обмене сообщениями.

Ограничения

Идентификатор клика получается только с первым сообщением клиента после нажатия на кнопку в рекламе. Он не включается в последующие сообщения. Поэтому событие может быть отправлено в любой момент диалога, но только если первое сообщение было инициировано рекламой.

Meta* предоставляет ctwa_clid для кликов из приложений Facebook* и Instagram* на Android и iOS.

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

Если клиент позже нажимает на другую рекламу, переменные перезаписываются. Конверсия атрибутируется к самой последней рекламе, с которой пришел клиент.

Если идентификатор клика отсутствует и в параметрах функции, и в клиентских переменных, функция возвращает ошибку No ctwa_clid variable in client variables, и событие не отправляется.