Подключите агента Quickchat AI к WhatsApp Business, в том числе номер, который вы уже используете в приложении WhatsApp Business. В руководстве описаны требования, шаги настройки и запуск обмена сообщениями в WhatsApp.
В этом руководстве описано, как подключить агента Quickchat AI к WhatsApp. Процесс состоит из 2 простых шагов:
- Шаг 0: подготовка
- Шаг 1: подключение WhatsApp
Если возникли проблемы с интеграцией или нужна помощь, перейдите к устранению неполадок и частым вопросам или свяжитесь с нами.
Дополнительные инструменты настройки
Заголовок раздела «Дополнительные инструменты настройки»-
Проверьте требования к настройке WhatsApp. Сопоставьте указанные данные о номере и провайдере с документированными требованиями. Проверка не получает доступ к аккаунту WhatsApp и не подключает его.
-
Проверьте окно обслуживания WhatsApp. Проверьте 24-часовое окно по указанным временным меткам входящего сообщения и ответа с учётом смещений часовых поясов. Инструмент не оценивает шаблоны, согласие или разрешения аккаунта и не отправляет сообщения.
-
Оцените стоимость использования. Рассчитайте кредиты моделей Quickchat AI и отдельный итог по указанным платным позициям. Инструмент не запрашивает тарифы провайдеров, не объединяет кредиты с деньгами и не проверяет ваш аккаунт.
Посмотрите видео
Заголовок раздела «Посмотрите видео»Шаг 0: подготовка
Заголовок раздела «Шаг 0: подготовка»А. Номер телефона компании
Заголовок раздела «А. Номер телефона компании»Решите, какой номер телефона использовать для WhatsApp. Можно прочитать подробнее в документации WhatsApp или воспользоваться ответами ниже:
Какой номер подходит для WhatsApp Cloud API?
- Нужен отдельный номер телефона компании, который может получать SMS или голосовые звонки для подтверждения.
- Номер должен быть действующим, принадлежать вам и содержать код страны и региона.
Можно ли использовать номер, который уже используется в личном WhatsApp (WhatsApp Messenger)?
- Нет. Вы можете продолжать пользоваться этим номером для звонков и SMS, но не в личном WhatsApp.
- Чтобы подключить его, удалите аккаунт WhatsApp на этом номере, подождите несколько минут, а затем подключите номер. Удаление аккаунта стирает историю чатов, поэтому сначала создайте резервную копию истории чатов WhatsApp. Если хотите сохранить чаты, подключите другой номер.
- Перед регистрацией заблокированных номеров нужно снять блокировку.
Можно ли использовать номер, который уже используется в приложении WhatsApp Business?
- Да (бета). Вы можете подключить его и продолжать пользоваться приложением WhatsApp Business на телефоне. Ваш AI-агент отвечает клиентам с того же номера, а ваши чаты остаются в приложении. Meta называет это Coexistence. См. раздел Продолжить использовать приложение WhatsApp Business (Coexistence).
- Чтобы подключить номер, не удаляйте аккаунт WhatsApp Business и не переносите номер.
Можно ли использовать новый номер телефона?
- Да. Если вы не хотите использовать текущий номер, приобретите новый (физическую SIM-карту или виртуальный номер). Виртуальный номер можно купить в сервисах вроде Hushed.
Б. Сведения о компании
Заголовок раздела «Б. Сведения о компании»Подготовьте следующие сведения (вы введёте их при подключении через Meta):
- Название компании
- Сайт компании
- Категория деятельности
- Описание компании
Даже если некоторые поля кажутся необязательными, заполните их точно. Неполные или неверные сведения могут задержать одобрение или привести к ограничениям аккаунта.
Шаг 1: подключение WhatsApp
Заголовок раздела «Шаг 1: подключение WhatsApp»Откройте приложение Quickchat AI → Каналы → Внешние приложения → WhatsApp. В поле Какой номер подключаете? выберите вариант, который подходит вашему номеру:
- Новый номер, которого нет в WhatsApp: выполните шаги ниже.
- Номер, уже используемый в приложении WhatsApp Business: следуйте разделу Продолжить использовать приложение WhatsApp Business (Coexistence).
- Номер, уже используемый в личном WhatsApp: сначала удалите аккаунт WhatsApp на этом номере (это сотрёт историю чатов), подождите несколько минут, а затем выполните шаги ниже. Или используйте другой номер.
Затем нажмите Подключить WhatsApp и следуйте инструкциям во всплывающем окне Meta:
Также можно начать из ChatGPT, Claude или другого подключённого AI-приложения: попросите ссылку для подключения этого агента к WhatsApp. Ссылка действует 10 минут, используется один раз и работает только для аккаунта Quickchat, который её запросил. Откройте её в браузере, где вы вошли в этот аккаунт, пройдите настройку Meta и завершите выбор аккаунта или телефона, если он появится после возвращения в Quickchat. Затем попросите AI-приложение проверить настройку и отправьте настоящее сообщение WhatsApp, чтобы убедиться, что AI-ответ приходит. Если подключено несколько номеров, проверьте каждый активный. Вы разрешаете доступ Meta в браузере, не передавая токены в чат.
- Войдите в аккаунт Meta (Facebook).
- Ознакомьтесь с разрешениями, которые предоставите Quickchat AI (доступ к аккаунту WhatsApp Business и бизнес-портфолио), и продолжите.
- Укажите точные сведения о компании (бизнес-портфолио, название, сайт, страну и т. д.).
- Создайте или выберите аккаунт WhatsApp Business.
- Выберите отображаемое имя и категорию WhatsApp Business.
- Добавьте номер телефона компании и подтвердите его по SMS или звонком, следуя инструкциям.
- Нажмите Confirm, чтобы предоставить Quickchat AI необходимый доступ.
- Когда Meta подтвердит завершение настройки, нажмите Finish. Во всплывающем окне появится подтверждение Quickchat AI о подключении аккаунта WhatsApp, после чего оно автоматически закроется.
Если номер используется в приложении WhatsApp Business, в окне Meta выберите подключение существующего приложения WhatsApp Business, затем подтвердите его в приложении, когда появится запрос (бета).
Если Meta предоставит Quickchat AI доступ к нескольким аккаунтам, панель WhatsApp покажет Выберите аккаунт WhatsApp Business вместо немедленного подключения. Выберите аккаунт, в котором должен отвечать ваш AI-агент, и нажмите Использовать этот аккаунт. При повторном подключении текущая настройка WhatsApp остаётся без изменений до вашего подтверждения.
После возвращения в приложение Quickchat AI панель WhatsApp показывает Завершить настройку, пока не будет подтверждён успешный обмен сообщениями на вашем номере компании. Если панель не обновилась примерно за 30 секунд, нажмите значок обновления.
Подключение к Meta и получение сообщения составляют лишь часть настройки. Панель показывает следующий шаг для каждого включённого номера:
- Ожидание первого сообщения: отправьте сообщение WhatsApp на указанный номер с другого телефона, затем нажмите Обновить. Убедитесь, что пишете на номер компании, которым будут пользоваться клиенты.
- Ожидание доставки ответа AI: Quickchat получил сообщение, но WhatsApp ещё не подтвердил доставку AI-ответа. Проверьте, пришёл ли ответ на другой телефон. Если нет, проверьте кредиты AI и предупреждения в панели, затем отправьте ещё одно тестовое сообщение.
- Ответ AI доставлен: WhatsApp подтвердил доставку AI-ответа на входящее сообщение через этот номер компании.
- Проверка требует внимания: устраните предупреждения о подключении, оставьте нужный номер включённым и отправьте новое тестовое сообщение.
- Display name: у каждого номера ниже в панели указан статус отображаемого имени от Meta (Одобрено, Ожидает проверки, Отклонено, Истёк или Нет отображаемого имени). Пока идёт проверка, от вас ничего не требуется; обычно она завершается за несколько дней. Если имя отклонено, срок его действия истёк или оно отсутствует, нужно подать его в WhatsApp Manager.
- Meta test number: предоставленные Meta номера +1 555 и номера песочницы не подтверждают активацию вашего номера компании. Добавьте собственный номер в WhatsApp Manager, включите его в Quickchat и проверьте именно его.
Панель показывает Работает, когда для каждого включённого номера компании подтверждён обмен сообщениями, а проверки подключения не выявляют проблем. Если вы включили несколько номеров компании, проверьте каждый. Успешный обмен на тестовом номере, отправленный шаблон или уведомление о лимите сообщений не завершают эту проверку.
Оставьте интеграцию включённой во время теста. Отправьте сообщение с другого телефона на каждый нужный номер компании, убедитесь, что AI-ответ приходит, и нажмите Обновить. Разговор также должен появиться во входящих приложения Quickchat AI. Существующее подключение может запросить новый тестовый обмен для проверки доставки; пока вы выполняете этот шаг, оно может продолжать получать сообщения и отвечать на них.
Если у Meta остались незавершённые шаги подключения, выполните их в Setup guidance в WhatsApp Manager. Quickchat AI также отправляет владельцу аккаунта напоминание по электронной почте, если шаги настройки Meta не завершены.
Продолжить использовать приложение WhatsApp Business (Coexistence)
Заголовок раздела «Продолжить использовать приложение WhatsApp Business (Coexistence)»Вы можете подключить номер, который уже используется в приложении WhatsApp Business, и продолжать пользоваться приложением на телефоне. Meta называет это Coexistence. В Quickchat AI эта возможность находится в бета-версии. Вы пользуетесь приложением как раньше, а ваш AI-агент отвечает клиентам с того же номера.
Перед началом
Заголовок раздела «Перед началом»- Обновите приложение WhatsApp Business на телефоне до версии 2.24.17 или новее.
- По возможности начните настройку на компьютере и держите телефон с приложением WhatsApp Business рядом. Подключение подтверждается в приложении.
Подключение номера
Заголовок раздела «Подключение номера»- В приложении Quickchat AI откройте Каналы → Внешние приложения → WhatsApp.
- В поле Какой номер подключаете? выберите Номер, уже используемый в приложении WhatsApp Business. На панели появится Продолжить использовать приложение WhatsApp Business (бета).
- Нажмите Подключить WhatsApp.
- В окне Meta нажмите Continue. Если Meta предлагает подключить ваше существующее приложение WhatsApp Business, выберите этот вариант. В противном случае выберите Enter a new phone number и введите номер, который вы используете в приложении WhatsApp Business.
- Когда приложение WhatsApp Business на телефоне попросит, нажмите Connect, а затем Confirm.
- Meta может спросить, делиться ли историей чатов. Это необязательно. Quickchat AI не импортирует прошлые чаты: входящие начинаются с момента подключения, а ваши прежние чаты остаются в приложении.
Затем отправьте тестовое сообщение с другого телефона, как описано выше, пока панель не покажет Работает.
Как работают ответы
Заголовок раздела «Как работают ответы»- Сообщения клиентов и ответы вашего AI-агента отображаются и в приложении WhatsApp Business, и во входящих Quickchat AI.
- Когда вы отвечаете клиенту из приложения, AI-агент перестаёт отвечать в этом чате.
- Если в чате 4 часа не было сообщений (ни от кого), следующее сообщение клиента начинает новый раунд разговора, и AI-агент снова на него отвечает. Эти 4 часа фиксированы и не меняются.
- Вы можете в любой момент вернуть чат, назначив его AI-агенту во входящих.
Ограничения при таком подключении
Заголовок раздела «Ограничения при таком подключении»Meta применяет эти ограничения к номеру, подключённому через Coexistence:
- Списки рассылки в приложении WhatsApp Business отключаются.
- Групповые чаты не синхронизируются.
- WhatsApp для Windows не поддерживается.
- Если вы не открываете приложение WhatsApp Business на телефоне около 14 дней, Meta отключает номер.
Если Meta просит освободить номер или удалить аккаунт WhatsApp Business, не делайте этого. Вместо этого напишите на support@quickchat.ai.
Устранение неполадок и частые вопросы
Заголовок раздела «Устранение неполадок и частые вопросы»Как устроена тарификация WhatsApp Business API?
- WhatsApp считает ответы на инициированные пользователями (входящие) обращения сервисными сообщениями. Они позволяют компаниям обрабатывать входящие запросы клиентов силами сотрудника или разговорного AI-бота.
- Когда пользователь пишет компании, открывается 24-часовое окно обслуживания, в течение которого компания может отвечать сервисными сообщениями бесплатно. Это окно начинается заново с каждым сообщением пользователя.
- За пределами 24 часов нужно использовать одобренные шаблоны сообщений (маркетинговые, служебные, аутентификационные и т. д.) и платить за каждое сообщение по тарифам WhatsApp Business Platform.
- Meta классифицирует разговоры и начисляет плату. Убедитесь, что для аккаунта WhatsApp Business указан действующий способ оплаты для сообщений по инициативе компании и шаблонных сообщений.
Кнопка Подключить WhatsApp не работает. Всплывающее окно Meta не появляется.
- Если браузер блокирует всплывающее окно, разрешите такие окна для приложения Quickchat AI и нажмите Попробовать снова. Также можно нажать Продолжить в Meta в этой вкладке, чтобы выполнить ту же настройку без всплывающего окна.
Quickchat не удалось подтвердить подключение WhatsApp
Quickchat показывает это сообщение о восстановлении, когда окно Meta не возвращает результат и Quickchat всё ещё не может проверить подключение. Это не означает, что Meta не внесла никаких изменений.
- Убедитесь, что вы администратор Meta Business, которому принадлежит аккаунт WhatsApp Business. Если нет, попросите администратора подключить его, войдя через свой Facebook.
- Нажмите Попробовать снова. Если блокировщик мешает окну Meta, используйте приватное окно с временно отключёнными расширениями или нажмите Продолжить в Meta в этой вкладке.
- Если номер активен в личном WhatsApp, удалите аккаунт WhatsApp на этом номере (это сотрёт историю чатов), подождите несколько минут и повторите попытку или используйте другой номер. Если он активен в приложении WhatsApp Business, удалять ничего не нужно: подключитесь снова, выберите Номер, уже используемый в приложении WhatsApp Business и в окне Meta выберите подключение существующего приложения WhatsApp Business. См. раздел Продолжить использовать приложение WhatsApp Business (Coexistence).
- Если аккаунт WhatsApp Business использует Aircall, Twilio, 360dialog, MessageBird или другого провайдера, добавьте Quickchat AI как партнёра в настройках компании Meta:
- Откройте Meta Business Settings и перейдите в Accounts → WhatsApp Accounts.
- Выберите аккаунт WhatsApp Business, откройте Partners и нажмите Add Partners.
- Введите Business ID Quickchat AI:
270696274483463. - Предоставьте Manage WhatsApp accounts, вернитесь в Quickchat AI и обновите статус.
Отключайте другого провайдера только если Meta не разрешает обоих партнёров в этом аккаунте. Если сомневаетесь, обратитесь в поддержку, прежде чем отключать работающего провайдера сообщений.
Проверка номера не прошла.
- Убедитесь, что номер может получать SMS или голосовые звонки.
- Если номер используется в приложении WhatsApp Business, подключите его через Coexistence и убедитесь, что версия приложения 2.24.17 или новее. Не удаляйте аккаунт WhatsApp Business и не переносите номер в попытке убрать ошибку.
- Общее сообщение Ineligible или подсказка This number can’t be shared with this app не устанавливают причину. Напишите на support@quickchat.ai, указав точный текст сообщения и шаг, на котором оно появилось.
Я подключил не тот аккаунт.
- Переподключить сохраняет уже подключённый аккаунт. Чтобы перевести AI-агента на другой аккаунт WhatsApp Business, нажмите Отключить в панели WhatsApp, затем снова Подключить WhatsApp и выберите правильные аккаунты Meta Business и WhatsApp в окне Meta.
Не удалось определить аккаунт WhatsApp Business для подключения
- Ваш вход в Meta даёт доступ к нескольким аккаунтам WhatsApp Business с номерами телефонов, и Quickchat не смог определить нужный. Напишите на support@quickchat.ai номер телефона, который хотите подключить, и мы завершим настройку за вас.
Сообщения не появляются во входящих Quickchat AI.
- Убедитесь, что во всплывающем окне появилось окончательное подтверждение: “WhatsApp account connected!”.
- Ещё раз проверьте, что вы подключили нужный аккаунт WhatsApp и выбрали правильного AI-агента.
- Карточка Ожидание первого сообщения показывает номер, на котором отвечает AI-агент. Убедитесь, что написали именно на него и что он включён в панели, затем нажмите Обновить.
- Если вы отправляете сообщения после 24 часов без сообщения от пользователя, используйте одобренные шаблоны и убедитесь, что в WhatsApp Manager указан способ оплаты.
AI-ответы в WhatsApp не отправляются.
Если AI-ответы не удаётся доставить, Quickchat AI показывает предупреждение “WhatsApp replies are failing” в панели WhatsApp в разделе Внешние приложения и уведомление в панели управления. Основные причины и решения:
- Отображаемое имя тестового номера Meta не одобрено: Meta удерживает ответы с предоставленного ею номера +1 555 до одобрения его отображаемого имени. Предупреждение об имени в панели становится красным и указывает номер. Дождитесь завершения проверки (обычно несколько дней) или, если имя отклонено, подайте новое в WhatsApp Manager, затем отправьте тестовое сообщение. Проверка отображаемого имени на вашем собственном номере сама по себе не блокирует ответы; панель показывает её как примечание.
- Подключение истекло или отозвано: ваше подключение WhatsApp больше не действует. Откройте панель WhatsApp и нажмите Переподключить, чтобы возобновить отправку ответов.
- Номер ограничен: Meta ограничила номер из-за рейтинга качества или нарушения правил. Проверьте статус в WhatsApp Manager, чтобы восстановить отправку.
- Бизнес-аккаунт заблокирован (ошибка 131031): Meta заблокировала ответы с аккаунта WhatsApp Business. Ошибка доставки во входящих и панель WhatsApp объясняют ограничение. Откройте Business Support Home, выберите аккаунт WhatsApp, затем нарушение и нажмите Request Review: Meta снимает блокировку аккаунта только через эту проверку. Повторное подключение Quickchat не снимает ограничение.
Другие предупреждения исчезают автоматически после следующей успешной отправки ответа. Предупреждение о блокировке аккаунта остаётся, пока на новое сообщение настоящего посетителя не будет полностью доставлен AI-ответ: Meta может принять ответ, а затем отклонить его отправку. Если активны только тестовые номера Meta (+1 555), предупреждение снимает следующий успешно отправленный AI-ответ. Support AI также может объяснить недавнюю сохранённую ошибку блокировки аккаунта, но исторические данные не доказывают, что он по-прежнему заблокирован.
Не отправляются шаблонные сообщения или сообщения по инициативе компании.
- Убедитесь, что шаблоны сообщений одобрены, а способ оплаты активен в WhatsApp Manager.
- Новые отправители начинают с лимитов сообщений, которые растут в зависимости от качества и проверки. Если вы достигли лимита сообщений по инициативе компании, изучите руководство Meta по лимитам сообщений.
- Проверьте лимиты сообщений и рейтинг качества в WhatsApp Manager, если скорость доставки ограничивается.
Как создать собственную ссылку WhatsApp и кнопку “Chat on WhatsApp”?
- Следуйте этому руководству WhatsApp.
- Или скачайте фирменные дизайны кнопок WhatsApp и используйте один из следующих фрагментов кода:
<!-- WhatsApp inline button --><!-- Update WHATSAPP_PHONE_NUMBER and filename/path as needed --><a aria-label="Chat on WhatsApp" href="https://wa.me/WHATSAPP_PHONE_NUMBER" target="_blank" rel="noopener noreferrer"> <img alt="Chat on WhatsApp" src="WhatsAppButtonGreenLarge.svg" style=" width: 200px; height: auto; cursor: pointer; border-radius: 12px; " /></a>или
<!-- WhatsApp floating button --><!-- Update WHATSAPP_PHONE_NUMBER and filename/path as needed --><a aria-label="Chat on WhatsApp" href="https://wa.me/WHATSAPP_PHONE_NUMBER" target="_blank" rel="noopener noreferrer" style="position: fixed; right: 20px; bottom: 20px; z-index: 9999"> <img alt="Chat on WhatsApp" src="WhatsAppButtonGreenLarge.svg" style=" width: 200px; height: auto; cursor: pointer; border-radius: 12px; box-shadow: rgba(0, 0, 0, 0.5) 0px 5px 15px 0px; transition: all 0.3s ease; " onmouseover="this.style.transform = 'scale(1.05)'" onmouseout="this.style.transform = 'scale(1)'" /></a>Как создать собственный QR-код WhatsApp?
- Откройте WhatsApp Manager → Phone numbers → выберите номер телефона компании → Message links → Create Message Link.
- Также его можно найти в мобильном приложении WhatsApp Business. Следуйте этому руководству WhatsApp.
Нужно ли удалять аккаунт приложения WhatsApp Business, чтобы исправить настройку?
- Нет. Вы можете подключить номер из приложения WhatsApp Business и продолжать пользоваться приложением. См. раздел Продолжить использовать приложение WhatsApp Business (Coexistence).
- Если Meta просит освободить номер или удалить аккаунт WhatsApp Business, не делайте этого. Вместо этого напишите на support@quickchat.ai.
Какой доступ Quickchat AI получает к нашему аккаунту WhatsApp Business?
- Ограниченный доступ по API, а не владение аккаунтом. Ваш аккаунт WhatsApp Business (WABA) находится в вашем Meta Business Manager. По модели WABA Sharing от Meta активы принадлежат вам, а Quickchat AI добавляется как партнёр, доступ которого можно в любой момент отозвать в Business Manager.
- Пока интеграция активна, мы можем отправлять и получать сообщения через Cloud API и получать события сообщений через webhook.
- Мы не можем закрыть, передать или переименовать ваш аккаунт под другой бренд, изменить оплату или удалить ваших администраторов.
Нужна помощь?
Заголовок раздела «Нужна помощь?»Поговорите с Support AI от Quickchat в WhatsApp:
📱 +1 302-405-9992: начать чат
Или отсканируйте QR-код:
