Aller au contenu
OmniChannels.ai

Comment configurer l'API WhatsApp Business : guide pas à pas

Configurer l'API WhatsApp Business pas à pas : portefeuille Meta, vérification, numéro, nom d'affichage, Embedded Signup, modèles et mise en production.

Mis à jour le 9 min de lecture

Par OmniChannels.ai Editorial Team · Relu par BroadNet Messaging Solutions Team

WhatsApp

Réponse courte

Pour configurer l'API WhatsApp Business, créez ou utilisez un portefeuille d'entreprise Meta, faites vérifier votre entreprise, choisissez un numéro capable de recevoir un SMS ou un appel vocal et non actif sur WhatsApp, retenez un nom d'affichage conforme à votre marque, connectez-vous via le parcours Embedded Signup de votre fournisseur, ajoutez un moyen de paiement, enregistrez le numéro avec un code PIN de validation en deux étapes, puis soumettez vos premiers modèles de message à approbation avant la mise en production.

Sur cette page
  1. De quoi avez-vous besoin avant de commencer ?
  2. Comment configurer l'API WhatsApp Business pas à pas ?
  3. Exemple concret : un institut de formation de Doha passe en production
  4. Checklist de mise en production
  5. Quelles sont les erreurs de configuration les plus courantes ?
  6. Comment OmniChannels.ai vous aide

Points clés

  • Selon Meta, le numéro de téléphone professionnel de l'API doit vous appartenir, comporter un indicatif pays et régional, et pouvoir recevoir un SMS ou un appel vocal ; les codes courts ne sont pas pris en charge.
  • Un numéro déjà utilisé sur WhatsApp doit être supprimé de l'appli avant l'enregistrement, sauf si l'on recourt à l'option de coexistence de Meta pour les numéros éligibles de l'application Business.
  • Embedded Signup permet de créer ou de sélectionner un portefeuille d'entreprise, un compte WhatsApp Business et un numéro de téléphone au sein de la plateforme d'un fournisseur.
  • La vérification de l'entreprise augmente le nombre de numéros que vous pouvez enregistrer et constitue l'une des voies vers des limites de messagerie plus élevées.
  • L'approbation des modèles, un moyen de paiement valide et un code PIN de validation en deux étapes sont les points de blocage habituels avant la mise en production.

Ce guide s'adresse au responsable marketing, expérience client ou informatique chargé de mettre son entreprise en production sur l'API WhatsApp Business. Il déroule chaque étape de l'activation dans l'ordre, explique ce que Meta contrôle à chaque stade et se termine par une checklist de mise en production et les erreurs les plus fréquentes.

De quoi avez-vous besoin avant de commencer ?

Réunissez quatre éléments : un accès administrateur au portefeuille d'entreprise Meta de votre société, vos documents légaux, un numéro de téléphone dédié et un nom de marque que les clients reconnaissent. La plupart des retards viennent de l'absence de l'un d'eux.

Élément Exigence Pourquoi c'est important
Portefeuille d'entreprise Meta Accès administrateur ; dénomination légale et adresse renseignées Détient le compte WhatsApp Business (WABA)
Documents d'entreprise Licence commerciale ou immatriculation, justificatif d'adresse Nécessaires à la vérification de l'entreprise
Site web Sur un domaine que vous contrôlez, affichant le nom de votre entreprise Appuie la vérification et l'examen du nom d'affichage
Numéro de téléphone Vous appartient, avec indicatif pays et régional, peut recevoir un SMS ou un appel vocal Requis pour l'enregistrement ; les codes courts ne sont pas pris en charge
Nom d'affichage Correspond à votre marque et à votre site Affiché sur votre profil WhatsApp ; examiné par Meta
Moyen de paiement Carte ou ligne de crédit du fournisseur Requis pour envoyer des modèles payants
Processus de consentement (opt-in) Consentement clair des clients pour recevoir des messages WhatsApp Exigé par la politique de WhatsApp

Comment configurer l'API WhatsApp Business pas à pas ?

Suivez ces étapes dans l'ordre. Si vous passez par un fournisseur, les étapes 3 à 6 se déroulent généralement dans son parcours Embedded Signup.

Étape 1 : préparer votre portefeuille d'entreprise Meta

Connectez-vous à Meta Business Suite avec un compte Facebook personnel qui est administrateur du portefeuille d'entreprise de la société, ou créez un portefeuille. Utilisez exactement la dénomination légale et l'adresse figurant sur vos documents. Ajoutez au moins deux administrateurs pour ne pas perdre l'accès si l'un d'eux quitte l'entreprise.

Étape 2 : lancer la vérification de l'entreprise

Dans le Centre de sécurité de votre portefeuille d'entreprise, lancez la vérification de l'entreprise. Meta demande des documents confirmant la dénomination légale, l'adresse et le téléphone ou l'e-mail, et peut vérifier par un code ou un contrôle de domaine. Les exigences diffèrent selon les pays et évoluent : suivez les instructions affichées à l'écran.

Vous pouvez commencer l'activation avant la fin de la vérification, mais Meta applique des limites plus basses d'ici là : selon sa documentation, les nouveaux portefeuilles démarrent avec deux numéros enregistrés et une limite de messagerie de 250 utilisateurs uniques hors fenêtre de service client.

Étape 3 : choisir le numéro de téléphone

Choisissez un numéro qui restera à l'entreprise pendant des années, comme une ligne fixe ou une ligne mobile dédiée. Meta exige que le numéro :

  • vous appartienne et comporte un indicatif pays et régional ;
  • puisse recevoir un SMS ou un appel vocal pour la vérification ;
  • ne soit pas un code court ;
  • ne soit pas actuellement enregistré sur WhatsApp, sauf si vous recourez à l'option de coexistence de Meta pour un numéro éligible de l'application WhatsApp Business.

Si le numéro est sur WhatsApp ou sur l'application WhatsApp Business et que vous ne souhaitez pas la coexistence, sauvegardez ce dont vous avez besoin et supprimez d'abord le compte dans l'appli.

Étape 4 : choisir votre nom d'affichage

Le nom d'affichage apparaît sur votre profil WhatsApp. Utilisez la marque que vos clients connaissent, en cohérence avec votre site web et vos documents d'entreprise. Évitez les noms génériques (« Best Deals »), les majuscules inhabituelles ou l'ajout de slogans. Meta examine le nom ; son statut apparaît dans WhatsApp Manager comme en attente, approuvé ou refusé.

Étape 5 : se connecter via Embedded Signup

L'Embedded Signup est le parcours de Meta que les fournisseurs intègrent à leur plateforme. Vous vous connectez avec Facebook, sélectionnez ou créez le portefeuille d'entreprise, créez ou sélectionnez un compte WhatsApp Business, saisissez le numéro de téléphone et le nom d'affichage, puis vérifiez le numéro avec un code reçu par SMS ou appel vocal. À la fin, le fournisseur reçoit l'autorisation de gérer le WABA en votre nom, tandis que votre portefeuille en conserve la propriété.

Étape 6 : enregistrer le numéro et définir un code PIN en deux étapes

Le numéro doit être enregistré pour l'API Cloud avec un code PIN de validation en deux étapes à six chiffres. Votre fournisseur s'en charge généralement lors de l'activation. Conservez le code PIN en lieu sûr : il sera nécessaire pour le modifier ou pour supprimer le numéro plus tard.

Étape 7 : ajouter un moyen de paiement

Meta facture chaque modèle de message délivré, selon la catégorie et le pays du destinataire. Ajoutez une carte au WABA dans WhatsApp Manager, ou vérifiez que la ligne de crédit de votre fournisseur couvre votre compte. Sans facturation valide, les envois de modèles échouent.

Étape 8 : créer vos premiers modèles

En dehors de la fenêtre de service client de 24 heures, vous ne pouvez envoyer que des modèles approuvés. Commencez par trois à cinq modèles utiles dès le premier jour :

  1. Un modèle utilitaire pour la confirmation de commande ou de réservation.
  2. Un modèle utilitaire pour un point d'avancement, comme une livraison ou un rappel.
  3. Un modèle d'authentification si vous envoyez des codes à usage unique.
  4. Un modèle marketing pour votre première campagne auprès de clients ayant donné leur accord.

Utilisez des variables pour les noms et les numéros de commande, tenez le langage promotionnel hors des modèles utilitaires, et créez des versions arabe et anglaise comme langues distinctes d'un même modèle si vous servez des clients du Golfe.

Exemple concret : un institut de formation de Doha passe en production

« Al Fanar Academy » (exemple fictif) souhaite utiliser WhatsApp pour les demandes d'information sur ses cours et les rappels de séances.

  • Semaine 1 : la responsable des opérations confirme son accès administrateur au portefeuille d'entreprise, téléverse l'extrait d'immatriculation et lance la vérification. L'académie choisit sa ligne fixe principale, qui peut recevoir un appel vocal.
  • Activation : via l'Embedded Signup du fournisseur, elle crée un WABA, saisit le nom d'affichage « Al Fanar Academy » et vérifie le numéro par appel vocal.
  • Modèles : elle soumet un rappel de cours (utilitaire), une confirmation d'inscription (utilitaire) et une annonce de nouvelle session (marketing), en arabe et en anglais. Le modèle marketing est rejeté pour un appel à l'action vague, puis approuvé après réécriture.
  • Mise en production : elle envoie des rappels aux étudiants qui ont donné leur accord via le formulaire d'inscription, et route les réponses vers la boîte de réception de l'équipe des admissions.

L'étape la plus longue a été la vérification, pas la mise en place technique.

Checklist de mise en production

Cochez chaque point avant votre première campagne.

  1. Vérification de l'entreprise soumise ou approuvée.
  2. Nom d'affichage approuvé.
  3. Numéro de téléphone enregistré et code PIN en deux étapes conservé en lieu sûr.
  4. Moyen de paiement valide et approvisionné.
  5. Modèles nécessaires approuvés dans toutes les langues requises.
  6. Consentement enregistré pour chaque contact que vous contacterez.
  7. Boîte de réception configurée, avec des agents désignés pour répondre aux messages entrants.
  8. Messages de test envoyés à des numéros internes et contrôlés sur Android et iOS.
  9. Reporting de livraison examiné pour les envois de test.
  10. Volume d'envoi planifié dans la limite de messagerie actuelle.

Quelles sont les erreurs de configuration les plus courantes ?

La plupart des erreurs relèvent d'une poignée de cas types. La documentation de Meta sur les codes d'erreur les recense ; voici ceux que les équipes d'activation rencontrent le plus.

Code d'erreur Signification (selon Meta) Correctif habituel
133010 Numéro de téléphone non enregistré Terminer l'enregistrement avec le code PIN en deux étapes
131047 Fenêtre de service client fermée Envoyer un modèle approuvé au lieu d'un texte libre
132001 Le modèle n'existe pas dans cette langue ou n'est pas approuvé Vérifier le nom du modèle, le code de langue et le statut d'approbation
132012 Les valeurs des variables ne correspondent pas au format du modèle Respecter le nombre et le format des variables
131042 Problème de moyen de paiement Corriger la carte ou la ligne de crédit du WABA
131026 Message non distribuable Le destinataire n'utilise peut-être pas WhatsApp ou a une appli obsolète ; passer par un autre canal
131049 Message retenu pour préserver la santé de l'écosystème Souvent lié à la fréquence marketing ; attendre avant de renvoyer et revoir le ciblage
368 Compte restreint pour violation de la politique Consulter les avis de politique dans WhatsApp Manager et faire appel si approprié

D'autres problèmes fréquents ne sont pas des codes d'erreur : un numéro encore actif sur l'appli WhatsApp, un nom d'affichage qui ne correspond pas au site web, et des administrateurs sans contrôle total du portefeuille.

Comment OmniChannels.ai vous aide

OmniChannels.ai, propulsé par BroadNet Technologies, active les numéros de l'API WhatsApp Business via Meta Embedded Signup : votre portefeuille d'entreprise conserve donc la propriété du WABA. Vous pouvez créer des modèles marketing, utilitaires et d'authentification, y compris des OTP one-tap, zero-tap et copy-code, avec variables, médias et boutons, puis les vérifier dans un aperçu téléphone et suivre leur approbation. Une fois en production, les campagnes prennent en charge l'import Excel/CSV, l'aperçu, la planification et le filtrage des doublons, avec des rapports de livraison pour chaque envoi. L'arabe et l'anglais sont pris en charge. Consultez la page API WhatsApp Business et les campagnes, ou réservez une démonstration.

Questions fréquentes

Puis-je utiliser mon numéro WhatsApp actuel pour l'API ?

Oui, sous conditions. Meta indique que les numéros déjà utilisés sur WhatsApp doivent être supprimés de l'appli avant d'être enregistrés sur l'API. Pour les numéros éligibles de l'application WhatsApp Business, Meta propose aussi, pendant l'Embedded Signup, une option de coexistence qui laisse l'appli fonctionner sur le même numéro. Vérifiez l'éligibilité pour votre marché avant de décider.

La vérification d'entreprise Meta est-elle obligatoire ?

Vous pouvez commencer à envoyer avant la vérification, mais avec des limites plus basses. Selon Meta, les nouveaux portefeuilles démarrent avec deux numéros enregistrés et une limite de messagerie de 250 utilisateurs uniques hors fenêtre de service ; vérifier l'entreprise est un moyen de relever le plafond de numéros et d'accéder à une limite de messagerie supérieure. La plupart des entreprises en croissance ont intérêt à vérifier tôt.

Quels documents faut-il pour la vérification d'entreprise ?

Meta demande en général des documents attestant la dénomination légale, l'adresse et le numéro de téléphone de l'entreprise, comme une licence commerciale, un extrait d'immatriculation ou une facture de services publics, ainsi qu'un site web sur un domaine que vous contrôlez. Les exigences varient selon les pays et évoluent : suivez les instructions du Centre de sécurité de Meta Business Suite pour votre portefeuille.

Pourquoi mon nom d'affichage a-t-il été refusé ?

Un nom d'affichage est généralement refusé lorsqu'il n'a pas de lien clair avec l'entreprise, ne comporte que des termes génériques, abuse des majuscules ou de la ponctuation, ou ne peut être rattaché à votre site web ou à votre entreprise vérifiée. Utilisez la marque que vos clients connaissent, assurez-vous que votre site la mentionne et soumettez de nouveau avec une identité cohérente.

Ai-je besoin d'un développeur pour configurer l'API WhatsApp Business ?

Non, lorsqu'un fournisseur propose l'Embedded Signup et une plateforme prête à l'emploi avec boîte de réception, modèles et campagnes. Un développeur est nécessaire si vous voulez appeler l'API directement, recevoir des webhooks dans vos propres systèmes ou intégrer WhatsApp à votre CRM ou à votre plateforme de commandes.

Sources

  1. Numéros de téléphone — API WhatsApp Cloud, Meta for Developers
  2. Embedded Signup — Meta for Developers
  3. Vérification d'entreprise — Meta for Developers
  4. Modèles de message — Meta for Developers
  5. Limites de messagerie — Meta for Developers
  6. Codes d'erreur — API WhatsApp Cloud, Meta for Developers