Your AI Connector Docs

Conectați propria aplicație Meta

Rulează WhatsApp prin propria ta aplicație Meta și plătește Meta direct la tarifele lor. Your AI Connector nu adaugă taxe per mesaj pentru această conexiune și nu există niciun cont Twilio la mijloc. Deoarece contul WhatsApp este al tău, clienții tăi vor vedea întotdeauna doar numele afacerii tale.

Aceasta este cea mai tehnică dintre opțiunile de conectare WhatsApp — vei crea o aplicație în site-ul pentru dezvoltatori Meta și vei copia patru valori în Your AI Connector. Planifică aproximativ 20 de minute. Dacă acest lucru sună mai complicat decât îți dorești, conexiunea gestionată WhatsApp Business rămâne cea mai simplă cale de a începe.

De ce aveți nevoie

  • Acces la contul dvs. Meta Business Manager.
  • Un număr de telefon care nu este deja utilizat în aplicația WhatsApp.
  • Aproximativ 20 de minute.

Partea 1 — Configurați aplicația în Meta

Efectuați mai întâi acești pași pe partea Meta. Veți colecta patru valori pe parcurs: un ID de aplicație (App ID), un secret de aplicație (App secret), un token de acces (Access token) și un ID de cont WhatsApp (WhatsApp account ID).

1. Creați o aplicație

Accesați developers.facebook.com, deschideți My Apps (Aplicațiile mele) și apăsați Create App (Creează aplicație). Alegeți tipul Business și dați-i orice nume — numele este vizibil doar pentru dvs.

2. Adăugați WhatsApp la aplicație

În tabloul de bord al aplicației, găsiți WhatsApp în lista de produse și apăsați Set up (Configurare). Meta creează un cont WhatsApp de test cu un număr de test gratuit, astfel încât să puteți încerca lucrurile înainte de a conecta un număr real.

3. Activați permisiunile WhatsApp

Acesta este pasul pe care majoritatea ghidurilor îl omit, iar omiterea lui este cel mai frecvent motiv pentru care conexiunea eșuează ulterior.

În aplicația dvs., deschideți App Review (Revizuirea aplicației), apoi Permissions and Features (Permisiuni și funcționalități). Căutați whatsapp_business_management. Dacă scrie No access (Fără acces), apăsați Get standard access (Obțineți acces standard) — Meta vă va cere să reintroduceți parola și vă va acorda accesul pe loc. Nu există nicio perioadă de așteptare și nicio revizuire a aplicației; este un singur buton.

whatsapp_business_messaging are de obicei deja acces standard. Ambele permisiuni trebuie să afișeze Standard access înainte de pasul următor, altfel tokenul pe care îl generați va fi incomplet.

4. Creați un utilizator de sistem

În Setări de afaceri Meta, deschideți Utilizatori, apoi Utilizatori de sistem. Adăugați unul și oferiți-i acces de administrator atât aplicației dvs., cât și contului dvs. WhatsApp.

5. Generați un token pentru acel utilizator

Selectați utilizatorul de sistem și apăsați Generare token. Alegeți aplicația, selectați un token care nu expiră niciodată și bifați atât whatsapp_business_messaging, cât și whatsapp_business_management. Meta afișează tokenul o singură dată — copiați-l imediat.

6. Găsiți ID-ul contului dvs. WhatsApp

În Setări de afaceri, deschideți Conturi, apoi Conturi WhatsApp și selectați contul dvs. Numărul lung de sub numele acestuia este ID-ul.

ID-ul aplicației (App ID) și secretul aplicației (App secret) se află în Setările aplicației, apoi De bază. Apăsați Afișare lângă secretul aplicației pentru a-l dezvălui.

Partea 2 — Conectează-l în Your AI Connector

Deschide Settings, apoi Channels, găsește cardul WhatsApp Business API și apasă pe Connect WhatsApp. Alege Use a number you already have, apoi Your own Meta app. Expertul se va deschide cu o scurtă prezentare generală — apasă pe Start setup.

  1. Detaliile tale. Acest pas repetă cei cinci pași de pe partea Meta din Partea 1, lângă un formular pentru cele patru valori ale tale. Lipește ID-ul aplicației, secretul aplicației, tokenul de acces și ID-ul contului WhatsApp exact așa cum le afișează Meta, fără spații suplimentare, și apasă Verifică detaliile mele. Nimic nu este salvat până când nu funcționează — Your AI Connector le verifică mai întâi cu Meta.
  1. Alegeți numărul de conectat. Expertul listează fiecare număr din contul dvs. WhatsApp, fiecare cu propriul rating de calitate Meta. Alegeți-l pe cel cu care acest spațiu de lucru ar trebui să trimită și să primească mesaje și apăsați Conectați acest număr.
  1. Activare și livrare. Your AI Connector activează automat numărul pentru Cloud API și înregistrează webhook-ul acestuia la Meta, astfel încât mesajele primite să ajungă în inbox-ul tău — în majoritatea cazurilor, vei ajunge direct pe cardul de conexiune cu o confirmare de „Număr conectat”. Dacă pasul automat nu se poate finaliza, expertul îți va afișa URL-ul de callback și token-ul de verificare cu butoane de copiere și te va ghida prin procesul de adăugare manuală a acestora în Meta; aceleași valori rămân vizibile pe cardul de conexiune în cazul în care Meta îți solicită vreodată să le introduci din nou.
  2. Expertul verifică singur conexiunea. La ultimul pas, acesta verifică automat configurarea — fără nicio așteptare din partea ta. Odată ce cardul indică faptul că este conectat, trimite-ți un mesaj WhatsApp de pe un alt telefon și urmărește cum ajunge în chat-urile tale: conversațiile de pe acel număr curg acum ca pe orice alt canal, iar agenții tăi AI pot răspunde la ele. Dacă verificarea găsește ceva ce Meta încă mai necesită (de exemplu, verificarea numărului), cardul îți va spune exact ce anume, iar Verifică conexiunea va rula din nou verificarea după ce ai remediat problema.

Poți reveni oricând pe aceeași pagină pentru a verifica starea conexiunii, pentru a te reconecta cu detalii noi sau pentru a apăsa Deconectare — numărul tău, contul tău Meta și facturarea rămân ale tale.

Bine de știut

  • Se aplică fereastra de 24 de ore, ca la orice conexiune WhatsApp Business. Poți oricând să răspunzi liber persoanelor care ți-au trimis mesaje în ultimele 24 de ore. În afara acelei ferestre, WhatsApp permite companiilor să înceapă conversații doar cu un șablon de mesaj aprobat — un mesaj text simplu va fi acceptat de Meta, dar nu va fi livrat.
  • Meta te facturează direct pentru conversații la tarifele lor publicate pe țară, folosind metoda de plată atașată contului tău WhatsApp în Meta. Your AI Connector nu percepe taxe per mesaj pentru această conexiune; utilizarea AI este facturată în credite, ca de obicei.
  • Păstrează o metodă de plată validă în acel cont WhatsApp. Fără una, Meta blochează fiecare conversație pe care afacerea ta o începe — difuzări, campanii și orice mesaj șablon — și afișează eroarea în WhatsApp Manager. Pe această conexiune, o difuzare sau o campanie refuză să pornească în acest caz și îți cere să adaugi o metodă de plată, în loc să eșueze mesaj cu mesaj. Răspunsurile către persoanele care ți-au trimis mesaje primele sunt trimise în continuare pentru moment, dar începând cu 1 octombrie 2026 Meta va taxa și aceste mesaje, deci un cont fără o metodă de plată funcțională va deveni complet tăcut la acea dată. Imaginea completă se află la Costurile WhatsApp și schimbarea din octombrie 2026.
  • Estimarea ta de cost arată diferit aici. Deoarece aceste taxe nu îți afectează niciodată creditele, estimarea de la pasul de revizuire a unei difuzări (și pasul de lansare a unei campanii) arată numărul de contacte și împărțirea pe țări cu o notă că Meta le facturează în contul tău WhatsApp Business, în loc de un total de credite.
  • Numerele de test sunt gratuite. Numărul de test pe care Meta îl oferă fiecărei aplicații noi poate trimite mesaje către până la cinci destinatari verificați fără niciun cost — o modalitate utilă de a încerca configurarea completă înainte de a direcționa un număr real către aceasta.

Șabloane

Șabloanele de mesaje funcționează pe această conexiune și se află în propriul tău cont WhatsApp Business. Creează unul pe pagina Șabloane (Templates), iar acesta va fi creat în contul respectiv și revizuit de Meta, rezultatul (aprobat, în așteptare sau respins) fiind afișat aici. Șabloanele pe care le ai deja în WhatsApp Manager apar automat în listă, iar butonul Sincronizare de la Meta (Sync from Meta) preia orice modificare efectuată recent acolo. Trimiterea funcționează la fel ca la orice altă conexiune WhatsApp — alege un șablon aprobat pentru a începe o conversație sau pentru a redeschide una în afara ferestrei de 24 de ore. Detaliile se află în Utilizarea șabloanelor cu propriul tău cont Meta WhatsApp.

Dacă ceva nu funcționează

  • „Nu ne-am putut conecta cu acele detalii” — copiază din nou fiecare valoare; un spațiu în plus este cauza obișnuită. Mesajul include propriul răspuns al Meta, care de obicei indică valoarea incorectă.
  • Eroarea spune că lipsește token-ul whatsapp_business_management — aplicației tale nu i-a fost încă acordată acea permisiune. Întoarce-te la Partea 1, pasul 3, apasă Obține acces standard, apoi generează un token nou cu ambele permisiuni bifate și verifică din nou detaliile. Regenerarea token-ului fără a parcurge acel pas va continua să producă aceeași eroare.
  • Token-ul tău a dispărut — Meta afișează un token o singură dată. Generează unul nou de la același utilizator de sistem; cel vechi continuă să funcționeze până când îl revoci, dar doar cel nou este vizibil.
  • Mesajele pe care le inițiezi nu ajung — verifică nota despre fereastra de 24 de ore de mai sus: în afara ferestrei, sunt livrate doar mesajele de tip șablon.
  • Nu ajunge nimic — numărul probabil nu este încă activat pentru Cloud API. Un număr poate fi utilizat într-un singur loc la un moment dat, deci dacă este încă conectat la aplicația WhatsApp Business de pe un telefon, elimină-l mai întâi de acolo, apoi apasă Verifică conexiunea pe cardul de conexiune. Your AI Connector îl activează pentru tine și îți spune pe loc dacă Meta încă mai are nevoie de ceva.
  • „Acest număr are deja un PIN de verificare în doi pași” — numărul a fost configurat undeva anterior și și-a păstrat PIN-ul. Dezactivează verificarea în doi pași pentru acesta în WhatsApp Manager, apoi apasă Reconectare.
  • „Meta nu a verificat încă acest număr” — finalizează verificarea numărului în WhatsApp Manager (Meta îi trimite un cod), apoi apasă Reconectare.
  • „Acest număr este găzduit pe API-ul On-Premises” — acesta rulează pe produsul mai vechi de tip self-hosted de la WhatsApp, care nu poate partaja un număr cu Cloud API. Migrează-l mai întâi la Cloud API în WhatsApp Manager.