Errore WhatsApp 33: numero di telefono eliminato — causa e soluzione
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
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).
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:
{
"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. 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). 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 ed errore 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
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.
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.
Se è stato eliminato, ricollegalo. L'azienda ripassa dal
link di connessione, 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).
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
connectionIddi 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}/healthfallisce 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: un parametro sconosciuto o scritto male; con il sottocodice 33, un oggetto che non si trova o a cui non si ha accesso.
- 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).
Fonti
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.
Errore WhatsApp 100: Invalid parameter — causa e soluzione
Errore 100 della WhatsApp Cloud API (Invalid parameter): un parametro sconosciuto, scritto male o troppo lungo. Come leggere details e correggere la richiesta.