Как настроить WhatsApp Business API: пошаговое руководство
Как подключить WhatsApp Business API по шагам: портфолио Meta, верификация, номер телефона, отображаемое имя, Embedded Signup, шаблоны и запуск.
Автор: OmniChannels.ai Editorial Team · Проверил: BroadNet Messaging Solutions Team
Короткий ответ
Чтобы настроить WhatsApp Business API, создайте бизнес-портфолио Meta или используйте существующее, пройдите верификацию бизнеса, выберите номер телефона, который может принять SMS или голосовой звонок и не активен в WhatsApp, подберите отображаемое имя, совпадающее с вашим брендом, подключитесь через Embedded Signup вашего провайдера, добавьте способ оплаты, зарегистрируйте номер с PIN-кодом двухэтапной проверки и отправьте на одобрение первые шаблоны сообщений до запуска.
На этой странице
Главное
- Номер телефона для API должен принадлежать вам, включать код страны и региона и принимать SMS или голосовой звонок; короткие номера (short codes) не поддерживаются, по данным Meta.
- Номера, уже используемые в WhatsApp, нужно удалить из приложения до регистрации, если только вы не применяете опцию coexistence от Meta для подходящих номеров WhatsApp Business App.
- Embedded Signup позволяет создать или выбрать бизнес-портфолио, аккаунт WhatsApp Business и номер телефона прямо на платформе провайдера.
- Верификация бизнеса увеличивает число номеров, которые можно зарегистрировать, и открывает один из путей к более высоким лимитам сообщений.
- Обычные препятствия перед запуском: одобрение шаблонов, действующий способ оплаты и PIN-код двухэтапной проверки.
Это руководство для руководителя по маркетингу, клиентскому опыту (CX) или ИТ, которому нужно запустить бизнес в WhatsApp Business API. Оно по порядку описывает каждый шаг подключения, объясняет, что Meta проверяет на каждом этапе, и завершается чек-листом запуска и списком ошибок, с которыми команды сталкиваются чаще всего.
Что нужно подготовить заранее?
Подготовьте четыре вещи: доступ администратора к бизнес-портфолио Meta вашей компании, бизнес-документы, выделенный номер телефона и название бренда, которое узнают клиенты. Чаще всего задержки возникают из-за того, что чего-то из этого не хватает.
| Что нужно | Требование | Зачем это нужно |
|---|---|---|
| Бизнес-портфолио Meta | Доступ администратора; указаны юридическое название и адрес компании | Владеет аккаунтом WhatsApp Business (WABA) |
| Бизнес-документы | Торговая лицензия или свидетельство о регистрации, подтверждение адреса | Нужны для верификации бизнеса |
| Сайт | На домене, которым вы управляете, с названием вашей компании | Помогает пройти верификацию и проверку отображаемого имени |
| Номер телефона | Принадлежит вам, с кодом страны и региона, принимает SMS или голосовой звонок | Нужен для регистрации; короткие номера (short codes) не поддерживаются |
| Отображаемое имя | Совпадает с брендом и сайтом | Показывается в профиле WhatsApp; проверяется Meta |
| Способ оплаты | Карта или кредитная линия провайдера | Нужен для отправки платных шаблонов |
| Процесс сбора согласия (opt-in) | Чёткое согласие клиентов на получение сообщений в WhatsApp | Требование политики WhatsApp |
Как настроить WhatsApp Business API по шагам?
Выполняйте шаги по порядку. Если вы подключаетесь через провайдера, шаги с 3 по 6 обычно проходят внутри его Embedded Signup.
Шаг 1. Подготовьте бизнес-портфолио Meta
Войдите в Meta Business Suite с личного аккаунта Facebook, который является администратором бизнес-портфолио компании, или создайте портфолио. Укажите юридическое название и адрес в точности так, как они записаны в ваших документах. Добавьте минимум двух администраторов, чтобы не потерять доступ, если один из сотрудников уйдёт.
Шаг 2. Начните верификацию бизнеса
В Центре безопасности вашего бизнес-портфолио запустите верификацию бизнеса. Meta запросит документы, подтверждающие юридическое название, адрес и телефон или e-mail, и может проверить вас с помощью кода или проверки домена. Требования зависят от страны и со временем меняются, поэтому следуйте подсказкам на экране.
Подключение можно начать до завершения верификации, но до этого момента Meta применяет более низкие лимиты. По документации Meta, новые портфолио стартуют с двумя зарегистрированными номерами и лимитом 250 уникальных пользователей вне окна обслуживания клиентов.
Шаг 3. Выберите номер телефона
Выберите номер, который останется у бизнеса на годы: городской или выделенный мобильный. Meta требует, чтобы номер:
- принадлежал вам и включал код страны и региона;
- мог принять SMS или голосовой звонок для верификации;
- не был коротким номером (short code);
- не был зарегистрирован в WhatsApp в данный момент, если только вы не используете опцию coexistence от Meta для подходящего номера WhatsApp Business App.
Если номер используется в WhatsApp или WhatsApp Business App и вам не нужен coexistence, сохраните резервную копию нужных данных и сначала удалите аккаунт из приложения.
Шаг 4. Выберите отображаемое имя
Отображаемое имя показывается в вашем профиле WhatsApp. Используйте название бренда, известное клиентам, в соответствии с вашим сайтом и бизнес-документами. Избегайте общих названий («Лучшие предложения»), необычного регистра и слоганов. Meta проверяет имя; статус отображается в WhatsApp Manager как «на рассмотрении», «одобрено» или «отклонено».
Шаг 5. Подключитесь через Embedded Signup
Embedded Signup — это процесс Meta, который провайдеры встраивают в свои платформы. Вы входите через Facebook, выбираете или создаёте бизнес-портфолио, создаёте или выбираете аккаунт WhatsApp Business, вводите номер телефона и отображаемое имя и подтверждаете номер кодом по SMS или голосовому звонку. В конце провайдер получает разрешение управлять WABA от вашего имени, а владельцем остаётся ваше портфолио.
Шаг 6. Зарегистрируйте номер и задайте PIN двухэтапной проверки
Номер нужно зарегистрировать для Cloud API с шестизначным PIN-кодом двухэтапной проверки. Обычно это делает ваш провайдер в рамках подключения. Храните PIN надёжно: он понадобится, чтобы позже сменить PIN или удалить номер.
Шаг 7. Добавьте способ оплаты
Meta берёт плату за каждое доставленное сообщение по шаблону — в зависимости от категории и страны получателя. Добавьте карту к WABA в WhatsApp Manager или убедитесь, что кредитная линия провайдера покрывает ваш аккаунт. Без действующей оплаты отправка шаблонов не пройдёт.
Шаг 8. Создайте первые шаблоны
Вне 24-часового окна обслуживания клиентов можно отправлять только одобренные шаблоны. Начните с трёх–пяти шаблонов, которые нужны в первый же день:
- Служебный шаблон (utility) для подтверждения заказа или бронирования.
- Служебный шаблон (utility) для обновления статуса, например доставки или напоминания.
- Аутентификационный шаблон (authentication), если вы отправляете одноразовые коды.
- Один маркетинговый шаблон (marketing) для первой рассылки по контактам с согласием.
Используйте переменные для имён и номеров заказов, не добавляйте рекламные формулировки в служебные шаблоны и создавайте арабскую и английскую версии как отдельные языки одного шаблона, если вы работаете с клиентами в странах Персидского залива (GCC).
Пример из практики: учебный центр в Дохе выходит в эфир
«Al Fanar Academy» (условный пример) хочет использовать WhatsApp для ответов на запросы о курсах и напоминаний о занятиях.
- Неделя 1. Операционный менеджер подтверждает доступ администратора к бизнес-портфолио, загружает свидетельство о регистрации и запускает верификацию. Академия выбирает свой основной городской номер, который может принять голосовой звонок.
- Подключение. Через Embedded Signup провайдера академия создаёт WABA, вводит отображаемое имя «Al Fanar Academy» и подтверждает номер голосовым звонком.
- Шаблоны. Она отправляет на одобрение напоминание о занятии (utility), подтверждение записи (utility) и анонс нового семестра (marketing) на арабском и английском. Маркетинговый шаблон отклонён из-за расплывчатого призыва к действию и одобрен после переработки.
- Запуск. Академия отправляет напоминания студентам, давшим согласие в форме записи, а ответы направляет в общий инбокс (единое окно для всех каналов) приёмной комиссии.
Дольше всего длилась верификация, а не техническая настройка.
Чек-лист запуска
Отметьте каждый пункт до первой кампании.
- Верификация бизнеса подана или одобрена.
- Отображаемое имя одобрено.
- Номер телефона зарегистрирован, PIN двухэтапной проверки надёжно сохранён.
- Способ оплаты действует и пополнен.
- Нужные шаблоны одобрены на всех необходимых языках.
- Согласие (opt-in) записано для каждого контакта, которому вы будете писать.
- Общий инбокс настроен, агенты назначены отвечать на входящие сообщения.
- Тестовые сообщения отправлены на внутренние номера и проверены на Android и iOS.
- Отчёты о доставке (DLR) по тестовым отправкам изучены.
- Объём отправки запланирован в пределах текущего лимита сообщений.
Какие ошибки при настройке встречаются чаще всего?
Большинство ошибок укладывается в несколько типовых случаев. Они перечислены в документации Meta по кодам ошибок; вот те, с которыми команды при подключении сталкиваются чаще всего.
| Код ошибки | Значение (по данным Meta) | Что обычно помогает |
|---|---|---|
| 133010 | Номер телефона не зарегистрирован | Завершите регистрацию с PIN двухэтапной проверки |
| 131047 | Окно обслуживания клиентов закрыто | Отправьте одобренный шаблон вместо текста в свободной форме |
| 132001 | Шаблон не существует на этом языке или не одобрен | Проверьте название шаблона, код языка и статус одобрения |
| 132012 | Значения переменных не соответствуют формату шаблона | Приведите количество и формат переменных в соответствие |
| 131042 | Проблема со способом оплаты | Исправьте карту или кредитную линию в WABA |
| 131026 | Сообщение не доставляется | Возможно, получатель не пользуется WhatsApp или у него устаревшее приложение; используйте другой канал |
| 131049 | Сообщение задержано в целях здоровья экосистемы | Часто связано с частотой маркетинговых сообщений; подождите перед повторной отправкой и пересмотрите таргетинг |
| 368 | Аккаунт ограничен за нарушение политики | Изучите уведомления о политике в WhatsApp Manager и при необходимости подайте апелляцию |
Другие частые проблемы не относятся к кодам ошибок: номер по-прежнему активен в приложении WhatsApp, отображаемое имя не совпадает с сайтом, у администраторов нет полного контроля над портфолио.
Чем помогает OmniChannels.ai
OmniChannels.ai на базе BroadNet Technologies подключает номера WhatsApp Business API через Meta Embedded Signup, поэтому владельцем WABA остаётся ваше бизнес-портфолио. Вы можете создавать маркетинговые, служебные (utility) и аутентификационные (authentication) шаблоны, включая OTP-коды one-tap, zero-tap и copy-code, с переменными, медиа и кнопками, проверять их в предпросмотре на телефоне и отслеживать одобрение. После запуска кампании поддерживают загрузку из Excel/CSV, предпросмотр, планирование и фильтрацию дубликатов, а по каждой отправке доступны отчёты о доставке. Поддерживаются арабский и английский языки. Посмотрите страницы WhatsApp Business API и кампании или запишитесь на демо.
Часто задаваемые вопросы
Можно ли использовать мой действующий номер WhatsApp для API?
Да, при соблюдении условий. По данным Meta, номера, уже используемые в WhatsApp, нужно удалить из приложения до регистрации в API. Для подходящих номеров WhatsApp Business App Meta также предлагает опцию coexistence в Embedded Signup: приложение продолжает работать на том же номере. Прежде чем решать, проверьте доступность для вашего рынка.
Обязательна ли верификация бизнеса в Meta?
Начать отправку можно и до верификации, но с более низкими лимитами. По данным Meta, новые портфолио стартуют с двумя зарегистрированными номерами и лимитом 250 уникальных пользователей вне окна обслуживания клиентов; верификация бизнеса — один из способов увеличить лимит номеров и получить право на более высокий лимит сообщений. Большинству растущих компаний стоит пройти верификацию заранее.
Какие документы нужны для верификации бизнеса?
Обычно Meta запрашивает документы, подтверждающие юридическое название, адрес и номер телефона компании: торговую лицензию, свидетельство о регистрации или счёт за коммунальные услуги, а также сайт на домене, которым вы управляете. Требования зависят от страны и со временем меняются, поэтому следуйте подсказкам в Центре безопасности Meta Business Suite для вашего портфолио.
Почему моё отображаемое имя отклонили?
Отображаемые имена обычно отклоняют, если они явно не связаны с бизнесом, состоят только из общих слов, неправильно используют регистр или знаки препинания либо их нельзя связать с вашим сайтом или верифицированным бизнесом. Используйте название бренда, известное клиентам, убедитесь, что оно указано на сайте, и подайте заявку повторно с единообразным брендингом.
Нужен ли разработчик для настройки WhatsApp Business API?
Нет, если провайдер предлагает Embedded Signup и готовую платформу с инбоксом, шаблонами и рассылками. Разработчик нужен, если вы хотите обращаться к API напрямую, получать вебхуки в собственных системах или интегрировать WhatsApp с CRM или платформой заказов.
Источники
Читайте дальше
Ещё руководстваWhatsApp
Ссылки wa.me и QR-коды для WhatsApp: практическое руководство
Как создать ссылки wa.me с готовым текстом сообщения, QR-коды WhatsApp для печати, упаковки и магазинов и отследить, какое размещение начало диалог.
8 мин чтения
WhatsApp
Кнопки и списки в WhatsApp: какой интерактивный тип выбрать
Кнопки ответа, списки, CTA-кнопки со ссылкой, карусели и товарные сообщения в WhatsApp: когда что использовать, лимиты Meta, UX-паттерны и примеры.
8 мин чтения
Маркетинг
Сообщения гостям отеля в WhatsApp: весь путь гостя
Руководство для отелей по общению с гостями в WhatsApp: до приезда, заселение, консьерж, допродажи и отзывы, категории шаблонов, языки и штат поддержки.
8 мин чтения
