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

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.

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 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 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, 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 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, 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 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 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. 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?

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, 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.

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. Se un numero è già bannato, parti da cosa fare con un numero WhatsApp bannato. Per i numeri nuovi vedi il riscaldamento (warm-up) di un numero WhatsApp.