WhatsApp

В этом руководстве описано, как подключить агента Quickchat AI к WhatsApp. Процесс состоит из 2 простых шагов:

• Шаг 0: подготовка
• Шаг 1: подключение WhatsApp

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

Дополнительные инструменты настройки

• Проверьте требования к настройке WhatsApp. Сопоставьте указанные данные о номере и провайдере с документированными требованиями. Проверка не получает доступ к аккаунту WhatsApp и не подключает его.

• Проверьте окно обслуживания WhatsApp. Проверьте 24-часовое окно по указанным временным меткам входящего сообщения и ответа с учётом смещений часовых поясов. Инструмент не оценивает шаблоны, согласие или разрешения аккаунта и не отправляет сообщения.

• Оцените стоимость использования. Рассчитайте кредиты моделей Quickchat AI и отдельный итог по указанным платным позициям. Инструмент не запрашивает тарифы провайдеров, не объединяет кредиты с деньгами и не проверяет ваш аккаунт.

Посмотрите видео

Play

Шаг 0: подготовка

А. Номер телефона компании

Решите, какой номер телефона использовать для WhatsApp. Можно прочитать подробнее в документации WhatsApp или воспользоваться ответами ниже:

Какой номер подходит для WhatsApp Cloud API?

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

Можно ли использовать номер, который уже используется в WhatsApp Messenger?

• Нет. Вы можете продолжать пользоваться этим номером для звонков и SMS, но не в WhatsApp Messenger.
• Если номер уже используется в WhatsApp Messenger, сначала удалите его оттуда. Не забудьте создать резервную копию истории чатов WhatsApp.
• Перед регистрацией заблокированных номеров нужно снять блокировку.

Можно ли использовать номер, который уже используется в приложении WhatsApp Business?

• Текущий процесс подключения Quickchat AI не предоставляет проверенного варианта Coexistence для существующего номера приложения WhatsApp Business. Meta описывает совместное использование в поддерживаемых интеграциях в руководстве по подключению пользователей приложения Business.
• Если вам нужно сохранить текущий номер, аккаунт приложения Business и историю чатов, напишите на support@quickchat.ai, прежде чем продолжать. Не удаляйте и не отключайте аккаунт приложения Business и не переносите номер ради устранения неполадок.

Можно ли использовать новый номер телефона?

• Да. Если вы не хотите использовать текущий номер, приобретите новый (физическую SIM-карту или виртуальный номер). Виртуальный номер можно купить в сервисах вроде Hushed.

Б. Сведения о компании

Подготовьте следующие сведения (вы введёте их при подключении через Meta):

• Название компании
• Сайт компании
• Категория деятельности
• Описание компании

Осторожно

Даже если некоторые поля кажутся необязательными, заполните их точно. Неполные или неверные сведения могут задержать одобрение или привести к ограничениям аккаунта.

Шаг 1: подключение WhatsApp

Откройте приложение Quickchat AI → External Apps → WhatsApp → нажмите Connect WhatsApp и следуйте инструкциям во всплывающем окне Meta:

Также можно начать из ChatGPT, Claude или другого подключённого AI-приложения: попросите ссылку для подключения этого агента к WhatsApp. Ссылка действует 10 минут, используется один раз и работает только для аккаунта Quickchat, который её запросил. Откройте её в браузере, где вы вошли в этот аккаунт, пройдите настройку Meta и завершите выбор аккаунта или телефона, если он появится после возвращения в Quickchat. Затем попросите AI-приложение проверить настройку и отправьте настоящее сообщение WhatsApp, чтобы убедиться, что AI-ответ приходит. Если подключено несколько номеров, проверьте каждый активный. Вы разрешаете доступ Meta в браузере, не передавая токены в чат.

1. Войдите в аккаунт Meta (Facebook).
2. Ознакомьтесь с разрешениями, которые предоставите Quickchat AI (доступ к аккаунту WhatsApp Business и бизнес-портфолио), и продолжите.
3. Укажите точные сведения о компании (бизнес-портфолио, название, сайт, страну и т. д.).
4. Создайте или выберите аккаунт WhatsApp Business.
5. Выберите отображаемое имя и категорию WhatsApp Business.
6. Добавьте номер телефона компании и подтвердите его по SMS или звонком, следуя инструкциям.
7. Нажмите Confirm, чтобы предоставить Quickchat AI необходимый доступ.
8. Когда Meta подтвердит завершение настройки, нажмите Finish. Во всплывающем окне появится подтверждение Quickchat AI о подключении аккаунта WhatsApp, после чего оно автоматически закроется.

Если Meta предоставит Quickchat AI доступ к нескольким аккаунтам, панель WhatsApp покажет Choose your WhatsApp Business Account вместо немедленного подключения. Выберите аккаунт, в котором должен отвечать ваш AI-агент, и нажмите Use this account. При повторном подключении текущая настройка WhatsApp остаётся без изменений до вашего подтверждения.

После возвращения в приложение Quickchat AI панель WhatsApp показывает Finish setup, пока не будет подтверждён успешный обмен сообщениями на вашем номере компании. Если панель не обновилась примерно за 30 секунд, нажмите значок обновления.

Подключение к Meta и получение сообщения составляют лишь часть настройки. Панель показывает следующий шаг для каждого включённого номера:

• Waiting for your first message: отправьте сообщение WhatsApp на указанный номер с другого телефона, затем нажмите Refresh. Убедитесь, что пишете на номер компании, которым будут пользоваться клиенты.
• Waiting for the AI reply to be delivered: Quickchat получил сообщение, но WhatsApp ещё не подтвердил доставку AI-ответа. Проверьте, пришёл ли ответ на другой телефон. Если нет, проверьте кредиты AI и предупреждения в панели, затем отправьте ещё одно тестовое сообщение.
• AI reply delivered: WhatsApp подтвердил доставку AI-ответа на входящее сообщение через этот номер компании.
• Verification needs attention: устраните предупреждения о подключении, оставьте нужный номер включённым и отправьте новое тестовое сообщение.
• Display name: у каждого номера ниже в панели указан статус отображаемого имени от Meta (Approved, Pending review, Declined, Expired или No display name). Пока идёт проверка, от вас ничего не требуется; обычно она завершается за несколько дней. Если имя отклонено, срок его действия истёк или оно отсутствует, нужно подать его в WhatsApp Manager.
• Meta test number: предоставленные Meta номера +1 555 и номера песочницы не подтверждают активацию вашего номера компании. Добавьте собственный номер в WhatsApp Manager, включите его в Quickchat и проверьте именно его.

Панель показывает Live, когда для каждого включённого номера компании подтверждён обмен сообщениями, а проверки подключения не выявляют проблем. Если вы включили несколько номеров компании, проверьте каждый. Успешный обмен на тестовом номере, отправленный шаблон или уведомление о лимите сообщений не завершают эту проверку.

Совет

Оставьте интеграцию включённой во время теста. Отправьте сообщение с другого телефона на каждый нужный номер компании, убедитесь, что AI-ответ приходит, и нажмите Refresh. Разговор также должен появиться во входящих приложения Quickchat AI. Существующее подключение может запросить новый тестовый обмен для проверки доставки; пока вы выполняете этот шаг, оно может продолжать получать сообщения и отвечать на них.

Если у Meta остались незавершённые шаги подключения, выполните их в Setup guidance в WhatsApp Manager. Quickchat AI также отправляет владельцу аккаунта напоминание по электронной почте, если шаги настройки Meta не завершены.

Устранение неполадок и частые вопросы

Как устроена тарификация WhatsApp Business API?

• WhatsApp считает ответы на инициированные пользователями (входящие) обращения сервисными сообщениями. Они позволяют компаниям обрабатывать входящие запросы клиентов силами сотрудника или разговорного AI-бота.
• Когда пользователь пишет компании, открывается 24-часовое окно обслуживания, в течение которого компания может отвечать сервисными сообщениями бесплатно. Это окно начинается заново с каждым сообщением пользователя.
• За пределами 24 часов нужно использовать одобренные шаблоны сообщений (маркетинговые, служебные, аутентификационные и т. д.) и платить за каждое сообщение по тарифам WhatsApp Business Platform.
• Meta классифицирует разговоры и начисляет плату. Убедитесь, что для аккаунта WhatsApp Business указан действующий способ оплаты для сообщений по инициативе компании и шаблонных сообщений.

Кнопка Connect WhatsApp не работает. Всплывающее окно Meta не появляется.

• Если браузер блокирует всплывающее окно, разрешите такие окна для приложения Quickchat AI и нажмите Try again. Также можно нажать Continue on Meta in this tab, чтобы выполнить ту же настройку без всплывающего окна.

Quickchat couldn’t confirm the WhatsApp connection

Quickchat показывает это сообщение о восстановлении, когда окно Meta не возвращает результат и Quickchat всё ещё не может проверить подключение. Это не означает, что Meta не внесла никаких изменений.

1. Убедитесь, что вы администратор Meta Business, которому принадлежит аккаунт WhatsApp Business. Если нет, попросите администратора подключить его, войдя через свой Facebook.
2. Нажмите Try again. Если блокировщик мешает окну Meta, используйте приватное окно с временно отключёнными расширениями или нажмите Continue on Meta in this tab.
3. Если номер активен в WhatsApp Messenger, сначала удалите его оттуда или используйте другой. Если он активен в приложении WhatsApp Business, остановитесь и напишите на support@quickchat.ai, прежде чем продолжать. Текущий процесс подключения Quickchat AI не предоставляет проверенного варианта Coexistence. Не удаляйте и не отключайте аккаунт приложения Business и не переносите номер для устранения этой ошибки.
4. Если аккаунт WhatsApp Business использует Aircall, Twilio, 360dialog, MessageBird или другого провайдера, добавьте Quickchat AI как партнёра в настройках компании Meta:
   1. Откройте Meta Business Settings и перейдите в Accounts → WhatsApp Accounts.
   2. Выберите аккаунт WhatsApp Business, откройте Partners и нажмите Add Partners.
   3. Введите Business ID Quickchat AI: 270696274483463.
   4. Предоставьте Manage WhatsApp accounts, вернитесь в Quickchat AI и обновите статус.

Отключайте другого провайдера только если Meta не разрешает обоих партнёров в этом аккаунте. Если сомневаетесь, обратитесь в поддержку, прежде чем отключать работающего провайдера сообщений.

Проверка номера не прошла.

• Убедитесь, что номер может получать SMS или голосовые звонки.
• Общее сообщение Ineligible или подсказка This number can’t be shared with this app не устанавливают причину и не подтверждают, выполнены ли требования Meta к совместному использованию. Напишите на support@quickchat.ai, указав точный текст сообщения и шаг, на котором оно появилось.
• Если номер используется в приложении WhatsApp Business и вам нужно сохранить этот аккаунт и историю, обратитесь в поддержку, прежде чем продолжать. Не удаляйте и не отключайте аккаунт и не переносите номер в попытке убрать ошибку.

Я подключил не тот аккаунт.

• Reconnect сохраняет уже подключённый аккаунт. Чтобы перевести AI-агента на другой аккаунт WhatsApp Business, нажмите Disconnect в панели WhatsApp, затем снова Connect WhatsApp и выберите правильные аккаунты Meta Business и WhatsApp в окне Meta.

We could not tell which WhatsApp Business Account to connect

• Ваш вход в Meta даёт доступ к нескольким аккаунтам WhatsApp Business с номерами телефонов, и Quickchat не смог определить нужный. Напишите на support@quickchat.ai номер телефона, который хотите подключить, и мы завершим настройку за вас.

Сообщения не появляются во входящих Quickchat AI.

• Убедитесь, что во всплывающем окне появилось окончательное подтверждение: “WhatsApp account connected!”.
• Ещё раз проверьте, что вы подключили нужный аккаунт WhatsApp и выбрали правильного AI-агента.
• Карточка Waiting for your first message показывает номер, на котором отвечает AI-агент. Убедитесь, что написали именно на него и что он включён в панели, затем нажмите Refresh.
• Если вы отправляете сообщения после 24 часов без сообщения от пользователя, используйте одобренные шаблоны и убедитесь, что в WhatsApp Manager указан способ оплаты.

AI-ответы в WhatsApp не отправляются.

Если AI-ответы не удаётся доставить, Quickchat AI показывает предупреждение “WhatsApp replies are failing” в панели WhatsApp в разделе External Apps и уведомление в панели управления. Основные причины и решения:

• Отображаемое имя тестового номера Meta не одобрено: Meta удерживает ответы с предоставленного ею номера +1 555 до одобрения его отображаемого имени. Предупреждение об имени в панели становится красным и указывает номер. Дождитесь завершения проверки (обычно несколько дней) или, если имя отклонено, подайте новое в WhatsApp Manager, затем отправьте тестовое сообщение. Проверка отображаемого имени на вашем собственном номере сама по себе не блокирует ответы; панель показывает её как примечание.
• Подключение истекло или отозвано: ваше подключение WhatsApp больше не действует. Откройте панель WhatsApp и нажмите Reconnect, чтобы возобновить отправку ответов.
• Номер ограничен: 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, чтобы исправить настройку?

• Нет. Не удаляйте и не отключайте аккаунт приложения Business и не переносите его номер ради устранения неполадок. Текущий процесс подключения Quickchat AI не предоставляет проверенного варианта Coexistence, который сохраняет существующую настройку приложения и историю.
• Прежде чем менять работающий аккаунт приложения Business, напишите на support@quickchat.ai. Руководство Meta по подключению пользователей приложения Business описывает совместное использование для поддерживаемых интеграций; оно не подтверждает доступность для вашей настройки 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-код: