Руководство показывает, как подключить AI-агента Quickchat AI к WhatsApp. Процесс состоит из 2 простых шагов:
- Шаг 0: Подготовка.
- Шаг 1: Подключение WhatsApp.
При затруднениях откройте решение проблем и FAQ или свяжитесь с нами.
Посмотрите видео
Шаг 0: Подготовка
A. Рабочий номер телефона
Выберите номер для WhatsApp. Прочитайте документацию WhatsApp или ответы ниже.
Какой номер подходит для WhatsApp Cloud API?
- Нужен отдельный номер компании, принимающий SMS или голосовые вызовы для проверки.
- Номер должен быть действующим, принадлежать вам и содержать код страны и региона.
Можно использовать номер, уже работающий в WhatsApp Messenger?
- Нет. Звонки и SMS по-прежнему доступны, но использование в WhatsApp Messenger одновременно невозможно.
- Если номер уже зарегистрирован в Messenger, сначала удалите эту регистрацию. Не забудьте сохранить историю чатов.
- Заблокированные номера необходимо разблокировать до регистрации.
Можно использовать номер приложения WhatsApp Business?
- Да. Номер из WhatsApp Business App может подходить для Cloud API без удаления аккаунта приложения. Подробнее о подключении через Coexistence в документации Meta.
Можно взять новый номер?
- Да. Если не хотите использовать существующий, получите новый номер (физическую SIM-карту или виртуальный номер). Виртуальные номера продают сервисы вроде Hushed.
B. Сведения о компании
Подготовьте эти данные (вы введёте их при подключении через Meta):
- Название компании.
- Сайт компании.
- Категория деятельности.
- Описание компании.
Даже поля, которые кажутся необязательными, заполняйте точно. Пропуски и ошибки могут задержать одобрение или вызвать ограничения аккаунта.
Шаг 1: Подключите WhatsApp
После последнего обновления подключение начинается одним нажатием. Отдельного второго этапа больше нет: Meta Embedded Signup помогает создать или выбрать WhatsApp Business Account и номер, а Quickchat AI завершает остальное.
Откройте приложение Quickchat AI → External Apps → WhatsApp, нажмите Connect WhatsApp и следуйте инструкциям во всплывающем окне Meta:
- Войдите в аккаунт Meta (Facebook).
- Проверьте разрешения Quickchat AI, включая доступ к WhatsApp Business и бизнес-портфолио, и продолжите.
- Укажите правильные Business Portfolio, Business Name, Business Website, Country и остальные сведения.
- Создайте или выберите WhatsApp Business Account.
- Выберите отображаемое имя и категорию WhatsApp Business.
- Добавьте номер компании и подтвердите его SMS или звонком по инструкции.
- Нажмите Confirm, чтобы предоставить Quickchat AI необходимые права доступа.
- Когда Meta подтвердит завершение, нажмите Finish. Всплывающее окно покажет подтверждение Quickchat AI о подключении вашего аккаунта WhatsApp и закроется автоматически.
В приложении панель показывает Connecting your WhatsApp account, затем примерно за 30 секунд Connected. Если нет, нажмите Refresh Status. Если это не помогло, вернитесь к разделу Подготовка выше и убедитесь, что правильно указали номер и сведения о компании.
Connected означает, что Quickchat AI может получить доступ к вашему аккаунту WhatsApp Business. Ниже панель показывает, что ещё нужно сделать, чтобы клиенты получали ответы:
Панель Connected показывает оставшийся шаг: здесь это первое сообщение
- Waiting for your first message: отправьте сообщение WhatsApp с другого телефона на указанный номер, затем нажмите Refresh. Когда сообщение придёт, рядом с Webhook Active и Admin Assigned появится Messages Received.
- Отображаемое имя: для каждого номера в нижней части панели показан статус имени в Meta (Approved, Pending review, Declined, Expired или No display name). Если проверка ещё идёт, ничего делать не нужно: обычно она завершается за несколько дней. Если имя отклонено, срок его действия истёк или оно отсутствует, отправьте имя на проверку в WhatsApp Manager.
- Тестовый номер Meta: если активный номер предоставлен Meta и начинается с +1 555, панель сообщит об этом. Такие номера предназначены для тестирования, их нельзя перенести в другой аккаунт. Чтобы начать работу с клиентами, добавьте свой номер в WhatsApp Manager.
Когда панель покажет Messages Received, агент готов к работе! 🎉 Клиенты смогут писать на номер WhatsApp и получать автоматические ответы.
Для проверки отправьте текстовое сообщение через WhatsApp на только что подключённый номер, затем нажмите Refresh на панели. Waiting for your first message сменится на Messages Received. Агент должен ответить, а беседа появиться в Inbox Quickchat AI. Если шаги Meta остались незавершёнными, Quickchat AI также отправит владельцу аккаунта напоминание по электронной почте с оставшимися шагами.
Решение проблем и FAQ
Как устроены цены WhatsApp Business API?
- Ответы на входящие обращения пользователей считаются Service messages. Их используют сотрудники и AI-боты для обработки запросов клиентов.
- Сообщение пользователя открывает 24-часовое окно обслуживания, в котором сервисные ответы бесплатны. Окно начинается заново с каждым сообщением пользователя.
- После 24 часов нужны одобренные Message Templates, например Marketing, Utility или Authentication. Оплата взимается за каждое сообщение по тарифам WhatsApp.
- Meta классифицирует разговоры и рассчитывает их стоимость. Добавьте действующий способ оплаты в WhatsApp Business Account для сообщений от компании и шаблонов.
Кнопка Connect WhatsApp не работает, окно Meta не появляется.
- При блокировке окна приложение просит разрешить его. Отключите блокировщики всплывающих окон и трекеров, обновите страницу и повторите. При необходимости смените браузер.
Проверка номера не проходит.
- Убедитесь, что номер принимает SMS или звонки и не связан с регистрацией, для которой Meta не допускает совместную работу. Для номера Business App попробуйте подключение Coexistence.
Meta сообщает о незавершённой настройке или панель показывает предупреждение.
- Сначала прочитайте карточку под Connected: она показывает номер, на котором отвечает ваш агент, и сообщает, проверяет ли Meta отображаемое имя, используется ли тестовый номер Meta или ещё не пришло первое сообщение. Каждая карточка содержит ссылку на нужный раздел WhatsApp Manager.
- Если предупреждение касается самого подключения, нажмите Reconnect WhatsApp. В большинстве случаев это решает проблему.
- Если нет, номер может быть подключён к другому поставщику. Meta разрешает одного партнёра на аккаунт WhatsApp одновременно. Добавьте Quickchat AI партнёром в Meta Business по инструкции и нажмите Refresh Status.
Подключён неверный аккаунт.
- Reconnect сохраняет уже подключённый аккаунт. Чтобы сменить его, нажмите Disconnect на панели WhatsApp, затем снова Connect WhatsApp и выберите в окне Meta правильные Meta Business и WhatsApp Account.
Сообщения не появляются в Quickchat AI Inbox.
- Проверьте, было ли показано окончательное подтверждение подключения.
- Убедитесь, что выбраны нужные WhatsApp Account и AI Agent.
- Карточка Waiting for your first message показывает номер, на котором отвечает ваш агент. Убедитесь, что отправили сообщение именно на этот номер и что он включён на панели, затем нажмите Refresh.
- Если отправляете после 24 часов без нового сообщения пользователя, используйте одобренные шаблоны и настройте оплату в WhatsApp Manager.
Ответы AI в WhatsApp не отправляются.
- Quickchat AI показывает «WhatsApp replies are failing» на панели WhatsApp и уведомление в панели управления. Частые решения: завершить одобрение отображаемого имени в WhatsApp Manager; нажать Reconnect, если срок действия подключения истёк или доступ был отозван; проверить статус в WhatsApp Manager, если Meta ограничила номер из-за качества или правил. Предупреждение исчезнет после успешного ответа.
Не отправляются шаблоны или сообщения от компании.
- Проверьте, что Message Templates одобрены, а способ оплаты активен в WhatsApp Manager.
- Для новых отправителей действуют лимиты сообщений, которые растут с повышением качества и после верификации. Изучите рекомендации Meta по Messaging Limits, если достигли лимита сообщений, инициируемых компанией.
- При ограничении доставки проверьте лимиты сообщений и рейтинг качества в WhatsApp Manager.
Как создать собственную ссылку WhatsApp и кнопку «Chat on WhatsApp»?
- Следуйте этому руководству WhatsApp.
Как создать свой QR-код WhatsApp?
- Откройте WhatsApp Manager → Phone numbers, выберите рабочий номер телефона, затем Message links → Create Message Link.
- Код доступен также в мобильном WhatsApp Business. Следуйте этому руководству.
Нужна помощь?
Поговорите с Support AI Quickchat в WhatsApp:
📱 +1 302-405-9992: Начать чат
Или отсканируйте QR-код:
