Почему WhatsApp подключается через QR-код, а не как Telegram?

У WhatsApp, в отличие от Telegram, нет отдельного API для ботов — подключение работает так же, как WhatsApp Web: бот становится ещё одним устройством, привязанным к реальному номеру, поэтому нужно физически подтвердить привязку сканированием QR-кода с телефона.

Что делать, если связь с телефоном пропала уже после подключения?

Разрыв сессии — не ошибка конструктора и не то, что чинится само. Нужно заново открыть QR-код в карточке бота и отсканировать его тем телефоном, к которому нужно привязать номер сейчас — восстановить связь можно только тем же способом, что и при первом подключении.

К какому телефону и номеру лучше привязывать бота?

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

Блог / WhatsApp

Как подключить WhatsApp к боту: QR-код, сессия и на что обратить внимание

Q: Почему QR-код для подключения живёт всего около 20 секунд?

Это особенность механизма привязки устройств самого WhatsApp, а не решение конструктора. Экран подключения справляется с этим сам — картинка обновляется на заднем плане, пока код не отсканирован, так что зависший на вид QR обычно значит, что новый вот-вот подгрузится.

Сергей Полухин · CTO и сооснователь PapAI · 8 июня 2026

Telegram-бота конструктор подключает сам, без единого действия с вашей стороны — токен появляется в момент сохранения описания. С WhatsApp так не выйдет: у него нет отдельного API для ботов, и подключение работает как второе устройство на вашем реальном номере — через QR-код и живой телефон рядом. Разберём, что происходит на этом шаге на самом деле и что стоит знать заранее, чтобы не принять нормальное поведение экрана за поломку.

Карточка подключённого WhatsApp-канала в личном кабинете PapAI Constructor

Почему тут не кнопка, а сессия

У Telegram есть официальный API специально для ботов: бот — самостоятельная сущность со своим токеном, не связанная ни с чьим личным аккаунтом. У WhatsApp для такой задачи в конструкторе нет отдельного пути — вместо этого бот подключается тем же способом, что и WhatsApp Web: как ещё одно устройство, привязанное к вашему реальному номеру. Отсюда и разница в подключении: Telegram получает токен мгновенно, а WhatsApp просит физически подтвердить привязку с телефона, на который зарегистрирован номер.

Что происходит на экране, шаг за шагом

Нажимаете «Подключить WhatsApp» в карточке коннектора — конструктор запускает сессию на движке (WAHA).
Пока сессия стартует, статус коннектора — «подключается»; через пару секунд на экране появляется QR-код.
Открываете WhatsApp на телефоне, идёте в «Связанные устройства» → «Привязать устройство» и наводите камеру на код.
Как только телефон подтвердил привязку, сессия переходит в рабочее состояние, а коннектор — в статус «активен» с привязанным номером.

Отдельного «сохранить» после сканирования не нужно — переход в статус «активен» происходит сам: конструктор просто опрашивает состояние сессии, пока ждёт вашего скана.

Почему код живёт всего около 20 секунд

Короткий срок жизни QR-кода — не решение конструктора, а особенность самого механизма привязки устройств в WhatsApp: код теряет силу, если его не отсканировали почти сразу. Экран подключения справляется с этим сам — картинка обновляется на заднем плане, пока вы не отсканировали код, так что зависший на вид QR обычно означает, что новый вот-вот подгрузится, а не что что-то сломалось. Практический вывод простой: разблокируйте телефон и откройте «Связанные устройства» заранее, до того как откроете сам QR-код, — тогда не придётся гоняться за обновляющейся картинкой.

Если связь с телефоном пропала уже после подключения

Сессия WhatsApp в буквальном смысле держится на телефоне — а значит, всё, что происходит с этим телефоном, отражается и на боте:

Телефон разрядился, потерян или на нём сбросили настройки.
Устройство отвязали вручную из списка «Связанные устройства» в самом WhatsApp.
Телефон подолгу остаётся без интернета — WhatsApp сам разлогинивает привязанные устройства, если долго их не видит.
Номер, на который была оформлена привязка, отключили или передали другому владельцу.

Честно о поведении: разрыв сессии — это не ошибка конструктора и не то, что чинится само собой. Коннектор вернётся в состояние, требующее нового подключения, и восстановить его можно только тем же способом, что и в первый раз, — заново открыть QR-код и отсканировать его тем телефоном, к которому вы хотите привязать номер сейчас. Это ближе к перепривязке Bluetooth-устройства, чем к разовой настройке навсегда: в этом смысле WhatsApp принципиально отличается от Telegram, где боту попросту нечему физически отключаться. Если Telegram-бот всё же замолчал, дело не в сессии — причины там принципиально другие.

Телефон и номер — часть инфраструктуры бота, а не разовая деталь

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

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

Instagram и WhatsApp — продукты компании Meta Platforms Inc., деятельность которой признана экстремистской и запрещена на территории Российской Федерации.

Как разрыв сессии выглядит со стороны клиента

Со стороны клиента разорванная сессия не выглядит как ошибка — переписка просто замолкает. Человек пишет «а сколько стоит доставка», не получает ответа полчаса, потом час, и либо пишет ещё раз с раздражением, либо уходит к тому, кто ответил быстрее. Никакого сообщения об ошибке клиент не видит — с его стороны это просто бизнес, который не отвечает. Поэтому стоит время от времени проверять статус коннектора в карточке бота самостоятельно, а не полагаться на то, что о разрыве кто-то сообщит: для клиента разница между «бот сломался» и «бот просто игнорирует» не читается никак, а стоит одинаково дорого.

Итог

WhatsApp подключается по-настоящему, но не мгновенно: вместо токена — сессия, вместо одного клика — QR-код и телефон рядом. Ничего из этого не поломка и не лишний шаг по недосмотру — это то, как устроена привязка устройств в самом WhatsApp. Отнеситесь к телефону и номеру, на которых держится эта сессия, как к части инфраструктуры бота: тогда разрыв связи станет редким исключением, а не регулярным поводом писать в поддержку.