# Errore WhatsApp 10: autorizzazione negata — causa e soluzione

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

> Errore WhatsApp 10: un'autorizzazione mancante, un modello OTP su un'azienda non verificata, oppure "Paid Message Account" quando il numero è passato a un altro account WhatsApp Business.

L'errore WhatsApp 10 significa che un'autorizzazione necessaria alla chiamata non è mai stata
concessa o è stata rimossa. Sulla Cloud API, il caso più frequente inganna tutti: creare un modello
`AUTHENTICATION` (OTP) per un'azienda che Meta non ha verificato restituisce "Application does not
have permission for this action". Il problema è l'azienda, non l'applicazione. Su un invio, il codice
10 ha un altro volto: "Viewer cannot access the provided Paid Message Account" significa che il
numero è stato spostato su un altro account WhatsApp Business e va ricollegato.

## Cosa significa l'errore 10?

Meta lo elenca tra gli errori di autorizzazione:

> "Permission is either not granted or has been removed."
> — [Meta, Cloud API error codes](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes#authorization-errors)

La soluzione suggerita da Meta copre tre piste: verificare nel debugger dei token di accesso che
all'app siano state concesse le autorizzazioni richieste dall'endpoint; per i WhatsApp Flows con un
endpoint, verificare che il numero di telefono usato per impostare la chiave pubblica dell'azienda
sia nella lista consentita; e verificare i requisiti di idoneità dell'API che stai chiamando, perché
un account non idoneo riceve proprio questo codice. La documentazione generale della Graph API
chiama il codice 10 "API Permission Denied"
([Meta, Graph API error handling](https://developers.facebook.com/docs/graph-api/guides/error-handling)).

## Quando si verifica l'errore 10?

| Situazione                                                                 | Cosa vedi                                                               | Chi può risolverlo                                                                           |
| -------------------------------------------------------------------------- | ----------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| Creazione di un modello `AUTHENTICATION` per un'azienda non verificata     | "Application does not have permission for this action"                  | L'azienda: verifica dell'azienda presso Meta, poi un limite di messaggistica portato a 2.000 |
| Token senza `whatsapp_business_management` o `whatsapp_business_messaging` | Lo stesso messaggio, su qualsiasi endpoint                              | Il proprietario del token                                                                    |
| Funzionalità riservata agli account idonei                                 | Codice 10 sull'endpoint di quella funzionalità                          | Dipende dai requisiti di Meta per quell'API                                                  |
| WhatsApp Flows con un endpoint, numero non nella lista consentita          | Codice 10 durante l'impostazione della chiave pubblica                  | Il proprietario dell'app                                                                     |
| Invio da un numero spostato su un altro account WhatsApp Business          | "Viewer cannot access the provided Paid Message Account …" a ogni invio | Il proprietario del numero: ricollegarlo                                                     |

### Il caso del modello OTP

È quello che fa perdere ore. Sugli account collegati a Genuka WA, vediamo che:

* la creazione di un modello `AUTHENTICATION` fallisce con "Application does not have permission
  for this action" quando l'azienda non ha superato la verifica dell'azienda di Meta;
* i modelli `MARKETING` e `UTILITY` sullo stesso account vengono creati normalmente;
* lo stato di salute dell'account riporta l'errore [141010](https://wa.genuka.com/it/docs/errors/141010), "The Business
  has not passed business verification".

Uno sviluppatore ha segnalato la stessa risposta sul forum di Meta, con `error_subcode: 2388185` e il
messaggio utente "This WhatsApp Business account does not have permission to create message
template"
([forum degli sviluppatori Meta](https://developers.facebook.com/community/threads/1372007877817645/)).
Il messaggio dà la colpa all'applicazione. Nessuna impostazione di token o di autorizzazioni cambia
qualcosa.

Non puoi aggirarlo nemmeno con un modello di utilità: quando un'app offre agli utenti password
monouso o codici di verifica su WhatsApp, Meta richiede un modello di autenticazione
([Meta, Authentication templates](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/authentication-templates/authentication-templates)).

### Il numero che ha cambiato account

Meta consente di spostare un numero di telefono da un account WhatsApp Business (WABA) a un altro,
per esempio quando il commerciante riorganizza il suo portfolio Meta. Nessun webhook lo comunica
all'applicazione che inviava per suo conto. Meta fattura ogni messaggio alla WABA del numero:
l'invio indica il vecchio account, che non è più condiviso con Genuka WA, e ogni messaggio torna
indietro con:

```text
(#10) Viewer cannot access the provided Paid Message Account 1559700625642290
```

Il numero è l'id della **vecchia** WABA. Il token, le autorizzazioni e il modello non sono il
problema, e riprovare non cambia nulla.

Genuka WA lo intercetta in due modi. Al primo invio rifiutato, leggiamo
`GET /{PHONE_NUMBER_ID}?fields=health_status`: l'entità `WABA` nella risposta è l'account in cui il
numero si trova oggi ([Meta, Health status](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/health-status)).
`GET /api/v1/numbers/{id}/health` esegue la stessa lettura su richiesta. Se quell'account non è
quello che conosciamo, il numero passa a `disconnected` con `setupIssue: "waba_moved"`, e la
dashboard lo mostra come "Ricollegamento necessario".

### Dove lo vedi in Genuka WA?

Genuka WA colloca il codice 10 nella classe `config`: token, autorizzazione o registrazione, niente
che un nuovo tentativo possa risolvere.

| Canale                            | Cosa ricevi                                                                                                                                                                                   |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `POST /api/v1/templates`          | `403`, `"error": "meta_rejected"`, `meta.code: 10`                                                                                                                                            |
| `POST /api/v1/messages`           | `409`, `"error": "send_config"`, `meta.code: 10`; `"reason": "waba_moved"` quando il numero ha cambiato account                                                                               |
| `GET /api/v1/numbers/{id}/health` | `genukaStatus: "disconnected"`, `setupIssue: "waba_moved"`, `currentWabaId`: l'account in cui si trova il numero                                                                              |
| Campagna `MARKETING`              | Se la Marketing Messages API rifiuta con questo codice, Genuka invia di nuovo il messaggio tramite l'endpoint `/messages` standard; se rifiuta anche quello, il destinatario passa a `failed` |

```json title="403 — POST /api/v1/templates (categoria AUTHENTICATION)"
{
  "error": "meta_rejected",
  "message": "Application does not have permission for this action",
  "meta": {
    "errorClass": "config",
    "retryable": false,
    "code": 10,
    "traceId": "AbC…"
  }
}
```

```json title="409 — POST /api/v1/messages (numero spostato su un altro account)"
{
  "error": "send_config",
  "message": "This number changed WhatsApp Business account. It now belongs to WhatsApp Business account 2222464398692076, not 1559700625642290, and the new account is not shared with Genuka WA. Reconnect the number (Embedded Signup) to share its new account, then send again. Meta's wording: \"(#10) Viewer cannot access the provided Paid Message Account 1559700625642290\".",
  "meta": {
    "errorClass": "config",
    "retryable": false,
    "code": 10,
    "traceId": "AbC…"
  },
  "reason": "waba_moved",
  "wabaId": "1559700625642290",
  "currentWabaId": "2222464398692076",
  "docUrl": "https://wa.genuka.com/en/docs/errors/10"
}
```

## Come risolvo l'errore 10?

### Su un numero che ha cambiato account

1. **Conferma lo spostamento.** `GET /api/v1/numbers/{id}/health` restituisce
   `setupIssue: "waba_moved"` e `currentWabaId`. Il messaggio di errore dell'invio riporta entrambi gli
   id.
2. **Ricollega il numero.** Esegui di nuovo l'Embedded Signup con questo numero e scegli il suo nuovo
   account WhatsApp Business: da **Numeri > Aggiungi un numero** se il numero è tuo, oppure inviando il
   tuo link di connessione al cliente. In questo modo il nuovo account viene condiviso con Genuka WA e
   il numero viene aggiornato. Non si perde nulla: messaggi, statistiche e impostazioni restano
   associati al numero.
3. **Controlla i modelli.** Un modello appartiene a una WABA. I modelli del vecchio account non seguono
   il numero: sincronizza i modelli e ricrea quelli mancanti nel nuovo account.

### Su un modello di autenticazione

1. **Conferma la causa.** In Meta Business Suite, **Centro per la sicurezza > Verifica dell'azienda** mostra lo
   stato di verifica del portfolio che possiede l'account WhatsApp. Se chiami tu stesso la Graph API,
   `GET /{WABA_ID}?fields=business_verification_status,health_status` risponde in una sola richiesta:
   `business_verification_status` è descritto nel
   [riferimento del WhatsApp Business Account](https://developers.facebook.com/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/whatsapp-business-account-api),
   `health_status` in [Health status](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/health-status).
2. **Fai verificare l'azienda.** Si parte da Meta Business Suite, sul portfolio che possiede l'account
   WhatsApp ([Meta, Verify your business](https://www.facebook.com/business/help/2058515294227817)).
   I dettagli sono nella pagina dell'[errore 141010](https://wa.genuka.com/it/docs/errors/141010).
3. **Ricrea il modello una volta che l'azienda è verificata e il limite è passato a 2.000**
   (WhatsApp Manager, **Account tools > Messaging limits**). Lo stesso `POST /api/v1/templates`, con
   `"category": "AUTHENTICATION"` — vedi la guida
   [codici OTP da Node.js](https://wa.genuka.com/it/docs/guides/whatsapp-otp-nodejs).

### Su un'autorizzazione mancante

* **Se il token è tuo**: aprilo nel
  [debugger dei token di accesso](https://developers.facebook.com/tools/debug/accesstoken/),
  controlla `whatsapp_business_management` e `whatsapp_business_messaging`, e rigeneralo con
  entrambe se ne manca una
  ([Meta, WhatsApp support](https://developers.facebook.com/documentation/business-messaging/whatsapp/support#authentication-authorization)).
* **Se passi da Genuka WA**: non hai nessun token Meta da correggere. Un codice 10 al di fuori di un
  modello di autenticazione e al di fuori di "Paid Message Account" è compito di Genuka: contatta il
  supporto con l'header `x-request-id` e il `meta.traceId`.

## Come prevengo l'errore 10?

* **Fai verificare l'azienda prima di pianificare gli OTP su WhatsApp.** È un prerequisito di Meta,
  non un'opzione di Genuka.
* **Testa il flusso di autenticazione su un account verificato** prima di annunciare la
  funzionalità: un account di test non verificato fallirà sempre.
* **Mantieni entrambe le autorizzazioni WhatsApp** su ogni token che generi tu stesso.

## Codici di errore correlati

* [141010](https://wa.genuka.com/it/docs/errors/141010): l'azienda non ha superato la verifica dell'azienda di Meta.
* [200](https://wa.genuka.com/it/docs/errors/200): il token non ha accesso all'account, oppure manca un'autorizzazione (da 200 a 299).
* [3](https://wa.genuka.com/it/docs/errors/3): capacità o autorizzazione mancante per questo endpoint.
* [190](https://wa.genuka.com/it/docs/errors/190): il token è scaduto.

## FAQ

### Perché Meta dà la colpa all'applicazione quando il mio token va bene?

Perché il messaggio è generico. Su un modello `AUTHENTICATION` lo vediamo quando l'azienda non è
verificata, mentre il token e le sue autorizzazioni sono corretti: i modelli di marketing e di
utilità sullo stesso account passano.

### Nel frattempo posso inviare codici OTP con un modello di utilità?

No. Meta richiede un modello di autenticazione per i codici monouso. Finché la verifica non è
completata, invia i tuoi codici tramite un altro canale, SMS o email.

### Devo rigenerare la mia chiave API Genuka?

No. La tua chiave Genuka non ha alcun ruolo nelle autorizzazioni di Meta. Un problema di chiave
produce un `401` di Genuka, mai un codice 10.

### Il codice 10 blocca anche i miei invii?

Non nel caso del modello OTP: viene rifiutata solo la creazione di modelli `AUTHENTICATION`. I tuoi
modelli di marketing e di utilità approvati continuano a partire. "Paid Message Account", invece,
blocca ogni invio dal numero finché non viene ricollegato.

### Perché il mio numero è passato a "disconnected" se non ho fatto nulla?

Perché il numero ha lasciato l'account WhatsApp Business con cui era collegato. Meta non avvisa
nessuno dello spostamento: lo vediamo al primo invio rifiutato o alla lettura della salute del
numero. Ricollegare il numero lo riporta a `connected`.

## Fonti

* [Meta — Error codes](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)
* [Meta — Graph API, Handling errors](https://developers.facebook.com/docs/graph-api/guides/error-handling)
* [Meta — Authentication templates](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/authentication-templates/authentication-templates)
* [Meta — Health status](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/health-status)
* [Meta — WhatsApp Business Account API](https://developers.facebook.com/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/whatsapp-business-account-api)
* [Meta — Messaging limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits)
* [Meta — WhatsApp support, errori di autenticazione e autorizzazione](https://developers.facebook.com/documentation/business-messaging/whatsapp/support#authentication-authorization)
* [Meta — Verify your business in Meta Business Suite](https://www.facebook.com/business/help/2058515294227817)
* [Forum degli sviluppatori Meta — errore 10 su un modello di autenticazione](https://developers.facebook.com/community/threads/1372007877817645/)
