Aller au contenu

Connectez votre Agent Quickchat AI à WhatsApp Business, y compris un numéro que vous utilisez déjà dans l’application WhatsApp Business. Ce guide couvre les prérequis, les étapes de configuration et la mise en production de la messagerie WhatsApp.

Ce guide explique comment intégrer votre Quickchat AI Agent à WhatsApp. Le processus se déroule en 2 étapes simples :

  • Étape 0 – Prérequis
  • Étape 1 – Connecter WhatsApp

En cas de problème, rendez-vous dans la section Dépannage & FAQ ou contactez-nous.

  • Vérifier les prérequis WhatsApp. Comparez les détails déclarés du numéro et du fournisseur aux prérequis documentés. Aucun compte WhatsApp n’est consulté ou connecté.

  • Vérifier une fenêtre de service WhatsApp. Vérifiez la fenêtre de 24 heures à partir des horodatages de réception et de réponse fournis avec décalage horaire. Les modèles, le consentement et les permissions ne sont pas vérifiés et aucun message n’est envoyé.

  • Estimer les coûts d’utilisation. Calculez les crédits des modèles Quickchat AI et un total séparé des frais fournis. Les tarifs fournisseurs ne sont pas consultés, les crédits ne sont pas additionnés à l’argent et votre compte n’est pas vérifié.

Les formulaires sont en anglais.

Play

Décidez quel numéro de téléphone vous utiliserez avec WhatsApp. Consultez la documentation WhatsApp ou les FAQ ci-dessous :

Quel numéro puis-je utiliser avec la WhatsApp Cloud API ?

  • Vous devez utiliser un numéro d’entreprise dédié capable de recevoir des SMS ou des appels vocaux pour la vérification.
  • Le numéro doit être valide, vous appartenir et comporter un indicatif pays + zone.

Puis-je utiliser un numéro déjà actif dans WhatsApp personnel (WhatsApp Messenger) ?

  • Non. Vous pouvez continuer à l’utiliser pour appeler ou envoyer des SMS, mais pas dans WhatsApp personnel.
  • Pour le connecter, supprimez le compte WhatsApp associé à ce numéro, patientez quelques minutes, puis connectez-le. La suppression du compte efface son historique de discussions : sauvegardez donc votre historique de discussions au préalable. Si vous souhaitez conserver vos discussions, connectez plutôt un autre numéro.
  • Les numéros bannis doivent être rétablis avant l’enregistrement.

Puis-je utiliser un numéro déjà utilisé dans l’application WhatsApp Business ?

  • Oui (bêta). Vous pouvez le connecter et continuer à utiliser l’application WhatsApp Business sur votre téléphone. Votre AI Agent répond aux clients sur le même numéro, et vos discussions restent dans l’application. Meta appelle cela Coexistence. Consultez Continuer à utiliser l’application WhatsApp Business (Coexistence).
  • Ne supprimez pas votre compte WhatsApp Business et ne migrez pas le numéro pour le connecter.

Puis-je utiliser un nouveau numéro ?

  • Oui. Si vous préférez conserver votre numéro actuel, achetez un nouveau numéro (SIM physique ou numéro virtuel). Des services comme Hushed en proposent.

Préparez les éléments suivants (ils seront demandés durant le flux d’intégration Meta) :

  • Nom de l’entreprise
  • Site web de l’entreprise
  • Catégorie de l’entreprise
  • Description de l’entreprise

Même si certains champs semblent facultatifs, renseignez-les précisément. Des informations manquantes ou incorrectes peuvent retarder l’approbation ou entraîner des restrictions.

Ouvrez la Quickchat AI App → Canaux → Applications externes → WhatsApp. Sous Quel numéro allez-vous connecter ?, choisissez l’option qui correspond à votre numéro :

  • Un nouveau numéro qui n’est pas sur WhatsApp : suivez les étapes ci-dessous.
  • Un numéro déjà utilisé dans l’application WhatsApp Business : suivez Continuer à utiliser l’application WhatsApp Business (Coexistence).
  • Un numéro déjà utilisé dans votre WhatsApp personnel : supprimez d’abord le compte WhatsApp associé à ce numéro (cela efface son historique de discussions), patientez quelques minutes, puis suivez les étapes ci-dessous. Vous pouvez aussi utiliser un autre numéro.

Cliquez ensuite sur le bouton Connecter WhatsApp et suivez la fenêtre Meta :

Vous pouvez également démarrer depuis ChatGPT, Claude ou une autre app AI connectée : demandez un lien pour connecter cet Agent à WhatsApp. Le lien est valable 10 minutes et ne fonctionne qu’une seule fois, uniquement pour le compte Quickchat depuis lequel il a été demandé. Ouvrez-le dans un navigateur connecté à ce compte, suivez la configuration de Meta, puis terminez toute sélection de compte ou de numéro lorsque Quickchat se rouvre. Demandez ensuite à votre app AI de vérifier la configuration et envoyez un véritable message WhatsApp pour confirmer que la réponse AI arrive. Testez chaque numéro actif si vous en connectez plusieurs. Vous approuvez l’accès sur Meta dans le navigateur, sans partager de tokens dans la conversation.

  1. Connectez-vous à votre compte Meta (Facebook).
  2. Vérifiez les permissions que vous partagerez avec Quickchat AI (accès au compte WhatsApp Business et accès au Business portfolio), puis continuez.
  3. Fournissez des informations exactes (Business Portfolio, Business Name, Business Website, pays, etc.).
  4. Créez ou sélectionnez votre compte WhatsApp Business.
  5. Choisissez un nom d’affichage et une catégorie WhatsApp Business.
  6. Ajoutez votre numéro professionnel et vérifiez-le par SMS/Appel.
  7. Cliquez sur Confirm pour accorder les accès requis à Quickchat AI.
  8. Quand Meta confirme que la configuration est terminée, cliquez sur Finish. La fenêtre affiche une confirmation Quickchat AI indiquant que votre compte WhatsApp est connecté, puis se ferme automatiquement.

Si le numéro est utilisé dans l’application WhatsApp Business, choisissez dans la fenêtre Meta de connecter votre application WhatsApp Business existante, puis confirmez dans l’application lorsque cela vous est demandé (bêta).

Si Meta accorde à Quickchat AI l’accès à plusieurs comptes, le panneau WhatsApp affiche Choisissez votre compte WhatsApp Business au lieu d’établir immédiatement la connexion. Sélectionnez le compte sur lequel votre AI Agent doit répondre, puis cliquez sur Utiliser ce compte. Si vous reconnectez WhatsApp, votre configuration WhatsApp actuelle reste inchangée jusqu’à votre confirmation.

De retour dans la Quickchat AI App, le panneau WhatsApp affiche Terminer la configuration jusqu’à ce qu’un échange réussi soit vérifié sur votre propre numéro professionnel. Si le panneau ne s’est pas actualisé après environ 30 secondes, cliquez sur l’icône d’actualisation.

La connexion à Meta et la réception d’un message ne constituent qu’une partie de la configuration. Le panneau indique l’étape suivante pour chaque numéro activé :

  • En attente de votre premier message : envoyez un message WhatsApp au numéro affiché depuis un autre téléphone, puis cliquez sur Actualiser. Veillez à écrire au numéro professionnel que vos clients utiliseront.
  • En attente de la livraison de la réponse AI : Quickchat a reçu votre message, mais WhatsApp n’a pas encore confirmé la livraison de la réponse AI. Vérifiez si la réponse est arrivée sur l’autre téléphone. Si ce n’est pas le cas, vérifiez vos crédits AI et les avertissements du panneau, puis envoyez un autre message de test.
  • Réponse AI livrée : WhatsApp a confirmé la livraison de la réponse AI à un message reçu sur ce numéro professionnel.
  • La vérification nécessite votre attention : résolvez les avertissements de connexion, gardez le numéro souhaité activé et envoyez un nouveau message de test.
  • Nom d’affichage : chaque numéro listé plus bas dans le panneau porte le statut de son nom d’affichage chez Meta (Approuvé, En cours d’examen, Refusé, Expiré ou Aucun nom d’affichage). Un examen en cours ne demande rien de votre part et se termine généralement en quelques jours. Si le nom d’affichage a été refusé, a expiré ou manque, soumettez-en un nouveau dans WhatsApp Manager.
  • Numéro de test Meta : les numéros +1 555 fournis par Meta et les numéros sandbox ne permettent pas de vérifier l’activation sur votre numéro professionnel. Ajoutez votre propre numéro dans WhatsApp Manager, activez-le dans Quickchat, puis testez ce numéro.

Le panneau affiche En ligne lorsqu’un échange a été vérifié sur chaque numéro professionnel activé et que les contrôles de connexion sont satisfaisants. Si vous activez plusieurs numéros professionnels, testez chacun d’eux. Un échange réussi sur un numéro de test, un modèle envoyé ou une notification concernant le quota de messages ne valide pas cette vérification.

Gardez l’intégration activée pendant le test. Envoyez un message depuis un autre téléphone à chaque numéro professionnel souhaité, confirmez que la réponse AI arrive, puis cliquez sur Actualiser. La conversation doit aussi apparaître dans la boîte de réception de la Quickchat AI App. Une connexion existante peut nécessiter un nouvel échange de test pour vérifier la livraison. Elle peut continuer à recevoir des messages et à y répondre pendant que vous terminez cette étape.

Si certaines étapes de configuration de Meta restent à terminer, complétez-les dans Setup guidance dans WhatsApp Manager. Quickchat AI envoie également un rappel par e-mail au propriétaire du compte lorsque des étapes de configuration de Meta restent inachevées.

Continuer à utiliser l’application WhatsApp Business (Coexistence)

Section intitulée « Continuer à utiliser l’application WhatsApp Business (Coexistence) »

Vous pouvez connecter un numéro déjà utilisé dans l’application WhatsApp Business et continuer à utiliser l’application sur votre téléphone. Meta appelle cela Coexistence. Dans Quickchat AI, cette fonctionnalité est en bêta. Vous continuez à utiliser l’application comme avant pendant que votre AI Agent répond aux clients sur le même numéro.

  • Mettez à jour l’application WhatsApp Business sur votre téléphone vers la version 2.24.17 ou ultérieure.
  • Si possible, lancez la configuration sur un ordinateur et gardez à portée de main le téléphone sur lequel se trouve l’application WhatsApp Business. Vous confirmez la connexion dans l’application.
  1. Dans la Quickchat AI App, ouvrez Canaux → Applications externes → WhatsApp.
  2. Sous Quel numéro allez-vous connecter ?, choisissez Un numéro déjà utilisé dans l’application WhatsApp Business. Le panneau affiche Continuez à utiliser l’application WhatsApp Business (bêta).
  3. Cliquez sur Connecter WhatsApp.
  4. Dans la fenêtre de Meta, cliquez sur Continue. Si Meta propose de connecter votre application WhatsApp Business existante, choisissez cette option. Sinon, choisissez Enter a new phone number et saisissez le numéro que vous utilisez dans l’application WhatsApp Business.
  5. Lorsque l’application WhatsApp Business sur votre téléphone vous le demande, appuyez sur Connect, puis sur Confirm.
  6. Meta peut vous demander si vous souhaitez partager votre historique de discussions. C’est facultatif. Quickchat AI n’importe pas les discussions passées : la boîte de réception commence au moment de la connexion, et vos discussions antérieures restent dans l’application.

Envoyez ensuite un message de test depuis un autre téléphone, comme décrit ci-dessus, jusqu’à ce que le panneau affiche En ligne.

  • Les messages des clients et les réponses de votre AI Agent apparaissent à la fois dans l’application WhatsApp Business et dans la boîte de réception Quickchat AI.
  • Lorsque vous répondez à un client depuis l’application, l’AI Agent cesse de répondre dans cette discussion.
  • Lorsque la discussion est restée inactive pendant 4 heures (aucun message de personne), le message suivant du client ouvre un nouveau cycle de conversation et l’AI Agent y répond à nouveau. Ces 4 heures sont fixes et ne peuvent pas être modifiées.
  • Vous pouvez rendre une discussion à l’AI Agent à tout moment en la lui assignant dans la boîte de réception.

Meta applique ces limites à un numéro connecté via Coexistence :

  • Les listes de diffusion sont désactivées dans l’application WhatsApp Business.
  • Les discussions de groupe ne sont pas synchronisées.
  • WhatsApp pour Windows n’est pas pris en charge.
  • Si vous n’ouvrez pas l’application WhatsApp Business sur votre téléphone pendant environ 14 jours, Meta déconnecte le numéro.

Si Meta vous demande de libérer le numéro ou de supprimer votre compte WhatsApp Business, ne le faites pas. Écrivez plutôt à support@quickchat.ai.

Comment fonctionne la tarification de la WhatsApp Business API ?

  • Les réponses aux demandes initiées par l’utilisateur (entrantes) sont considérées comme des messages de service. Elles permettent de gérer les demandes via un agent humain ou un bot conversationnel.
  • Lorsqu’un utilisateur contacte une entreprise, une fenêtre de service de 24 heures s’ouvre, durant laquelle vous pouvez répondre avec des messages de service sans frais. Cette fenêtre se réinitialise après chaque message utilisateur.
  • Au-delà de 24 heures, vous devez utiliser des Message Templates approuvés (Marketing, Utility, Authentication, etc.) et payer chaque message selon les tarifs de la plateforme WhatsApp Business.
  • Les conversations sont catégorisées et facturées par Meta. Vérifiez que votre compte WhatsApp Business dispose d’un moyen de paiement valide pour les messages initiés par l’entreprise ou basés sur des modèles.

Le bouton Connecter WhatsApp ne fonctionne pas. La fenêtre Meta ne s’ouvre pas.

  • Si votre navigateur bloque la fenêtre pop-up, autorisez les pop-ups pour la Quickchat AI App et cliquez sur Réessayer. Vous pouvez également cliquer sur Continuer sur Meta dans cet onglet pour effectuer la même configuration sans fenêtre pop-up.

Quickchat n’a pas pu confirmer la connexion WhatsApp

Quickchat affiche ce message de récupération lorsque la fenêtre Meta ne renvoie aucun résultat et que Quickchat ne peut toujours pas vérifier la connexion. Cela ne prouve pas que Meta n’a effectué aucune modification.

  1. Vérifiez que vous êtes administrateur du compte Meta Business propriétaire du compte WhatsApp Business. Sinon, demandez à un administrateur de le connecter depuis sa session Facebook.
  2. Cliquez sur Réessayer. Si un bloqueur perturbe la fenêtre Meta, utilisez une fenêtre privée avec les extensions désactivées ou cliquez sur Continuer sur Meta dans cet onglet.
  3. Si le numéro est actif dans WhatsApp personnel, supprimez le compte WhatsApp associé à ce numéro (cela efface son historique de discussions), patientez quelques minutes et réessayez, ou utilisez un autre numéro. S’il est actif dans l’application WhatsApp Business, vous n’avez rien à supprimer : reconnectez-vous, choisissez Un numéro déjà utilisé dans l’application WhatsApp Business, puis, dans la fenêtre de Meta, choisissez de connecter votre application WhatsApp Business existante. Consultez Continuer à utiliser l’application WhatsApp Business (Coexistence).
  4. Si le compte WhatsApp Business utilise Aircall, Twilio, 360dialog, MessageBird ou un autre fournisseur, ajoutez Quickchat AI en tant que partenaire dans les paramètres Meta Business :
    1. Ouvrez les paramètres Meta Business et accédez à Comptes → Comptes WhatsApp.
    2. Sélectionnez le compte WhatsApp Business, ouvrez Partenaires, puis cliquez sur Ajouter des partenaires.
    3. Saisissez la Business ID de Quickchat AI : 270696274483463.
    4. Accordez l’autorisation Gérer les comptes WhatsApp, revenez dans Quickchat AI et actualisez le statut.

Déconnectez l’autre fournisseur uniquement si Meta n’autorise pas les deux partenaires sur ce compte. En cas de doute, contactez le support avant de déconnecter un fournisseur de messagerie actif.

La vérification du numéro a échoué.

  • Assurez-vous que le numéro peut recevoir des SMS ou des appels vocaux.
  • Si le numéro est utilisé dans l’application WhatsApp Business, connectez-le via Coexistence et vérifiez que l’application est en version 2.24.17 ou ultérieure. Ne supprimez pas votre compte WhatsApp Business et ne migrez pas le numéro pour tenter de faire disparaître l’erreur.
  • Un message générique Ineligible ou une infobulle This number can’t be shared with this app ne permet pas de déterminer la cause du problème. Écrivez à support@quickchat.ai en précisant le message exact et l’étape à laquelle il est apparu.

J’ai connecté le mauvais compte.

  • Se reconnecter conserve le compte déjà connecté. Pour faire passer l’AI Agent sur un autre compte WhatsApp Business, cliquez sur Déconnecter dans le panneau WhatsApp, puis de nouveau sur Connecter WhatsApp, et choisissez le bon compte Meta Business et le bon compte WhatsApp dans la fenêtre Meta.

Impossible de déterminer quel compte WhatsApp Business connecter

  • Votre connexion Meta comporte plusieurs comptes WhatsApp Business avec des numéros de téléphone et Quickchat n’a pas pu déterminer lequel vous vouliez. Écrivez à support@quickchat.ai en indiquant le numéro à connecter et nous terminerons la configuration pour vous.

Les messages n’apparaissent pas dans la boîte de réception Quickchat AI.

  • Vérifiez que la fenêtre pop-up a bien affiché le message de confirmation final : “WhatsApp account connected!”.
  • Assurez-vous d’avoir relié le bon compte WhatsApp et sélectionné l’AI Agent approprié.
  • La carte En attente de votre premier message indique le numéro sur lequel votre AI Agent répond. Vérifiez que vous avez bien écrit à ce numéro précis et qu’il est activé dans le panneau, puis cliquez sur Actualiser.
  • Si vous envoyez des messages après 24 heures sans message utilisateur, utilisez des templates approuvés et assurez-vous que le WhatsApp Manager dispose d’un moyen de paiement actif.

Les réponses WhatsApp de mon AI n’arrivent pas à être envoyées.

Si les réponses de votre AI ne peuvent pas être délivrées, Quickchat AI affiche une alerte “Les réponses WhatsApp échouent” sur le panneau WhatsApp dans Applications externes ainsi qu’une notification sur votre tableau de bord. Les causes les plus fréquentes et leurs solutions :

  • Nom d’affichage non approuvé sur un numéro de test Meta : Meta retient les réponses d’un numéro +1 555 attribué par Meta tant que son nom d’affichage n’est pas approuvé. L’alerte du nom d’affichage dans le panneau devient rouge et indique le numéro. Attendez la fin de l’examen (généralement quelques jours) ou, s’il a été refusé, soumettez un nouveau nom d’affichage dans WhatsApp Manager, puis envoyez un message de test. Un nom d’affichage encore en cours d’examen sur votre propre numéro ne bloque pas les réponses à lui seul ; le panneau l’affiche comme une note.
  • Connexion expirée ou révoquée : votre connexion WhatsApp n’est plus valide. Ouvrez le panneau WhatsApp et cliquez sur Se reconnecter pour reprendre l’envoi des réponses.
  • Numéro restreint : Meta a restreint votre numéro WhatsApp (évaluation de la qualité ou politique). Vérifiez son statut dans WhatsApp Manager pour rétablir l’envoi.
  • Compte WhatsApp Business bloqué (erreur 131031) : Meta a bloqué les réponses du compte WhatsApp Business. L’erreur de livraison dans la boîte de réception et le panneau WhatsApp expliquent cette restriction. Ouvrez Business Support Home, sélectionnez le compte WhatsApp et l’infraction, puis demandez un examen : Meta ne lève un blocage de compte que par cet examen. Reconnecter Quickchat ne lève pas cette restriction.

Les autres alertes disparaissent automatiquement dès qu’une réponse est envoyée avec succès. Une alerte de blocage du compte reste affichée jusqu’à la livraison complète d’une réponse AI à un nouveau message réel d’un visiteur, car Meta peut accepter une réponse sans la livrer. Si seuls des numéros de test Meta (+1 555) sont actifs, la prochaine réponse AI envoyée avec succès la fait disparaître. Support AI peut également expliquer un échec récent enregistré dû à un blocage du compte, mais les éléments historiques ne prouvent pas que le compte est toujours bloqué.

Les templates ou les messages initiés par l’entreprise échouent.

  • Confirmez que vos Message Templates sont approuvés et qu’un moyen de paiement est actif dans le WhatsApp Manager.
  • Les nouveaux expéditeurs commencent avec des limites de messagerie qui augmentent selon la qualité et la vérification. Si vous atteignez une limite, consultez la documentation Meta sur les Messaging Limits.
  • Surveillez les limites et la note de qualité dans le WhatsApp Manager si les envois sont restreints.

Comment créer votre propre lien WhatsApp et bouton “Discuter sur WhatsApp” ?

<!-- Bouton WhatsApp en ligne -->
<!-- Modifiez WHATSAPP_PHONE_NUMBER et le chemin/nom du fichier si nécessaire -->
<a
aria-label="Discuter sur WhatsApp"
href="https://wa.me/WHATSAPP_PHONE_NUMBER"
target="_blank"
rel="noopener noreferrer"
>
<img
alt="Discuter sur WhatsApp"
src="WhatsAppButtonGreenLarge.svg"
style="
width: 200px;
height: auto;
cursor: pointer;
border-radius: 12px;
"
/>
</a>

ou

<!-- Bouton flottant WhatsApp -->
<!-- Modifiez WHATSAPP_PHONE_NUMBER et le chemin/nom du fichier si nécessaire -->
<a
aria-label="Discuter sur WhatsApp"
href="https://wa.me/WHATSAPP_PHONE_NUMBER"
target="_blank"
rel="noopener noreferrer"
style="position: fixed; right: 20px; bottom: 20px; z-index: 9999"
>
<img
alt="Discuter sur WhatsApp"
src="WhatsAppButtonGreenLarge.svg"
style="
width: 200px;
height: auto;
cursor: pointer;
border-radius: 12px;
box-shadow: rgba(0, 0, 0, 0.5) 0px 5px 15px 0px;
transition: all 0.3s ease;
"
onmouseover="this.style.transform = 'scale(1.05)'"
onmouseout="this.style.transform = 'scale(1)'"
/>
</a>

Comment créer votre propre code QR WhatsApp ?

  • Rendez-vous sur WhatsApp Manager → Numéros de téléphone → sélectionnez votre numéro d’entreprise → Liens de message → Créer un lien de message.
  • Vous pouvez aussi le générer dans l’application mobile WhatsApp Business. Consultez ce tutoriel WhatsApp.

Dois-je supprimer mon compte de l’application WhatsApp Business pour résoudre un problème de configuration ?

Quel accès Quickchat AI obtient-il à notre compte WhatsApp Business ?

  • Un accès limité à l’API, sans propriété du compte. Votre compte WhatsApp Business (WABA) se trouve dans votre propre Meta Business Manager. Dans le cadre du modèle WABA Sharing de Meta, vous possédez les ressources et Quickchat AI est ajouté en tant que partenaire que vous pouvez révoquer à tout moment depuis le Business Manager.
  • Nous pouvons envoyer et recevoir des messages via la Cloud API et recevoir des événements de message par webhook tant que l’intégration est active.
  • Nous ne pouvons pas fermer, transférer ou renommer votre compte, modifier la facturation ou supprimer vos administrateurs.

Discutez avec le support Quickchat AI sur WhatsApp :
📱 +1 302-405-9992 — Démarrer une conversation

Ou scannez le QR code :

QR code WhatsApp

Dernière mise à jour :