Ce guide explique comment relier votre Agent IA Quickchat AI à WhatsApp. Le processus comporte 2 étapes simples :
- Étape 0 : Préparer les prérequis.
- Étape 1 : Connecter WhatsApp.
En cas de difficulté, consultez le dépannage et les questions fréquentes ou contactez-nous.
Regardez la vidéo
Étape 0 : Prérequis
A. Numéro de téléphone professionnel
Choisissez le numéro de téléphone à utiliser sur WhatsApp. Consultez la documentation WhatsApp ou les réponses ci-dessous.
Quel numéro peut être utilisé avec WhatsApp Cloud API ?
- Il faut un numéro professionnel dédié, capable de recevoir des SMS ou appels vocaux pour la vérification.
- Le numéro doit être valide, vous appartenir et inclure les indicatifs du pays et de la zone.
Puis-je utiliser un numéro déjà enregistré dans WhatsApp Messenger ?
- Non. Vous pouvez continuer les appels et SMS, mais pas l’utiliser simultanément dans WhatsApp Messenger.
- S’il est déjà dans Messenger, supprimez d’abord cet enregistrement. Pensez à sauvegarder vos conversations.
- Un numéro banni doit être débloqué avant l’enregistrement.
Puis-je utiliser un numéro de l’application WhatsApp Business ?
- Oui. Un numéro dans WhatsApp Business App peut être éligible à Cloud API sans suppression du compte de l’application. Consultez la documentation Meta sur l’inscription avec Coexistence.
Puis-je utiliser un nouveau numéro ?
- Oui. Si vous préférez ne pas utiliser votre numéro actuel, obtenez un nouveau numéro, avec carte SIM physique ou numéro virtuel. Des services comme Hushed proposent des numéros virtuels.
B. Informations sur l’entreprise
Préparez les informations à saisir pendant le parcours Meta :
- Nom de l’entreprise.
- Site web.
- Catégorie d’activité.
- Description.
Même les champs apparemment facultatifs doivent être remplis correctement. Des informations manquantes ou erronées peuvent retarder l’approbation ou entraîner des restrictions sur le compte.
Étape 1 : Connecter WhatsApp
Depuis notre dernière mise à jour, la connexion commence par un clic. Il n’y a plus de deuxième phase indépendante : l’assistant Embedded Signup de Meta vous guide pour créer ou sélectionner un compte WhatsApp Business et un numéro. Quickchat AI termine le reste.
Ouvrez l’application Quickchat AI → External Apps → WhatsApp, cliquez sur Connect WhatsApp et suivez la fenêtre Meta :
- Connectez-vous à votre compte Meta, ou Facebook.
- Vérifiez les autorisations partagées avec Quickchat AI, notamment l’accès au compte WhatsApp Business et au portefeuille professionnel, puis continuez.
- Renseignez correctement Business Portfolio, Business Name, Business Website, Country et les autres données.
- Créez ou sélectionnez le compte WhatsApp Business.
- Choisissez le nom affiché et la catégorie WhatsApp Business.
- Ajoutez le numéro professionnel et vérifiez-le par SMS ou appel selon les indications.
- Cliquez sur Confirm pour accorder à Quickchat AI les accès nécessaires.
- Lorsque Meta confirme la fin de la configuration, cliquez sur Finish. La fenêtre affiche une confirmation de Quickchat AI indiquant que votre compte WhatsApp est connecté, puis se ferme automatiquement.
Dans l’application, le panneau affiche Connecting your WhatsApp account, puis Connected en environ 30 secondes. Sinon, cliquez sur Refresh Status. Si le problème persiste, vérifiez les Prérequis, le numéro et les informations professionnelles.
Connected signifie que Quickchat AI peut accéder à votre compte WhatsApp Business. Juste en dessous, le panneau indique ce qu’il reste à faire avant que les clients reçoivent des réponses :
Le panneau Connected indique ce qu’il reste à faire : ici, envoyer le premier message
- Waiting for your first message : envoyez un message WhatsApp depuis un autre téléphone au numéro indiqué, puis cliquez sur Refresh. Une fois le message reçu, le panneau affiche Messages Received à côté de Webhook Active et Admin Assigned.
- Nom d’affichage : chaque numéro dans la partie inférieure du panneau affiche le statut de son nom auprès de Meta (Approved, Pending review, Declined, Expired ou No display name). Un examen en cours ne demande aucune action de votre part et se termine généralement en quelques jours. Si le nom a été refusé, a expiré ou manque, soumettez-en un dans WhatsApp Manager.
- Numéro de test Meta : si le numéro actif est un +1 555 fourni par Meta, le panneau le signale. Ces numéros servent à faire des essais et ne peuvent pas être transférés vers un autre compte. Ajoutez votre propre numéro dans WhatsApp Manager pour commencer à servir vos clients.
Dès que le panneau affiche Messages Received, votre agent est en ligne ! 🎉 Les clients peuvent écrire au numéro WhatsApp et recevoir une réponse automatique.
Pour vérifier, envoyez un message texte via WhatsApp au numéro connecté, puis cliquez sur Refresh dans le panneau. Waiting for your first message devient Messages Received. Votre agent doit répondre et la conversation apparaître dans l’Inbox de Quickchat AI. Si une étape Meta reste inachevée, Quickchat AI envoie aussi au propriétaire du compte un rappel par e-mail avec les étapes restantes.
Dépannage et questions fréquentes
Comment fonctionne la tarification de WhatsApp Business API ?
- Les réponses aux demandes entrantes initiées par l’utilisateur sont des Service messages. Elles permettent le traitement par une personne ou un chatbot IA.
- Un message utilisateur ouvre une fenêtre de service de 24 heures, pendant laquelle les réponses de service sont gratuites. Cette fenêtre recommence à chaque message utilisateur.
- Au-delà de 24 heures, il faut des Message Templates approuvés, par exemple Marketing, Utility ou Authentication, facturés par message selon les tarifs WhatsApp.
- Meta classe les conversations et calcule leur facturation. Prévoyez un moyen de paiement valide sur votre compte WhatsApp Business pour les messages initiés par l’entreprise ou basés sur des modèles.
Connect WhatsApp ne fonctionne pas et la fenêtre Meta n’apparaît pas.
- Si le navigateur bloque la fenêtre, l’application vous demande de l’autoriser. Désactivez les bloqueurs de fenêtres et de traqueurs, actualisez et réessayez. Au besoin, utilisez un autre navigateur.
La vérification du numéro échoue.
- Vérifiez la réception des SMS ou appels et l’absence d’un enregistrement incompatible avec la coexistence autorisée par Meta. Pour un numéro Business App, essayez l’inscription Coexistence.
Meta indique une configuration incomplète, ou le panneau affiche un avertissement.
- Lisez d’abord la carte sous Connected : elle indique le numéro auquel votre agent répond et précise si Meta examine encore le nom d’affichage, s’il s’agit d’un numéro de test ou si le premier message n’est pas encore arrivé. Chaque carte renvoie au bon endroit dans WhatsApp Manager.
- Si l’avertissement concerne la connexion elle-même, cliquez sur Reconnect WhatsApp. Cela résout la plupart des cas.
- Sinon, le numéro peut être relié à un autre fournisseur. Meta autorise un seul partenaire par compte WhatsApp à la fois. Suivez les instructions pour ajouter Quickchat AI comme partenaire dans les paramètres Meta Business, puis cliquez sur Refresh Status.
J’ai connecté le mauvais compte.
- Reconnect conserve le compte déjà connecté. Pour en changer, cliquez sur Disconnect dans le panneau WhatsApp, puis de nouveau sur Connect WhatsApp, et choisissez les bons comptes Meta Business et WhatsApp dans la fenêtre Meta.
Les messages n’apparaissent pas dans l’Inbox Quickchat AI.
- Confirmez que la fenêtre a montré la confirmation finale de connexion.
- Vérifiez que le compte WhatsApp souhaité est connecté et que le bon Agent IA est sélectionné.
- La carte Waiting for your first message indique le numéro auquel votre agent répond. Vérifiez que vous avez écrit à ce numéro exact et qu’il est activé dans le panneau, puis cliquez sur Refresh.
- Si vous envoyez après 24 heures sans nouveau message utilisateur, utilisez des modèles approuvés et configurez un moyen de paiement dans WhatsApp Manager.
Les réponses WhatsApp de mon IA ne partent pas.
- Quickchat AI affiche “WhatsApp replies are failing” dans le panneau et une notification sur le tableau de bord. Solutions courantes : terminer l’approbation du nom affiché dans WhatsApp Manager ; cliquer sur Reconnect si la connexion a expiré ou été révoquée ; vérifier le statut dans WhatsApp Manager si Meta a restreint le numéro pour des raisons de qualité ou de politique. L’alerte disparaît dès qu’une réponse est envoyée correctement.
Les modèles ou messages initiés par l’entreprise échouent.
- Vérifiez que les Message Templates sont approuvés et que le moyen de paiement est actif dans WhatsApp Manager.
- Les nouveaux expéditeurs ont des limites de messagerie qui augmentent selon qualité et vérification. Consultez les consignes Meta sur Messaging Limits si vous atteignez les limites des messages initiés par votre entreprise.
- Vérifiez messaging limits et quality rating dans WhatsApp Manager si l’envoi est limité.
Comment créer mon propre lien WhatsApp et un bouton « Chat on WhatsApp » ?
- Suivez ce tutoriel WhatsApp.
Comment créer mon code QR WhatsApp ?
- Ouvrez WhatsApp Manager → Phone numbers, sélectionnez votre numéro professionnel, puis Message links → Create Message Link.
- Il est aussi disponible dans l’application mobile WhatsApp Business. Suivez ce tutoriel.
Besoin d’aide ?
Discutez avec la Support AI de Quickchat sur WhatsApp :
📱 +1 302-405-9992 : Démarrer la conversation
Ou scannez le code QR :
