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.

Trecerea de la conexiunea gestionată

Puteți începe cu conexiunea gestionată WhatsApp Business și să treceți ulterior la propria aplicație Meta. Ambele coexistă în același cont, așa că nu trebuie să reconstruiți nimic.

  • Contactele și istoricul conversațiilor rămân. Contactele, conversațiile, etichetele, agenții și baza de cunoștințe aparțin contului dumneavoastră, nu conexiunii. Eliminarea sau înlocuirea unui număr nu șterge nimic din acestea, iar când cineva care v-a scris anterior trimite din nou un mesaj la număr, acesta ajunge în aceeași conversație.
  • Numărul trebuie mutat mai întâi din partea Meta. WhatsApp permite ca un număr să fie activ într-un singur loc la un moment dat. Solicitați asistenței să elibereze numărul din configurarea gestionată, adăugați-l în propriul cont WhatsApp Business din WhatsApp Manager, apoi urmați pașii de pe această pagină. Vă puteți aștepta ca numărul să fie indisponibil pentru o scurtă perioadă în timpul mutării.
  • Folosiți un număr pe care îl dețineți dacă plănuiți să faceți trecerea. Un număr închiriat în cadrul Your AI Connector este o linie virtuală care aparține configurării gestionate și nu poate fi pur și simplu transferată către propria aplicație Meta, deci trecerea ar însemna un nou număr WhatsApp.
  • Șabloanele trebuie aprobate din nou. Meta aprobă șabloanele pentru fiecare cont WhatsApp Business, așa că recreați-le pe cele pe care le utilizați în cadrul propriului cont (consultați Șabloane mai jos).
  • Agenții: fiecare sub-cont își conectează propria aplicație Meta, astfel încât clienții pot face trecerea pe rând.

Bine de știut

  • Se aplică fereastra de 24 de ore, ca la orice conexiune WhatsApp Business. Poți răspunde oricând în format liber persoanelor care ți-au trimis mesaje în ultimele 24 de ore. În afara acestei ferestre, WhatsApp permite companiilor să inițieze 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 publicate pentru fiecare ț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ă aceasta, Meta blochează fiecare conversație inițiată de compania ta — difuzările și orice mesaj de tip șablon — și afișează eroarea în WhatsApp Manager. În această conexiune, o difuzare refuză să pornească în acest caz și îți solicită 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, astfel încât un cont fără o metodă de plată funcțională va deveni complet inactiv la acea dată. Imaginea de ansamblu este disponibilă la Costurile WhatsApp și schimbarea din octombrie 2026.
  • Estimarea costurilor tale arată diferit aici. Deoarece aceste taxe nu îți afectează niciodată creditele, estimarea din etapa de revizuire a unei difuzări afișează numărul de contacte și distribuția pe țări, cu o notă care precizează 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 testa întreaga configurație î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” — copiați 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 greșită.
  • Eroarea spune că tokenul lipsește whatsapp_business_management — aplicației dvs. nu i s-a acordat încă acea permisiune. Reveniți la Partea 1, pasul 3, apăsați Obțineți acces standard (Get standard access), apoi generați un token nou cu ambele permisiuni bifate și verificați din nou detaliile. Regenerarea tokenului fără a parcurge acel pas va continua să producă aceeași eroare.
  • Tokenul dvs. a dispărut — Meta afișează un token o singură dată. Generați unul nou de la același utilizator de sistem; cel vechi continuă să funcționeze până când îl revocați, dar numai cel nou este vizibil.
  • Răspunsurile eșuează cu „Această conversație a venit pe numărul WhatsApp Business …, care nu este numărul conectat” — aplicația dvs. Meta are mai mult de un număr, iar utilizatorii trimit mesaje către un număr care nu este cel conectat aici. Mesajele lor apar în continuare, deoarece Meta trimite mesajele aplicației pentru fiecare număr, dar răspunsurile pot fi trimise doar de pe numărul conectat, așa că AI-ul nu le răspunde. Cardul WhatsApp de pe pagina Canale (Channels) afișează un avertisment care menționează acel număr în timp ce mesajele sale continuă să sosească. Rândul numărului de pe acel card nu are butonul Reconectare (doar Setează ca principal și ștergere): deschideți din nou pagina de conexiune a aplicației Meta (Conectați WhatsApp pe cardul WhatsApp Business API, apoi Folosiți un număr pe care îl aveți deja, apoi Propria aplicație Meta), apăsați Reconectare pe cardul de conexiune de acolo și alegeți numărul la care scriu clienții dvs. Tokenul utilizatorului de sistem are nevoie de acces la acel cont WhatsApp. Dacă acel număr nu ar trebui să ajungă deloc la Your AI Connector, eliminați-l (sau contul său WhatsApp) din aplicația dvs. Meta.
  • Mesajele pe care le inițiați nu sosesc — verificați nota despre fereastra de 24 de ore de mai sus: în afara ferestrei, sunt livrate doar mesajele șablon.
  • Nu sosește nimic — numărul probabil nu este încă activat pentru Cloud API. Un număr poate exista într-un singur loc la un moment dat, deci dacă este încă conectat la aplicația WhatsApp Business de pe un telefon, eliminați-l mai întâi de acolo, apoi apăsați Verificați conexiunea pe cardul de conexiune. Your AI Connector îl activează pentru dvs. și vă 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 înainte și și-a păstrat PIN-ul. Dezactivați verificarea în doi pași pentru acesta în WhatsApp Manager, apoi apăsați Reconectare.
  • „Meta nu a verificat încă acest număr” — finalizați verificarea numărului în WhatsApp Manager (Meta îi trimite un cod), apoi apăsați Reconectare.
  • „Acest număr este găzduit pe API-ul On-Premises” — rulează pe produsul mai vechi de tip self-hosted al WhatsApp, care nu poate partaja un număr cu Cloud API. Migrați-l mai întâi la Cloud API în WhatsApp Manager.