WhatsApp по QR — канал недоступен

Подключение WhatsApp через Green-API и self-hosted шлюз в ImpactBot отключено. Это не временный сбой и не настройка тарифа: ручки подключения отвечают отказом (HTTP 501), QR не выдаётся, сообщения через эти шлюзы не ходят вообще. Карточка канала в каталоге помечена «Недоступно» по той же причине.

Раньше эта страница описывала настройку так, будто она работает. Это было неверно: по ней люди тратили время на подключение, которое не могло заработать.

Рабочий путь один — WABA (WhatsApp Business API через Meta Cloud). Инструкция: статья «WhatsApp Business API (Meta Cloud)».

Что нужно заранее

Для этого пути — ничего: готовиться не к чему, подключить его нельзя.

Для WABA, которым он заменяется, понадобятся: бизнес-аккаунт Meta и приложение с продуктом WhatsApp, номер, подтверждённый в WhatsApp Business Account, постоянный токен системного пользователя и Phone Number ID с экрана API Setup.

Права и доступы

Выдавать нечего: раз коннектор отключён, ни токенов, ни разрешений он не запрашивает и в проекте ничего не занимает — слот канала в тарифе не расходуется, потому что канал не создаётся вовсе.

Права, которые понадобятся для WABA: токен системного пользователя с доступом к WhatsApp Business Account и к самому номеру, а в подписках приложения — поле messages, без которого входящие до нас не доходят.

Подключение и вебхук

Подключить нельзя. Вебхука тоже нет — приёмник неофициальных шлюзов не поднимается, адрес выдавать не из чего, и никакая настройка на вашей стороне это не изменит.

Почему так, а не «пока не сделали». Неофициальные шлюзы держатся на веб-сессии обычного WhatsApp. Meta такие сессии закрывает, и номер вместе с накопленной перепиской теряется без предупреждения. Продавать канал, который отключается по чужому решению, мы не готовы. У WABA этой проблемы нет: номер живёт в бизнес-аккаунте, автоматизация разрешена правилами, а исходящие вне 24-часового окна идут одобренными шаблонами.

Проверка

Проверять нечего: канала нет, диагностика для него не запускается, карточка в списке каналов не появляется.

Если вы уже подключили WABA — проверка там обычная: «Проверить» на карточке канала, затем сообщение боту с личного WhatsApp, которое должно появиться в разделе «Диалоги».

Частые ошибки

• «Пробую подключить, получаю ошибку». Так и задумано: ручки `connect-green-api` и `connect-self-hosted` отвечают 501. Ошибка честная, повторять попытку бессмысленно.
• «Канал был подключён раньше, теперь молчит». Боты неофициальных провайдеров отключены целиком, а не только их создание. Переносите номер на WABA.
• «Ищу QR-код». У WABA QR-кода не бывает: номер подтверждается в Meta, а не сканированием.
• Ожидание, что переписка пропадёт при переезде. Не пропадёт: диалоги продолжаются, воронки и блоки менять не нужно, клиенты сопоставляются по номеру телефона.