# Errore 463 WhatsApp e reachout timelock: cos'è e cosa fare

> L'errore 463 di WhatsApp indica un reachout timelock: l'account non può scrivere a nuovi contatti. Cosa conferma WhatsApp, cosa hanno trovato gli sviluppatori, cosa fare.

Source: https://whasp.ai/it/blog/errore-463-whatsapp-reachout-timelock · 2026-10-20

## In breve

- L'errore 463 è ciò che una libreria riceve quando WhatsApp rifiuta un messaggio perché all'account è vietato avviare chat con nuovi contatti.
- WhatsApp documenta la restrizione (i messaggi nelle chat esistenti funzionano ancora, quelli nelle chat nuove no) ma non pubblica mai il codice 463, le soglie o le durate.
- Il legame tra il 463 e il reachout timelock viene da sviluppatori che hanno letto il codice di WhatsApp Web, quindi i dettagli vanno presi come reverse engineering ben documentato, non come policy.
- La mancanza dei trusted-contact token ha fatto scattare il blocco prima nelle librerie, ma aggiornare la libreria non toglie una restrizione già attiva.
- Riprovare, riavviare o rifare il pairing non serve: smetti di scrivere a nuovi contatti e aspetta la fine della restrizione.

L'errore 463 di WhatsApp è ciò che una libreria come Baileys o WAHA riceve quando WhatsApp rifiuta di inviare un messaggio perché l'account è sotto un reachout timelock: una restrizione temporanea che impedisce di avviare chat con persone con cui non si è mai parlato. Le chat già esistenti continuano a funzionare e la restrizione finisce da sola. WhatsApp descrive la restrizione ma non nomina mai il codice.

## Che aspetto ha l'errore 463 nei log?

L'errore 463 compare con nomi diversi a seconda della libreria. whatsmeow e il motore GOWS di WAHA restituiscono `server returned error 463`. Baileys riceve un ack del messaggio con `error='463'` e scrive `messageStubParameters: ["463"]`. Evolution API, che incapsula Baileys, spesso non mostra nulla se non un messaggio fermo in `PENDING` dopo che la chiamata HTTP è riuscita, quindi il codice compare solo con `LOG_BAILEYS=trace`, come ha riportato un utente nel [thread di indagine di Baileys](https://github.com/WhiskeySockets/Baileys/issues/2441).

Le prime segnalazioni pubbliche che abbiamo trovato risalgono al 12 febbraio 2026 (issue 1074 di whatsmeow). I maintainer di Baileys hanno aperto l'indagine il 25 marzo 2026, e la [segnalazione su GOWS](https://github.com/devlikeapro/waha/issues/1992) di WAHA è seguita il 31 marzo 2026. Era ancora aperta il 19 ottobre 2026.

## Cosa conferma WhatsApp?

La pagina di aiuto di WhatsApp [Informazioni sugli account con restrizioni](https://faq.whatsapp.com/717472490411581) conferma il comportamento senza nominare l'errore. Un account può vedere nell'app il messaggio "Your account is restricted right now" (nella versione inglese) oppure un avviso che potrebbe essere limitato a breve. La pagina dice:

- La restrizione finisce automaticamente dopo un tempo prestabilito, e WhatsApp invia una notifica quando succede.
- Per vedere il tempo rimasto, tocca Nuova chat e scegli un contatto con cui non hai mai chattato.
- La causa è un'attività recente che può mostrare segni di spam, di messaggi automatici o in massa.
- Puoi comunque comunicare con i contatti e i gruppi con cui hai già scambiato chat o chiamate.
- Non puoi avviare chat o chiamate con nuovi contatti, creare gruppi, aggiungere membri ai gruppi né usare i dispositivi collegati, e potresti essere disconnesso da alcuni dispositivi companion.

Una seconda pagina, [How to use WhatsApp responsibly](https://faq.whatsapp.com/361005896189245), dice di scrivere solo a chi ti ha contattato per primo o ha chiesto di essere contattato. Aggiunge che WhatsApp usa il machine learning e le segnalazioni degli utenti per rilevare i messaggi automatici indesiderati.

WhatsApp non pubblica il codice 463, la parola "timelock", le soglie né le durate. Nemmeno il [riferimento agli errori della Cloud API](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes) di Meta elenca il 463.

## Cosa hanno scoperto gli sviluppatori?

Gli sviluppatori hanno collegato il 463 alla restrizione leggendo il codice di WhatsApp Web. È reverse engineering ben documentato, non documentazione. Le scoperte principali:

- **Il nome.** Un maintainer di Baileys ha trovato `NackCallerReachoutTimelocked: 463` in WhatsApp Web, più una query che restituisce se il blocco è attivo, il suo tipo e la sua ora di fine ([Baileys 2441](https://github.com/WhiskeySockets/Baileys/issues/2441), 25 marzo 2026).
- **Cosa blocca.** Il codice del client permette a un account limitato di scrivere a sé stesso, agli account business, agli account di assistenza, ai bot e a qualunque chat per cui abbia un trusted-contact token (tctoken). WhatsApp distribuisce quel token di privacy man mano che due account si scambiano messaggi. Una chat nuova non ne ha, e questo coincide con la pagina di aiuto di WhatsApp.
- **I tipi.** Baileys include un enum dei tipi di enforcement letto dal client web. Comprende `WEB_COMPANION_ONLY`, `BIZ_QUALITY` e 15 valori `BIZ_COMMERCE_VIOLATION_*`, e WAHA elenca anche `RESTRICT_ALL_COMPANIONS`. Fa pensare a uno strumento generale di enforcement, non solo a un limite di volume (è un'inferenza).
- **Un bug della libreria ha peggiorato le cose.** L'ipotesi dei maintainer era che gli invii senza token di privacy contassero verso il limite. Sono seguite delle correzioni: le pull request 2257 (integrata il 17 gennaio 2026) e 2339 (24 aprile) di Baileys, poi la [release 7.0.0-rc10](https://github.com/WhiskeySockets/Baileys/releases/tag/v7.0.0-rc10) del 6 maggio 2026, che invia i tctoken e aggiunge `fetchAccountReachoutTimelock()` e un campo `reachoutTimeLock` su `connection.update`. whatsmeow ha integrato il suo [ciclo di vita dei tctoken](https://github.com/tulir/whatsmeow/pull/1081) il 27 aprile 2026.
- **I token non sono tutta la storia.** Utenti su 7.0.0-rc14 (29 luglio 2026) hanno segnalato il 463 anche ad agosto, e i maintainer hanno concluso che si tratta di una restrizione dell'account, non solo di un token mancante.

WAHA ha trasformato tutto questo in [endpoint documentati](https://waha.devlike.pro/docs/how-to/sessions/#reachout-timelock). Dalla release 2026.8.1 (14 agosto 2026), `GET /api/sessions/{session}/timelock` restituisce `isActive`, `timeEnforcementEnds` e `enforcementType`, e un evento `session.status` segnala i cambiamenti. WAHA documenta anche un secondo limite, basato sul volume: il message capping, che fa fallire gli invii con l'errore 475 finché un ciclo di quota non si azzera.

Evolution API è un caso a parte. La sua ultima release stabile (2.3.7, dicembre 2025) e il suo ramo main fissano `baileys` 7.0.0-rc.9 (21 novembre 2025), precedente all'invio dei tctoken, mentre il ramo develop usa rc13. Un utente ha riportato di aver sistemato una sessione nuova aggiornando da solo Baileys a rc13.

## Quali affermazioni non sono ancora confermate?

| Affermazione | Da dove arriva | Stato |
| --- | --- | --- |
| Il 463 si verifica solo quando manca un token | Prime segnalazioni e issue 2707 di Baileys (14 luglio 2026) | Superata: i maintainer hanno trovato una restrizione a livello di account |
| Scrivere a numeri che non sono su WhatsApp fa scattare il blocco | Una segnalazione, 8 agosto 2026 | Non confermata |
| Gli account già bannati o segnalati in passato sono i più colpiti | Un'osservazione di un maintainer e segnalazioni su WAHA | Plausibile, non confermata da WhatsApp |
| Il blocco può essere seguito subito da un logout forzato del dispositivo collegato (401, `device_removed`) | Due segnalazioni, 4 e 26 agosto 2026, una delle quali misura 159 ms | Coerente con l'avviso di WhatsApp sui dispositivi companion, causa scatenante ignota |
| Un tetto fisso, come 300 nuove chat | Un commento su WAHA | Nessuna fonte |

## Cosa fare quando compare l'errore 463?

1. **Smetti di scrivere a nuovi contatti da quel numero.** Continua a rispondere alle chat che esistono già.
2. **Leggi lo stato invece di tirare a indovinare.** Usa `fetchAccountReachoutTimelock()` in Baileys, l'endpoint timelock di WAHA o Nuova chat sul telefono.
3. **Non riavviare, non fare logout, non rifare il pairing.** La documentazione di WAHA dice che non toglie la restrizione, e i test di un contributor mostrano che non servono nemmeno nuovi tentativi, nuovi token o un fallback cstoken.
4. **Controlla la tua dipendenza.** Usa Baileys 7.0.0-rc10 o successivo e verifica quale versione fissa il tuo wrapper.
5. **Registra gli ack, non solo lo stato HTTP.** Alcuni wrapper restituiscono successo mentre WhatsApp rifiuta il messaggio.
6. **Aspetta l'ora di fine.** La restrizione si toglie da sola.

## Perché i sistemi in cui scrive prima l'utente lo evitano?

La restrizione colpisce la prima mossa: avviare chat con persone che non hanno mai scritto. Il consiglio di WhatsApp stesso è di scrivere a chi ti ha contattato per primo. Un sistema in cui è l'utente ad aprire la chat, per esempio da un [link wa.me](https://whasp.ai/it/blog/link-wa-me-qr-code-whatsapp), non fa mai quella mossa, quindi il blocco non ha nulla su cui agire.

whasp applica questa regola nell'API. Un numero non può aprire una chat a freddo (409 `chat_not_open`), e il suo stato di salute passa a `at_risk` quando WhatsApp lo avvisa o lo limita. I suoi numeri eseguono l'app WhatsApp su un telefono invece di una libreria di protocollo, quindi la gestione dei token spetta all'app, non a te. Questo non rende impossibili i ban: gli utenti possono comunque bloccare o segnalare un numero, e decide WhatsApp. Un numero bannato viene sostituito senza costi, ma le chat non passano al nuovo. Vedi [perché WhatsApp banna i numeri](https://whasp.ai/it/blog/perche-whatsapp-banna-numeri).

## Cosa fare dopo

Se usi Baileys, WAHA o Evolution API, aggiorna la dipendenza, registra gli ack e aggiungi una regola che blocca gli invii a nuovi contatti mentre un timelock è attivo. Per confrontare le opzioni leggi il [confronto tra le API non ufficiali di WhatsApp](https://whasp.ai/it/blog/whatsapp-api-non-ufficiale-confronto). Se un numero è già bannato, parti da [cosa fare con un numero WhatsApp bannato](https://whasp.ai/it/blog/numero-whatsapp-bannato-cosa-fare). Per i numeri nuovi vedi il [riscaldamento (warm-up) di un numero WhatsApp](https://whasp.ai/it/blog/warm-up-numero-whatsapp).

## Domande

### Cosa significa l'errore 463 di WhatsApp?

Significa che WhatsApp ha rifiutato di inviare un messaggio o una chiamata perché l'account è sotto un reachout timelock, una restrizione temporanea sul contattare persone con cui non ha mai chattato. Il codice non è nelle pagine di aiuto di WhatsApp: gli sviluppatori lo hanno collegato alla restrizione leggendo il codice di WhatsApp Web.

### Quanto dura un reachout timelock?

WhatsApp non pubblica le durate. La restrizione ha un'ora di fine, che il telefono mostra se tocchi Nuova chat e scegli un contatto con cui non hai mai chattato, e si toglie da sola quando quell'ora passa.

### Posso ancora rispondere alle persone che mi hanno scritto mentre sono limitato?

La pagina di aiuto di WhatsApp dice che puoi continuare a comunicare con i contatti e i gruppi con cui hai già scambiato chat o chiamate. La documentazione di WAHA riporta lo stesso per le chat 1:1 esistenti.

### L'errore 463 è lo stesso di un ban?

No. Un account limitato funziona ancora per le chat esistenti e la restrizione finisce da sola. Un account bannato mostra "Questo account non può più usare WhatsApp" e richiede una richiesta di revisione.

### L'errore 463 compare sulla WhatsApp Business Platform ufficiale?

Le segnalazioni arrivano da librerie e server non ufficiali. Il codice 463 non è nel riferimento dei codici di errore della Cloud API di Meta, controllato il 19 ottobre 2026.