Genuka WA docs

Errore WhatsApp 141010: azienda non verificata — soluzione

Errore WhatsApp 141010 "The Business has not passed business verification": perché i tuoi modelli OTP vengono rifiutati, e come sbloccarli.

L'errore WhatsApp 141010 significa che l'azienda titolare dell'account WhatsApp non ha superato la verifica dell'azienda di Meta. Compare nello stato di salute dell'account, non nella risposta a un invio. La conseguenza pratica: i modelli di autenticazione (codici OTP) vengono rifiutati, mentre i modelli di marketing e di utilità continuano a funzionare normalmente sullo stesso account.

Cosa significa l'errore 141010?

Non lo troverai nell'elenco pubblico di Meta dei codici di errore della Cloud API. Viene dal campo health_status che Meta espone sull'account WhatsApp, sul numero di telefono e sui modelli. Per ogni entità coinvolta (numero, account, portafoglio business, app), Meta può allegare una lista errors in cui ogni elemento riporta un error_code, un error_description e un possible_solution (Meta, Health status).

Sugli account collegati a Genuka WA la cui azienda non è verificata, ecco cosa leggiamo:

Excerpt of health_status
{
  "error_code": 141010,
  "error_description": "The Business has not passed business verification"
}

La verifica dell'azienda si applica al portafoglio business Meta titolare dell'account WhatsApp. Non ha nulla a che vedere con lo status di provider di Genuka: Genuka è un Meta Tech Provider, ed è la tua azienda che deve essere verificata.

Quando si verifica l'errore 141010?

Appena un numero viene collegato sotto un portafoglio non verificato. L'Embedded Signup di Meta ti permette di collegare un numero senza verifica, e molte aziende iniziano così. Il codice resta silenzioso fino al giorno in cui crei un modello di autenticazione:

Cosa faiAzienda non verificataAzienda verificata
Creare un modello MARKETING o UTILITYAccettatoAccettato
Creare un modello AUTHENTICATION (OTP)Rifiutato: errore 10, "Application does not have permission for this action"Accettato una volta che il limite è passato a 2.000
Raggiungere destinatari unici fuori dalla finestra di servizio, ogni 24 ore250 per iniziare2.000 una volta che Meta approva la qualità dei tuoi messaggi, poi aumenti automatici

I limiti sono quelli di Meta: un nuovo portafoglio parte da 250, e la verifica è uno dei percorsi per arrivare a 2.000 (Meta, Messaging limits).

Perché i codici OTP? Meta riserva la categoria AUTHENTICATION alle aziende che hanno completato uno dei suoi percorsi di crescita, come la verifica dell'azienda, con un limite di messaggistica di almeno 2.000 conversazioni avviate dall'azienda al giorno; devono essere soddisfatte entrambe le condizioni (360dialog, Authentication messages). La verifica da sola quindi non basta: dopo un percorso di crescita, Meta analizza la qualità dei tuoi messaggi e può negare l'aumento, nel qual caso il tuo limite resta dov'è (Meta, Messaging limits). Su 60 account clienti Genuka WA esaminati a settembre 2026, nessuno dei 45 non verificati ha un modello di autenticazione; l'unico dell'insieme appartiene a un account verificato.

Dove lo vedi in Genuka WA?

CanaleCosa vedi
POST /api/v1/templates con "category": "AUTHENTICATION"403 meta_rejected, meta.code: 10, messaggio "Application does not have permission for this action"
Meta Business SuiteLo stato di verifica del portafoglio, sotto Centro per la sicurezza (in inglese, Security Center)
Server MCP di Genuka, strumento create_templateL'errore arriva con una spiegazione di questo caso per il tuo agente IA — vedi Agenti IA

L'API di Genuka WA non inoltra health_status in sé: non hai un token Meta con cui interrogarlo, e lo stato di verifica è più facile da leggere in Meta Business Suite.

Come risolvo l'errore 141010?

Controlla lo stato attuale. In Meta Business Suite, apri Centro per la sicurezza > Verifica dell'azienda (in inglese, Security Center > Business Verification) sul portafoglio titolare dell'account WhatsApp (Meta, Embedded Signup errors). Se chiami Graph tu stesso, GET /{WABA_ID}?fields=business_verification_status,health_status restituisce entrambi; Meta documenta valori come VERIFIED, PENDING e NOT_VERIFIED per il primo (Meta, WhatsApp Business Account API). Confronta senza distinguere maiuscole e minuscole: quando abbiamo controllato, l'API ha restituito not_verified, in minuscolo.

Avvia la verifica. La richiedi da Meta Business Suite, su quello stesso portafoglio (Meta, Verify your business). Genuka non ha alcun ruolo: è una questione tra la tua azienda e Meta.

Ricrea il modello di autenticazione. Una volta che l'azienda è verificata e il limite è passato a 2.000 (visibile in WhatsApp Manager, Account tools > Messaging limits, o nel campo whatsapp_business_manager_messaging_limit del numero), invia di nuovo lo stesso modello. Il testo dei modelli di autenticazione lo scrive Meta: tu fornisci solo la struttura.

const response = await fetch("https://wa.genuka.com/api/v1/templates", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.GENUKA_WA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    connectionId: "con_1",
    name: "verification_code",
    language: "en_US",
    category: "AUTHENTICATION",
    messageSendTtlSeconds: 600,
    components: [
      { type: "BODY", add_security_recommendation: true },
      { type: "FOOTER", code_expiration_minutes: 10 },
      { type: "BUTTONS", buttons: [{ type: "OTP", otp_type: "COPY_CODE", text: "Copy code" }] },
    ],
  }),
});
const json = await response.json();

if (response.status === 403 && json.meta?.code === 10) {
  // Unverified business (141010): nothing to fix in your code or your key.
  throw new Error("Meta business verification required for OTP templates");
}
if (!response.ok) throw new Error(`${response.status} ${json.error}: ${json.message ?? ""}`);
console.log(json.data.id, json.data.status);

E se l'azienda non può essere verificata subito?

Meta descrive altri due percorsi per arrivare a 2.000 destinatari al giorno: la verifica da parte del partner che ti ha fatto l'onboarding, e 2.000 messaggi consegnati fuori dalle finestre di servizio a destinatari unici su 30 giorni mobili, usando modelli di alta qualità (Meta, Messaging limits). Aumentano il tuo limite di messaggistica. Secondo 360dialog, la condizione per gli OTP è un percorso di crescita completato, non la verifica in sé; ma nessuno degli account non verificati che abbiamo esaminato ha un modello di autenticazione. Nel frattempo, invia i tuoi codici via SMS o email e tieni WhatsApp per le tue notifiche: vedi API WhatsApp senza verifica Meta.

Come prevengo l'errore 141010?

  • Avvia la verifica appena prevedi i codici OTP, prima di scrivere il flusso di accesso: è l'unico passaggio che non controlli tu.
  • Verifica il portafoglio giusto. Quello titolare dell'account WhatsApp collegato, non un altro portafoglio della stessa azienda.
  • Prova a creare il modello AUTHENTICATION sull'account di produzione: un account di test non verificato fallirà sempre, qualunque cosa faccia il tuo codice.

Codici di errore correlati

  • 10: la risposta che Meta restituisce quando viene creato il modello OTP.
  • 200: un vero problema di permessi o di accesso all'account, da non confondere con questo.
  • 2388098: durante l'Embedded Signup, Meta limita quanti account WhatsApp un'azienda non verificata può creare (Meta, Embedded Signup errors).

FAQ

Si possono inviare messaggi WhatsApp senza la verifica dell'azienda?

Sì. I modelli di marketing e di utilità, e le risposte dentro la finestra di servizio di 24 ore, funzionano senza verifica, entro 250 destinatari unici ogni 24 ore per iniziare. Solo i codici OTP la richiedono.

Perché l'errore parla di un permesso dell'applicazione?

Perché Meta risponde alla creazione del modello con un errore di permessi generico, il codice 10. La vera causa è l'azienda: lo stesso account crea modelli di marketing senza alcun problema.

Perché 141010 manca dall'elenco dei codici di errore di Meta?

È un codice diagnostico di health_status, che descrive perché un'entità è limitata, non un codice restituito da una chiamata API. L'elenco pubblico di Meta copre solo questi ultimi.

Devo ricreare il modello dopo la verifica?

Sì. Un modello rifiutato alla creazione non esiste lato Meta: invialo di nuovo quando l'azienda è verificata e il limite dell'account è passato a 2.000.

Fonti

In questa pagina