Acest ghid arată cum să îți integrezi Quickchat AI Agent cu WhatsApp. Procesul este împărțit în 2 pași simpli:
- Pasul 0 - Cerințe preliminare
- Pasul 1 - Conectează WhatsApp
Dacă ai probleme cu integrarea sau ai nevoie de ajutor, mergi la secțiunea Depanare și întrebări frecvente sau contactează-ne.
Urmărește videoclipul
Pasul 0 - Cerințe preliminare
A. Număr de telefon de business
Decide ce număr de telefon vei folosi pentru WhatsApp. Poți citi mai multe în documentația WhatsApp sau poți consulta întrebările frecvente de mai jos:
Ce număr poate fi folosit în WhatsApp Cloud API?
- Trebuie să folosești un număr de telefon de business dedicat care poate primi SMS-uri sau apeluri vocale pentru verificare.
- Numărul trebuie să fie valid, să îți aparțină și să aibă un cod de țară și un prefix.
Pot folosi un număr care este deja folosit în WhatsApp Messenger?
- Nu. Poți continua să folosești acest număr pentru apeluri și SMS-uri, dar nu în WhatsApp Messenger.
- Dacă numărul este deja folosit în WhatsApp Messenger, șterge-l mai întâi. Nu uita să faci backup istoricului conversațiilor WhatsApp.
- Numerele blocate trebuie deblocate înainte de înregistrare.
Pot folosi un număr care este deja folosit de WhatsApp Business App?
- Da. Dacă numărul tău este folosit în prezent în WhatsApp Business App, este posibil să îl poți înregistra în Cloud API fără să ștergi contul din aplicație. Citește mai multe despre integrarea prin Coexistence în documentația Meta.
Pot folosi un număr de telefon nou?
- Da, dacă preferi să nu folosești numărul actual, obține un număr nou (SIM fizic sau număr virtual). Poți cumpăra un număr de telefon virtual de la servicii precum Hushed.
B. Informații despre business
Pregătește aceste detalii (le vei introduce în timpul fluxului de integrare Meta):
- Numele businessului
- Website-ul businessului
- Categoria businessului
- Descrierea businessului
Chiar dacă unele câmpuri par opționale, completează-le corect. Informațiile lipsă sau incorecte pot întârzia aprobarea sau pot cauza restricții ale contului.
Pasul 1 - Conectează WhatsApp
De la cea mai recentă actualizare, conectarea necesită un singur clic. Nu mai există un al doilea pas separat: asistentul Embedded Signup al Meta te ghidează prin crearea unui nou WhatsApp Business Account și a unui număr sau prin alegerea unuia pe care îl ai deja, iar Quickchat AI finalizează restul.
Deschide Quickchat AI App → External Apps → WhatsApp → apasă butonul Connect WhatsApp și urmează fereastra pop-up Meta:
- Autentifică-te în contul tău Meta (Facebook).
- Verifică permisiunile pe care le vei partaja cu Quickchat AI (acces la contul WhatsApp Business și acces la portofoliul Business) și continuă.
- Furnizează detalii corecte despre business (Business Portfolio, Business Name, Business Website, Country etc.).
- Creează sau selectează WhatsApp Business Account.
- Alege un nume afișat și o categorie pentru WhatsApp Business.
- Adaugă numărul de telefon de business și verifică-l prin SMS/voce, conform instrucțiunilor.
- Apasă Confirm pentru a acorda Quickchat AI accesul necesar.
- Când Meta confirmă că configurarea este completă, apasă Finish. Fereastra pop-up afișează o confirmare Quickchat AI că contul tău WhatsApp a fost conectat și se închide automat.
Înapoi în Quickchat AI App, panoul WhatsApp afișează Connecting your WhatsApp account și se actualizează la Connected în aproximativ 30 de secunde. Dacă nu se întâmplă acest lucru, apasă Refresh Status în panou. În caz contrar, revizuiește Cerințe preliminare de mai sus pentru a te asigura că ai furnizat corect numărul de telefon de business și informațiile.
Connected înseamnă că Quickchat AI poate accesa WhatsApp Business Account. Imediat dedesubt, panoul arată ce mai este necesar înainte ca clienții să primească răspunsuri:
Panoul Connected listează ce mai rămâne: aici, primul mesaj
- Waiting for your first message: trimite un mesaj WhatsApp la numărul afișat, de pe alt telefon, apoi apasă Refresh. După ce un mesaj a sosit, panoul afișează Messages Received lângă Webhook Active și Admin Assigned.
- Display name: fiecare număr listat mai jos în panou preia de la Meta starea numelui afișat (Approved, Pending review, Declined, Expired sau No display name). O verificare în curs nu necesită nicio acțiune din partea ta și se finalizează de obicei în câteva zile. Un nume afișat respins, expirat sau lipsă îți cere să trimiți unul în WhatsApp Manager.
- Meta test number: dacă numărul activ este un număr +1 555 furnizat de Meta, panoul indică acest lucru. Aceste numere sunt pentru testare și nu pot fi mutate în alt cont. Adaugă propriul număr în WhatsApp Manager pentru a trece în producție.
După ce panoul afișează Messages Received, ești live! 🎉 Clienții pot trimite mesaje la numărul tău WhatsApp, iar AI Agentul tău va răspunde automat.
Ca verificare finală a integrării, trimite un mesaj text la numărul WhatsApp pe care tocmai l-ai conectat, apoi apasă Refresh în panou. Waiting for your first message se transformă în Messages Received, ar trebui să primești un răspuns de la AI Agentul tău, iar conversația ar trebui să apară în Inbox din Quickchat AI App. Dacă lași nefinalizați pași de configurare Meta, Quickchat AI îi trimite și proprietarului contului un e-mail cu pașii rămași, ca reamintire.
Depanare și întrebări frecvente
Cum funcționează tarifele WhatsApp Business API?
- Răspunsurile la solicitările clienților inițiate de utilizator (inbound) sunt tratate de WhatsApp ca mesaje de serviciu. Aceste mesaje permit companiilor să gestioneze solicitările primite de la clienți, fie printr-un agent uman, fie printr-un bot conversațional bazat pe AI.
- Când utilizatorii trimit mesaje unei companii, se deschide o fereastră de servicii pentru clienți de 24 de ore, timp în care companiile pot răspunde cu mesaje de serviciu, fără costuri. Această fereastră se resetează la fiecare mesaj al utilizatorului.
- În afara celor 24 de ore, trebuie să folosești Message Templates aprobate (Marketing, Utility, Authentication etc.) și să plătești per mesaj conform tarifelor pentru mesaje WhatsApp Business Platform.
- Conversațiile sunt clasificate și facturate de Meta. Asigură-te că WhatsApp Business Account are o metodă de plată validă pentru mesaje inițiate de business/pe bază de template.
Butonul Connect WhatsApp nu funcționează. Nu văd fereastra pop-up Meta.
- Dacă browserul blochează fereastra pop-up, aplicația afișează un mesaj care îți cere să permiți ferestrele pop-up. Dezactivează blocatoarele de pop-up-uri și trackere în browser, reîncarcă website-ul și încearcă din nou. Dacă nu ajută, încearcă un alt browser.
Verificarea numărului a eșuat.
- Asigură-te că numărul poate primi SMS-uri/apeluri vocale și nu este blocat de o cale de înregistrare activă pe care Meta nu permite să coexiste. Dacă numărul este folosit în Business App, încearcă înregistrarea prin Coexistence.
Meta spune că configurarea mea nu este finalizată sau panoul afișează un avertisment.
- Citește mai întâi cardul de sub Connected: acesta indică numărul la care răspunde AI Agentul tău și spune dacă Meta încă verifică numele afișat, dacă este un număr de test Meta sau dacă primul mesaj nu a sosit încă. Fiecare card are link către locul corect din WhatsApp Manager.
- Dacă avertismentul este despre conexiunea în sine, apasă Reconnect WhatsApp în panou. Acest lucru rezolvă majoritatea cazurilor.
- Dacă nu rezolvă problema, numărul tău poate fi conectat la alt furnizor (Meta permite un singur partener per cont WhatsApp la un moment dat). Urmează instrucțiunile de pe ecran pentru a adăuga Quickchat AI ca partener în setările Meta Business, apoi apasă Refresh Status.
Am conectat contul greșit.
- Reconnect păstrează contul care este deja conectat. Pentru a comuta, apasă Disconnect în panoul WhatsApp, apoi Connect WhatsApp din nou și alege contul Meta Business și WhatsApp Account corecte în fereastra Meta.
Mesajele nu apar în Inbox din Quickchat AI.
- Confirmă că fereastra pop-up a afișat confirmarea finală că a fost conectat contul tău WhatsApp.
- Verifică din nou că ai conectat WhatsApp Account intenționat și că este selectat AI Agent corect.
- Cardul Waiting for your first message indică numărul la care răspunde AI Agentul tău. Asigură-te că ai trimis mesaj exact la acel număr și că este activat în panou, apoi apasă Refresh.
- Dacă trimiți mesaje după 24 de ore fără un mesaj al utilizatorului, folosește template-uri aprobate și asigură-te că o metodă de plată este setată în WhatsApp Manager.
Răspunsurile WhatsApp ale AI-ului meu nu se trimit.
- Quickchat AI afișează o alertă “WhatsApp replies are failing” în panoul WhatsApp și o notificare în dashboard. Remedieri frecvente: finalizează aprobarea numelui afișat în WhatsApp Manager; dacă conexiunea a expirat sau a fost revocată, apasă Reconnect; dacă Meta ți-a restricționat numărul din motive de calitate sau politici, verifică-i starea în WhatsApp Manager. Alerta dispare după ce un răspuns se trimite din nou cu succes.
Mesajele de tip template sau inițiate de business eșuează.
- Verifică dacă Message Templates sunt aprobate și dacă metoda de plată este activă în WhatsApp Manager.
- Expeditorii noi încep cu limite de mesagerie care cresc în funcție de calitate și verificare. Dacă atingi limitele pentru mesageria inițiată de business, consultă îndrumările Meta despre Messaging Limits.
- Verifică limitele de mesagerie și ratingul de calitate în WhatsApp Manager dacă livrarea este încetinită.
Cum creez propriul link WhatsApp și butonul „Chat on WhatsApp”?
- Urmează acest tutorial WhatsApp.
Cum creez propriul cod QR WhatsApp?
- Accesează WhatsApp Manager → Phone numbers → selectează numărul de telefon de business → Message links → Create Message Link.
- Alternativ, îl poți găsi în aplicația mobilă WhatsApp Business. Urmează acest tutorial WhatsApp.
Ai nevoie de ajutor?
Discută cu Support AI de la Quickchat pe WhatsApp:
📱 +1 302-405-9992: Începe un chat
Sau scanează codul QR:
