Підключіть агента Quickchat AI до WhatsApp Business, зокрема номер, який ви вже використовуєте в застосунку WhatsApp Business. Посібник описує вимоги, кроки налаштування й запуск обміну повідомленнями у WhatsApp.
Цей посібник показує, як підключити агента Quickchat AI до WhatsApp. Процес складається з 2 простих кроків:
- Крок 0: підготовка
- Крок 1: підключення WhatsApp
Якщо виникли проблеми з інтеграцією чи потрібна допомога, перейдіть до розділу усунення несправностей і поширених запитань або зв’яжіться з нами.
Додаткові інструменти налаштування
Section titled “Додаткові інструменти налаштування”-
Перевірте вимоги до налаштування WhatsApp. Зіставте вказані дані про номер і провайдера із задокументованими вимогами. Перевірка не отримує доступу до облікового запису WhatsApp і не підключає його.
-
Перевірте вікно обслуговування WhatsApp. Перевірте 24-годинне вікно за вказаними часовими мітками вхідного повідомлення й відповіді з урахуванням зміщень часових поясів. Інструмент не оцінює шаблони, згоду чи дозволи облікового запису й не надсилає повідомлень.
-
Оцініть вартість використання. Обчисліть кредити моделей Quickchat AI й окрему суму за вказаними платними позиціями. Інструмент не шукає тарифи провайдерів, не поєднує кредити з грошима й не перевіряє ваш обліковий запис.
Перегляньте відео
Section titled “Перегляньте відео”Крок 0: підготовка
Section titled “Крок 0: підготовка”А. Номер телефону компанії
Section titled “А. Номер телефону компанії”Вирішіть, який номер телефону використовуватимете для 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.
Б. Відомості про компанію
Section titled “Б. Відомості про компанію”Підготуйте такі відомості (ви введете їх під час підключення через Meta):
- Назва компанії
- Сайт компанії
- Категорія діяльності
- Опис компанії
Навіть якщо деякі поля здаються необов’язковими, заповніть їх точно. Неповні чи неправильні відомості можуть затримати схвалення або призвести до обмежень облікового запису.
Крок 1: підключення WhatsApp
Section titled “Крок 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)
Section titled “Продовжити користуватися застосунком WhatsApp Business (Coexistence)”Ви можете підключити номер, який уже використовується в застосунку WhatsApp Business, і надалі користуватися застосунком на телефоні. Meta називає це Coexistence. У Quickchat AI ця можливість перебуває в бета-версії. Ви користуєтеся застосунком як раніше, а ваш AI-агент відповідає клієнтам з того самого номера.
Перед початком
Section titled “Перед початком”- Оновіть застосунок WhatsApp Business на телефоні до версії 2.24.17 або новішої.
- За можливості почніть налаштування на комп’ютері й тримайте телефон із застосунком WhatsApp Business поруч. Підключення підтверджується в застосунку.
Підключення номера
Section titled “Підключення номера”- У застосунку 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 не імпортує минулі чати: вхідні починаються з моменту підключення, а ваші попередні чати залишаються в застосунку.
Потім надішліть тестове повідомлення з іншого телефону, як описано вище, доки панель не покаже Працює.
Як працюють відповіді
Section titled “Як працюють відповіді”- Повідомлення клієнтів і відповіді вашого AI-агента відображаються і в застосунку WhatsApp Business, і у вхідних Quickchat AI.
- Коли ви відповідаєте клієнту із застосунку, AI-агент припиняє відповідати в цьому чаті.
- Якщо в чаті 4 години не було повідомлень (ні від кого), наступне повідомлення клієнта починає новий раунд розмови, і AI-агент знову на нього відповідає. Ці 4 години фіксовані й не змінюються.
- Ви можете будь-коли повернути чат, призначивши його AI-агенту у вхідних.
Обмеження за такого підключення
Section titled “Обмеження за такого підключення”Meta застосовує ці обмеження до номера, підключеного через Coexistence:
- Списки розсилки в застосунку WhatsApp Business вимикаються.
- Групові чати не синхронізуються.
- WhatsApp для Windows не підтримується.
- Якщо ви не відкриваєте застосунок WhatsApp Business на телефоні близько 14 днів, Meta від’єднує номер.
Якщо Meta просить звільнити номер або видалити обліковий запис WhatsApp Business, не робіть цього. Натомість напишіть на support@quickchat.ai.
Усунення несправностей і поширені запитання
Section titled “Усунення несправностей і поширені запитання”Як працює тарифікація 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.
- Ми не можемо закрити, передати чи змінити брендинг вашого облікового запису, змінити оплату або видалити ваших адміністраторів.
Потрібна допомога?
Section titled “Потрібна допомога?”Поговоріть із Support AI від Quickchat у WhatsApp:
📱 +1 302-405-9992: почати чат
Або відскануйте QR-код:
