У цьому посібнику показано, як інтегрувати вашого 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?
- Так, через Coexistence (бета). Номер залишається в WhatsApp Business App на вашому телефоні, а ваш AI Agent відповідає на тому самому номері. Видаляти акаунт застосунку не потрібно. Кроки описано в розділі Крок 1 нижче. Також можна прочитати про підключення через Coexistence в документації Meta.
Чи можна використовувати новий номер телефону?
- Так, якщо ви не хочете використовувати поточний номер, отримайте новий номер (фізичну SIM-картку або віртуальний номер). Віртуальний номер телефону можна купити в сервісах, наприклад Hushed.
Б. Інформація про бізнес
Підготуйте ці дані (ви вводитимете їх під час процесу інтеграції 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 підключено, після чого воно закриється автоматично.
Хочете залишити WhatsApp Business App на цьому номері (Coexistence, бета)? Оновіть WhatsApp Business App до версії 2.24.17 або новішої. На панелі WhatsApp виберіть A number already used in the WhatsApp Business app, потім натисніть Connect WhatsApp. У вікні Meta виберіть підключення наявного WhatsApp Business App (або введіть його номер) замість підтвердження номера кодом, потім підтвердьте підключення в застосунку на телефоні. Після цього:
- Ви й далі користуєтеся застосунком на телефоні, а ваш AI Agent відповідає клієнтам на тому самому номері.
- Коли ви відповідаєте клієнту із застосунку, AI Agent перестає відповідати в цьому чаті. Через 4 години без повідомлень у чаті наступне повідомлення клієнта починає новий раунд, і AI Agent знову відповідає. Також можна повернути чат AI Agent в Inbox Quickchat AI.
- Попередні чати залишаються в застосунку. Inbox Quickchat AI починається з моменту підключення.
- Meta обмежує цей режим: списки розсилки вимкнені, групові чати не синхронізуються, WhatsApp для Windows не підтримується, а номер від’єднується приблизно через 14 днів, якщо не відкривати застосунок на телефоні.
Повернувшись у 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 або голосові виклики. Якщо номер досі активний в особистому WhatsApp Messenger, спершу видаліть цей обліковий запис WhatsApp або використайте інший номер. Якщо номер використовується в WhatsApp Business App, підключіться знову, виберіть A number already used in the WhatsApp Business app і у вікні Meta підключіть наявний застосунок замість підтвердження номера кодом (підключення Coexistence). Потрібна версія застосунку 2.24.17 або новіша.
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 і сповіщення на вашій панелі керування. Типові виправлення: завершіть схвалення відображуваної назви у WhatsApp Manager; якщо підключення закінчилося або було відкликане, натисніть Reconnect; якщо Meta обмежила ваш номер через якість або правила, перевірте його статус у WhatsApp Manager. Сповіщення зникає, коли відповідь знову буде успішно надіслано.
Не вдається надіслати шаблонні або ініційовані бізнесом повідомлення.
- Переконайтеся, що ваші 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. Дотримуйтеся цього посібника WhatsApp.
Потрібна допомога?
Поспілкуйтеся з Support AI Quickchat у WhatsApp:
📱 +1 302-405-9992: Почати чат
Або відскануйте QR-код:
