Aller au contenu principal
Guides 7 min de lecture

Créer son App Meta pour WhatsApp API : Configuration Pas-à-Pas pour Débutants

Guide complet pour créer et configurer une application Meta for Developers pour accéder à l'API WhatsApp Business. Étapes détaillées avec captures d'écran, erreurs courantes et bonnes pratiques.

Créer son App Meta pour WhatsApp API : Configuration Pas-à-Pas pour Débutants

La création d'une application Meta est l'une des premières étapes techniques du déploiement de l'API WhatsApp Business. C'est une étape qui fait peur aux non-développeurs — le portail Meta for Developers peut sembler complexe — mais elle est en réalité accessible à quiconque suit la bonne procédure. Ce guide vous mène pas à pas, du premier clic jusqu'à votre premier appel API fonctionnel.

Comprendre le Rôle de l'Application Meta

Avant de créer quoi que ce soit, il faut comprendre pourquoi une "application" Meta est nécessaire. Dans l'écosystème Meta, une application est en réalité un conteneur d'autorisations et de credentials. C'est elle qui :

  • Détient les clés d'accès (tokens) pour appeler l'API WhatsApp
  • Définit les permissions accordées (quels endpoints API vous pouvez appeler)
  • Gère la liaison entre vos numéros WhatsApp et votre compte business
  • Contient la configuration de vos webhooks (URL de réception des événements)

Une même application peut être liée à plusieurs numéros WhatsApp. À l'inverse, plusieurs applications peuvent être liées au même WABA (WhatsApp Business Account), ce qui est utile si vous avez des équipes ou des environnements différents (dev, staging, prod).

Pour les BSP (Business Solution Providers) comme Whakup, l'application Meta est gérée par le BSP. Vous n'avez pas à créer votre propre application — vous vous connectez via le processus Embedded Signup. Ce guide est utile si vous souhaitez une intégration directe (cloud API) sans passer par un BSP, ou si vous voulez comprendre ce qui se passe en coulisses.

Prérequis avant de Commencer

Assurez-vous d'avoir :

  • Un compte Facebook personnel (requis pour accéder à Meta for Developers)
  • Un compte Meta Business Manager créé et vérifié (voir notre guide vérification Meta Business)
  • Un numéro de téléphone disponible pour la vérification WhatsApp

Création de l'Application Meta : Étapes Complètes

Étape 1 — Accéder au portail développeurs

  1. Rendez-vous sur developers.facebook.com
  2. Connectez-vous avec votre compte Facebook
  3. Si c'est votre première visite, acceptez les Conditions d'utilisation développeur
  4. Cliquez sur "Mes applications" dans le menu supérieur

Étape 2 — Créer une nouvelle application

  1. Cliquez sur le bouton vert "Créer une application"
  2. Une boîte de dialogue vous demande de choisir le type d'app
  3. Sélectionnez "Business" (et non "Consumer" ou "None") — c'est impératif pour accéder à l'API WhatsApp Business
  4. Cliquez sur "Suivant"

Étape 3 — Renseigner les informations de l'application

  1. Nom de l'application : choisissez un nom descriptif et professionnel (ex: "NomMarque-WhatsApp-Prod")
  2. Email de contact : votre email professionnel, utilisé pour les notifications Meta importantes
  3. Business Portfolio : sélectionnez votre Meta Business Manager dans la liste déroulante
  4. Cliquez sur "Créer une application"
  5. Meta peut vous demander de confirmer votre identité avec votre mot de passe Facebook

Étape 4 — Ajouter le produit WhatsApp Une fois l'application créée, vous arrivez sur le tableau de bord :

  1. Dans la section "Ajouter des produits à votre application", cherchez "WhatsApp"
  2. Cliquez sur "Configurer" dans la carte WhatsApp
  3. Meta vous redirige vers la configuration WhatsApp

Étape 5 — Lier votre WABA (WhatsApp Business Account)

  1. Dans WhatsApp > Paramètres, la section "WhatsApp Business Account" apparaît
  2. Cliquez sur "Créer un nouveau WABA" si vous n'en avez pas, ou sélectionnez un WABA existant
  3. Si vous créez un nouveau WABA, renseignez : nom du compte business, fuseau horaire, devise, et catégorie d'entreprise
  4. Validez — votre WABA est maintenant lié à votre application

Étape 6 — Ajouter un numéro de téléphone

  1. Dans WhatsApp > Configuration API, section "De"
  2. Cliquez sur "Ajouter un numéro de téléphone"
  3. Renseignez les informations du profil business : Display Name, catégorie, description
  4. Saisissez votre numéro de téléphone
  5. Choisissez la méthode de vérification : SMS ou appel vocal
  6. Entrez le code reçu pour valider

Étape 7 — Récupérer vos identifiants API

# Les identifiants clés à conserver sont :
# - App ID : visible dans l'URL de votre app (/app/1234567890)
# - App Secret : Paramètres > Général > Clé secrète de l'application
# - Phone Number ID : WhatsApp > Configuration API > Numéro sélectionné
# - WABA ID : WhatsApp > Configuration API > Compte WhatsApp Business
# - Temporary User Access Token : valable 24h, à remplacer par un System User Token

# Test rapide avec le token temporaire
curl -X GET \
  "https://graph.facebook.com/v19.0/YOUR_PHONE_NUMBER_ID?fields=display_phone_number,quality_rating" \
  -H "Authorization: Bearer YOUR_TEMP_TOKEN"

Étape 8 — Créer un System User pour les tokens permanents

  1. Retournez dans votre Meta Business Manager (business.facebook.com)
  2. Paramètres > Utilisateurs > Utilisateurs système
  3. Cliquez sur "Ajouter" > Type : "Admin system user" > Validez
  4. Cliquez sur "Générer un token" pour ce system user
  5. Sélectionnez votre application et cochez les permissions whatsapp_business_messaging et whatsapp_business_management
  6. Le token généré n'expire pas (sauf révocation manuelle) — conservez-le en sécurité

Configuration du Mode Production vs Développement

Par défaut, votre application est en mode développement. Dans ce mode :

  • Seuls les utilisateurs listés comme testeurs peuvent recevoir des messages
  • Les webhooks fonctionnent normalement
  • Idéal pour les tests initiaux

Pour passer en mode live (production) :

  1. Dans votre app Meta, cliquez sur le toggle "Mode développement" en haut à droite
  2. Meta vous demandera de confirmer et peut nécessiter des informations supplémentaires sur l'usage
  3. Une fois en mode live, votre API peut contacter n'importe quel numéro WhatsApp

Important : Ne passez en mode live que lorsque votre intégration est testée et stable. Un basculement prématuré avec des bugs de production peut rapidement dégrader votre score de qualité.

Pour tester votre app en sandbox avant le mode live, consultez notre guide Sandbox WhatsApp API. Pour la compréhension des identifiants, lisez notre article sur le Phone Number ID et WABA ID. Le guide WhatsApp Business API sans développeur vous montrera l'alternative no-code.

FAQ — Création App Meta WhatsApp API

Doit-on créer une application Meta séparée pour chaque numéro WhatsApp ? Non. Une seule application Meta peut gérer plusieurs numéros WhatsApp (liés au même WABA ou à des WABA différents). En général, une application par environnement (développement, production) est la meilleure pratique.

L'application Meta doit-elle être publique pour utiliser l'API WhatsApp ? Non. Votre application Meta n'a pas besoin d'être visible publiquement (pas de publication sur l'App Store Facebook). Elle sert uniquement d'interface API entre votre infrastructure et les serveurs Meta. Elle peut rester en mode privé.

Peut-on utiliser un compte Meta personnel (non Business) ? Techniquement oui pour créer l'app, mais vous devez obligatoirement associer un Meta Business Manager pour accéder à l'API WhatsApp Business. Sans Business Manager vérifié, l'accès à la production est impossible.

Que se passe-t-il si je supprime mon application Meta ? La suppression de l'application Meta est une action irréversible qui révoque tous les tokens associés et désactive l'accès API pour tous les numéros liés. Vos WABA et numéros WhatsApp ne sont pas supprimés (ils restent dans votre Business Manager), mais il faut reconfigurer une nouvelle application depuis zéro.


La configuration d'une application Meta vous semble encore complexe ? Créez votre compte Whakup et laissez notre infrastructure gérer toute la configuration technique — vous accédez directement à vos campagnes WhatsApp sans toucher à une seule ligne de code.

#app meta whatsapp#developer app facebook#créer application meta#meta for developers
Pablo Lenormand
Pablo LenormandCo-fondateur & CPO

Co-fondateur et Chief Product Officer de Whakup, Pablo conçoit les fonctionnalités qui permettent aux marques africaines de maximiser leur impact sur WhatsApp.

Guides
🚀

Prêt à passer à l'action ?

Essayez Whakup gratuitement pendant 15 jours. Aucune carte bancaire requise.

Démarrer l'essai gratuit