☁️ Подключение WhatsApp Cloud API (WACA) напрямую к Meta
WACA это официальный WhatsApp Cloud API, подключённый напрямую. Аккаунт WhatsApp Business и номер живут в вашем бизнес-портфолио Meta, а за сообщения Meta списывает деньги с карты вашей компании по своим ставкам. WazzaBee берёт только подписку за линию, наценки на сообщения нет. Подключение занимает 15 минут.
WACA или WABA: что выбрать
| WACA (напрямую) | WABA (через WazzaBee) | |
|---|---|---|
| Кто платит Meta | Ваша компания, картой в аккаунте Meta | WazzaBee, а вы пополняете баланс линии |
| Наценка на сообщения | Нет | Входит в цену сообщения |
| Как подключается | Приложение Meta, токен и три поля в кабинете | Вход через Facebook прямо из кабинета |
| Приложение WhatsApp на телефоне | Нет, номер работает только через API | Можно оставить через Coexistence |
| 1 000 бесплатных ответов в месяц | Да, на каждый номер | Нет |
Если у компании нет карты для международных платежей или не хочется разбираться с кабинетом разработчика Meta, подключайте WABA. Сравнение всех способов и калькулятор расходов есть на странице WhatsApp Cloud API.
Что подготовить
- ✅ Аккаунт Facebook администратора компании;
- ✅ Бизнес-портфолио в Meta Business Suite: готовое или созданное по шагу 1;
- ✅ Номер телефона, который принимает SMS или звонок и не зарегистрирован в приложении WhatsApp;
- ✅ Банковская карта Visa или Mastercard с разрешёнными международными онлайн-платежами;
- ✅ Кабинет WazzaBee, открытый в соседней вкладке.
Номер занят обычным WhatsApp? Освободите его: WhatsApp → Настройки → Аккаунт → Удалить аккаунт, подождите 3 минуты и продолжайте. Переписка из приложения при этом не переносится.
📱 Пошаговое подключение
Шаг 1. Бизнес-портфолио Meta
Откройте business.facebook.com и войдите через Facebook. Если портфолио у компании ещё нет, нажмите «Создать аккаунт» и заполните название компании, своё имя и рабочую почту.
В разделе «Настройки» → «Информация о компании» укажите юридическое название, адрес, телефон и сайт так же, как они записаны в регистрационных документах. От этого зависит, пройдёт ли компания верификацию, когда понадобится поднять лимит рассылок.
Шаг 2. Приложение в кабинете разработчика
- Откройте developers.facebook.com/apps. При первом входе Meta попросит зарегистрироваться как разработчик: подтвердите телефон и почту.
- Нажмите «Создать приложение».
- Введите название, например «WhatsApp WazzaBee», и контактную почту.
- В списке сценариев выберите «Общайтесь с клиентами в WhatsApp» (Connect with customers through WhatsApp).
- Выберите своё бизнес-портфолио из шага 1 и завершите создание.
Шаг 3. Номер телефона
- В меню приложения откройте WhatsApp → «Настройка API» (API Setup).
- В блоке номеров нажмите «Добавить номер телефона».
- Заполните профиль WhatsApp: отображаемое имя, категорию и описание. Имя увидят клиенты, поэтому пишите название компании без рекламных слов.
- Введите номер и выберите способ подтверждения: SMS или звонок. Введите полученный код.
- Задайте PIN двухэтапной проверки из шести цифр и сохраните его. Он понадобится при переносе номера и для получения синей галочки.
ℹ️ В этом же разделе Meta показывает ID номера телефона (Phone number ID) и ID аккаунта WhatsApp Business (WhatsApp Business Account ID). Скопируйте оба, они понадобятся на шаге 7.
Шаг 4. Способ оплаты
- Откройте WhatsApp Manager и выберите свой аккаунт WhatsApp Business.
- Перейдите в «Настройки аккаунта» → «Оплата» и нажмите «Добавить способ оплаты».
- Выберите страну и валюту аккаунта. После привязки карты валюту сменить нельзя.
- Введите данные карты и сохраните.
⚠️ Не пропускайте этот шаг. Без способа оплаты Meta не доставляет платные сообщения, а с 1 октября 2026 года и обычные ответы клиентам сверх бесплатной тысячи в месяц.
Шаг 5. Системный пользователь
Обычный токен из раздела «Настройка API» живёт 24 часа, для постоянной работы нужен токен системного пользователя.
- В Meta Business Suite откройте «Настройки компании» → «Пользователи» → «Системные пользователи».
- Нажмите «Добавить», введите имя, например «wazzabee», и выберите роль «Администратор».
- Нажмите «Назначить ресурсы». Во вкладке «Приложения» отметьте приложение из шага 2 и включите полный доступ.
- Во вкладке «Аккаунты WhatsApp» отметьте свой аккаунт и тоже включите полный доступ.
Шаг 6. Постоянный токен
- На странице системного пользователя нажмите «Сгенерировать маркер».
- Выберите приложение из шага 2.
- Срок действия: «Никогда».
- Отметьте разрешения whatsapp_business_messaging и whatsapp_business_management.
- Нажмите «Сгенерировать» и сразу скопируйте токен. Второй раз Meta его не покажет.
🔒 Токен даёт полный доступ к отправке сообщений от имени компании. Не пересылайте его в мессенджерах и не публикуйте. Вставляйте только в кабинет WazzaBee.
Шаг 7. Подключение в WazzaBee
- В кабинете откройте «Линии связи» и нажмите «Добавить линию».
- Выберите WhatsApp, затем WhatsApp Cloud API (WACA).
- Введите название линии, его видят только ваши менеджеры.
- Вставьте токен из шага 6, ID номера телефона и ID аккаунта WhatsApp Business из шага 3.
- Нажмите «Подключить». WazzaBee проверит токен и покажет адрес вебхука и маркер подтверждения.
Шаг 8. Вебхук для входящих сообщений
- Вернитесь в приложение Meta: WhatsApp → «Конфигурация» (Configuration).
- В блоке «Вебхук» нажмите «Изменить», вставьте адрес и маркер подтверждения из кабинета WazzaBee и сохраните.
- В списке полей вебхука подпишитесь на messages.
- Отправьте на подключённый номер сообщение со своего телефона. Если оно появилось в чатах WazzaBee, линия работает.
💳 Сколько стоит
| Что | Кому платите |
|---|---|
| Подписка за линию | WazzaBee, в тенге, долларах или евро |
| Рассылки, уведомления, коды подтверждения | Meta, с карты по ставке страны получателя |
| Ответы клиентам в окне 24 часа | Meta, с 1 октября 2026 года сверх 1 000 бесплатных в месяц на номер |
| Входящие сообщения | Бесплатно |
Актуальную цену подписки, ставки Meta по Казахстану и Кыргызстану и калькулятор смотрите на странице WhatsApp Cloud API.
🛠 Что может пойти не так
| Проблема | Решение |
|---|---|
| «This phone number is already registered» | Номер занят приложением WhatsApp. Удалите аккаунт на телефоне, подождите 3 минуты и повторите шаг 3 |
| Код подтверждения не приходит | Выберите подтверждение звонком. Виртуальные номера и номера, недавно удалённые из WhatsApp, часто не получают SMS |
| Нет сценария «Общайтесь с клиентами в WhatsApp» | Приложение создано не того типа. Создайте новое и выберите бизнес-портфолио при создании |
| Системного пользователя нельзя создать | У вас нет прав администратора портфолио. Попросите владельца портфолио выдать полный доступ |
| WazzaBee пишет, что токен недействителен | Токен скопирован не полностью, выпущен со сроком действия или без разрешений whatsapp_business_messaging и whatsapp_business_management. Выпустите новый по шагу 6 |
| Исходящие уходят, входящие не приходят | Не настроен вебхук или нет подписки на поле messages. Проверьте шаг 8 |
| Сообщения не доставляются, ошибка оплаты | Карта не привязана или платёж отклонён. Проверьте раздел «Оплата» в WhatsApp Manager и разрешите международные платежи в банке |
| Шаблон отклонён | Причину отказа видно в WazzaBee. Исправьте текст по разбору частых ошибок и отправьте заново |
➡️ Что дальше
- Лимиты сообщений, уровень и качество номера: как выйти за 250 получателей в сутки;
- Шаблоны сообщений: что нужно, чтобы писать клиентам первыми;
- Подключение Битрикс24: переписка из WhatsApp в открытых линиях CRM.
