Това ръководство показва как да интегрирате своя Quickchat AI Agent с WhatsApp. Процесът е разделен на 2 лесни стъпки:
- Стъпка 0 - Предварителни изисквания
- Стъпка 1 - Свързване на WhatsApp
Ако имате проблеми с интеграцията или се нуждаете от помощ, отидете в раздела Отстраняване на проблеми и ЧЗВ или се свържете с нас.
Гледайте видеото
Стъпка 0 - Предварителни изисквания
A. Служебен телефонен номер
Решете кой телефонен номер ще използвате за WhatsApp. Можете да прочетете повече в документацията на WhatsApp или да следвате ЧЗВ по-долу:
Кой номер може да се използва в 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
След последната ни актуализация свързването се извършва с едно кликване. Вече няма отделна втора стъпка: собственият съветник на Meta Embedded Signup ви води през създаването на нов 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 и се актуализира до Connected в рамките на около 30 секунди. Ако това не се случи, кликнете върху 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: ако активният номер е предоставен от Meta номер +1 555, панелът го посочва. Тези номера са за изпробване и не могат да бъдат преместени в друг акаунт. Добавете собствен номер в 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 също изпраща имейл до собственика на акаунта с оставащите стъпки като напомняне.
Отстраняване на проблеми и ЧЗВ
Как работи ценообразуването на WhatsApp Business API?
- Отговорите на потребителски (входящи) клиентски запитвания се третират от WhatsApp като Service messages. Тези съобщения позволяват на бизнесите да управляват входящи клиентски запитвания, независимо дали чрез човешки агент, или чрез conversational AI-powered bot.
- Когато потребителите изпратят съобщение до бизнес, това отваря 24-часов прозорец за обслужване на клиенти, през който бизнесите могат да отговарят със service messages без такса. Този прозорец се нулира при всяко потребителско съобщение.
- Извън 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.
Съобщенията не се появяват в Quickchat AI Inbox.
- Потвърдете, че изскачащият прозорец е показал финалното потвърждение, че вашият 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 кода:
