Le constructeur MaviBot prend également en charge l'API officielle WhatsApp Business.

Comment connecter WhatsApp Business

Pour connecter l'API WhatsApp Business (WABA) à votre projet, accédez à la section Messagers 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. Cliquez ensuite sur le bouton « 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, période pendant laquelle la communication est gratuite 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 intervalle de temps donné, 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 (contenant des informations spécifiques sur les transactions, factures, paiements, etc.) ;

2. Modèles de 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 WABA sont soumis à modération.

Les principales raisons du rejet d'un modèle

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 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 (par exemple, numéros de passeport, détails de carte bancaire, numéros d'identification personnels, adresses personnelles) échoueront à la modération.
  5. Contenu offensant : tout message contenant des informations susceptibles d'offenser les utilisateurs en fonction de la race, de la nationalité, du sexe, de l'identité ou d'autres critères sera rejeté.
  6. Rejet discrétionnaire : les modérateurs WhatsApp se réservent le droit de rejeter des modèles sans fournir de raison spécifique.

Comment installer les modèles de messages

Étant donné que 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 d'API WhatsApp Business.

  • Coût et premier message : L'envoi de modèles de messages est gratuit dans 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 que 24 heures se sont écoulées depuis l'ouverture du chat, vous ne pouvez envoyer qu'un autre modèle approuvé pour réengager l'utilisateur.
  • Note de 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. Accédez à la section Canaux, sélectionnez API WhatsApp Business, puis choisissez Modèles de messages.

  1. Cliquez sur le bouton « Créer un modèle ». Cela ouvre la page de création de modèle.
  2. Les modèles sont liés à des blocs dans 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.

  1. Le modèle de message sera soumis à modération lors de 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 modèle MARKETING dans les formats suivants : SVG, PNG, JPG et GIF.

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

Notre système est adapté aux variables MaviBot et ne prend pas en charge les variables au format {{1}}

Utilisation de variables dans les messages modèles WhatsApp

Si vous devez utiliser des variables dans les modèles de messages, suivez cette règle : écrivez toujours les noms de variables en lettres latines uniquement, par exemple, #{example}. Après l'envoi, vérifiez que les variables sont traitées correctement en consultant le message via le lien fourni.

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 celle-ci en suivant le lien :

Les boutons sont définis au format de tableau JSON.

Paramètres de création de bouton :

Paramètre Requis Description
type Oui Valeurs : PHONE_NUMBER, URL et QUICK_REPLY
text Oui Texte du bouton
url Non

L'URL qui sera ouverte

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

créer des liens dynamiques.
phone_number Non

Le numéro de téléphone auquel

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

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

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

qu'il s'agit d'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": "Pas pratique"}]

Fonctionnalités des boutons dans les modèles

Il existe deux types de boutons disponibles dans les messages modèles :

  1. Appel à l'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 de texte 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 d'appel à l'action. Cependant, vous ne pouvez pas utiliser deux liens ou deux numéros de téléphone simultanément.
  • Les boutons ne peuvent pas inclure de variables, de sauts de ligne, d'emojis ou de symboles de formatage.

Comportement :

  • Cliquer sur un bouton Réponse rapide envoie son texte comme message de réponse de l'utilisateur.
  • Un bouton Appel à l'action peut ouvrir un lien vers un fichier.
  • Cliquer sur un bouton Appel à l'action 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 effectués depuis la version de bureau.

Comment fonctionne la modération des modèles

Chaque modèle est soumis à modération immédiatement après sa création. Le processus prend généralement environ 8 heures, avec un temps de révision maximal de 48 heures.

Vous pouvez suivre le statut de modération dans votre liste de modèles.

Si un modèle est rejeté, la raison du rejet sera fournie.

Les modèles avec une forte probabilité d'approbation ont généralement :

  • Un langage clair et professionnel.
  • Un cas d'utilisation spécifique et légitime (par exemple, rappels de rendez-vous, mises à jour de commandes).

Important : Le texte en italique peut être variable et personnalisé.

Bonjour, nous n'avons pas pu vous joindre. Serait-il pratique pour vous de continuer à communiquer ici ?

Bonjour, vous avez laissé un message sur le site Web et m'avez demandé de vous contacter. (sujet à modification)

Bonjour, je suis John Smith de MaviBot. Plus tôt, vous avez demandé la création d'un chatbot. Nous sommes heureux 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 fonction days_from_last_message() dans votre condition de déclenchement.

Exemple de vérification de la fenêtre de 24 heures :

days_from_last_message() == 0

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 les frais mensuels).
  • Aucune restriction sur les messages entrants.

Pour lever ces restrictions, votre entreprise doit compléter le processus de vérification de l'entreprise, qui prend généralement 2 à 3 semaines.

Systèmes de paiement

Vérifiez auprès de votre revendeur le prix des messages entrants et sortants pour les comptes non vérifiés.

Le paiement est effectué directement à 360dialog.

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 catégorie « Authentification » à 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 la politique de confidentialité mises à jour.
  4. Le message n'a pas été livré pour maintenir une expérience utilisateur de haute qualité (il s'agit d'un blocage de politique générale).

Conversions publicitaires Click-to-WhatsApp

Un ajout à la documentation pour la fonction fb_pixel_event().

Meta* marque chaque clic sur une publicité Click-to-WhatsApp avec un identifiant de clic ctwa_clid. Il est reçu avec le premier message WhatsApp du client et est utilisé pour attribuer une conversion de la conversation à une publicité spécifique — de la même manière que les événements pixel sont attribués à un clic sur un site Web.

Signature

fb_pixel_event(
    event_name,
    pixel_id,
    access_token,
    event_source_url,
    action_source,
    fbc,
    test_event_code,
    data,
    ctwa_clid,
    messaging_channel
)

Nouveaux paramètres

Paramètre Description
ctwa_clid Identifiant de clic pour une publicité Click-to-WhatsApp. Si ce paramètre n'est pas fourni, la variable client ctwa_clid, enregistrée automatiquement par le bot, est utilisée. Facultatif.
messaging_channel Le canal de messagerie où la conversion a eu lieu. Par défaut, whatsapp. Facultatif.

Nouvelle valeur pour action_source

La ligne suivante est ajoutée au tableau des valeurs de action_source :

Valeur Description
business_messaging La conversion a eu lieu dans une conversation après que le client a cliqué sur une publicité Click-to-WhatsApp.

Un événement est envoyé comme conversion de messagerie si au moins une des conditions suivantes est remplie :

  • action_source="business_messaging" est fourni ;
  • ctwa_clid est fourni ;
  • messaging_channel est fourni.

Dans ce cas, Meta* reçoit la combinaison action_source + messaging_channel + ctwa_clid. Sans cette combinaison, le clic sur la publicité ne sera pas attribué à la conversion.

La valeur website ne doit pas être utilisée pour les conversions de messagerie : l'événement atteindra le pixel, mais il ne sera pas attribué à la publicité.

Variables client

Lorsqu'un client envoie un message WhatsApp après avoir cliqué sur une publicité, le bot enregistre les données de clic dans les variables client du client. Vous n'avez pas besoin de remplir ces variables manuellement.

Variable Description
ctwa_clid Identifiant de clic. Ajouté automatiquement à l'événement.
ctwa_clid_time Heure à laquelle l'identifiant a été reçu, au format Unix. Il peut être utilisé pour déterminer le temps écoulé depuis le clic.
wa_ads_data Données publicitaires au format JSON : URL de la publicité, ID de la publicité (source_id), titre, description, type de création et URL de la création.

L'identifiant de clic est automatiquement extrait de la variable client, vous n'avez donc pas besoin de le passer explicitement à la fonction.

Le numéro de téléphone du client est automatiquement ajouté à l'événement s'il n'est pas fourni dans data.

Le paramètre event_source_url n'est pas utilisé pour les conversions de messagerie.

Limitations

L'identifiant de clic est reçu uniquement avec le premier message du client après qu'il a cliqué sur le bouton dans la publicité. Il n'est pas inclus dans les messages suivants. Par conséquent, l'événement peut être envoyé à tout moment de la conversation, mais uniquement si le premier message provient de la publicité.

Meta* fournit ctwa_clid pour les clics depuis les applications Facebook* et Instagram* sur Android et iOS.

L'identifiant n'est pas fourni lorsque le client clique depuis un navigateur ou clique sur une publication ordinaire au lieu du bouton de la publicité. Les conversions provenant de telles interactions ne peuvent pas être attribuées à la publicité.

Si le client clique sur une autre publicité plus tard, les variables sont écrasées. La conversion est attribuée à la publicité la plus récente d'où provient le client.

Si l'identifiant de clic est absent à la fois des paramètres de la fonction et des variables client, la fonction renvoie l'erreur No ctwa_clid variable in client variables et l'événement n'est pas envoyé.