Connecter l'API Cloud WhatsApp Business à AssistFlow : Guide étape par étape

Temps : ~10 minutes · Niveau de compétence : Intermédiaire · Coût : Gratuit avec le numéro de test fourni par Meta

Dans ce guide, nous allons créer une application API Cloud WhatsApp Business sur Meta for Developers, la connecter à AssistFlow et activer les réponses automatiques par IA pour les messages entrants. Chaque étape a été testée en direct.

Prérequis

• Un compte Meta (Facebook) avec un compte Meta Business actif
• Un numéro de téléphone non enregistré sur WhatsApp (Meta vous fournit également un numéro de test gratuit)
• Un compte AssistFlow avec accès au tableau de bord développeur (/dashboard/whatsapp-settings)

1. Créer une application Meta for Developers

1. Rendez-vous sur developers.facebook.com/apps et cliquez sur Create App.
2. Choisissez le cas d'utilisation "Other" et le type d'application "Business".
3. Saisissez un nom d'application (par exemple "AssistFlow WhatsApp") et votre email de contact, puis sélectionnez votre compte Business.

2. Ajouter le produit WhatsApp

1. Depuis la barre latérale du tableau de bord de l'application, cliquez sur "Add product" et sélectionnez "Set up" sur la carte WhatsApp.
2. Sélectionnez un Portfolio Business (ou créez-en un).
3. Meta provisionnera automatiquement un numéro de téléphone de test et un compte WhatsApp Business (WABA) — vous pouvez envoyer des messages gratuits avec celui-ci pendant le développement.

3. Récupérez votre ID de numéro de téléphone, ID WABA et numéro d'affichage

Depuis la barre latérale, ouvrez WhatsApp → API Setup :

• ID de numéro de téléphone — longue chaîne de chiffres sous "From" (par exemple 527144740475098)
• ID de compte WhatsApp Business — en haut, à côté du menu déroulant
• Numéro de téléphone d'affichage — votre numéro de test ou vérifié au format E.164 (par exemple +90 555 724 22 44)
• Nom commercial vérifié — le nom de votre entreprise dans Business Manager

Copiez ces quatre valeurs quelque part en sécurité — nous les collerons dans AssistFlow ensuite.

4. Générer un jeton d'accès permanent

Le "jeton d'accès temporaire" sur API Setup expire dans 24 heures. Pour la production, créez un Utilisateur Système dans Meta Business et émettez-lui un jeton permanent :

1. business.facebook.com → Paramètres → Utilisateurs → Utilisateurs Système
2. Ajouter → nommez-le (par exemple "AssistFlow Token"), définissez le rôle sur Admin.
3. Sélectionnez le nouvel utilisateur → Ajouter des actifs → Applications → choisissez votre application AssistFlow → accordez Gérer l'application.
4. Ajoutez également Comptes WhatsApp comme actif → accordez Gérer le compte WhatsApp.
5. Générer un nouveau jeton → sélectionnez votre application → activez au moins :
   • whatsapp_business_management
   • whatsapp_business_messaging
   • business_management
6. Activez "Never expires" → Générer → copiez le jeton immédiatement (Meta ne le montrera plus).

5. Collez les identifiants dans AssistFlow

1. Connectez-vous à votre tableau de bord développeur AssistFlow → WhatsApp AI → Paramètres WhatsApp.
2. Dans la carte Identifiants API Cloud Meta, collez :
   • ID de numéro de téléphone
   • ID de compte WhatsApp Business
   • Jeton d'accès permanent
   • Numéro de téléphone d'affichage
   • Nom commercial vérifié
3. Cliquez sur Enregistrer en bas. Le système génère automatiquement un Jeton de vérification Webhook pour vous.

6. Connecter le webhook côté Meta

Après avoir enregistré, la carte Paramètres Webhook affiche deux valeurs :

Callback URL : https://<project>.supabase.co/functions/v1/whatsapp-webhook Verify Token : (généré automatiquement, cliquez sur "Copier")

Retournez maintenant au portail développeur Meta :

1. Barre latérale → WhatsApp → Configuration → Webhook.
2. Collez Callback URL et Verify Token → Vérifier et enregistrer.
3. Dans "Champs Webhook" S'abonner à messages. (Optionnel : abonnez-vous aussi à message_template_status_update et account_update.)

7. Activer les réponses IA

AssistFlow → Paramètres WhatsApp → carte Paramètres de réponse automatique :

• Activer l'intégration → on
• Réponses IA actives → on
• Widget par défaut → choisissez quelle base de connaissances + persona l'IA doit utiliser (vous pouvez choisir votre widget de chat existant).
• Limite de messages quotidiens → 1000 (ou ce qui convient à votre plan).
• Message en dehors des heures → texte envoyé automatiquement en dehors de vos heures de travail.

Cliquez à nouveau sur Enregistrer.

8. Testez-le

1. Depuis le panneau "Envoyer et recevoir des messages" du numéro de test, envoyez un message — écrivez au numéro depuis votre propre WhatsApp.
2. En moins de 30 secondes, vous devriez voir la réponse de l'IA sur votre WhatsApp.
3. Ouvrez Messages WhatsApp dans AssistFlow → confirmez que le message est enregistré comme entrant + sortant.

9. Passer en production

1. Portail développeur Meta → App Review → Permissions and Features → Demander un accès avancé pour whatsapp_business_messaging et whatsapp_business_management.
2. WhatsApp → Numéros de téléphone → Ajouter un numéro de téléphone → ajoutez votre vrai numéro d'entreprise, vérifiez par SMS/Voix.
3. Mettez à jour le nouvel ID de numéro de téléphone dans AssistFlow (remplacez celui de test).
4. Changez le mode de l'application en Live.

Problèmes courants

"Échec de la vérification du webhook"

Le jeton de vérification ne correspond pas ou vous n'avez pas enregistré AssistFlow en premier. Enregistrez les paramètres, puis collez dans Meta.

Les messages arrivent mais l'IA ne répond pas

"Réponses IA actives" pourrait être désactivé. De plus, si "Widget par défaut" n'est pas défini, l'IA ne sait pas quelle persona utiliser.

Erreur de "Réengagement" / fenêtre de 24 heures

Politique WhatsApp : si un client ne vous a pas envoyé de message depuis 24 heures, vous ne pouvez le joindre qu'avec un modèle approuvé. Synchronisez les modèles depuis Meta dans l'onglet Modèles.

Jeton expiré

Vous avez utilisé le jeton temporaire (24h). Utilisez le flux Utilisateur Système à l'étape 4 pour obtenir un jeton permanent.

Prochaines étapes

• Modèles WhatsApp : synchronisez vos modèles marketing approuvés dans l'onglet Modèles.
• Campagnes WhatsApp : téléchargez une liste de prospects et lancez des campagnes goutte à goutte.
• Analytique conversationnelle : suivez les envois quotidiens, les ouvertures et les sessions actives dans l'onglet Analytique.

Besoin d'aide ? Envoyez un email à support@assistflow.ai — le support à l'installation est inclus dans votre plan.