Чатва

Поиск по документации

Поиск по заголовкам, инструкциям и подписям к изображениям. ↑ ↓ — выбрать, Enter — открыть, Esc — закрыть.

Введите название канала или нужный шаг подключения.

    Документация: WhatsApp*

    WhatsApp*

    Обновлено 11 октября 2026 г.

    На этой странице

    Для личного номера используйте QR или код привязки в приложении Чатвы. Для бизнес-интеграции выберите Meta Cloud API — у неё отдельные данные подключения и правила отправки сообщений.

    Перед подключением

    • Личный профиль: WhatsApp с активным номером и доступом к «Связанным устройствам».
    • Бизнес: доступ к нужному бизнес-аккаунту Meta и номеру WhatsApp Business Platform.

    Откройте нужную группу в Чатве → «Каналы» → карточку канала → «Подключить». При первом подключении пройдите подсказки кнопкой «Далее». В мобильном приложении тот же мастер доступен в онбординге и разделе «Каналы».

    Выберите сценарий

    Способ 1. QR-код

    1. Покажите QR в Чатве

      В веб-кабинете выберите «Личный профиль» → «Показать QR для связки». В приложении выберите «По QR».

    2. Откройте связанные устройства WhatsApp

      На Android откройте WhatsApp → ⋮ → «Связанные устройства»; на iPhone — WhatsApp → «Настройки» → «Связанные устройства». Нажмите «Связать устройство» и отсканируйте код с другого экрана. Инструкция WhatsApp.

    3. Дождитесь появления номера

      QR может обновляться — сканируйте тот, который виден сейчас. После успешной привязки проверьте подключённый номер в Чатве.

    Способ 2. На одном телефоне

    1. В приложении Чатвы выберите «По номеру»

      Введите полный номер WhatsApp с кодом страны и нажмите «Получить код».

    2. Скопируйте или запомните код привязки

      Чатва покажет код. Это не SMS и не одноразовый код входа в WhatsApp — его нужно ввести в настройках связанных устройств.

    3. Нажмите «Открыть WhatsApp»

      Перейдите: «Связанные устройства» → «Связать устройство» → «Привязать по номеру телефона». Введите показанный Чатвой код и вернитесь в Чатву. Привязка по номеру в справке WhatsApp.

    Способ 3. WhatsApp Business через Meta

    В веб-кабинете выберите «Бизнес (Meta*)». Если доступна кнопка «Подключить через Meta», пройдите вход, выберите нужный бизнес и номер, затем завершите мастер. Если кнопки нет, используйте ручную форму. В мобильном приложении вкладка «Бизнес» содержит ручные поля.

    В Meta: где взять данные WhatsApp Business

    Этот раздел нужен для ручного подключения Cloud API. Откройте список приложений Meta и выберите своё приложение с WhatsApp. Если его ещё нет, создайте приложение со сценарием WhatsApp по официальному мастеру.

    1. Найдите идентификатор рабочего номера

      В приложении Meta откройте WhatsApp → API Setup («Настройка API»; в новом мастере — Start using the API). Выберите свой рабочий номер в From и скопируйте Phone Number ID. Не копируйте сам телефон, WhatsApp Business Account ID или ID тестового номера. Описание Meta.

    2. Откройте системных пользователей

      В настройках бизнеса Meta выберите нужный бизнес → Users / «Пользователи» → System users / «Системные пользователи». Выберите пользователя интеграции или создайте его кнопкой Add. В Assign assets добавьте своё приложение и аккаунт WhatsApp. Порядок выдачи доступа.

    Meta Business Settings: System users → Add Assets. На опубликованном примере выбрано приложение автора; выберите своё. Вид кабинета может отличаться.

    Источник: Digital Inspiration · Meta Business Settings ↗

    Meta Business Settings: System users → Add Assets. На опубликованном примере выбрано приложение автора; выберите своё. Вид кабинета может отличаться.

    Источник: Digital Inspiration · Meta Business Settings ↗
    Meta Business Settings: System users → Add Assets. На опубликованном примере выбрано приложение автора; выберите своё. Вид кабинета может отличаться.
    1. Создайте токен доступа для интеграции

      У выбранного пользователя в Meta Business Settings нажмите Generate token / Generate New Token. Выберите своё приложение, срок действия и разрешения WhatsApp по инструкции Meta. Для сообщений нужны whatsapp_business_messaging и whatsapp_business_management. Скопируйте выданное значение в поле «Токен доступа» Чатвы.

    Кнопка Generate New Token у системного пользователя Meta. Снимок из инструкции Digital Inspiration, интерфейс на английском.

    Источник: Digital Inspiration · Generate New Token ↗

    Кнопка Generate New Token у системного пользователя Meta. Снимок из инструкции Digital Inspiration, интерфейс на английском.

    Источник: Digital Inspiration · Generate New Token ↗
    Кнопка Generate New Token у системного пользователя Meta. Снимок из инструкции Digital Inspiration, интерфейс на английском.

    App Secret, Verify token и адрес вебхука

    Поле ЧатвыОткуда взять
    Phone Number IDMeta Apps → WhatsApp → API Setup → выбранный рабочий номер → Phone Number ID.
    Токен доступаBusiness Settings → System users → Generate token, как показано выше.
    Meta App SecretMeta Apps → ваше приложение → App settings / Settings → Basic → App Secret → Show. Описание поля.
    Verify tokenПридумайте собственную случайную строку и внесите одно и то же значение в Чатву и Meta. Это не App Secret и не токен доступа.
    Callback URLСкопируйте адрес вебхука из формы WhatsApp Business в Чатве. Сначала сохраните подключение, затем вставьте адрес в Meta → WhatsApp → Configuration → Webhook.

    В настройках вебхука в Meta Apps укажите Callback URL и тот же Verify token, подтвердите адрес, затем включите поле messages для WhatsApp. Официальная настройка вебхуков.

    Проверьте входящее сообщение и ответ

    1. Напишите с другого аккаунта

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

    2. Найдите диалог в Чатве

      Откройте «Инбокс» нужной группы, проверьте канал и отправителя. Если установлен фильтр по оператору или статусу, временно переключитесь на все диалоги.

    3. Ответьте из инбокса

      Отправьте «Сообщение получили» и убедитесь на стороне клиента, что ответ пришёл от нужного номера, бота или страницы. Отметка подключения сама по себе не проверяет доставку в обе стороны.

    Несколько операторов и номеров

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

    Если не получилось

    Что произошлоЧто проверить
    Не получается сканировать QR на том же телефонеВ приложении Чатвы переключитесь на «По номеру» либо покажите QR на компьютере.
    Связанное устройство отключилосьПроверьте список устройств в WhatsApp и подключите аккаунт заново в Чатве.
    Meta не подтверждает URLСохраните данные в Чатве до проверки, сравните Verify token символ в символ и используйте URL именно этой группы.
    Входящие есть, ответ не доставленПроверьте ошибку у сообщения, действительность токена и разрешения Meta. Тестируйте ответ на свежее обращение клиента.