Conectează Meta cu un token (System User)

Pasul 1 — Deschide Business Settings

Mergi în Meta Business Manager și autentifică-te cu un cont de administrator.

Deschide Meta Business Settings

ℹ️ Dacă administrezi mai multe business-uri, verifică selectorul din stânga sus și alege-l pe cel corect — business-ul care deține contul publicitar.

Pasul 2 — Creează un system user

Un System User este un "utilizator tehnic" al business-ului, gândit special pentru integrări.

1. În meniul din stânga, mergi la Users → System users.
2. Apasă Add.
3. Dă-i un nume ușor de recunoscut, ex. RoyLead Sync.
4. Rol: Employee — accesul în citire e suficient, nu ai nevoie de Admin. Apasă Create system user.

Pasul 3 — Asignează contul publicitar

Token-ul funcționează doar pe asset-urile pe care le asignezi explicit acestui utilizator.

1. Cu system user-ul selectat, apasă Assign assets.
2. La Ad accounts, selectează contul pe care vrei să-l conectezi.
3. La permisiuni, activează doar toggle-ul "View performance" (sub Partial access): e accesul în citire de care are nevoie ads_read. Lasă dezactivate "Manage campaigns" și "Full control".
4. Apasă Assign assets.

⚠️ Dacă sari peste acest pas, conectarea contului va eșua cu o eroare de permisiuni: token-ul ar fi valid, dar n-ar "vedea" niciun cont.

Pasul 4 — Pregătește aplicația

Token-ul se generează printr-o aplicație din business, iar system user-ul are nevoie de un rol pe acea aplicație. Dacă ai deja o aplicație legată de system user, sari direct la Pasul 5.

Creează aplicația (dacă nu ai una)

Nu ai nevoie de review-ul Meta: aplicația e doar "containerul" tehnic pentru token, și orice aplicație de business cu Marketing API merge.

1. Mergi la Business Settings → Accounts → Apps → Add → "Create a new app ID".

2. App name: ex. RoyLead Sync (email-ul de contact e deja al tău).

3. Use cases: lasă selectat "Create and manage ads with the Marketing API" (prima opțiune, bifată implicit).

4. Business: leagă aplicația de portofoliul tău de business, ca să aparțină business-ului corect.
5. Verifică Overview și apasă Create app. Marketing API e deja inclus datorită use case-ului ales.

Leagă aplicația de system user

Nu e suficient să creezi aplicația: system user-ul are nevoie de un rol pe aplicație, altfel pasul "Assign permissions" al token-ului rămâne gol.

1. Mergi la Accounts → Apps și selectează aplicația ta.
2. Apasă Assign people.

3. Selectează system user-ul roylead, activează toggle-ul "Develop app" și apasă Assign.

Pasul 5 — Generează token-ul

1. Pe system user, apasă Generate new token.
2. Selectează aplicația ta din listă (cea pregătită la Pasul 4).
3. Printre permisiuni, bifează ads_read.
4. Expirarea token-ului: o poți seta pe Never pentru o conexiune permanentă.
5. Apasă Generate token și copiază-l imediat.

⚠️ Dacă la pasul "Assign permissions" vezi "No permissions available", aplicația nu e legată de system user: completează Pasul 4 și reîncearcă.

🔒 Meta arată token-ul o singură dată. Dacă îl pierzi, nu-i nicio problemă: generezi altul și îl lipești din nou în RoyLead.

Pasul 6 — Găsește ID-ul contului publicitar

1. În Business Settings, mergi la Accounts → Ad accounts.
2. Selectează contul: ID-ul este numărul afișat (ex. 123456789012345).

RoyLead acceptă atât numărul simplu, cât și formatul act_123456789012345.

Pasul 7 — Lipește totul în RoyLead

1. Deschide secțiunea Advertising din RoyLead.
2. Apasă Conectează cont și alege Facebook · cu token.
3. Lipește token-ul și ID-ul contului, apoi confirmă.

Mergi în Advertising ↗

RoyLead validează imediat token-ul cu Meta, preia automat numele și moneda contului (nu le alegi tu) și salvează conexiunea.

Pasul 8 — Verifică

• Contul apare în listă cu starea Conectat.
• Sincronizarea automată rulează la câteva ore; o poți declanșa și tu manual din butonul Sincronizează.
• După prima sincronizare, cheltuielile și ROI apar în Analytics alături de lead-urile tale.

Token și aplicație: cum coexistă

Token-ul manual și autentificarea cu Facebook (OAuth) sunt două moduri de a obține același lucru: permisiunea de a citi datele contului. Poți folosi token-ul acum și trece la OAuth oricând vrei, fără să pierzi datele istorice.

ℹ️ O atenționare: token-ul e legat de aplicația Meta folosită pentru generarea lui. Dacă acea aplicație e suspendată de Meta, se opresc și token-ul, și OAuth-ul. Token-ul te protejează de problemele fluxului de autentificare, nu de o suspendare a aplicației.

Dacă token-ul expiră sau nu mai funcționează

Dacă generezi un token cu expirare și acesta expiră, sau îl revoci din Business Manager, RoyLead marchează contul cu o stare de eroare.

Ca să-l repari: pe cardul contului, meniul ⋯ → Editează Credențialele, lipește noul token și salvează. Nu trebuie să refaci întreaga conectare.

Depanare

💡 Generează token-ul cu expirare Never ca să eviți întreruperile: e cea mai comodă alegere pentru o sincronizare continuă.

Bune practici

• 🔑 Folosește un system user dedicat pentru RoyLead: dacă îi revoci token-ul, blochezi doar această integrare.
• 🔒 Asignează system user-ului doar conturile publicitare pe care chiar vrei să le sincronizezi.
• 🚨 Tratează token-ul ca pe o parolă: dacă bănuiești că a fost expus, regenerează-l din Business Manager și lipește-l din nou.