Erori WhatsApp Business API: ce înseamnă fiecare cod și cum îl remediezi

WhatsApp Business API nu funcționează: verifică mai întâi aceste cinci lucruri

Când toate mesajele se opresc deodată, cauza este aproape întotdeauna una dintre cinci și le poți verifica pe toate în câteva minute. Parcurge-le în această ordine, pentru că primele verificări afectează toate mesajele, iar ultima afectează clienți individuali.

1. 1

   Verifică pagina de status Meta

   Deschide pagina de status WhatsApp Business API a Meta. Dacă Meta raportează o problemă, așteaptă să se rezolve înainte să schimbi setări. Codurile 1, 2, 131016 și 133004 trimit aici.
2. 2

   Verifică starea numărului tău în Whapi

   În panoul Whapi din Shopify, numărul tău WhatsApp trebuie să arate un status verde. Meta trimite și primește mesaje doar pentru numerele cu statusul Connected. Dacă nu este conectat, apasă Connect WhatsApp și reconectează-l.
3. 3

   Verifică metoda de plată în Meta

   Deschide WhatsApp Manager și caută un mesaj Add payment method pe pagina Overview. Fără o metodă de plată validă, mesajele șablon eșuează, adesea cu eroarea 131042. Urmează ghidul metodei de plată.
4. 4

   Verifică starea șablonului

   Fiecare automatizare Whapi trimite un șablon pe care Meta trebuie să-l aprobe. Un șablon încă în analiză, respins sau pus pe pauză eșuează cu 132001, 132015 sau 132016. Vezi de ce sunt respinse șabloanele.
5. 5

   Verifică numărul clientului

   Dacă doar unii clienți nu primesc mesaje, uită-te la codul de pe mesajul eșuat. 131026 înseamnă că numărul nu poate primi mesaje WhatsApp, 131047 că fereastra de 24 de ore s-a închis, 131049 și 131050 se aplică mesajelor de marketing.

Erori de configurare și conectare

Erorile de configurare apar în fereastra pop-up de înscriere Meta, după ce apeși Connect WhatsApp în Whapi. Vin din procesul Embedded Signup al Meta, deci formularea de mai jos este a Meta, iar soluția se aplică în partea Meta sau WhatsApp.

„Your phone number isn’t eligible to connect to the WhatsApp Business Platform”

Este codul Meta 3441045 (numărul nu este eligibil), afișat când conectezi un număr din aplicația WhatsApp Business. Singura rezolvare indicată de Meta este că ai nevoie de mai multă activitate în aplicația WhatsApp Business pentru a stabili eligibilitatea, iar Meta nu publică un minim. Ghidul numărului neeligibil explică ce poți face și erorile de verificare asociate.

„This number is registered to an existing WhatsApp account”

Meta afișează asta (numărul este înregistrat la un cont WhatsApp existent) când numărul este deja folosit pe WhatsApp Messenger, în aplicația WhatsApp Business sau pe WhatsApp Business API. Dacă numărul este în aplicația WhatsApp Business și vrei să continui să folosești aplicația, alege în schimb Connect a WhatsApp Business App în configurarea Whapi (aceasta este WhatsApp Coexistence). Ca să folosești numărul doar pe API, șterge mai întâi contul WhatsApp de pe telefon. Meta spune că numărul poate dura până la 3 minute să devină disponibil.

„The business is already sharing this WhatsApp Business account with a partner”

Este codul 2655093. Numărul tău din aplicația WhatsApp Business este încă conectat la alt furnizor, iar Meta nu acceptă schimbarea partenerului în acest proces. Deconectează partenerul curent în aplicația WhatsApp Business, la Settings > Account > Business Platform, așteaptă 15 minute, apoi conectează din nou. Ghidul de mutare a numărului la Whapi acoperă atât numerele Coexistence, cât și pe cele doar-API.

Fereastra pop-up Meta nu se deschide sau se închide la jumătate

Înscrierea Meta rulează într-o fereastră pop-up. Rulează configurarea Whapi pe un computer, permite ferestrele pop-up pentru panoul tău Shopify în browser și reîncarcă pagina. Dacă Meta spune „Your Facebook account is too new to create a business account. Try again in an hour” (contul tău Facebook este prea nou), așteaptă sau conectează-te cu un cont Facebook mai vechi și activ. Dacă spune „User does not have permission to create WhatsApp Business Accounts” (utilizatorul nu are permisiunea de a crea conturi WhatsApp Business), ai nevoie de acces Admin la portofoliul de business selectat.

Nume afișat respins

Meta verifică numele tău afișat WhatsApp în raport cu ghidul său pentru nume afișate. Dacă înscrierea spune „Your verified name violates WhatsApp guidelines. Please edit your verified name and try again” (numele tău verificat încalcă regulile WhatsApp), consultă ghidul pentru nume afișate și introdu un nume care îl respectă. Poți schimba un nume afișat de până la 10 ori în 30 de zile în WhatsApp Manager, la Account tools > Phone numbers > Profile. Eroarea 131037 se aplică doar numerelor de business 555 oferite de Meta, fără nume afișat aprobat.

Verificarea firmei și limitele de numere

Un portofoliu de business nou poate înregistra două numere de telefon de business. Meta ridică acest plafon la 20 odată ce firma este verificată sau atinge o limită de mesaje de 2.000. Până la finalizarea verificării, Meta limitează și câte conturi WhatsApp Business poți crea (codul 2388098). Vezi verificarea business Meta pentru WhatsApp pentru documente și pași.

Erori de plată și facturare

Eroarea 131042, „There was an error related to your payment method”, înseamnă că Meta nu poate taxa Messaging account-ul care trimite mesajele tale. Lista proprie a Meta cu cauze include: niciun cont de plată atașat, o linie de credit peste limită, un cont WhatsApp Business șters sau suspendat și un fus orar sau o monedă nesetate.

De la 1 octombrie 2026, lipsa unei metode de plată oprește și mesajele de service după ce cele 1.000 gratuite per număr de business pe lună s-au epuizat, iar șabloanele Utility trimise într-o fereastră deschisă de 24 de ore se taxează. Articolul despre modificarea prețurilor din octombrie 2026 acoperă detaliile.

Ghidul metodei de plată explică adăugarea unui card în WhatsApp Manager și erorile de card afișate de Meta, precum „Couldn’t save payment method”. Prețurile mesajelor pe țări sunt pe pagina de prețuri WhatsApp API.

Erori de livrare a mesajelor

Erorile de livrare afectează câte un client sau un mesaj, deci restul mesajelor continuă să plece. Tratează-le ca pe o informație despre acel client și evită să retrimiți același mesaj la nesfârșit.

131026: mesaj nelivrabil

Meta dă trei motive: numărul nu este un număr WhatsApp, clientul nu a acceptat ultimii Termeni de utilizare WhatsApp sau aplicația clientului este mai veche decât minimul acceptat de Meta. Dacă o confirmare de comandă eșuează, sună sau trimite un SMS clientului. Ghidul erorii 131026 enumeră verificările.

131047: fereastra de 24 de ore s-a închis

Răspunsurile libere sunt permise doar în 24 de ore de la ultimul mesaj al clientului. După aceea, trimite un șablon aprobat. Citește mai multe despre eroarea 131047 și fereastra de asistență pentru clienți.

131049 și 131050: mesaje de marketing reținute

131049 înseamnă că Meta a limitat șabloanele Marketing către acel client „to maintain healthy ecosystem engagement”; așteaptă cel puțin 24 de ore înainte să retrimiți. 131050 înseamnă că clientul a ales să nu mai primească mesaje de marketing de la firma ta, deci nu reîncerca. Ambele se aplică șabloanelor Marketing. Vezi ghidul erorii 131049.

130429 și 131056: trimitere prea rapidă

130429 înseamnă că s-a atins debitul de mesaje al numărului; reîncearcă mai târziu. 131056 înseamnă că prea multe mesaje au ajuns la același client într-un interval scurt; așteaptă înainte să-i scrii din nou, în timp ce ceilalți clienți nu sunt afectați.

131021: test trimis către propriul număr de business

Meta nu livrează un mesaj de la un număr către el însuși. Când folosești Send Test Message în Whapi, introdu un număr WhatsApp personal, diferit de numărul de business.

Erori de șabloane

Erorile de șabloane înseamnă că Meta nu a aprobat șablonul, variabilele din mesaj nu i se potrivesc sau Meta l-a pus pe pauză pentru că clienții l-au blocat sau raportat. Whapi trimite șabloanele la Meta când configurezi o automatizare, iar Meta decide categoria și aprobarea.

• 132001: șablonul nu există în acea limbă sau nu este aprobat. Verifică-i starea în Whapi sau în WhatsApp Manager.
• 132000 și 132012: variabilele trimise nu se potrivesc cu numărul sau formatul din șablon. Fă-le să corespundă sau trimite suportului Whapi numele automatizării.
• 132005: o traducere este prea lungă. Scurtează acea versiune lingvistică.
• 132007: conținutul încalcă o politică WhatsApp. Vezi de ce respinge Meta șabloanele.
• 132015 și 132016: pus pe pauză pentru calitate scăzută, apoi dezactivat definitiv după pauze repetate. Editează un șablon pus pe pauză; înlocuiește unul dezactivat cu conținut nou.
• 131064: contul a atins o limită de mesaje pentru încălcări de clasificare a șabloanelor. Asigură-te că actualizările de comandă sunt scrise ca Utility, iar promoțiile ca Marketing. Ghidul Utility vs Marketing explică diferența.
• 2388019: contul are deja maximul de 250 de șabloane. Șterge-le pe cele pe care nu le mai folosești.
• Șablon recategorizat ca Marketing: pentru asta nu există cod de eroare. De la 9 aprilie 2025, un șablon trimis ca Utility pe care Meta îl consideră Marketing este aprobat ca Marketing, iar Meta poate schimba ulterior și categoria unui șablon aprobat. Conținutul mixt, de exemplu o actualizare de comandă cu un cod de reducere, contează ca Marketing. Poți cere o reanalizare în 60 de zile de la schimbarea categoriei.

Rating de calitate, limite de mesaje și restricții de cont

Meta scade limitele sau restricționează un număr când clienții îi blochează sau raportează mesajele ori când firma încalcă o politică WhatsApp Business. Whapi folosește WhatsApp Business API oficial al Meta, care evită blocările declanșate de instrumentele WhatsApp Web neoficiale, dar Meta poate totuși limita orice număr care încalcă politicile sale.

Limite de mesaje

O limită de mesaje plafonează câți clienți unici poți contacta în afara unei ferestre de asistență, într-un interval mobil de 24 de ore. Se stabilește per portofoliu de business și este partajată de toate numerele lui. Portofoliile noi încep de la 250. Ca să ajungi la 2.000, verifică-ți firma sau trimite 2.000 de mesaje livrate în afara ferestrelor de asistență, către clienți unici, în 30 de zile, cu șabloane de calitate înaltă. După aceea, Meta ridică automat limita la 10.000, 100.000 și nelimitat, când calitatea rămâne ridicată și folosești cel puțin jumătate din limita curentă în 7 zile. Verifică-ți limita în WhatsApp Manager, la Account tools > Messaging limits.

131048, 368 și 131031: trimitere sau conturi restricționate

131048 înseamnă că trimiterea de pe număr este restricționată pentru că prea multe mesaje anterioare au fost blocate sau marcate ca spam; verifică starea calității în WhatsApp Manager. Codurile 368 și 131031 înseamnă că contul a fost restricționat sau dezactivat pentru încălcarea unei politici. Citește alerta din Business Support Home și contestă acolo dacă crezi că este o greșeală. Codul 130497 înseamnă că categoria ta de business nu poate scrie clienților din anumite țări.

Păstrează-ți ratingul de calitate sănătos

• Scrie doar clienților care au comandat de la tine sau și-au dat acordul.
• Trimite actualizările de comandă, precum confirmările de comandă, ca șabloane Utility și păstrează promoțiile în șabloane Marketing.
• Păstrează marketingul relevant și rar și fă dezabonarea ușoară.

Coexistence, apeluri, Flows și nume de utilizator

Aceste erori vin de la funcții WhatsApp mai noi. Majoritatea magazinelor le întâlnesc doar la conectarea unui număr din aplicația WhatsApp Business sau la testarea unei funcții pe care Meta încă o lansează.

Coexistence: erori de asociere și liste de transmisie

Coexistence conectează numărul tău din aplicația WhatsApp Business la API, ca să poți conversa în continuare de pe telefon, în timp ce Whapi trimite automatizările. Meta dezactivează listele de transmisie din aplicație după conectare, iar listele existente devin doar pentru citire. „Error while pairing Cloud API” și celelalte erori de asociere, istoricul lipsă al conversațiilor și deconectările sunt tratate în WhatsApp Coexistence nu funcționează.

„Calling APIs cannot be enabled for this phone number”

Eroarea Meta 138015 înseamnă că apelurile WhatsApp Business nu pot fi activate încă pentru acel număr. Soluția Meta este să te asiguri că limita de mesaje a numărului este de 2.000 sau mai mare. Folosește pașii despre limita de mesaje de mai sus ca să ajungi acolo.

WhatsApp Flows: „Blocked By Integrity”

Eroarea 139000 înseamnă că Meta a identificat o problemă de integritate pe cont, care împiedică crearea sau publicarea unui Flow. Verifică Business Support Home pentru restricții pe firmă, apoi contactează suportul Meta, singura cale pe care o oferă Meta pentru acest cod.

Business-scoped user ID (BSUID)

WhatsApp adaugă nume de utilizator opționale, așa că Meta identifică acum clienții și cu un business-scoped user ID (BSUID), unic pentru fiecare portofoliu de business. Unele tipuri de mesaje nu pot fi adresate unui BSUID, iar Meta returnează 131062, „Business-scoped User ID (BSUID) recipients are not supported for this message.” Trimiterea către numărul de telefon al clientului o evită. Comenzile Shopify conțin numărul de telefon, pe care îl folosesc automatizările de comandă.

Întreruperi Meta și acces expirat

Codurile 2, 131016 și 133004 înseamnă că serviciul Meta este supraîncărcat sau temporar indisponibil, deci soluția este să aștepți și să reîncerci. Codul 1 poate fi o eroare de server sau o cerere malformată, iar sfatul Meta pentru toate patru este să verifici mai întâi metastatus.com. 131000 este o eroare necunoscută; reîncearcă o dată și raportează-o dacă se repetă.

Codurile 0 și 190 înseamnă că tokenul de acces care permite Whapi să trimită pentru contul tău a expirat sau a fost invalidat. Meta enumeră drept cauză și o setare de utilizator care blochează accesul tuturor aplicațiilor la datele sale. Codurile 10 și 200 până la 299 înseamnă că o permisiune a fost eliminată. În fiecare caz, reconectează WhatsApp din panoul Whapi, ca Meta să emită un acces nou.

Cum obții ajutor pentru o eroare WhatsApp API

Trimite mai întâi codul erorii, pentru că îi arată suportului unde să se uite. Suportul Whapi răspunde prin e-mail la info@usewhapi.com și pe WhatsApp. Include:

• codul erorii și mesajul Meta sau o captură de ecran a acestuia;
• data și ora la care s-a întâmplat, cu fusul tău orar;
• numărul comenzii Shopify sau automatizarea care a eșuat;
• dacă toate mesajele eșuează sau doar unii clienți.

Pentru probleme de cont, facturare sau politici pe care le poate rezolva doar Meta, deschide un tichet în Meta Direct Support. Pentru probleme cu cardul, Meta îți cere să alegi subiectul „Dev: Billing, Credit & Pricing” și tipul cererii „Credit Card Billing”. Dacă nu vezi acel subiect, Meta spune să ceri furnizorului să deschidă tichetul, deci scrie-ne și îl deschidem noi. Ne poți găsi și prin pagina de contact.