Nom affiché WhatsApp Business refusé : l'erreur 131037 qui bloque tous vos messages

En août, en préparant un numéro WhatsApp pour une conciergerie, nous avons eu le bug le plus traître pour un outil de messagerie : les messages ne partaient plus, et rien ne disait pourquoi. Le reste fonctionnait normalement, ce qui rendait la panne encore plus difficile à voir. Si vous passez par l'API officielle WhatsApp Business, voici ce qui s'est passé, et comment l'éviter.

Ce qu'on a vu, et ce qui se passait vraiment

Côté interface, un envoi en échec, sans autre information. Il a fallu rejouer la scène et aller lire les journaux techniques pour trouver la réponse de Meta : erreur 131037. Elle signifie que le numéro qui envoie doit avoir un nom affiché approuvé par Meta avant de pouvoir écrire. Le nom choisi pour ce numéro n'avait pas encore passé la validation.

Le piège, c'est que cette erreur bloque tous les envois du numéro sans rien casser d'autre : la réception des messages, le tableau de bord, tout le reste marche. Rien ne crie, et c'est un voyageur sans réponse qui finit par vous l'apprendre.

Le nom affiché, c'est quoi ?

C'est le nom que vos voyageurs voient en haut de la conversation, à la place du numéro. Sur l'API officielle, chaque numéro a le sien, et Meta le vérifie avant de l'activer. Changer de nom relance la vérification.

Les règles de Meta, telles qu'on nous les a données

Après le refus, nous avons interrogé le support de Meta. Voici ce qui fait passer, ou bloquer, un nom :

• Le nom doit exister ailleurs, à l'identique. Meta vérifie qu'il apparaît sur votre site ou vos réseaux sociaux. Un nom qui n'existe nulle part est refusé.
• Pas de nom générique. « Conciergerie Annecy » ou « Service client » seuls sont refusés. Il faut le nom propre de votre entreprise.
• Pas de majuscules à outrance, sauf si c'est le sigle officiel de votre marque.
• Un nom par numéro, une vérification par nom. Si vous avez plusieurs numéros, chacun passe la sienne.
• Si un prestataire gère le numéro pour vous, Meta doit pouvoir faire le lien entre vous et lui : une mention sur votre site aide, et un nom du type « Votre conciergerie par [prestataire] » passe plus facilement.

Ce qu'on a changé depuis

1. On vérifie le nom avant de le soumettre : présent à l'identique sur le site de la conciergerie, pas générique, sans majuscules inutiles.
2. On n'ouvre jamais un numéro aux voyageurs avant que Meta ait validé son nom. C'est une étape de la mise en route, pas une formalité.
3. Chaque échec d'envoi est enregistré avec la raison exacte donnée par Meta : on sait tout de suite si c'est le nom, une autorisation expirée ou la fenêtre de 24 heures de WhatsApp, sans rejouer la scène.

Les 3 questions à poser à votre outil WhatsApp

• Le nom affiché de mon numéro est-il approuvé par Meta ? Où puis-je le voir ?
• Quand un message échoue, est-ce que je suis prévenu, et est-ce que je sais pourquoi ?
• Si je change le nom de ma conciergerie, qu'est-ce qui se passe pour mon numéro ?

Si la réponse à la deuxième question est floue, c'est le point à creuser : un message qui ne part pas ne fait aucun bruit. Pour aller plus loin sur le choix de l'intégration, voyez API WhatsApp officielle ou solution détournée.