Документация › Каналы › Подключить WhatsApp

Подключить WhatsApp (Wazzup)

После этой статьи твой бот будет сам отвечать клиентам в WhatsApp — первые 3 дня и 10 диалогов бесплатно, без карты и предоплаты.

⏱ 12 мин · 👤 для владельца и оператора · 🟢 live

За 30 секунд:

• WhatsApp подключается через сервис Wazzup сканированием QR-кода — как обычный «WhatsApp на компьютере».
• Нужен «живой» рабочий номер (на котором уже переписывались), иначе WhatsApp забанит за спам.
• Перед сканом — обязательный чек-лист из 5 галочек (защита номера от бана).
• Бесплатно: 3 дня или 10 диалогов (что раньше). Дальше — подписка проекта.
• Телефоном можно продолжать пользоваться — бот работает как привязанное устройство, не вместо тебя.

Зачем это нужно

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

Каждая входящая переписка превращается в диалог, а заинтересованный клиент — в лида в твоей CRM. Ты в любой момент можешь перехватить разговор вручную (см. Диалоги).

Почему через Wazzup, а не напрямую

У WhatsApp нет «кнопки подключить бота» для обычного аккаунта. Платформа использует посредника — Wazzup — который умеет легально привязываться к твоему WhatsApp как ещё одно устройство (точно так же, как WhatsApp Web на компьютере). Тебе про Wazzup знать почти ничего не нужно: платформа всё делает за кулисами, ты только сканируешь QR. Главное помнить — подключается обычный личный/рабочий WhatsApp по QR, а не official Business API.

⚠️ Важно с самого начала. WhatsApp очень не любит, когда «свежий» номер вдруг начинает отвечать через сторонний сервис. Подключишь «холодный» номер — Meta забанит его за минуты (так называемый qridle-бан). Поэтому подключение защищено обязательным чек-листом (шаг 2). Не пропускай его: по данным поддержки Wazzup, две трети банов — именно из-за этого.

Что понадобится

• ☐ Создан проект → Создание проекта
• ☐ Написан промпт бота, хотя бы черновой (иначе боту нечем отвечать) → Системный промпт
• ☐ Телефон с WhatsApp на номере, который уже использовался для обычной переписки (не только что куплен/зарегистрирован)
• ☐ Этот телефон под рукой — на нём надо открыть камеру для скана QR
• ☐ Роль в проекте admin или owner. Роль editor видит страницу, но кнопку подключения нажать не сможет → Роли и права

Какой номер выбрать

💡 Совет. Один номер = один проект. Если у тебя два бизнеса (две стоматологии) — это два проекта и два разных номера. Подключить два WhatsApp-номера в один проект нельзя.

Шаги

1. Открой раздел «Каналы»

В меню проекта слева → «Каналы». Подзаголовок страницы: «Подключение WhatsApp и Telegram к боту проекта».

В блоке WhatsApp видно текущее состояние — «Не подключён». Под ним кнопка «Подключить WhatsApp» и памятка из трёх шагов:

1. «Подключите бесплатно» — первые 3 дня и 10 диалогов без оплаты;
2. «Сканируйте QR» — откройте WhatsApp → Связанные устройства → Привязать;
3. «Готово!» — бот начнёт отвечать клиентам автоматически.

2. Пройди чек-лист безопасности (антибан)

После нажатия откроется окно с 5 галочками — это защита твоего номера от бана. Отметь честно все пять (иначе кнопка продолжения остаётся серой):

🚫 Не делай так. Не подключай номер, купленный сегодня «специально под бота». Для WhatsApp это сигнал спама → мгновенный бан.

✅ А так правильно. Возьми номер, с которого ты или сотрудники реально переписывались хотя бы пару недель. Идеально — рабочий номер компании.

3. Отсканируй QR-код

После подтверждения чек-листа платформа создаёт подключение и показывает QR-код. Статус меняется на «Ожидаем QR».

На телефоне с нужным номером:

1. Открой WhatsApp;
2. Настройки → Связанные устройства (Linked Devices);
3. на iPhone: вкладка «Настройки» → «Связанные устройства»;
4. на Android: «⋮» (три точки) → «Связанные устройства»;
5. «Привязать устройство» → наведи камеру на QR-код на экране компьютера.

💡 Совет про «живой» QR. QR-код действует ограниченное время. Если он не появился за ~минуту, увидишь жёлтую подсказку «QR-код загружается дольше обычного. Wazzup API иногда отвечает медленно» — это нормально, подожди или обнови страницу. Если статус стал «QR истёк» — просто запусти подключение заново, сгенерируется свежий код.

4. Дождись статуса «Подключён»

Как только телефон привяжется, статус сам сменится на «Подключён», и рядом появится номер телефона. Перезагружать страницу не нужно — она обновляется в реальном времени.

📌 Пример (стоматология). Подключают рабочий +7 705…. Через ~10 секунд после скана статус — «Подключён (+7 705…)». Клиент пишет «сколько стоит чистка?» — бот отвечает сам, заявка падает в Лиды.

📌 Пример (барбершоп). Мастер боится, что после подключения «телефон отвалится». Ничего подобного: он дальше переписывается в WhatsApp как обычно, а бот просто параллельно отвечает новым клиентам. Если мастер сам вступит в диалог — бота на этом чате можно поставить на паузу.

Проверь, что работает

1. Статус в блоке WhatsApp = «Подключён» + виден номер.
2. Напиши боту с другого телефона в этот WhatsApp — должен прийти ответ от бота (несколько секунд).
3. Открой Диалоги — там появится твоя тестовая переписка.

Если бот молчит — иди в Бот не отвечает.

Сколько это стоит

• Триал — бесплатно: первые 3 дня ИЛИ 10 диалогов (что наступит раньше). Карта не нужна.
• После триала канал работает, только если у проекта активная подписка. Если не оплатить — подключение автоматически снимется (мы отключаем заранее, чтобы ты не попал на лишние списания Wazzup). Цены и оплата — в статье Биллинг.

⚠️ Важно про лимит триала. Бот мягко перестаёт отвечать уже на 9-м бесплатном диалоге (а не на 10-м) — это специально, с запасом, чтобы пробный период не «перебрал». Увидел, что бот «замолчал» на исходе триала — значит пора оформить подписку.

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

Если WhatsApp отвалился

WhatsApp может разорвать связь (телефон надолго офлайн, устройство разлогинило). Тогда в блоке появится кнопка «Переподключить» — она снова проведёт через чек-лист и QR. Это штатная операция.

⚠️ Никогда не отключай номер «вручную через телефон», чтобы потом подключить заново «по-новому». Всегда пользуйся кнопкой «Переподключить» на платформе — она удаляет старое подключение правильно (с очисткой чатов на стороне Wazzup). Иначе WhatsApp увидит «то же устройство с теми же контактами» и расценит это как уклонение от бана. Подробнее — Гигиена и антибан.

Вопросы, которые обычно возникают

Смогу ли я дальше пользоваться WhatsApp на телефоне?
Да. Бот работает как привязанное устройство (как WhatsApp Web). Твой телефон остаётся главным, ты переписываешься как обычно. Бот отвечает параллельно на новые входящие.

Что будет с моими старыми чатами и контактами?
На твоём телефоне — ничего, всё остаётся. Подключение только «читает» новые входящие и отвечает на них.

А если я сам отвечу клиенту, бот не перебьёт?
Когда оператор вступает в диалог, бота на этом чате можно поставить на паузу — он не будет встревать. Подробно — Диалоги.

Подойдёт WhatsApp Business?
Да. И обычный WhatsApp, и WhatsApp Business подключаются одинаково по QR. Главное — «живой» номер.

⚠️ Если у тебя WhatsApp Business — отключи встроенные авто-ответы (приветственное сообщение и «сообщение об отсутствии»). Найти: в приложении WhatsApp Business → Настройки → Инструменты для бизнеса → Приветственное сообщение / Сообщение в нерабочее время → выключить. Зачем: эти авто-ответы уходят от твоего имени, и платформа считает их за «оператор сам вступил в диалог» → ставит бота на паузу в этом чате (он ответит один раз и замолчит). Бот и так сам здоровается с клиентами, поэтому родной авто-ответ WhatsApp Business только мешает — два приветствия конфликтуют.

Можно один номер на два проекта?
Нет. Один номер = один канал = один проект. Для второго бизнеса — отдельный проект и отдельный номер.

Нужно ли держать телефон постоянно онлайн?
Желательно. Как и у WhatsApp Web, привязанное устройство какое-то время работает и без телефона, но если телефон надолго пропадёт из сети — WhatsApp может разлогинить устройство, и придётся «Переподключить».

Справка: состояния подключения WhatsApp

🔧 Под капотом (для разработчиков и любопытных)

Что происходит автоматически, пока ты сканируешь QR.

Архитектура связи: проект ↔ дочерний аккаунт Wazzup ↔ канал ↔ номер телефона. При первом подключении создаётся дочерний Wazzup-аккаунт (provisionWazzupAccount), внутри него — канал WhatsApp. Инвариант: 1 канал = 1 проект = 1 номер.

Поток подключения (POST /api/projects/[id]/wazzup/connect):

• права admin+; рейт-лимит 12 запросов/мин на проект;
• гейт isWazzupReconnectBlocked() — если триал истёк и подписки нет, вернётся HTTP 402 TRIAL_EXPIRED_PAYMENT_REQUIRED с текстом «Пробный период WhatsApp завершён…»;
• фронт опрашивает /wazzup/status каждые 3 секунды, до 60 попыток; предупреждение о медленном QR — после ~60 сек;
• по скану прилетает вебхук Wazzup channel.qr_update → в таблице projects ставится wazzup_authorized = true; polling это видит и рисует «Подключён».

Триал и софт-кап. Триал активен, пока одновременно: now < wazzup_trial_ends_at И число диалогов < (лимит − 1). Константы: WAZZUP_TRIAL_DAYS = 3, WAZZUP_TRIAL_CONVERSATIONS_LIMIT = 10 → бот стопорит ответы на 9-м диалоге, чтобы остаться в рамках пробного периода. После оплаты подписки лимиты снимаются.

Ройщик неоплаченных триалов (wazzup-expired-trial-offboard, крон ежечасно). Неоплаченный пробный канал удаляется к концу 3-х суток жизни (billableAgeHours 72 − safetyMargin 2 ≈ 70–71 ч), без grace-периода. При удалении: канал отключается с delete_chats=true; в projects обнуляются wazzup_channel_id / wazzup_authorized / wazzup_qr; в conversations пишется last_send_error = "WhatsApp отключён: пробный период завершён, требуется оплата подписки."; владельцу уходит событие whatsapp_disconnected. Уже авторизованный платный канал ройщик не трогает.

Антибан в коде: (1) pre-connect чек-лист обязателен (WazzupPreConnectModal, BAN-EVASION-4); (2) любое отключение идёт с delete_chats=true — иначе контакты «переедут» на следующий канал, Meta увидит «новое устройство, те же контакты» = уклонение = мгновенный qridle (BAN-EVASION-1); (3) исходящие гейтятся на реконнекте (isOutboundGatedOnReconnect); (4) софт-кап диалогов на 9.

Гейт «можно ли отвечать» (checkProjectEligibility): для WhatsApp нужно project.status === 'active' И (активный триал ИЛИ активная подписка). Для Telegram — только active, без подписки.

Таймлайн жизни триал-канала:

0ч ──────────── создан, QR отсканирован, бот в эфире
 │  бесплатно: до 3 дней ИЛИ до 9-го диалога
~70ч ─────────── если НЕ оплачено → ройщик удаляет канал (к концу 3-х суток, с запасом)
                 если оплачено → канал живёт, пока активна подписка

💬 Простыми словами

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

Первые 3 дня и 10 переписок — бесплатно, чтобы попробовать. Дальше нужна подписка, иначе подключение само отключится — и мы специально отключаем его до того, как пойдут списания, чтобы ты не переплатил.

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

Дальше: → Функции (инструменты бота)
Связано: Обзор каналов · Подключить Telegram · Биллинг · Диалоги · Антибан
Не получилось? → Канал отвалился / WhatsApp забанили · Бот не отвечает