# WhatsApp Business API Конструктор MaviBot также поддерживает официальный WhatsApp Business API. ## Как подключить WhatsApp Business Чтобы подключить WhatsApp Business API (WABA) к вашему проекту, перейдите в **Мессенджеры** раздел и выберите **WhatsApp Business API**.
**Подключение WhatsApp Business API**
В открывшемся окне войдите в свою учетную запись Facebook. Затем нажмите кнопку «Подключить через 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. Перейдите на вкладку **разделе «Каналы»** выберите **WhatsApp Business API**а затем выберите **Шаблоны сообщений**.
2. Нажмите кнопку **кнопку «Создать шаблон»** Откроется страница создания шаблона. 3. Шаблоны привязаны к блокам в вашей цепочке. По умолчанию содержимое шаблона берется из блока, но вы можете указать свой текст и кнопки.
4. Шаблон сообщения будет отправлен на модерацию после создания. **Вы можете использовать только одобренные шаблоны.** Модерация обычно занимает около 8 часов, максимум — 48 часов. ## Типы шаблонов Доступны 3 типа шаблонов на выбор. Вы можете прикрепить изображение к **МАРКЕТИНГОВОМУ** шаблону в следующих форматах: SVG, PNG, JPG и GIF. #### Как передавать переменные в шаблонах Переменные в шаблонах обрабатываются так же, как и во всем MaviBot, а не по нативному формату WhatsApp. {% hint style="danger" %} Наша система адаптирована под переменные MaviBot и **не поддерживает** переменные в `{{1}}` форматировать {% endhint %} #### Использование переменных в шаблонных сообщениях WhatsApp Если вам нужно использовать переменные в шаблонах сообщений, следуйте этому правилу: **всегда пишите имена переменных только латинскими буквами**например, `#{example}`. После отправки проверьте, что переменные обрабатываются корректно, просмотрев сообщение через предоставленный [ссылка](https://business.facebook.com/wa/manage/message-templates/). Если шаблон содержит переменную, но бот не присваивает ей значение или значение отсутствует, сообщение **не будет отправлено**! ## Как работают кнопки в шаблонах Шаблоны сообщений поддерживают кнопки. В MaviBot кнопки настраиваются аналогично синтаксису Facebook API. Вы можете ознакомиться с ним, перейдя по [ссылка](https://developers.facebook.com/docs/whatsapp/business-management-api/message-): Кнопки задаются в формате JSON-массива. **Параметры создания кнопки:** | Параметр | Обязательно | Описание | | ------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | тип | Да | Значения: PHONE\_NUMBER, URL и QUICK\_REPLY | | text | Да | Текст кнопки | | url | Нет |

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

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

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

| | phone\_number | Нет |

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

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

| | пример | Нет |

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

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

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

| Например: Сообщение с двумя кнопками: \[{"type":"QUICK\_REPLY", "text": "Да, удобно"}, {"type":"QUICK\_REPLY", "text": "Неудобно"}] ### Функции кнопок в шаблонах В шаблонных сообщениях доступны два типа кнопок: 1. **Call-To-Action (CTA):** Кнопка для ссылки или номера телефона (отображается со значком ссылки или трубки рядом с текстом). 2. **Quick Reply:** Стандартные текстовые кнопки с ограничением в 20 символов. **Ограничения:** * Один шаблон может содержать до **3 кнопок Quick Reply** и до **2 кнопок Call-to-Action**. Однако нельзя одновременно использовать две ссылки или два номера телефона. * Кнопки не могут содержать переменные, переносы строк, эмодзи или символы форматирования. **Поведение:** * Нажатие на **Quick Reply** кнопку отправляет ее текст как ответное сообщение от пользователя. * A **Call-to-Action** кнопка может открывать ссылку на файл. * Нажатие на **Call-to-Action** кнопка для телефонного звонка открывает стандартный номеронабиратель. В WhatsApp Web появится уведомление о том, что звонки нельзя совершать из десктопной версии. ### Как работает модерация шаблонов Каждый шаблон отправляется на модерацию сразу после создания. Обычно процесс занимает **около 8 часов**, а максимальное время проверки составляет **48 часов**. Вы можете отслеживать статус модерации в списке ваших шаблонов. Если шаблон отклонен, будет указана причина отклонения. **Шаблоны с высокой вероятностью одобрения обычно:** * Используют ясный, профессиональный язык. * Имеют конкретный, законный сценарий использования (например, напоминания о встречах, обновления заказов). **Важно:** Текст в *курсив* может быть переменным и настраиваемым. Здравствуйте, нам не удалось до вас дозвониться. Вам будет удобно продолжить общение здесь? Здравствуйте, вы оставили сообщение на сайте и попросили связаться с вами.(subject to change) Здравствуйте, я Джон Смит из MaviBot. Ранее вы подали заявку на создание чат-бота. Рады сообщить, что у нас для вас есть новости. Шаблоны, которые не пройдут модерацию: любой рекламный текст #### **Как проверить, находитесь ли вы в пределах 24-часового окна** Вы можете определить, сколько дней прошло с момента последнего сообщения клиента, используя `days_from_last_message()` функцию в условии триггера. **Пример проверки 24-часового окна:** `days_from_last_message() == 0` ### Как использовать кнопки без шаблонов Вне шаблонов доступны два типа кнопок, настраиваемых так же, как и в других мессенджерах: 1. [**Кнопки ответа:**](/doc/ru/chatbot/builder/knopki.md) Максимум **3** можно использовать в блоке. 2. [**Inline-кнопки**](/doc/ru/chatbot/builder/knopki.md)**:** Вы можете создать до **10**, и они отображаются, как показано в примере. **Важные ограничения для кнопок без шаблонов:** * Кнопки могут содержать только **text**. **Ссылки не поддерживаются.** * Их единственная функция — **перемещать клиента из одного блока в другой** внутри вашей цепочки. *** **Ограничения для неподтвержденных аккаунтов** Неподтвержденные бизнес-аккаунты Facebook имеют следующие ограничения: * **50 шаблонных сообщений в день** (включено в ежемесячную плату). * **Без ограничений** на входящие сообщения. Чтобы снять эти ограничения, ваша компания должна пройти процесс **Business Verification** который обычно занимает **2–3 недели**. ## Платежные системы Уточните у своего реселлера стоимость входящих и исходящих сообщений для неподтвержденных аккаунтов. {% hint style="info" %} Оплата производится напрямую в **360dialog**. {% endhint %} ## Ошибки отправки сообщений **Возможные причины сбоя доставки:** 1. Номер телефона получателя не зарегистрирован в WhatsApp. 2. Попытка отправить шаблон из **«Authentication»** категории пользователю WhatsApp с кодом страны **+91 (Индия)**. В настоящее время шаблоны категории Authentication не могут быть доставлены пользователям в Индии. 3. Получатель не принял обновленные **Условия обслуживания** и **Политика конфиденциальности**. 4. Сообщение не было доставлено, чтобы поддерживать высокое качество пользовательского опыта (это общее ограничение политики). --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mavibot.ai/doc/ru/chatbot/messendzhery/waba.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.