Error 463 de WhatsApp y el reachout timelock, explicado

El error 463 de WhatsApp es lo que recibe una librería como Baileys o WAHA cuando WhatsApp se niega a enviar un mensaje porque la cuenta tiene un reachout timelock: una restricción temporal para iniciar chats con personas con las que no ha hablado antes. Los chats que ya existen siguen funcionando y la restricción termina sola. WhatsApp describe la restricción, pero nunca menciona el código.

¿Cómo se ve el error 463 en tus logs?

El error 463 aparece con nombres distintos según la librería. whatsmeow y el motor GOWS de WAHA devuelven server returned error 463. Baileys recibe un ack del mensaje con error='463' y escribe messageStubParameters: ["463"]. Evolution API, que envuelve Baileys, a menudo no muestra nada salvo un mensaje atascado en PENDING después de que la llamada HTTP tuvo éxito, así que el código solo aparece con LOG_BAILEYS=trace, como informó un usuario en el hilo de investigación de Baileys.

Los primeros reportes públicos que encontramos son del 12 de febrero de 2026 (issue 1074 de whatsmeow). Los mantenedores de Baileys abrieron su investigación el 25 de marzo de 2026, y el reporte de GOWS en WAHA llegó el 31 de marzo de 2026. Seguía abierto el 19 de octubre de 2026.

¿Qué confirma el propio WhatsApp?

La página de ayuda de WhatsApp sobre cuentas restringidas confirma el comportamiento sin nombrar el error. Una cuenta puede ver en la app el mensaje «Tu cuenta está restringida en este momento» o un aviso de que podría restringirse pronto. La página dice:

• La restricción termina automáticamente pasado un tiempo fijado, y WhatsApp envía una notificación cuando lo hace.
• Para ver el tiempo que queda, toca Nuevo chat y elige un contacto con el que nunca hayas chateado.
• La causa es actividad reciente que puede mostrar señales de spam o de mensajería automatizada o masiva.
• Puedes seguir comunicándote con los contactos y grupos con los que has intercambiado chats o llamadas.
• No puedes iniciar chats ni llamadas con contactos nuevos, crear grupos, añadir miembros a grupos ni usar dispositivos vinculados, y es posible que se cierre tu sesión en algunos dispositivos complementarios.

Una segunda página, Cómo usar WhatsApp de forma responsable, indica que solo se escriba a quienes te contactaron primero o pidieron que los contactaras. Añade que WhatsApp usa aprendizaje automático y los reportes de los usuarios para detectar mensajes automatizados no deseados.

WhatsApp no publica el código 463, la palabra «timelock», umbrales ni duraciones. La referencia de errores de la Cloud API de Meta tampoco lista el 463.

¿Qué han descubierto los desarrolladores?

Los desarrolladores relacionaron el 463 con la restricción leyendo el propio código de WhatsApp Web. Es ingeniería inversa con buenas fuentes, no documentación. Los hallazgos principales:

• El nombre. Un mantenedor de Baileys encontró NackCallerReachoutTimelocked: 463 en WhatsApp Web, además de una consulta que devuelve si el bloqueo está activo, su tipo y la hora de fin (Baileys 2441, 25 de marzo de 2026).
• Qué controla el bloqueo. El código del cliente deja que una cuenta restringida escriba a sí misma, a cuentas de empresa, a cuentas de soporte, a bots y a cualquier chat del que tenga un token de contacto de confianza (tctoken). WhatsApp reparte ese token de privacidad a medida que dos cuentas intercambian mensajes. Un chat nuevo no tiene ninguno, lo que coincide con la página de ayuda de WhatsApp.
• Los tipos. Baileys incluye un enum de tipos de sanción leído del cliente web. Entre ellos están WEB_COMPANION_ONLY, BIZ_QUALITY y 15 valores BIZ_COMMERCE_VIOLATION_*, y WAHA lista además RESTRICT_ALL_COMPANIONS. Eso sugiere una herramienta de sanción general, no solo un límite de volumen (es una inferencia).
• Un bug de la librería lo empeoró. La hipótesis de los mantenedores fue que los envíos sin tokens de privacidad contaban para el límite. Siguieron correcciones: los pull requests 2257 (fusionado el 17 de enero de 2026) y 2339 (24 de abril) de Baileys, y después la versión 7.0.0-rc10 el 6 de mayo de 2026, que envía tctokens y añade fetchAccountReachoutTimelock() y un campo reachoutTimeLock en connection.update. whatsmeow fusionó su ciclo de vida de tctoken el 27 de abril de 2026.
• Los tokens no son toda la historia. Usuarios de la 7.0.0-rc14 (29 de julio de 2026) siguieron reportando el 463 en agosto, y los mantenedores concluyeron que es una restricción de la cuenta, no solo un token que falta.

WAHA lo convirtió en endpoints documentados. Desde la versión 2026.8.1 (14 de agosto de 2026), GET /api/sessions/{session}/timelock devuelve isActive, timeEnforcementEnds y enforcementType, y un evento session.status informa de los cambios. WAHA documenta además un segundo límite, basado en el volumen: el tope de mensajes (message capping), que hace fallar los envíos con el error 475 hasta que se reinicia un ciclo de cuota.

Evolution API es un caso aparte. Su última versión estable (2.3.7, diciembre de 2025) y su rama main fijan baileys 7.0.0-rc.9 (21 de noviembre de 2025), anterior al envío de tctoken, mientras que la rama develop usa rc13. Un usuario reportó que arregló una sesión nueva subiendo Baileys a rc13 por su cuenta.

¿Qué afirmaciones siguen sin confirmar?

¿Qué debes hacer cuando ves el 463?

1. Deja de escribir a contactos nuevos desde ese número. Sigue respondiendo a los chats que ya existen.
2. Lee el estado en vez de adivinar. Usa fetchAccountReachoutTimelock() en Baileys, el endpoint timelock de WAHA o Nuevo chat en el teléfono.
3. No reinicies, cierres sesión ni vuelvas a vincular. La documentación de WAHA dice que eso no levanta la restricción, y las pruebas de un colaborador encontraron que tampoco lo hacen los reintentos, los tokens nuevos ni un fallback de cstoken.
4. Revisa tu dependencia. Usa Baileys 7.0.0-rc10 o posterior y confirma qué versión fija tu wrapper.
5. Registra los acks, no solo el estado HTTP. Algunos wrappers devuelven éxito mientras WhatsApp rechaza el mensaje.
6. Espera a la hora de fin. La restricción se levanta sola.

¿Por qué los diseños en los que el usuario escribe primero lo evitan?

La restricción apunta al primer movimiento: iniciar chats con personas que nunca escribieron. El propio consejo de WhatsApp es escribir a quienes te contactaron primero. Un sistema en el que el usuario abre el chat, por ejemplo desde un enlace wa.me, nunca da ese paso, así que el bloqueo no tiene nada sobre lo que actuar.

whasp lo aplica en la API. Un número no puede abrir un chat en frío (409 chat_not_open), y su salud pasa a at_risk cuando WhatsApp avisa o lo restringe. Sus números ejecutan la app de WhatsApp en un teléfono en lugar de una librería de protocolo, así que el manejo de los tokens es cosa de la app, no tuya. Esto no hace imposibles los baneos: los usuarios aún pueden bloquear o reportar un número, y WhatsApp decide. Un número baneado se sustituye sin costo, pero los chats no se trasladan. Consulta por qué WhatsApp banea números.

Qué hacer ahora

Si usas Baileys, WAHA o Evolution API, actualiza la dependencia, registra los acks y añade una regla que bloquee los envíos a contactos nuevos mientras haya un timelock activo. Para comparar las opciones, lee la comparativa de APIs no oficiales de WhatsApp. Si un número ya está baneado, empieza por qué hacer a continuación. Para números nuevos, consulta cómo calentar un número de WhatsApp.