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.

Regarder la vidéo

Play

Étape 0 – Prérequis

A. Numéro de téléphone professionnel

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 Messenger ?

• Non. Vous pouvez continuer à l’utiliser pour appeler ou envoyer des SMS, mais pas dans WhatsApp Messenger.
• Si le numéro est déjà utilisé dans WhatsApp Messenger, supprimez-le d’abord. Pensez à sauvegarder votre historique de discussions.
• Les numéros bannis doivent être rétablis avant l’enregistrement.

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

• Le processus de connexion actuel de Quickchat AI ne propose pas de parcours Coexistence vérifié pour un numéro déjà utilisé dans l’application WhatsApp Business. Meta explique le fonctionnement de la coexistence dans les intégrations compatibles dans son guide d’intégration de l’application Business.
• Si vous devez conserver votre numéro actuel, votre compte dans l’application Business et votre historique de discussions, écrivez à support@quickchat.ai avant de poursuivre. Ne supprimez pas et ne déconnectez pas le compte de l’application Business, et ne migrez pas le numéro pour résoudre un problème.

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.

B. Informations sur l’entreprise

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

Attention

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.

Étape 1 – Connecter WhatsApp

Ouvrez la Quickchat AI App → External Apps → WhatsApp → cliquez sur le bouton Connecter WhatsApp et suivez la fenêtre Meta :

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 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.

Astuce

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.

Troubleshooting & FAQs

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 Messenger, supprimez-le d’abord ou utilisez un autre numéro. S’il est actif dans l’application WhatsApp Business, arrêtez-vous ici et écrivez à support@quickchat.ai avant de poursuivre. Le processus de connexion actuel de Quickchat AI ne propose pas de parcours Coexistence vérifié. Ne supprimez pas et ne déconnectez pas le compte de l’application Business, et ne migrez pas le numéro pour tenter de résoudre ce problème.
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.
• 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 ni si les conditions de coexistence de Meta sont remplies. Écrivez à support@quickchat.ai en précisant le message exact et l’étape à laquelle il est apparu.
• Si le numéro est utilisé dans l’application WhatsApp Business et que vous devez conserver ce compte et son historique, contactez le support avant de poursuivre. Ne supprimez pas et ne déconnectez pas le compte, et ne migrez pas le numéro pour tenter de faire disparaître l’erreur.

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 External Apps 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.

L’alerte disparaît automatiquement dès qu’une réponse est envoyée avec succès.

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” ?

• Suivez ce tutoriel WhatsApp.
• Ou téléchargez les boutons officiels WhatsApp et utilisez l’un de ces scripts HTML :

<!-- 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 déconnecter mon compte de l’application WhatsApp Business pour résoudre un problème de configuration ?

• Non. Ne supprimez pas et ne déconnectez pas votre compte de l’application Business, et ne migrez pas son numéro pour résoudre un problème. Le processus de connexion actuel de Quickchat AI ne propose pas de parcours Coexistence vérifié qui préserve votre configuration actuelle de l’application et votre historique.
• Écrivez à support@quickchat.ai avant de modifier un compte de l’application Business en service. Le guide d’intégration de l’application Business de Meta décrit la coexistence dans les intégrations compatibles, mais ne confirme pas sa disponibilité pour votre configuration Quickchat AI.

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.

Besoin d’aide ?

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

Ou scannez le QR code :