# Erreur WhatsApp 463 : le reachout timelock expliqué

> L'erreur WhatsApp 463 signale un reachout timelock : le compte ne peut plus écrire à de nouveaux contacts. Ce que WhatsApp confirme, ce que les développeurs ont trouvé.

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

## L’essentiel

- L'erreur 463 est ce que reçoit une bibliothèque quand WhatsApp refuse un message parce que le compte n'a plus le droit d'ouvrir des discussions avec de nouveaux contacts.
- WhatsApp documente la restriction (les messages vers les discussions existantes passent, pas les nouvelles discussions) mais ne publie jamais le code 463, les seuils ni les durées.
- Le lien entre le 463 et le reachout timelock vient de développeurs qui ont lu le code de WhatsApp Web : considérez les détails comme de la rétro-ingénierie bien sourcée, pas comme une politique officielle.
- L'absence de jetons de contact de confiance a fait tomber les bibliothèques plus vite dans le verrou, mais mettre la bibliothèque à jour ne lève pas une restriction déjà active.
- Réessayer, redémarrer ou réassocier le compte n'aide pas : cessez d'écrire à de nouveaux contacts et attendez la fin de la restriction.

L'erreur WhatsApp 463 est ce que renvoie une bibliothèque comme Baileys ou WAHA quand WhatsApp refuse d'envoyer un message parce que le compte est sous un reachout timelock : une restriction temporaire qui empêche d'ouvrir des discussions avec des personnes à qui il n'a jamais parlé. Les discussions déjà existantes continuent de fonctionner, et la restriction se termine d'elle-même. WhatsApp décrit la restriction, mais ne mentionne jamais le code.

## À quoi ressemble l'erreur 463 dans vos logs ?

L'erreur 463 apparaît sous des formes différentes selon la bibliothèque. whatsmeow et le moteur GOWS de WAHA renvoient `server returned error 463`. Baileys reçoit un ack de message avec `error='463'` et écrit `messageStubParameters: ["463"]`. Evolution API, qui enveloppe Baileys, n'affiche souvent rien d'autre qu'un message bloqué en `PENDING` alors que l'appel HTTP a réussi : le code n'apparaît qu'avec `LOG_BAILEYS=trace`, comme l'a signalé un utilisateur dans le [fil d'enquête de Baileys](https://github.com/WhiskeySockets/Baileys/issues/2441).

Les premiers signalements publics que nous ayons trouvés datent du 12 février 2026 (issue 1074 de whatsmeow). Les mainteneurs de Baileys ont ouvert leur enquête le 25 mars 2026, et le [signalement GOWS](https://github.com/devlikeapro/waha/issues/1992) de WAHA a suivi le 31 mars 2026. Il était encore ouvert le 19 octobre 2026.

## Que confirme WhatsApp lui-même ?

La page d'aide de WhatsApp [À propos des comptes restreints](https://faq.whatsapp.com/717472490411581) confirme le comportement sans nommer l'erreur. Un compte peut voir dans l'app le message « Votre compte est actuellement restreint », ou un avertissement qui dit qu'il risque bientôt de l'être. La page indique :

- La restriction se termine automatiquement après un délai fixé, et WhatsApp envoie une notification à ce moment-là.
- Pour voir le temps restant, touchez Nouvelle discussion et choisissez un contact avec qui vous n'avez jamais discuté.
- La cause est une activité récente qui peut présenter des signes de spam, de messages automatisés ou envoyés en masse.
- Vous pouvez toujours communiquer avec les contacts et les groupes avec lesquels vous avez échangé des discussions ou des appels.
- Vous ne pouvez pas démarrer de discussions ou d'appels avec de nouveaux contacts, créer des groupes, ajouter des membres à un groupe ni utiliser des appareils liés, et vous pouvez être déconnecté de certains appareils associés.

Une seconde page, [Comment utiliser WhatsApp de façon responsable](https://faq.whatsapp.com/361005896189245), demande de ne contacter que les personnes qui vous ont écrit en premier ou qui ont demandé à être contactées. Elle ajoute que WhatsApp s'appuie sur l'apprentissage automatique et sur les signalements des utilisateurs pour détecter les messages automatisés non sollicités.

WhatsApp ne publie ni le code 463, ni le mot « timelock », ni seuils, ni durées. La [référence des codes d'erreur de la Cloud API](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes) de Meta ne liste pas le 463 non plus.

## Qu'ont découvert les développeurs ?

Des développeurs ont rattaché le 463 à la restriction en lisant le code de WhatsApp Web lui-même. C'est de la rétro-ingénierie bien sourcée, pas de la documentation. Les principales trouvailles :

- **Le nom.** Un mainteneur de Baileys a trouvé `NackCallerReachoutTimelocked: 463` dans WhatsApp Web, ainsi qu'une requête qui indique si le verrou est actif, son type et son heure de fin ([Baileys 2441](https://github.com/WhiskeySockets/Baileys/issues/2441), 25 mars 2026).
- **Ce que le verrou bloque.** Le code client laisse un compte restreint écrire à lui-même, aux comptes professionnels, aux comptes de support, aux bots et à toute discussion pour laquelle il détient un jeton de contact de confiance (tctoken). WhatsApp distribue ce jeton de confidentialité au fil des échanges entre deux comptes. Une nouvelle discussion n'en a aucun, ce qui correspond à la page d'aide de WhatsApp.
- **Les types.** Baileys embarque une énumération des types de sanction lue dans le client web. Elle comprend `WEB_COMPANION_ONLY`, `BIZ_QUALITY` et 15 valeurs `BIZ_COMMERCE_VIOLATION_*`, et WAHA liste aussi `RESTRICT_ALL_COMPANIONS`. Cela laisse penser à un outil de sanction général, pas seulement à une limite de volume (une déduction).
- **Un bug de bibliothèque a aggravé le problème.** L'hypothèse des mainteneurs était que les envois sans jetons de confidentialité comptaient dans la limite. Des correctifs ont suivi : les pull requests 2257 (fusionnée le 17 janvier 2026) et 2339 (24 avril) de Baileys, puis la [version 7.0.0-rc10](https://github.com/WhiskeySockets/Baileys/releases/tag/v7.0.0-rc10) du 6 mai 2026, qui envoie les tctokens et ajoute `fetchAccountReachoutTimelock()` et un champ `reachoutTimeLock` sur `connection.update`. whatsmeow a fusionné son [cycle de vie des tctokens](https://github.com/tulir/whatsmeow/pull/1081) le 27 avril 2026.
- **Les jetons ne sont pas toute l'histoire.** Des utilisateurs sous 7.0.0-rc14 (29 juillet 2026) ont encore signalé des 463 en août, et les mainteneurs en ont conclu qu'il s'agit d'une restriction du compte, pas seulement d'un jeton manquant.

WAHA en a fait des [endpoints documentés](https://waha.devlike.pro/docs/how-to/sessions/#reachout-timelock). Depuis la version 2026.8.1 (14 août 2026), `GET /api/sessions/{session}/timelock` renvoie `isActive`, `timeEnforcementEnds` et `enforcementType`, et un événement `session.status` signale les changements. WAHA documente aussi une seconde limite, fondée sur le volume : le plafonnement des messages (message capping), qui fait échouer les envois avec l'erreur 475 jusqu'à la réinitialisation du cycle de quota.

Evolution API est un cas à part. Sa dernière version stable (2.3.7, décembre 2025) et sa branche main épinglent `baileys` 7.0.0-rc.9 (21 novembre 2025), antérieure à l'envoi des tctokens, tandis que la branche develop utilise rc13. Un utilisateur a signalé avoir réglé une session neuve en passant lui-même Baileys à rc13.

## Quelles affirmations restent non confirmées ?

| Affirmation | D'où elle vient | Statut |
| --- | --- | --- |
| Le 463 n'arrive que lorsqu'un jeton manque | Premiers signalements et issue 2707 de Baileys (14 juillet 2026) | Dépassée : les mainteneurs ont trouvé une restriction au niveau du compte |
| Écrire à des numéros qui ne sont pas sur WhatsApp déclenche le verrou | Un signalement, 8 août 2026 | Non confirmé |
| Les comptes déjà bannis ou signalés sont les plus touchés | Une observation d'un mainteneur et des signalements WAHA | Plausible, non confirmé par WhatsApp |
| Le verrou peut être suivi aussitôt d'une déconnexion forcée de l'appareil lié (401, `device_removed`) | Deux signalements, 4 et 26 août 2026, dont un mesure 159 ms | Cohérent avec l'avertissement de WhatsApp sur les appareils associés, déclencheur inconnu |
| Un plafond fixe, comme 300 nouvelles discussions | Un commentaire sur WAHA | Aucune source |

## Que faire quand vous voyez l'erreur 463 ?

1. **Cessez d'écrire à de nouveaux contacts depuis ce numéro.** Continuez de répondre aux discussions qui existent déjà.
2. **Lisez l'état au lieu de deviner.** Utilisez `fetchAccountReachoutTimelock()` dans Baileys, l'endpoint timelock de WAHA, ou Nouvelle discussion sur le téléphone.
3. **Ne redémarrez pas, ne vous déconnectez pas, ne réassociez pas.** La documentation de WAHA dit que cela ne lève pas la restriction, et les tests d'un contributeur ont montré que les nouvelles tentatives, les nouveaux jetons et un repli sur cstoken n'y changent rien non plus.
4. **Vérifiez votre dépendance.** Utilisez Baileys 7.0.0-rc10 ou plus récent, et confirmez ce que votre wrapper épingle.
5. **Journalisez les acks, pas seulement le statut HTTP.** Certains wrappers renvoient un succès alors que WhatsApp rejette le message.
6. **Attendez l'heure de fin.** La restriction se lève d'elle-même.

## Pourquoi les conceptions où l'utilisateur écrit en premier l'évitent-elles ?

La restriction vise le premier geste : démarrer des discussions avec des gens qui n'ont jamais écrit. Le conseil de WhatsApp lui-même est de ne contacter que les personnes qui vous ont écrit en premier. Un système où c'est l'utilisateur qui ouvre la discussion, par exemple depuis un [lien wa.me](https://whasp.ai/fr/blog/lien-wa-me-qr-code-whatsapp), ne fait jamais ce geste : le verrou n'a donc rien sur quoi agir.

whasp l'impose dans l'API. Un numéro ne peut pas ouvrir une discussion à froid (409 `chat_not_open`), et sa santé passe à `at_risk` quand WhatsApp l'avertit ou le restreint. Ses numéros font tourner l'app WhatsApp sur un téléphone plutôt qu'une bibliothèque de protocole : la gestion des jetons est l'affaire de l'app, pas la vôtre. Cela ne rend pas les bannissements impossibles : les utilisateurs peuvent toujours bloquer ou signaler un numéro, et c'est WhatsApp qui décide. Un numéro banni est remplacé gratuitement, mais les conversations ne passent pas sur le nouveau. Lisez [pourquoi WhatsApp bannit des numéros](https://whasp.ai/fr/blog/pourquoi-whatsapp-bannit-numero).

## Pour aller plus loin

Si vous utilisez Baileys, WAHA ou Evolution API, mettez la dépendance à jour, journalisez les acks et ajoutez une règle qui bloque les envois vers de nouveaux contacts tant qu'un timelock est actif. Pour comparer les options, lisez [API WhatsApp non officielles comparées](https://whasp.ai/fr/blog/api-whatsapp-non-officielle-comparatif). Si un numéro est déjà banni, commencez par [la marche à suivre](https://whasp.ai/fr/blog/compte-whatsapp-banni-que-faire). Pour les nouveaux numéros, voyez [comment préchauffer un numéro WhatsApp](https://whasp.ai/fr/blog/prechauffer-numero-whatsapp-warm-up).

## Questions

### Que signifie l'erreur WhatsApp 463 ?

Elle signifie que WhatsApp a refusé d'envoyer un message ou un appel parce que le compte est sous un reachout timelock, une restriction temporaire sur les contacts avec qui il n'a jamais discuté. Le code ne figure pas dans les pages d'aide de WhatsApp : des développeurs l'ont rattaché à la restriction en lisant le code de WhatsApp Web.

### Combien de temps dure un reachout timelock ?

WhatsApp ne publie aucune durée. La restriction porte une heure de fin, que le téléphone affiche si vous touchez Nouvelle discussion et choisissez un contact avec qui vous n'avez jamais discuté, et elle se lève d'elle-même une fois cette heure passée.

### Puis-je répondre aux personnes qui m'ont écrit pendant la restriction ?

La page d'aide de WhatsApp dit que vous pouvez continuer à communiquer avec les contacts et les groupes avec lesquels vous avez déjà échangé des discussions ou des appels. La documentation de WAHA indique la même chose pour les discussions 1:1 existantes.

### L'erreur 463 est-elle un bannissement ?

Non. Un compte restreint fonctionne toujours pour les discussions existantes et la restriction prend fin d'elle-même. Un compte banni affiche « Ce compte ne peut plus utiliser WhatsApp » et nécessite une demande de réexamen.

### L'erreur 463 existe-t-elle sur la WhatsApp Business Platform officielle ?

Les signalements viennent de bibliothèques et de serveurs non officiels. Le code 463 ne figure pas dans la référence des codes d'erreur de la Cloud API de Meta, vérifiée le 19 octobre 2026.