> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Réservez votre nom d'utilisateur WhatsApp Business dans WhatsApp Manager

> Réservez votre @handle pour la WhatsApp Business Platform avant que quelqu'un d'autre ne le fasse : prérequis, étapes dans WhatsApp Manager, règles de nom d'utilisateur, codes d'erreur, et ce qui change lorsque les clients cachent leurs numéros de téléphone.

WhatsApp introduit les **noms d'utilisateur**. Au lieu d'un numéro de téléphone, votre entreprise obtient un handle comme `@votremarque` que les clients peuvent taper dans WhatsApp pour démarrer une conversation. Les réservations de noms d'utilisateur professionnels ont ouvert le **29 juin 2026**, et la fonctionnalité s'active pays par pays au cours des mois suivants. Les noms d'utilisateur sont attribués selon le principe du premier arrivé, premier servi, cette page vous guide donc pour réserver le vôtre sur la WhatsApp Business Platform maintenant, même s'il n'est pas encore actif dans votre pays.

Ce guide couvre uniquement la voie de la **WhatsApp Business Platform**, celle sur laquelle vous êtes si WhatsApp fonctionne via Flowella ou tout autre système plutôt que via l'application WhatsApp Business sur un téléphone.

<Note>
  **Vérifié pour la dernière fois le 13 septembre 2026** par rapport au centre d'aide WhatsApp et à la documentation développeur de Meta. Meta déploie encore cette fonctionnalité, donc consultez les [sources](#sources) si quelque chose à l'écran ne correspond pas.
</Note>

## Pourquoi réserver maintenant

* **Les noms d'utilisateur sont uniques et attribués selon le principe du premier arrivé, premier servi.** Une fois qu'un handle est pris par un compte WhatsApp, qu'il soit consommateur ou professionnel, personne d'autre ne peut l'utiliser.
* **Les handles Facebook et Instagram correspondants sont conservés pour leurs propriétaires, mais seulement pour une durée limitée.** Meta réserve le nom d'utilisateur que vous utilisez déjà sur votre Page Facebook ou votre compte Instagram afin que vous puissiez le revendiquer sur WhatsApp. WhatsApp indique qu'il existe une fenêtre limitée pour le faire et n'a pas publié de date de fin. Passé cette fenêtre, il n'y a aucune garantie que le handle sera toujours disponible.
* **C'est gratuit.** Réserver un nom d'utilisateur n'a aucun coût, et vous pouvez le changer ou le supprimer plus tard.
* **Cela protège votre marque même si vous n'avez pas encore de projets WhatsApp.** Un nom d'utilisateur réservé est conservé pour votre numéro de téléphone et ne peut être revendiqué par personne d'autre.

## Ce que fait, et ne fait pas, un nom d'utilisateur professionnel

Un nom d'utilisateur professionnel est un moyen pour les clients de vous joindre **sans avoir besoin de votre numéro de téléphone**. Une fois actif, les clients qui n'ont pas votre numéro enregistré voient votre nom d'utilisateur au lieu de votre numéro dans les conversations, les groupes et les appels.

Il vaut la peine d'être clair sur les limites :

* **Cela ne masque pas votre numéro de téléphone professionnel.** Votre numéro reste sur votre profil professionnel. La documentation de Meta est explicite : les noms d'utilisateur professionnels ne sont pas une fonctionnalité de confidentialité ; c'est ce à quoi servent les noms d'utilisateur consommateur.
* **Il n'y a pas de répertoire.** Personne ne peut parcourir ou rechercher votre entreprise. Les clients doivent taper votre nom d'utilisateur exact, donc mettez-le sur votre site web, votre signalétique, vos signatures d'e-mail et vos profils sociaux une fois qu'il est actif.
* **Un nom d'utilisateur par numéro de téléphone.** Si votre WhatsApp Business Account a plusieurs numéros, chacun a besoin de son propre nom d'utilisateur.
* **Votre nom d'utilisateur est distinct de votre nom d'affichage.** Le nom d'affichage passe toujours par la revue de Meta et apparaît toujours aux clients ; voir [Nom d'affichage et profil](/fr/meta/profile-setup).

### Comment votre nom est affiché dans une conversation

Meta affiche l'identité professionnelle dans cet ordre de priorité. Le premier qui s'applique est ce que le client voit.

1. Le nom sous lequel le client vous a enregistré dans ses contacts
2. Votre nom d'entreprise vérifié, ou votre nom Official Business Account
3. Votre nom d'utilisateur
4. Votre numéro de téléphone

Ainsi, une entreprise qui a complété la vérification d'entreprise affiche son nom d'entreprise aux clients qui n'ont pas enregistré le numéro, avec le nom d'utilisateur en dessous comme moyen de la joindre.

## Avant de commencer

Vous devez avoir tout ce qui suit en place. Si l'un des éléments manque, parcourez d'abord la [séquence de configuration](/fr/meta/setup-sequence).

<Steps>
  <Step title="Un portefeuille d'entreprise Meta avec un WhatsApp Business Account">
    Le nom d'utilisateur est défini sur un numéro de téléphone appartenant à un WhatsApp Business Account (WABA) à l'intérieur de votre portefeuille. Voir [Portefeuille d'activités](/fr/meta/business-portfolio) et [WhatsApp Business Account](/fr/meta/whatsapp-business-account).
  </Step>

  <Step title="Un numéro de téléphone enregistré pour la Platform">
    Le numéro doit être enregistré pour utilisation API sur le WABA. Un numéro qui a été ajouté mais pas encore enregistré renvoie l'erreur `133010` lorsque vous essayez de définir un nom d'utilisateur. Voir [Numéros de téléphone](/fr/meta/phone-numbers).
  </Step>

  <Step title="Une limite de messagerie supérieure au palier de départ">
    Meta exige que le portefeuille d'entreprise ait une **limite de messagerie plus élevée** que celle sur laquelle chaque nouveau portefeuille démarre (250 conversations initiées par l'entreprise par 24 heures). Si ce n'est pas le cas, WhatsApp Manager affiche **Compte non éligible** et l'API renvoie l'erreur `147002`. Le moyen le plus rapide de dépasser ce palier est de compléter la [vérification d'entreprise](/fr/meta/business-verification), ce qui fait passer un portefeuille approuvé à 2 000. Passer à l'échelle par volume d'envoi fonctionne également mais prend plus de temps. Voir [Limites de messagerie](/fr/meta/messaging-limits).
  </Step>

  <Step title="Les bonnes autorisations">
    Pour définir un nom d'utilisateur, vous avez besoin d'un accès de niveau administrateur au WABA ou au numéro de téléphone. Si vous voulez revendiquer un handle déjà utilisé sur votre Page Facebook ou votre compte Instagram, vous avez également besoin du **contrôle total** de cette Page ou de ce compte, ou d'un **accès partiel avec l'autorisation de gérer le téléphone**, car Meta vous demande d'abord de lier le numéro de téléphone à celui-ci.
  </Step>
</Steps>

<Tip>
  Si vous n'êtes pas sûr sur quel palier de messagerie vous vous trouvez, ouvrez **WhatsApp Manager → Outils de compte → Limites de messagerie**. Tout ce qui est au-dessus de 250 suffit.
</Tip>

## Réserver votre nom d'utilisateur dans WhatsApp Manager

C'est la voie recommandée et celle présentée dans le guide vidéo de Flowella.

<Steps>
  <Step title="Ouvrir WhatsApp Manager">
    Allez sur [business.facebook.com/latest/whatsapp\_manager/phone\_numbers](https://business.facebook.com/latest/whatsapp_manager/phone_numbers/) et sélectionnez le portefeuille d'entreprise qui possède votre WABA si demandé.
  </Step>

  <Step title="Sélectionner le numéro de téléphone">
    Dans le menu de gauche sous **Outils de compte**, cliquez sur **Numéros de téléphone**, puis cliquez sur le numéro auquel vous souhaitez attribuer un nom d'utilisateur. Le panneau de détail du numéro s'ouvre à droite.
  </Step>

  <Step title="Ouvrir l'onglet Profil">
    En haut du panneau de détail, cliquez sur **Profil**. Faites défiler au-delà de **Photo de profil** et **Nom d'affichage** jusqu'à la section **Nom d'utilisateur**.
  </Step>

  <Step title="Cliquer sur Créer (ou Modifier)">
    Si le numéro n'a pas encore de nom d'utilisateur, cliquez sur **Créer**. S'il en existe déjà un, cliquez sur **Modifier**. La boîte de dialogue **Modifier le nom d'utilisateur** s'ouvre.
  </Step>

  <Step title="Choisir une suggestion ou saisir la vôtre">
    La boîte de dialogue affiche une ligne **Suggéré**. Ce sont les noms d'utilisateur que Meta a déjà réservés pour votre entreprise depuis votre Page Facebook, votre compte Instagram et le domaine de votre site web, et ils ont plus de chances d'être approuvés. Cliquez sur l'un d'eux, ou saisissez votre propre handle dans le champ. Une coche verte signifie qu'il est disponible ; **Ce nom d'utilisateur n'est pas disponible** signifie qu'il est pris ou qu'il échoue aux vérifications de Meta.
  </Step>

  <Step title="Enregistrer">
    Cliquez sur **Enregistrer**. La section Nom d'utilisateur affiche maintenant **Nom d'utilisateur actuel : @votrehandle** avec un badge de statut et la date de mise à jour.
  </Step>
</Steps>

<Warning>
  Si vous avez choisi un handle utilisé sur votre Page Facebook ou votre compte Instagram, Meta vous demandera de **lier le numéro de téléphone** à cette Page ou ce compte avant de l'enregistrer. Vous pouvez le faire depuis la même boîte de dialogue, ou en ajoutant directement le numéro WhatsApp à la Page ou au compte Instagram. Sans le lien, la demande échoue avec l'erreur `147003` (Facebook) ou `147004` (Instagram).
</Warning>

### Ce que signifie le badge de statut

| Badge        | Signification                                                                                                                                                                                                                                                       |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Réservé**  | Approuvé et conservé pour votre numéro de téléphone, mais pas encore visible pour les utilisateurs WhatsApp. Il bascule automatiquement en actif lorsque Meta rend les noms d'utilisateur disponibles dans votre pays. Personne ne peut le revendiquer entre-temps. |
| **Approuvé** | Actif et visible. Les clients qui n'ont pas votre numéro enregistré voient le nom d'utilisateur et peuvent démarrer une conversation en le tapant.                                                                                                                  |

WhatsApp envoie une notification lorsqu'un nom d'utilisateur réservé devient actif. Vous n'avez rien à faire.

## Autres moyens de réserver

<AccordionGroup>
  <Accordion title="Meta Business Suite">
    Allez dans **Paramètres → Comptes → Comptes WhatsApp**, ouvrez l'onglet **Numéros de téléphone**, cliquez sur le numéro, faites défiler jusqu'à **Nom d'utilisateur** et cliquez sur **Créer**. C'est la même boîte de dialogue que dans WhatsApp Manager.
  </Accordion>

  <Accordion title="API Nom d'utilisateur">
    Pour les développeurs et les fournisseurs de solutions, Meta expose le nom d'utilisateur sur le numéro de téléphone professionnel. Le jeton d'accès a besoin de l'autorisation `whatsapp_business_management` avec contrôle total ou accès partiel aux numéros de téléphone sur le WABA.

    Définir ou changer un nom d'utilisateur :

    ```bash theme={null}
    curl -X POST "https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/username" \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer <ACCESS_TOKEN>" \
      -d '{ "username": "yourbrand" }'
    ```

    Une réponse réussie renvoie `{ "status": "reserved" }` ou `{ "status": "approved" }`.

    Lister les noms d'utilisateur que Meta a réservés pour votre portefeuille :

    ```bash theme={null}
    curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/username_suggestions" \
      -H "Authorization: Bearer <ACCESS_TOKEN>"
    ```

    Lisez le nom d'utilisateur et le statut actuels avec `GET .../username`, et supprimez-le avec `DELETE .../username`. Référence complète dans la documentation [Business-scoped user IDs](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids/) de Meta.
  </Accordion>
</AccordionGroup>

## Règles des noms d'utilisateur

* 3 à 35 caractères
* Lettres anglaises (a à z), chiffres (0 à 9), points (.) et traits de soulignement (\_) uniquement ; les caractères accentués tels que ñ, é ou ü sont rejetés
* Au moins une lettre ; un nom d'utilisateur ne peut pas être composé uniquement de chiffres
* Pas de point au début ou à la fin, et pas de deux points consécutifs
* Ne peut pas commencer par `www.`
* Ne peut pas se terminer par une extension de domaine répertoriée telle que `.com`, `.org`, `.net`, `.edu`, `.gov` ou `.html`
* La casse est ignorée lors de la vérification d'unicité, mais pas les points et les traits de soulignement : `myid`, `my.id` et `my_id` sont trois noms d'utilisateur différents
* Certains noms d'utilisateur sont réservés par Meta aux entreprises, aux gouvernements et aux personnalités publiques et ne peuvent pas être revendiqués

## Erreurs que vous pourriez voir

| Erreur                                                   | Ce qu'elle signifie                                                                                | Que faire                                                                                                                                     |
| -------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **Compte non éligible** / `147002`                       | Le portefeuille d'entreprise est encore sur le palier de messagerie de départ.                     | Complétez la [vérification d'entreprise](/fr/meta/business-verification), ou attendez d'avoir dépassé 250 par volume d'envoi, puis réessayez. |
| **Ce nom d'utilisateur n'est pas disponible** / `147001` | Le handle est pris, échoue aux vérifications internes de Meta, ou est réservé à quelqu'un d'autre. | Choisissez un autre handle. S'il s'agit de votre marque enregistrée et que quelqu'un d'autre le détient, consultez la [FAQ](#faq) ci-dessous. |
| **Compte FB non lié** / `147003`                         | Le handle est utilisé sur une Page Facebook que vous n'avez pas liée à ce numéro de téléphone.     | Liez le numéro de téléphone à la Page (contrôle total, ou accès partiel avec gestion du téléphone), puis réessayez.                           |
| **Compte IG non lié** / `147004`                         | Le handle est utilisé sur un compte Instagram que vous n'avez pas lié à ce numéro de téléphone.    | Liez le numéro de téléphone au compte Instagram, puis réessayez.                                                                              |
| **Transfert de nom d'utilisateur requis** / `147005`     | Le handle est déjà sur un autre numéro de téléphone de votre portefeuille.                         | Déplacez-le : dans l'API, renvoyez avec `"transfer_action": "force_transfer"`.                                                                |
| **Compte non enregistré** / `133010`                     | Le numéro de téléphone n'a pas été enregistré pour utilisation API.                                | Terminez l'enregistrement du numéro sur le WABA, puis réessayez.                                                                              |
| `100` Param invalid                                      | Le handle enfreint les règles de format.                                                           | Vérifiez les [règles](#username-rules) ci-dessus.                                                                                             |

## Changer, déplacer ou supprimer un nom d'utilisateur

* Vous pouvez **changer** votre nom d'utilisateur depuis la même boîte de dialogue Modifier. Il y a une limite au nombre de fois où vous pouvez le changer, et une fois que vous libérez un handle, il peut devenir disponible pour d'autres.
* Sur la Platform, un nom d'utilisateur peut être **transféré entre des numéros de téléphone du même portefeuille d'entreprise**, par exemple d'un numéro de test à un numéro de production, ou lors de la consolidation de numéros. Le handle lui-même reste inchangé.
* **Supprimer** retire le nom d'utilisateur du numéro. Faites-le uniquement si vous êtes sûr ; le handle retourne dans le pool.

## Lorsque les clients cachent leurs numéros

Les noms d'utilisateur consommateur sont une fonctionnalité de confidentialité. Lorsqu'un client en adopte un, son numéro de téléphone est **masqué à quiconque ne l'a pas déjà enregistré**, y compris les entreprises. C'est la partie du déploiement qui importe pour tout ce qui est connecté à un CRM.

La réponse de Meta est l'**identifiant utilisateur limité à l'entreprise (BSUID)**, un identifiant stable pour chaque client qui est unique à votre portefeuille d'entreprise. Depuis avril 2026, il apparaît dans chaque webhook entrant. Le numéro de téléphone du client est inclus à côté uniquement lorsque l'une de ces trois conditions est remplie : vous avez échangé un message ou un appel au cours des 30 derniers jours, le client figure dans votre liste de contacts professionnels, ou le client a explicitement partagé ses coordonnées. Sinon, le numéro est omis et seul le BSUID est fourni. Meta fournit également un bouton **Demander les coordonnées** que les entreprises peuvent envoyer pour demander à un client de partager son numéro dans la conversation.

Les conséquences pratiques :

* Un client qui vous envoie un message via votre nom d'utilisateur peut ne jamais partager son numéro de téléphone.
* Si vos workflows reposent sur le numéro de téléphone comme clé client, ils doivent gérer un identifiant stable à la place. Meta exige que toutes les entreprises et partenaires de la Platform prennent en charge le BSUID.
* Lorsqu'un workflow a besoin du numéro, comme pour une expédition ou un rappel, demandez-le dans la conversation plutôt que de supposer qu'il arrivera avec le message.

## FAQ

<AccordionGroup>
  <Accordion title="Quelqu'un a pris ma marque comme nom d'utilisateur. Que puis-je faire ?">
    Meta propose deux voies. Pour l'usurpation d'identité, utilisez le canal **Signaler un abus** dans Meta Direct Support. Pour la contrefaçon de marque, utilisez le formulaire de contact Propriété intellectuelle de WhatsApp. Le fait que votre Page Facebook et votre compte Instagram soient liés au numéro, et que la vérification d'entreprise soit complétée, renforce le dossier.
  </Accordion>

  <Accordion title="Ai-je besoin de la coche bleue (Official Business Account) pour obtenir un nom d'utilisateur ?">
    Non. Le badge Official Business Account est une demande distincte dans le même onglet Profil et n'est pas requis. Les noms d'utilisateur nécessitent la condition de limite de messagerie ci-dessus, pas la coche bleue.
  </Accordion>

  <Accordion title="Je suis Meta Verified avec une adresse web personnalisée. Dois-je faire quelque chose ?">
    WhatsApp indique que pour les entreprises Meta Verified avec une adresse de page web personnalisée, le nom d'utilisateur professionnel correspond automatiquement à cette adresse et est déjà réservé. Vérifiez la section Nom d'utilisateur dans WhatsApp Manager pour confirmer.
  </Accordion>

  <Accordion title="J'utilise l'application WhatsApp Business sur un téléphone, pas la Platform">
    Cette page ne couvre pas l'application. Dans l'application, les noms d'utilisateur sont réservés depuis votre profil professionnel sur le téléphone (pas WhatsApp Web) et aucune vérification d'entreprise n'est nécessaire. Si vous utilisez l'application et Flowella ensemble, consultez [Co-existence](/fr/meta/co-existence).
  </Accordion>

  <Accordion title="Mon nom d'utilisateur fonctionnera-t-il dans les points d'entrée Flowella et les liens click-to-chat ?">
    Une fois votre nom d'utilisateur actif, partagez-le partout où vous partagez actuellement votre numéro. Les liens suivis et les QR codes de Flowella continuent de fonctionner comme aujourd'hui ; voir [Points d'entrée](/fr/app/entry-points) et [Click-to-chat](/fr/campaigns/click-to-chat).
  </Accordion>
</AccordionGroup>

## Sources

* Centre d'aide WhatsApp : [About usernames on WhatsApp Business](https://faq.whatsapp.com/1131753190029163/)
* Centre d'aide WhatsApp : [About username reservations on WhatsApp Business](https://faq.whatsapp.com/) (lié depuis l'article ci-dessus)
* Meta for Developers : [Business-scoped user IDs](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids/) (noms d'utilisateur réservés, API Nom d'utilisateur, codes d'erreur, règles de format, priorité d'affichage)
* Meta for Developers : [Messaging limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits)

## Connexes

<CardGroup cols={2}>
  <Card title="Vérification d'entreprise" icon="badge-check" href="/fr/meta/business-verification">
    Le moyen le plus rapide de dépasser « Compte non éligible ».
  </Card>

  <Card title="Limites de messagerie" icon="gauge" href="/fr/meta/messaging-limits">
    Comment fonctionne le palier de départ et comment le dépasser.
  </Card>

  <Card title="Nom d'affichage et profil" icon="id-card" href="/fr/meta/profile-setup">
    Le nom que les clients voient au-dessus de votre nom d'utilisateur.
  </Card>

  <Card title="Séquence de configuration" icon="list-ordered" href="/fr/meta/setup-sequence">
    Tout ce qui doit être en place avant cette étape.
  </Card>
</CardGroup>
