# Errore WhatsApp 141010: azienda non verificata — soluzione

URL: https://wa.genuka.com/it/docs/errors/141010
Language: Italian

> 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/health-status)).

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

```json title="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 fai                                                                    | Azienda non verificata                                                                             | Azienda verificata                                                                    |
| --------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| Creare un modello `MARKETING` o `UTILITY`                                   | Accettato                                                                                          | Accettato                                                                             |
| Creare un modello `AUTHENTICATION` (OTP)                                    | Rifiutato: errore [10](https://wa.genuka.com/it/docs/errors/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 ore | 250 per iniziare                                                                                   | 2.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](https://developers.facebook.com/documentation/business-messaging/whatsapp/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](https://docs.360dialog.com/docs/resources/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](https://developers.facebook.com/documentation/business-messaging/whatsapp/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?

| Canale                                                      | Cosa 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 Suite                                         | Lo stato di verifica del portafoglio, sotto **Centro per la sicurezza** (in inglese, *Security Center*)               |
| Server MCP di Genuka, strumento `create_template`           | L'errore arriva con una spiegazione di questo caso per il tuo agente IA — vedi [Agenti IA](https://wa.genuka.com/it/docs/guides/ai-agents) |

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?

1. **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](https://developers.facebook.com/documentation/business-messaging/whatsapp/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](https://developers.facebook.com/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/whatsapp-business-account-api)).
   Confronta senza distinguere maiuscole e minuscole: quando abbiamo controllato, l'API ha restituito `not_verified`, in minuscolo.
2. **Avvia la verifica.** La richiedi da Meta Business Suite, su quello stesso portafoglio
   ([Meta, Verify your business](https://www.facebook.com/business/help/2058515294227817)). Genuka
   non ha alcun ruolo: è una questione tra la tua azienda e Meta.
3. **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.

**Node.js**

```ts
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);
```

**Python**

```python
import os
import requests

response = requests.post(
    "https://wa.genuka.com/api/v1/templates",
    headers={"Authorization": f"Bearer {os.environ['GENUKA_WA_API_KEY']}"},
    json={
        "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"}]},
        ],
    },
    timeout=30,
)
body = response.json()

if response.status_code == 403 and (body.get("meta") or {}).get("code") == 10:
    # Unverified business (141010): nothing to fix in your code or your key.
    raise RuntimeError("Meta business verification required for OTP templates")
response.raise_for_status()
print(body["data"]["id"], body["data"]["status"])
```

**PHP**

```php
<?php
$ch = curl_init("https://wa.genuka.com/api/v1/templates");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERAGENT => "acme-crm/1.0 (+https://example.com)",
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("GENUKA_WA_API_KEY"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "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"]]],
        ],
    ]),
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

if ($status === 403 && ($body["meta"]["code"] ?? null) === 10) {
    // Unverified business (141010): nothing to fix in your code or your key.
    throw new RuntimeException("Meta business verification required for OTP templates");
}
echo $body["data"]["id"] ?? $body["error"];
```

**curl**

```bash
curl -X POST https://wa.genuka.com/api/v1/templates \
  -H "Authorization: Bearer $GENUKA_WA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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" } ] }
    ]
  }'
# Unverified business: 403 { "error": "meta_rejected", "meta": { "code": 10, … } }
```

### 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/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](https://wa.genuka.com/it/docs/guides/without-meta-verification).

## 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](https://wa.genuka.com/it/docs/errors/10): la risposta che Meta restituisce quando viene creato il modello OTP.
* [200](https://wa.genuka.com/it/docs/errors/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](https://developers.facebook.com/documentation/business-messaging/whatsapp/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

* [Meta — Health status](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/health-status)
* [Meta — Messaging limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits)
* [Meta — WhatsApp Business Account API](https://developers.facebook.com/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/whatsapp-business-account-api)
* [Meta — Embedded Signup flow errors](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/errors)
* [Meta — Error codes](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)
* [Meta — Verify your business in Meta Business Suite](https://www.facebook.com/business/help/2058515294227817)
* [360dialog — Authentication messages](https://docs.360dialog.com/docs/resources/authentication-messages)
