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