# API WhatsApp Business Le builder MaviBot prend également en charge l'API officielle WhatsApp Business. ## Comment connecter WhatsApp Business Pour connecter l'API WhatsApp Business (WABA) à votre projet, allez à la **Messageries** et sélectionnez **API WhatsApp Business**.
**Connexion de l'API WhatsApp Business**
Dans la fenêtre qui s'ouvre, connectez-vous avec votre compte Facebook. Ensuite, cliquez sur le bouton « Se connecter via Facebook ». Si nécessaire, saisissez votre mot de passe Facebook pour continuer.
La configuration est maintenant terminée. Vous n'avez pas besoin de garder votre téléphone en ligne en permanence ; le bot fonctionnera de manière stable et autonome. ## Modèles de messages pour l'API WhatsApp Business Lors de l'utilisation de l'API WhatsApp Business, les utilisateurs ne peuvent pas écrire aux clients à tout moment de la journée et envoyer des messages illimités lors de la création d'un bot, comme avec le WhatsApp gris, en dehors de la fenêtre de service client de 24 heures. En dehors de la fenêtre de 24 heures, seuls les modèles de messages WhatsApp (ou messages modèles WhatsApp) peuvent être utilisés, pendant laquelle la communication se déroule gratuitement dans la catégorie sélectionnée. Cette fonctionnalité est utilisée dans WhatsApp pour empêcher les envois de spam en limitant le nombre de messages autorisés dans un certain intervalle de temps, ainsi qu'en attribuant une catégorie aux modèles. Les catégories de messages suivantes sont installées pour l'API WhatsApp Business par Meta : 1\. Modèles utiles (contiennent des informations spécifiques sur les transactions, factures, paiements, etc.) ; 2\. Modèles pour le marketing (informations sur l'entreprise, l'organisation, les stratégies, la publicité et la promotion) ; 3\. Modèles de vérification et d'authentification.
Les modèles créés pour la WABA sont soumis à modération. ### Les principales raisons du rejet des modèles Un nombre important de modèles échouent à la modération WhatsApp pour plusieurs raisons : 1. **Publicité excessive :** WhatsApp Business rejette les modèles surchargés de publicités et de contenu promotionnel. Si les modérateurs ou l'IA de la plateforme déterminent que la publicité éclipse le message principal, le modèle sera bloqué. 2. **Violation de la politique produit :** les modèles faisant la promotion d'articles interdits tels que les stupéfiants, les substances psychotropes, l'alcool, le tabac, les services intimes ou tout contenu jugé dégradant pour la dignité humaine seront rejetés. 3. **Ambiguïté, omission ou fausseté :** si les modérateurs de WhatsApp détectent un sous-texte caché, des informations trompeuses ou un manque de détails clairs sur votre entreprise ou service, le modèle ne sera pas approuvé. 4. **Collecte d'informations confidentielles :** les modèles conçus pour recueillir des données sensibles des utilisateurs (p. ex. numéros de passeport, détails de carte bancaire, numéros d'identité personnelle, adresses de domicile) échoueront à la modération. 5. **Contenu offensant :** tout message contenant des informations susceptibles d'offenser des utilisateurs en fonction de la race, de la nationalité, du genre, de l'identité ou d'autres critères sera rejeté. 6. **Rejet discrétionnaire :** les modérateurs de WhatsApp se réservent le droit de rejeter des modèles sans fournir de raison spécifique. Comment installer les modèles de messages Comme les modèles sont créés à partir de blocs, vous devez d'abord créer un bloc dans votre flux avant de l'utiliser pour un modèle de l'API WhatsApp Business. * **Coût et premier message :** L'envoi de messages modèles est gratuit pendant la fenêtre de conversation de 24 heures. Le **premier message** à un client ne peut être qu'un modèle approuvé par Meta (Facebook). * **Après 24 heures :** Une fois 24 heures écoulées depuis l'ouverture de la discussion, vous ne pouvez envoyer qu'un autre modèle approuvé pour réengager l'utilisateur. * **Remarque sur la modération :** Les modèles peuvent échouer à la modération s'ils contiennent des variables (en écriture cyrillique ou latine). ## **Création de modèles dans MaviBot** 1. Allez dans l’onglet **Canaux** section, sélectionnez **API WhatsApp Business**, puis choisissez **Modèles de messages**.
2. Cliquez sur le bouton **« Créer un modèle »** bouton. Cela ouvre la page de création du modèle. 3. Les modèles sont liés aux blocs de votre flux. Par défaut, le contenu du modèle est extrait du bloc, mais vous pouvez spécifier un texte et des boutons personnalisés.
4. Le modèle de message sera soumis à la modération dès sa création. **Vous ne pouvez utiliser que des modèles approuvés.** La modération prend généralement environ 8 heures, avec un maximum de 48 heures. ## Types de modèles Il existe 3 types de modèles parmi lesquels choisir. Vous pouvez joindre une image au **MARKETING** modèle dans les formats suivants : SVG, PNG, JPG et GIF. #### Comment transmettre des variables dans les modèles Les variables dans les modèles sont gérées de la même manière que dans tout MaviBot, et non selon le format natif de WhatsApp. {% hint style="danger" %} Notre système est adapté aux variables MaviBot et **ne prend pas en charge** les variables dans le `{{1}}` mettre en forme {% endhint %} #### Utilisation de variables dans les messages modèles WhatsApp Si vous devez utiliser des variables dans des modèles de messages, suivez cette règle : **écrivez toujours les noms de variables uniquement en lettres latines**, par exemple, `#{example}`. Après l'envoi, vérifiez que les variables sont traitées correctement en consultant le message via le [lien](https://business.facebook.com/wa/manage/message-templates/). Si un modèle contient une variable, mais que le bot ne lui attribue pas de valeur ou que la valeur est manquante, le message **ne sera pas envoyé**! ## Comment fonctionnent les boutons dans les modèles Les modèles de messages prennent en charge les boutons. Dans MaviBot, les boutons sont définis de manière similaire à la syntaxe de l'API Facebook. Vous pouvez vous familiariser avec elle en suivant le [lien](https://developers.facebook.com/docs/whatsapp/business-management-api/message-): Les boutons sont définis au format de tableau JSON. **Paramètres de création des boutons :** | Paramètre | Obligatoire | Description | | ------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | type | Oui | Valeurs : PHONE\_NUMBER, URL et QUICK\_REPLY | | text | Oui | Texte du bouton | | url | Aucun |

L'URL qui sera ouverte

lorsque le bouton est cliqué. Vous pouvez utiliser des variables pour

créer des liens dynamiques.

| | phone\_number | Aucun |

Le numéro de téléphone vers lequel

l'appel sera effectué lorsque le bouton est pressé

| | exemple | Aucun |

Fournit un exemple de données possibles pour votre modèle. Cela aide au processus de vérification et d'approbation afin que vous puissiez

comprendre quel message vous prévoyez d'envoyer. Assurez-vous

que ce ne sont que des exemples et qu'ils ne contiennent aucune information confidentielle ou personnelle.

| Par exemple : Message avec deux boutons : \[{"type":"QUICK\_REPLY", "text": "Oui, pratique"}, {"type":"QUICK\_REPLY", "text": "Peu pratique"}] ### Fonctionnalités des boutons dans les modèles Il existe deux types de boutons disponibles dans les messages modèles : 1. **Call-To-Action (CTA) :** Un bouton pour un lien ou un numéro de téléphone (affiché avec une icône de lien ou de combiné à côté de son texte). 2. **Réponse rapide :** Boutons textuels standard avec une limite de 20 caractères. **Limitations :** * Un seul modèle peut contenir jusqu'à **3 boutons de réponse rapide** et jusqu'à **2 boutons Call-to-Action**. Cependant, vous ne pouvez pas utiliser simultanément deux liens ou deux numéros de téléphone. * Les boutons ne peuvent pas inclure de variables, de sauts de ligne, d'emojis ou de symboles de mise en forme. **Comportement :** * Cliquer sur un **bouton de réponse rapide** envoie son texte comme message de réponse de l'utilisateur. * Un **bouton Call-to-Action** peut ouvrir un lien vers un fichier. * Cliquer sur un **bouton Call-to-Action** bouton pour un appel téléphonique ouvre le composeur standard. Sur WhatsApp Web, une notification apparaîtra indiquant que les appels ne peuvent pas être passés depuis la version de bureau. ### Comment fonctionne la modération des modèles Chaque modèle est soumis à la modération immédiatement après sa création. Le processus prend généralement **environ 8 heures**, avec un délai maximal d'examen de **48 heures**. Vous pouvez suivre l'état de la modération dans votre liste de modèles. Si un modèle est rejeté, le motif du rejet sera fourni. **Les modèles ayant une forte probabilité d'approbation :** * Utilisent un langage clair et professionnel. * Répondent à un cas d'utilisation spécifique et légitime (p. ex. rappels de rendez-vous, mises à jour de commande). **Important :** Le texte dans *italique* peut être variable et personnalisé. Bonjour, nous n'avons pas réussi à vous joindre. Serait-il pratique pour vous de continuer à communiquer ici ? Bonjour, vous avez laissé un message sur le site et m'avez demandé de vous contacter.(sous réserve de modification) Bonjour, je suis John Smith de MaviBot. Plus tôt, vous avez demandé la création d'un chatbot. Nous avons le plaisir de vous informer que nous avons des nouvelles pour vous. Modèles qui ne passeront pas la modération : tout texte publicitaire #### **Comment vérifier si vous êtes dans la fenêtre de 24 heures** Vous pouvez déterminer combien de jours se sont écoulés depuis le dernier message du client en utilisant la `days_from_last_message()` fonction dans votre condition de déclenchement. **Exemple de vérification de la fenêtre de 24 heures :** `days_from_last_message() == 0` ### Comment utiliser les boutons sans modèles Il existe deux types de boutons disponibles en dehors des modèles, configurés de la même manière que dans les autres messageries : 1. [**Boutons de réponse :**](/doc/fr/chatbot/builder/boutons.md) Un maximum de **3** peuvent être utilisés dans un bloc. 2. [**Boutons intégrés**](/doc/fr/chatbot/builder/boutons.md)**:** Vous pouvez en créer jusqu'à **10**, et ils apparaissent comme indiqué dans l'exemple. **Limitations importantes pour les boutons non modèles :** * Les boutons ne peuvent contenir que **text**. **Les liens ne sont pas pris en charge.** * Leur seule fonction est de **déplacer le client d'un bloc à un autre** dans votre flux. *** **Restrictions pour les comptes non vérifiés** Les comptes Facebook Business non vérifiés sont soumis aux limites suivantes : * **50 messages modèles par jour** (inclus dans l'abonnement mensuel). * **Aucune restriction** sur les messages entrants. Pour lever ces restrictions, votre entreprise doit effectuer le **Vérification de l'entreprise** processus, qui prend généralement **2 à 3 semaines**. ## Systèmes de paiement Vérifiez auprès de votre revendeur le tarif des messages entrants et sortants pour les comptes non vérifiés. {% hint style="info" %} Le paiement est effectué directement à **360dialog**. {% endhint %} ## Erreurs d'envoi de messages **Raisons possibles de l'échec de la livraison :** 1. Le numéro de téléphone du destinataire n'est pas enregistré sur WhatsApp. 2. Tentative d'envoi d'un modèle de la **« Authentification »** catégorie à un utilisateur WhatsApp avec l'indicatif pays **+91 (Inde)**. Actuellement, les modèles de la catégorie Authentification ne peuvent pas être livrés aux utilisateurs en Inde. 3. Le destinataire n'a pas accepté les **Conditions d'utilisation** et **Politique de confidentialité**. 4. Le message n'a pas été livré afin de maintenir une expérience utilisateur de haute qualité (il s'agit d'un blocage général de politique). --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mavibot.ai/doc/fr/chatbot/messageries/waba.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.