Tento návod ukazuje, jak integrovat svého Quickchat AI Agent s WhatsApp. Postup je rozdělený do 2 jednoduchých kroků:
- Krok 0 - Předpoklady
- Krok 1 - Připojení WhatsApp
Pokud máš s integrací problémy nebo potřebuješ pomoc, přejdi do sekce Řešení problémů a FAQ nebo nás kontaktuj.
Podívej se na video
Krok 0 - Předpoklady
A. Firemní telefonní číslo
Rozhodni se, které telefonní číslo budeš pro WhatsApp používat. Můžeš si přečíst víc v dokumentaci WhatsApp nebo se řídit FAQ níže:
Které číslo lze použít ve WhatsApp Cloud API?
- Musíš použít vyhrazené firemní telefonní číslo, které pro ověření dokáže přijímat SMS nebo hlasové hovory.
- Číslo musí být platné, musí patřit tobě a musí mít kód země a předvolbu.
Můžu použít číslo, které už se používá ve WhatsApp Messenger?
- Ne. Toto číslo můžeš dál používat pro hovory a SMS, ale ne ve WhatsApp Messenger.
- Pokud se číslo už používá ve WhatsApp Messenger, nejdřív ho smaž. Nezapomeň si zálohovat historii chatů ve WhatsApp.
- Zablokovaná čísla musí být před registrací odblokována.
Můžu použít číslo, které už používá WhatsApp Business App?
- Ano. Pokud se tvoje číslo aktuálně používá v WhatsApp Business App, možná ho budeš moct připojit ke Cloud API bez smazání účtu v aplikaci. Přečti si víc o připojení přes Coexistence v dokumentaci Meta.
Můžu použít nové telefonní číslo?
- Ano, pokud nechceš použít své aktuální číslo, pořiď si nové číslo (fyzickou SIM nebo virtuální číslo). Virtuální telefonní číslo si můžeš koupit u služeb jako Hushed.
B. Firemní údaje
Připrav si tyto údaje (zadáš je během integračního procesu Meta):
- Název firmy
- Firemní web
- Kategorie firmy
- Popis firmy
I když některá pole vypadají jako volitelná, vyplň je přesně. Chybějící nebo nepřesné informace mohou zpozdit schválení nebo způsobit omezení účtu.
Krok 1 - Připojení WhatsApp
Od naší poslední aktualizace stačí k připojení jedno kliknutí. Samostatný druhý krok už neexistuje: vlastní průvodce Embedded Signup od Meta tě provede vytvořením nového WhatsApp Business Account a čísla, nebo výběrem toho, který už máš, a Quickchat AI dokončí zbytek.
Otevři Quickchat AI App → External Apps → WhatsApp → klikni na tlačítko Connect WhatsApp a postupuj podle vyskakovacího okna Meta:
- Přihlas se ke svému účtu Meta (Facebook).
- Zkontroluj oprávnění, která budeš sdílet s Quickchat AI (přístup k účtu WhatsApp Business a přístup k Business portfolio), a pokračuj.
- Zadej přesné firemní údaje (Business Portfolio, Business Name, Business Website, Country atd.).
- Vytvoř nebo vyber svůj WhatsApp Business Account.
- Vyber zobrazovaný název a kategorii pro WhatsApp Business.
- Přidej své firemní telefonní číslo a ověř ho přes SMS nebo hlasový hovor podle pokynů.
- Kliknutím na Confirm uděl Quickchat AI požadovaný přístup.
- Když Meta potvrdí, že nastavení je dokončené, klikni na Finish. Vyskakovací okno zobrazí potvrzení Quickchat AI, že tvůj WhatsApp účet byl připojen, a automaticky se zavře.
Zpět v Quickchat AI App se v panelu WhatsApp zobrazí Connecting your WhatsApp account a zhruba do 30 sekund se stav změní na Connected. Pokud se to nestane, klikni v panelu na Refresh Status. Jinak se prosím vrať k části Předpoklady výše a ověř, že jsi správně zadal své firemní telefonní číslo a údaje.
Connected znamená, že Quickchat AI se dokáže spojit s tvým WhatsApp Business Account. Hned pod tím panel ukazuje, co je ještě potřeba, než zákazníci začnou dostávat odpovědi:
Panel Connected uvádí, co ještě zbývá: tady první zpráva
- Waiting for your first message: pošli z jiného telefonu zprávu WhatsApp na zobrazené číslo a potom klikni na Refresh. Jakmile zpráva dorazí, panel zobrazí Messages Received vedle Webhook Active a Admin Assigned.
- Display name: každé číslo uvedené níže v panelu nese stav zobrazovaného názvu z Meta (Approved, Pending review, Declined, Expired nebo No display name). Probíhající kontrola od tebe nic nevyžaduje a obvykle skončí během několika dní. Zamítnutý, expirovaný nebo chybějící zobrazovaný název vyžaduje, abys ho odeslal ve WhatsApp Manager.
- Meta test number: pokud je aktivním číslem číslo +1 555 poskytnuté Meta, panel to uvede. Tato čísla slouží k testování a nelze je přesunout do jiného účtu. Pokud chceš službu spustit veřejně, přidej ve WhatsApp Manager vlastní číslo.
Jakmile panel ukáže Messages Received, jsi online! 🎉 Zákazníci mohou psát na tvé WhatsApp číslo a tvůj AI Agent bude odpovídat automaticky.
Jako závěrečné ověření integrace pošli textovou zprávu na WhatsApp číslo, které jsi právě připojil, a potom v panelu klikni na Refresh. Waiting for your first message se změní na Messages Received, měl bys dostat odpověď od svého AI Agent a konverzace by se měla objevit v Inbox v Quickchat AI App. Pokud necháš některé kroky nastavení Meta nedokončené, Quickchat AI také pošle vlastníkovi účtu e-mail se zbývajícími kroky jako připomenutí.
Řešení problémů a FAQ
Jak fungují ceny WhatsApp Business API?
- Odpovědi na zákaznické dotazy zahájené uživatelem (příchozí) bere WhatsApp jako Service messages. Tyto zprávy umožňují firmám spravovat příchozí zákaznické dotazy, ať už přes lidského agenta, nebo přes konverzačního bota poháněného AI.
- Když uživatel napíše firmě, otevře se 24hodinové okno zákaznické podpory, během kterého mohou firmy odpovídat servisními zprávami bez poplatku. Toto okno se resetuje s každou zprávou od uživatele.
- Mimo 24 hodin musíš používat schválené Message Templates (Marketing, Utility, Authentication atd.) a platit za každou zprávu podle cen WhatsApp Business Platform Message Rates.
- Konverzace kategorizuje a účtuje Meta. Ujisti se, že tvůj WhatsApp Business Account má platnou platební metodu pro zprávy iniciované firmou a šablonové zprávy.
Tlačítko Connect WhatsApp nefunguje. Nevidím vyskakovací okno Meta.
- Pokud tvůj prohlížeč blokuje vyskakovací okno, aplikace zobrazí zprávu s žádostí, abys vyskakovací okna povolil. Vypni v prohlížeči blokování vyskakovacích oken a trackerů, obnov web a zkus to znovu. Pokud to nepomůže, zkus jiný prohlížeč.
Ověření čísla selhalo.
- Ujisti se, že číslo může přijímat SMS nebo hlasové hovory a není blokované aktivní registrační cestou, u které Meta nepovoluje souběžné používání. Pokud se číslo používá v Business App, zkus připojení přes Coexistence.
Meta říká, že moje nastavení není dokončené, nebo panel zobrazuje varování.
- Nejdřív si přečti kartu pod Connected: uvádí číslo, na kterém tvůj AI Agent odpovídá, a říká, jestli Meta stále kontroluje jeho zobrazovaný název, jestli jde o testovací číslo Meta, nebo jestli ještě nepřišla první zpráva. Každá karta odkazuje na správné místo ve WhatsApp Manager.
- Pokud se varování týká samotného připojení, klikni v panelu na Reconnect WhatsApp. Tím se vyřeší většina případů.
- Pokud to nepomůže, tvoje číslo může být připojené k jinému poskytovateli (Meta povoluje vždy jen jednoho partnera na jeden WhatsApp účet). Postupuj podle pokynů na obrazovce a přidej Quickchat AI jako partnera v nastavení Meta Business, potom klikni na Refresh Status.
Připojil jsem špatný účet.
- Reconnect zachová účet, který už je připojený. Pokud chceš účet změnit, klikni v panelu WhatsApp na Disconnect, potom znovu na Connect WhatsApp a v okně Meta vyber správný Meta Business účet a WhatsApp Account.
Zprávy se nezobrazují v Quickchat AI Inbox.
- Ověř, že vyskakovací okno zobrazilo závěrečné potvrzení, že tvůj WhatsApp účet byl připojen.
- Znovu zkontroluj, že jsi propojil zamýšlený WhatsApp Account a že je vybraný správný AI Agent.
- Karta Waiting for your first message uvádí číslo, na kterém tvůj AI Agent odpovídá. Ujisti se, že jsi napsal přesně na toto číslo a že je v panelu zapnuté, potom klikni na Refresh.
- Pokud posíláš zprávy po 24 hodinách bez zprávy od uživatele, použij schválené šablony a ujisti se, že je ve WhatsApp Manager nastavená platební metoda.
Odpovědi WhatsApp od mé AI se nedaří odeslat.
- Quickchat AI zobrazuje v panelu WhatsApp upozornění “WhatsApp replies are failing” a notifikaci na tvém dashboardu. Běžná řešení: dokonči schválení zobrazovaného názvu ve WhatsApp Manager; pokud připojení expirovalo nebo bylo odvoláno, klikni na Reconnect; pokud Meta omezila tvoje číslo kvůli kvalitě nebo zásadám, zkontroluj jeho stav ve WhatsApp Manager. Upozornění zmizí, jakmile se znovu úspěšně odešle odpověď.
Šablonové zprávy nebo zprávy iniciované firmou selhávají.
- Ověř, že tvoje Message Templates jsou schválené a tvoje platební metoda je aktivní ve WhatsApp Manager.
- Noví odesílatelé začínají s limity zpráv, které se navyšují podle kvality a ověření. Pokud narazíš na limity u zpráv iniciovaných firmou, projdi si pokyny Meta k Messaging Limits.
- Pokud je doručování omezené, zkontroluj limity zpráv a hodnocení kvality ve WhatsApp Manager.
Jak vytvořím vlastní WhatsApp odkaz a tlačítko „Chat on WhatsApp“?
- Postupuj podle tohoto návodu WhatsApp.
Jak vytvořím vlastní QR kód pro WhatsApp?
- Přejdi do WhatsApp Manager → Phone numbers → vyber své firemní telefonní číslo → Message links → Create Message Link.
- Případně ho najdeš ve své mobilní aplikaci WhatsApp Business. Postupuj podle tohoto návodu WhatsApp.
Potřebuješ pomoc?
Piš si s Quickchat Support AI na WhatsApp:
📱 +1 302-405-9992: Zahájit chat
Nebo naskenuj QR kód:
