# Errore WhatsApp 33: numero di telefono eliminato — causa e soluzione

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

> Errore 33 della WhatsApp Cloud API: il numero WhatsApp Business di destinazione è stato eliminato, oppure l'ID non è più quello giusto. Come diagnosticarlo e ricollegarlo.

L'errore WhatsApp 33 significa, secondo Meta, che il numero di telefono WhatsApp Business a cui punta
la richiesta è stato eliminato. L'ID del numero di telefono che stai usando non punta più a un
numero attivo. Controlla quell'ID; se il numero è stato davvero eliminato, va collegato di nuovo.
Inviare di nuovo la stessa richiesta non cambierà nulla.

## Cosa significa l'errore 33?

Meta lo classifica tra gli "altri errori" della Cloud API:

> "The business phone number has been deleted." — soluzione suggerita: "Verify that the business
> phone number is correct."
> — [Meta, Cloud API error codes](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes#other-errors)

La soluzione di Meta copre quindi due cause: un numero che è stato davvero eliminato, oppure un ID
che non è quello giusto.

### Eliminato, deregistrato o in corso di eliminazione?

Tre stati simili producono tre codici diversi:

| Stato del numero                                            | Codice restituito                                                         | Cosa fare                                          |
| ----------------------------------------------------------- | ------------------------------------------------------------------------- | -------------------------------------------------- |
| Eliminato dall'account WhatsApp                             | **33**                                                                    | Controlla l'ID, poi aggiungi e ricollega il numero |
| Deregistrato dalla Cloud API, ma ancora presente            | `133010`: "Phone number not registered on the WhatsApp Business Platform" | Registralo di nuovo                                |
| Eliminato pochi minuti fa, e in fase di nuova registrazione | `133015`: l'eliminazione non è ancora completata                          | Aspetta 5 minuti prima di riprovare                |

La formulazione proviene dalla stessa pagina di Meta. Meta precisa inoltre che deregistrare un
numero non elimina né il numero né la sua cronologia dei messaggi
([Meta, Registration](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration)).

## Errore 33 o sottocodice 33?

Per prima cosa controlla quale campo contiene il 33. La Graph API può anche rispondere con il codice
`100` e `error_subcode: 33`, una risposta che non dice nulla su un numero eliminato:

```json title="Codice 100, sottocodice 33"
{
  "error": {
    "message": "Unsupported post request. Object with ID '123456789012345' does not exist, cannot be loaded due to missing permissions, or does not support this operation.",
    "type": "GraphMethodException",
    "code": 100,
    "error_subcode": 33
  }
}
```

Questa risposta è stata segnalata sul
[forum di Activepieces](https://community.activepieces.com/t/whatsapp-business-error/4324). Dice che
l'oggetto di destinazione non esiste, oppure che il token non vi ha accesso. Le cause segnalate sono
un ID sbagliato, un token che ha perso l'accesso a quella risorsa, oppure un accesso partner rimosso
([Fast2SMS](https://www.fast2sms.com/help/?p=17132)). Può produrla un numero eliminato, e anche un
accesso rimosso: non concludere che il numero sia stato eliminato prima di aver controllato
l'accesso, vedi [errore 100](https://wa.genuka.com/it/docs/errors/100) ed [errore 200](https://wa.genuka.com/it/docs/errors/200).

## Quando si verifica l'errore 33?

* **Il numero è stato eliminato in WhatsApp Manager** da qualcuno dell'azienda, mentre
  un'integrazione lo stava ancora usando.
* **L'ID è sbagliato o non aggiornato**: copiato da un altro account, rimasto in una configurazione
  dopo un cambio di numero, oppure confuso con il numero di telefono visualizzato.

### Dove lo vedi in Genuka WA?

Genuka WA memorizza l'ID del numero quando viene collegato; il `connectionId` che passi punta a
quell'ID. Se in seguito l'azienda elimina il numero in WhatsApp Manager, le chiamate su quella
connessione vengono rifiutate: con `meta.code: 33`, oppure con `meta.code: 100` e
`meta.subcode: 33`, la risposta descritta sopra.

Genuka non colloca il 33 in una classe dedicata: la classe segue lo stato HTTP restituito da Meta,
di solito `unknown`, e non è ritentabile.

| Canale                             | Cosa ricevi                                                                               |
| ---------------------------------- | ----------------------------------------------------------------------------------------- |
| `POST /api/v1/messages`            | `400 send_unknown` (oppure `409 send_config` se Meta risponde 401 o 403), `meta.code: 33` |
| `GET /api/v1/numbers/{id}/health`  | `422 meta_error` (oppure `403` se Meta risponde 401 o 403), con lo stesso oggetto `meta`  |
| `GET /api/v1/numbers?refresh=true` | Il numero torna con `"refreshed": false` e un `refreshError`                              |
| Campagna                           | Ogni destinatario passa a `failed`, con il messaggio di Meta                              |

## Come risolvo l'errore 33?

### Se passi da Genuka WA

1. **Conferma che il numero non risponde più.** `GET /api/v1/numbers/{id}/health` interroga Meta per
   quel solo numero: un rifiuto `meta_error` il cui `meta.code` o `meta.subcode` è 33 lo conferma in
   una sola chiamata. Leggi anche il suo stato in `GET /api/v1/connections`: se non è più `connected`,
   può darsi che sia stato rimosso l'accesso piuttosto che eliminato il numero, vedi
   [errore 200](https://wa.genuka.com/it/docs/errors/200).

2. **Fai controllare il numero in WhatsApp Manager**, scheda **Phone numbers**, da qualcuno che abbia
   accesso all'account WhatsApp dell'azienda. Se è ancora elencato, l'ID memorizzato non è più quello
   giusto: contatta il supporto Genuka con `x-request-id` e `meta.traceId`.

3. **Se è stato eliminato, ricollegalo.** L'azienda ripassa dal
   [link di connessione](https://wa.genuka.com/it/docs/onboarding), che aggiunge il numero tramite l'Embedded Signup di Meta
   e lo registra sulla Cloud API. Poi rileggi `GET /api/v1/connections` e usa il `connectionId` elencato
   lì per questo numero, invece di quello che avevi conservato.

   Se Meta ha assegnato al numero un nuovo identificativo, il ricollegamento crea una nuova connessione,
   che richiede uno slot libero nel tuo piano. Se tutti gli slot sono occupati, libera prima quello
   vecchio dalla pagina del cliente nella dashboard (**Libera il posto**): non invia più, ma occupa
   ancora uno slot, e il ricollegamento verrebbe rifiutato con `plan_limit_numbers`.

Se Meta ha assegnato al numero un nuovo identificativo, i messaggi, i modelli e le statistiche già
registrati da Genuka WA restano associati alla vecchia connessione.

### Se chiami direttamente la Cloud API

Elenca i numeri dell'account con `GET /{WABA_ID}/phone_numbers` e confronta il loro `id` con quello
che usi. Se il numero non c'è più, aggiungilo di nuovo in WhatsApp Manager, verificalo, poi
registralo con `POST /{PHONE_NUMBER_ID}/register`
([Meta, Registration](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration)).
Subito dopo un'eliminazione, aspetta qualche minuto: Meta risponde `133015` finché non è completata.

## Come prevengo l'errore 33?

* **Ferma gli invii prima di eliminare un numero.** Avvisa chi gestisce WhatsApp Manager: eliminare
  un numero ferma immediatamente ogni integrazione che lo usa.
* **Fai riferimento alla connessione, non al numero di telefono.** Memorizza il `connectionId` di
  Genuka WA, oppure l'ID del numero di telefono di Meta, invece del numero visualizzato, che non è
  un identificativo dell'API.
* **Controlla la salute prima di una grande campagna.** Un `GET /api/v1/numbers/{id}/health`
  fallisce subito su un numero eliminato, invece di lasciar fallire ogni destinatario uno per uno.

## Codici di errore correlati

* `133010`: il numero esiste ma non è registrato sulla Cloud API.
* `133015`: il numero è appena stato eliminato e l'eliminazione non è completata.
* [100](https://wa.genuka.com/it/docs/errors/100): un parametro sconosciuto o scritto male; con il sottocodice 33, un
  oggetto che non si trova o a cui non si ha accesso.
* [200](https://wa.genuka.com/it/docs/errors/200): l'account non è più accessibile, per esempio dopo la rimozione
  dell'accesso.

## FAQ

### Qual è la differenza tra deregistrare ed eliminare un numero?

Deregistrare rende il numero inutilizzabile con la Cloud API finché non viene registrato di nuovo,
senza eliminare né il numero né la sua cronologia. Eliminare lo rimuove dall'account WhatsApp: è il
caso che produce l'errore 33.

### Devo riprovare un invio rifiutato con l'errore 33?

No. Finché il numero non viene ricollegato, ogni invio su quella connessione fallirà allo stesso
modo.

### La mia cronologia dei messaggi è persa?

Non dal lato di Genuka WA: ciò che è stato registrato resta associato alla vecchia connessione. Dal
lato di Meta, sì: eliminare un numero elimina anche la sua cronologia, mentre deregistrarlo la
conserva
([Meta, Registration](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration)).

## Fonti

* [Meta — Error codes](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)
* [Meta — Register a business phone number](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration)
* [Community Activepieces — codice 100, error\_subcode 33](https://community.activepieces.com/t/whatsapp-business-error/4324)
* [Fast2SMS — Unsupported POST/GET request, object does not exist](https://www.fast2sms.com/help/?p=17132)
