Guide WhatsApp Business API

Ce guide vous accompagne dans la création d'un numéro WhatsApp Business et l'accès à l'API Cloud de Meta pour intégrer WhatsApp dans vos applications.

Vue d'ensemble

Cette procédure résume les étapes indispensables pour :

• Créer un numéro WhatsApp Business via Meta
• L'enregistrer pour l'API Cloud
• Obtenir un jeton d'accès permanent avec les autorisations WhatsApp

Les informations proviennent de la documentation officielle de Meta et de guides de développeurs.

1. Créer et vérifier votre compte Business sur Meta

Créer une application Meta WhatsApp

1. Connectez-vous à developers.facebook.com (opens in a new tab)
2. Créez une nouvelle application de type « Entreprises » (business app)
3. Cette application sera associée à votre entreprise et au numéro WhatsApp

Vérifier l'entreprise

Assurez-vous que votre Business Manager est vérifié avec :

• Nom légal
• Adresse
• Numéro de téléphone

Important : Meta n'active pas les numéros tant que l'entreprise n'est pas approuvée.

2. Ajouter et vérifier un numéro de téléphone

Ajouter le numéro

1. Ouvrez le tableau de bord de votre application
2. Dans le menu latéral, allez à WhatsApp > API Setup
3. Sous « Step 5 : Add a phone number », cliquez sur Add phone number

Configurer le numéro

1. Indiquez un nom d'affichage correspondant à votre marque
2. Choisissez votre fuseau horaire
3. Sélectionnez la catégorie d'activité
4. Ajoutez une description

Note : Meta vérifie le nom - il doit refléter clairement l'entreprise, sinon le numéro reste en état « Pending ».

Vérifier le numéro

1. Saisissez le numéro de téléphone (il doit être capable de recevoir un appel ou un SMS)
2. Le numéro ne doit pas être déjà utilisé dans WhatsApp
3. Recevez le code par SMS ou appel
4. Saisissez le code dans la fenêtre de vérification

Après validation, le numéro apparaît dans la liste et peut être utilisé pour envoyer des messages.

Astuce : Le tableau de bord affiche un « Phone Number ID » pour chaque numéro. Notez cet identifiant, car il est requis dans les requêtes API.

3. Enregistrer le numéro (prise en charge par le développeur)

Une fois le numéro ajouté dans le tableau de bord, il doit parfois être « enregistré » via l'API Cloud pour être pleinement activé.

Aucune action n'est nécessaire de votre part : cette étape technique sera réalisée par votre développeur à l'aide du Phone Number ID et du jeton généré au moment de l'installation.

L'objectif est simplement de valider définitivement le numéro auprès de Meta.

4. Créer un system user et générer un jeton permanent

Créer l'utilisateur système

1. Dans business.facebook.com > Business Settings
2. Accédez à Users > System Users
3. Cliquez sur Add pour créer un utilisateur système
4. Donnez un nom et définissez le rôle Admin pour un contrôle total sur l'application

Générer le jeton

1. Une fois l'utilisateur créé, cliquez sur Generate New Token dans sa fiche

2. Sélectionnez votre application dans la liste

3. Cochez les permissions Graph API suivantes :

   • business_management – donne accès à la gestion des actifs de l'entreprise
   • whatsapp_business_management – permet de gérer l'API WhatsApp Business
   • whatsapp_business_messaging – permet d'envoyer des messages WhatsApp

4. Validez pour générer un jeton permanent

Important : Copiez le jeton immédiatement ; il ne sera plus affiché. Contrairement aux jetons d'utilisateur qui expirent, ce jeton est à longue durée de vie tant que vous ne le révoquez pas.

Attribuer les actifs

1. De retour dans la liste des utilisateurs système
2. Utilisez Add assets pour attribuer votre application et le compte WhatsApp Business à l'utilisateur
3. Donnez-lui Full Control / Manage App

Cela garantit que le jeton peut accéder au numéro et envoyer des messages.

Résumé

La création d'un numéro WhatsApp Business et l'accès à l'API Cloud Meta reposent sur trois actions principales :

1. Ajouter et vérifier le numéro
2. L'enregistrer via l'API
3. Générer un jeton permanent via un utilisateur système

En suivant ces étapes, vous obtenez :

• Un identifiant de numéro (phone_number_id)
• Un jeton d'accès avec les autorisations nécessaires pour intégrer WhatsApp à vos applications

Informations à fournir pour l'intégration

Pour finaliser l'intégration de votre numéro, merci de nous transmettre les informations suivantes :

Avec ces éléments, nous pourrons configurer l'API et envoyer des messages WhatsApp en votre nom.

Besoin d'aide ? Contactez notre équipe support pour un accompagnement personnalisé dans la configuration de votre numéro WhatsApp Business.