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-код: