Alexgub84/meta-whatsapp-cloud-api

Que fait meta-whatsapp-cloud-api ?

Cette procédure a été testée pour la dernière fois sur la véritable Meta Business Suite et la console développeur le 08/11/2026. Meta modifie ces écrans, noms de champs et flux d'assistance souvent et sans préavis — si une étape ci-dessous ne correspond pas à ce que vous voyez, ouvrez un ticket dans ce dépôt plutôt que de deviner, et envoyez une pull request avec la correction si vous en trouvez une.

Ne jamais

• Resoumettre une vérification rejetée le même jour que le rejet. Corrigez le problème réel, attendez 24 heures, puis soumettez à nouveau. Les nouvelles tentatives le même jour ont tendance à être signalées pour un examen encore plus long.
• Deviner ou "nettoyer" le nom légal, l'adresse ou le numéro de téléphone saisi dans les informations de l'entreprise. Copiez-les caractère par caractère à partir du document qui sera téléchargé pour les prouver.
• Traiter un statut en_attente de longue durée comme "Meta est juste lent" sans revérifier le champ de statut réel (voir §2). Il peut devenir silencieusement "nécessite plus d'informations", et l'e-mail de notification a tendance à atterrir dans une boîte de réception que personne ne surveille activement.
• Proposer un certificat d'enregistrement fiscal d'entreprise individuelle comme preuve du nom ou de l'adresse légale, si l'équivalent de la juridiction locale ne figure pas sur la liste des documents acceptés par Meta à cette fin — voir l'exemple concret dans §1. Meta indique clairement quand un document "n'est pas un type accepté" ; lisez ce message au lieu de supposer qu'un document local bien connu sera accepté parce qu'il est officiel.
• Soumettre avec le nom légal de l'entreprise absent de la page d'accueil réelle du site web. Meta récupère /, pas une page À propos ou Conditions générales, et échoue spécifiquement à la vérification sur ce point si le nom n'y est pas.
• Ajouter des collaborateurs externes en tant qu'utilisateurs complets du portefeuille juste pour obtenir de l'aide sur une tâche. C'est une raison de rejet explicite dans la propre liste de Meta — utilisez plutôt un niveau d'accès partenaire/collaborateur plus restreint.
• Saisir un code de vérification, un code PIN à deux étapes ou un mot de passe dans autre chose que la console de Meta elle-même, saisi par le titulaire du compte.

1. Vérification de l'entreprise

Ce qu'est la vérification, et ce qu'elle n'est pas

La vérification d'entreprise dans Meta Business Suite est une chose différente de l'abonnement payant Meta Verified, et elle ne produit pas de badge vérifié. Meta le déclare directement : "La vérification de votre entreprise dans Meta Business Suite est différente de Meta Verified pour les entreprises et ne vous donnera pas de badge vérifié." (Centre d'aide Meta Business, "Comment vérifier votre entreprise dans Meta Business Suite", https://www.facebook.com/business/help/2058515294227817, consulté le 09/11/2026 — la même phrase est répétée sur https://www.facebook.com/business/help/2342133782492969, consulté le 09/11/2026). Le badge vérifié est spécifiquement un avantage de Meta Verified : "Meta Verified pour les entreprises est un abonnement payant qui fournit des outils pour vous aider à renforcer la confiance avec de nouveaux publics et à protéger votre marque. Cet abonnement est assorti d'avantages tels que le badge vérifié, une assistance renforcée, une protection contre l'usurpation d'identité, etc." (https://www.facebook.com/business/help/308979828303560, consulté le 09/11/2026). Meta Verified est facturé de manière récurrente et constitue un achat séparé de la procédure de vérification gratuite couverte par cette compétence.

Ce que la vérification d'entreprise débloque réellement, selon les propres mots de Meta : "La vérification de l'entreprise est requise pour accéder à certaines fonctionnalités de publicité, de développement, de facturation et de dépenses." (https://www.facebook.com/business/help/2058515294227817, consulté le 09/11/2026). Détaillé plus loin sur https://www.facebook.com/business/help/1095661473946872 (consulté le 09/11/2026) : la limite de dépense quotidienne, les fonctionnalités de développement éligibles, l'accès aux Meta Business Partners, l'index des Pages d'actualités, la plateforme WhatsApp Business, la transparence des Pages, les agences basées en Chine et le statut d'annonceur de services financiers. Pour la plateforme WhatsApp Business en particulier, la même page indique : "Les entreprises utilisant la plateforme WhatsApp Business peuvent avoir besoin de terminer la vérification pour accéder à certaines fonctionnalités." Du côté développeur : "L'accès avancé nécessite désormais la vérification de l'entreprise... Les applications qui demandent un accès avancé pour les autorisations et les applications qui permettent à d'autres entreprises d'accéder à leurs propres données doivent être connectées à une entreprise qui a terminé la vérification de l'entreprise." (https://developers.facebook.com/docs/development/release/business-verification/, consulté le 09/11/2026).

Vérifié et non trouvé sur aucune des pages ci-dessus, ou sur la page de mise à l'échelle du compte WhatsApp de Meta (https://www.facebook.com/business/help/595597942906808, consulté le 09/11/2026) : aucune déclaration de Meta sur le nombre de fois à soumettre à nouveau avant d'arrêter, ou de conseil pour corriger les documents à la racine plutôt que de soumettre à nouveau. Ce conseil est courant sur les blogs d'agences tierces mais Meta ne le dit nulle part dans les sources vérifiées pour cette compétence, il n'est donc pas répété ici comme un fait. La liste "Ne jamais" ci-dessous s'en tient à ce que les propres pages de Meta soutiennent : une règle de temporisation, pas un compteur.

Choisir le bon ensemble de documents

Les catégories de documents acceptés par Meta (lues directement dans sa boîte de dialogue "Détails et prochaines étapes", qui n'apparaît qu'une fois qu'une tentative de vérification a réellement eu lieu) :

Prouve	Types acceptés
Nom légal de l'entreprise	Certificat/Statuts constitutifs, licence ou permis d'exploitation, relevé bancaire ou lettre bancaire
Adresse	Les quatre mêmes, plus une facture de services publics — eau, gaz, électricité ou téléphone

Pour une société enregistrée, le certificat d'incorporation est généralement le document unique le plus simple. Pour un entrepreneur individuel sans enregistrement de société, il n'y a souvent pas d'équivalent exact — ne supposez pas que le certificat générique d'enregistrement fiscal pour petites entreprises d'une juridiction compte, même s'il semble être le document évident. Exemple concret (Israël) : le certificat עוסק פטור/עוסק מורשה d'un entrepreneur individuel israélien est explicitement rejeté par Meta ("n'est pas un type accepté"), même s'il s'agit de la preuve standard du statut commercial légal en Israël. Ce qui a fonctionné à la place : une lettre de propriété de compte bancaire pour le nom légal (la plupart des banques peuvent en émettre une sur demande, spécifiquement pour la vérification d'entreprise) plus une facture de services publics pour l'adresse — un document de chacune des deux catégories acceptées, chacun imprimant le nom ou l'adresse exactement comme saisi dans les informations de l'entreprise.

Règles générales qui s'appliquent quelle que soit la juridiction :

• Un seul document portant à la fois le nom et l'adresse complets, clairement, satisfait aux deux exigences en un seul téléchargement.
• L'hébreu, ou tout script non anglais, est accepté tel quel — aucune traduction requise — mais choisissez une langue pour le nom/l'adresse et utilisez-la uniformément dans les informations de l'entreprise, la page d'accueil du site web et les documents eux-mêmes.
• Rejeter, d'emblée, comme ne valant pas la peine d'être tentés : les baux, une facture personnelle (pas professionnelle), une capture d'écran d'une page de portail, tout ce qui est recadré, annoté ou autrement modifié, et tout document de plus de 90 jours environ, à l'exception des documents d'enregistrement officiels.
• Un rendu fidèle pleine page d'un format de fichier à un autre (PDF vers un PNG haute résolution, par exemple) est acceptable ; le recadrage ou la ressaisie d'une partie quelconque ne l'est pas.

Préparer le portefeuille avant de soumettre

• Les champs d'informations de l'entreprise doivent refléter exactement le document téléchargé, y compris la ponctuation et les suffixes légaux (un suffixe de société comme "Ltd" apparaît soit aux deux endroits, soit nulle part). Décidez quelle langue standardiser et utilisez-la partout.
• Le site web doit être accessible, servir via HTTPS, ne montrer aucune erreur ni état "en construction" sur aucune page, et — ceci est vérifié séparément et échoue indépendamment de l'accessibilité — montrer le nom légal exact sur la page d'accueil spécifiquement. Un domaine enregistré très récemment est également plus susceptible de susciter des soupçons ; un domaine avec un certain âge s'en sort mieux.
• L'e-mail professionnel doit être sur le même domaine que le site web. Un domaine d'e-mail personnel gratuit augmente mesurablement le taux de rejet et ralentit l'examen quand ce n'est pas le cas.
• Choisissez une catégorie de liste qui correspond honnêtement à l'entreprise — une catégorie sensible (finance, santé, jeux d'argent, alcool) invite à un examen plus approfondi et à des documents supplémentaires requis.
• Deux administrateurs sur le portefeuille avec une authentification à deux facteurs activée sur les deux tend à réduire les frictions ; un administrateur unique non protégé est lui-même listé comme déclencheur de rejet.
• Quel que soit l'actif à vérifier (généralement un WABA), il doit déjà être attaché au portefeuille avant de commencer — sinon le point d'entrée de la vérification lui-même est grisé comme "non éligible".

Si le site web continue d'échouer à son propre contrôle même une fois ce qui précède corrigé, Meta documente deux autres moyens de confirmer l'identité de l'entreprise au lieu d'un site web fonctionnel : un e-mail de confirmation sur un domaine différent réellement associé à l'entreprise, ou la confirmation par numéro de téléphone professionnel à la place.

Le canal de confirmation change les documents dont vous avez besoin

Quel que soit le canal de confirmation choisi lors de l'assistant, cela change ce que l'étape de téléchargement demande réellement :

• Canal d'appel téléphonique, SMS ou message WhatsApp → l'assistant demande ensuite des documents prouvant le nom légal et un numéro de téléphone.
• Canal e-mail → l'assistant demande des documents prouvant le nom légal et une adresse ou un numéro de téléphone.

Choisissez donc le canal en fonction des documents réellement les plus faciles à obtenir, et non l'inverse — si une lettre bancaire et une facture de services publics sont ce qui est disponible, choisissez l'e-mail.

Soumettre

Allez au point d'entrée de la vérification (Centre de sécurité, dans la disposition actuelle de Meta), choisissez le cas d'utilisation qui correspond à ce qui est vérifié (il y a généralement une option séparée spécifiquement pour configurer un compte WhatsApp Business — préférez celle-ci à une option générique "autorisations d'application" si les deux existent), et parcourez l'assistant : pays, type d'entreprise (un travailleur indépendant non enregistré est généralement "Entreprise individuelle", et est souvent toujours répondu comme "Enregistré" si l'administration fiscale locale a émis un numéro d'enregistrement à ce dernier, même sans société formelle), détails de l'entreprise, un CAPTCHA (toujours complété par un humain, jamais par un agent automatisé), une étape de correspondance avec les registres publics, le canal de confirmation, le téléchargement de documents, et un examen/soumission final.

Deux pièges à anticiper à l'étape des registres publics et à l'étape de téléchargement :

• Meta peut proposer une correspondance avec les registres publics qui semble plausible mais appartient à une entité différente et non liée avec un nom similaire. Vérifiez chaque détail d'identification (adresse, domaine, tout numéro fiscal ou d'enregistrement affiché) avant d'accepter une correspondance — revendiquer le dossier d'une autre entreprise est une violation de politique qui peut restreindre l'ensemble du portefeuille, et pas seulement faire échouer cette seule vérification. En cas de doute, choisissez "mon entreprise n'est pas listée".
• Certaines étapes de téléchargement de documents ont par défaut un bouton facile à manquer ("votre document incluait-il votre numéro de téléphone ou votre adresse ?") sur "Non", ce qui exige alors un deuxième document entièrement séparé que la plupart des candidats n'ont pas sous la main. Si le seul document déjà téléchargé comporte bien les deux informations, basculez ce bouton sur "Oui" et l'étape supplémentaire disparaît.

Après la soumission, attendez environ 1 à 2 jours ouvrables pour une soumission vérifiée par canal et 3 à 7 (jusqu'à 14 pendant les fenêtres de mise à jour périodique des politiques de Meta) pour une soumission basée sur des documents. Ne touchez pas à la soumission pendant qu'elle est "en attente" — n'ajoutez pas d'administrateurs, ne modifiez pas les paramètres et n'ouvrez pas de fil d'assistance sur un coup de tête ; rien de tout cela n'accélère un examen en file d'attente, et tout ce qui crée une divergence avec ce qui a été soumis ne peut que nuire.

Surveiller les "besoin d'informations supplémentaires" sans compter sur l'e-mail

La notification de Meta concernant un changement de statut est envoyée à l'adresse e-mail définie comme contact administrateur du portefeuille — qui n'est très souvent pas la boîte de réception que quelqu'un consulte quotidiennement. Le seul moyen fiable sans navigateur est un appel API direct si un accès API existe déjà :

curl -s "https://graph.facebook.com/v21.0/$WABA_ID?fields=business_verification_status" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Valeurs observées dans la pratique : en_attente (tour de Meta, rien à faire à part attendre), en_attente_besoin_infos_supp (votre tour — allez lire exactement ce qui est demandé dans la console, que ce champ seul ne dit pas), et vérifié. Interrogez ceci périodiquement plutôt que d'attendre qu'on vous le dise — l'écart entre un statut qui passe silencieusement à "besoin d'informations supplémentaires" et quelqu'un qui le remarque réellement a coûté à de vraies soumissions un cycle d'examen complet.

2. Mise en place de l'API Cloud (fonctionne aussi avant la vérification)

Chaque étape ci-dessous fonctionne sur un portefeuille non vérifié — la vérification modifie uniquement le plafond de volume de messages, pas le fonctionnement de l'API elle-même. Menez les deux en parallèle plutôt que d'attendre l'un avant de commencer l'autre. Un portefeuille d'entreprise doit déjà exister (créé sur business.facebook.com) avant l'étape 1 — l'étape ci-dessous attache une nouvelle application à ce portefeuille existant, elle n'en crée pas un.

1. Créer l'application. Dans la console développeur, créez une application en utilisant le cas d'utilisation axé sur WhatsApp ("connectez-vous avec les clients via WhatsApp", ou l'équivalent dans la console actuelle), et attachez-la au portefeuille d'entreprise existant — ne créez jamais un nouveau portefeuille pour cela, ce qui ferait repartir la vérification de zéro.
2. Attacher ou créer un compte WhatsApp Business (WABA). Le panneau de configuration WhatsApp de l'application se connecte soit à un WABA existant, soit en crée un nouveau. Enregistrez l'ID WABA et l'ID du numéro de téléphone de test à un endroit durable.
3. Essayez d'abord le numéro de test fourni par Meta. Il est gratuit pour une période d'essai limitée, prend en charge une poignée de numéros de destinataires pré-approuvés (chacun nécessitant un code à usage unique pour être sur liste blanche), et est le moyen le plus rapide de prouver que le webhook et le code d'envoi de messages fonctionnent avant qu'une vraie carte SIM ne soit impliquée.
4. Générez un jeton d'accès utilisateur système, pas un jeton utilisateur temporaire. Un utilisateur système avec le rôle approprié, affecté à l'application avec un accès de gestion, peut générer un jeton sans date d'expiration — les autorisations nécessaires sont généralement les périmètres de messagerie et de gestion WABA ; un périmètre de gestion d'entreprise plus large est également nécessaire si l'intégration doit un jour lire le statut de vérification ou supprimer un WABA via l'API plutôt que la console. Les jetons temporaires provenant des guides de démarrage rapide expirent dans les 24 heures et ne conviennent pas à un usage continu.