Integration WhatsApp

Dans cet article, vous apprendrez comment intégrer et configurer WhatsApp Business pour envoyer des notifications de livraison automatisées à vos destinataires.

WhatsApp peut être utilisé comme alternative aux SMS pour les notifications de livraison, offrant une expérience de messagerie plus riche. Cette intégration vous permet d'envoyer des mises à jour de livraison, des ETA et des informations de suivi via WhatsApp, avec un basculement automatique vers les SMS si nécessaire.

Aperçu

Fonctionnalités prises en charge et limitations
Configuration du compte WhatsApp Business
Connexion de votre compte WhatsApp Business
Création de modèles de messages
Configuration des notifications dans Urbantz
Configuration du basculement SMS
Surveillance des notifications
Bonnes pratiques
FAQ

1. Fonctionnalités prises en charge et limitations

Fonctionnalités prises en charge

Connexion sécurisée au compte WhatsApp Business : Connectez votre compte WhatsApp Business à Urbantz de manière sécurisée, permettant à Urbantz d'envoyer des messages au nom de votre entreprise en utilisant votre numéro de téléphone
Notifications aux destinataires : Envoyez des mises à jour de livraison, des ETA et des informations de suivi via WhatsApp
Support multilingue : Créez des modèles dans plusieurs langues pour atteindre les destinataires dans leur langue préférée
Basculement SMS : Basculement automatique vers SMS si la livraison WhatsApp échoue

Limitations actuelles

❗ Notifications aux destinataires uniquement: L'intégration WhatsApp est actuellement limitée aux notifications aux destinataires. Les notifications aux administrateurs de plateforme (telles que les alertes aux opérateurs de trafic ou au personnel interne) ne peuvent pas être envoyées via WhatsApp et doivent continuer à utiliser d'autres canaux comme les SMS ou les e-mails.

❗ Pas de communication bidirectionnelle: Les destinataires peuvent répondre aux messages WhatsApp, mais ces réponses ne seront pas actuellement affichées ou gérées dans Urbantz. Étant donné qu'Urbantz contrôle le numéro WhatsApp via l'API, vous ne pouvez pas non plus accéder aux réponses via l'application WhatsApp.

2.Configuration du compte WhatsApp Business

Création de votre compte

Pour utiliser WhatsApp avec Urbantz, vous devez d'abord créer un compte WhatsApp Business. Veuillez suivre la documentation officielle de Meta :

WhatsApp Business
Messages utilitaires WhatsApp
Plateforme et API WhatsApp Business
Gestionnaire WhatsApp Business (une fois votre compte créé)

Exigences et limitations importantes

Avant de connecter WhatsApp à Urbantz, soyez conscient de ces contraintes importantes:

Modèles de messages et fenêtres de conversation

Messages initiaux: Pour notifier un destinataire, vous devez utiliser un modèle qui a été approuvé par Meta
Fenêtre de 24 heures: Si un destinataire répond à votre message, vous disposez d'une fenêtre de 24 heures pour envoyer des messages libres ou des demandes de géolocalisation
Renouvellement de la fenêtre: Chaque fois que le destinataire envoie un message, la fenêtre de 24 heures se réinitialise
Après 24 heures: Vous devez à nouveau utiliser des modèles approuvés pour réinitier la conversation

Limitations du numéro de téléphone

❗ Accès exclusif à l'API: Une fois connecté à l'API WhatsApp Business, le numéro de téléphone peut UNIQUEMENT être utilisé pour la messagerie automatisée via l'API. Vous ne pouvez pas utiliser ce numéro avec les applications mobiles ou WhatsApp Web.

❗ Verrouillage de plateforme: Chaque numéro de téléphone ne peut être connecté qu'à UNE seule plateforme de messagerie (Urbantz dans ce cas).

Autres utilisations autorisées: Le numéro peut toujours recevoir des SMS et des appels vocaux réguliers.

Tarification

Les règles de tarification sont expliquées en détail ici : Documentation sur la tarification WhatsApp

Remarque: Lorsqu'Urbantz envoie un message, nous recevons immédiatement le modèle de tarification qui lui est associé, permettant une estimation en temps réel du prix de la messagerie WhatsApp sur votre plateforme.

3.Connexion de votre compte WhatsApp Business

Une fois WhatsApp activé pour votre plateforme, vous pouvez connecter votre compte WhatsApp Business :

Depuis votre plateforme, allez dans Administration > Plateforme > Intégrations
Sélectionnez l'intégration WhatsApp
Cliquez sur le bouton "Se connecter à Facebook"
Suivez le flux OAuth pour autoriser Urbantz à accéder à votre compte WhatsApp Business
Sélectionnez le compte WhatsApp Business et le numéro de téléphone à utiliser
Terminez le processus de connexion

Vérifiez votre connexion

Une fois connecté avec succès, les informations de votre compte WhatsApp Business seront affichées, ainsi que le numéro de téléphone connecté. Il s'agit d'une configuration unique - votre plateforme restera connectée à ce compte WhatsApp Business. Vous pouvez vous déconnecter et vous reconnecter à un compte différent si nécessaire.

Test de votre intégration

Pour tester votre intégration WhatsApp, vous pouvez envoyer des messages de test à n'importe quel numéro de téléphone:

Exigence: Vous devez avoir un modèle nommé urbantz_test créé dans votre compte WhatsApp Business
Bouton de test: Utilisez le bouton de test dans la page d'intégration pour envoyer des messages de test
Vérification: Vérifiez si le message est envoyé et reçu correctement sur le téléphone cible

ℹ Vous remarquerez que sur la page d'intégration (Administration > Plateforme > Intégration > WhatsApp), vous avez la possibilité de tester les notifications WhatsApp. Cliquez sur "Envoyer un message de test" et entrez votre numéro de téléphone, puis cliquez sur "Envoyer".

4.Création de modèles de messages

Création de modèles dans Meta Business Suite

Tous les messages WhatsApp envoyés par Urbantz doivent utiliser des modèles pré-approuvés créés dans votre compte WhatsApp Business.

Pour des instructions détaillées sur la création de modèles de messages, consultez :

Points clés pour la création de modèles

Accédez à Meta Business Suite > Gestionnaire WhatsApp > Modèles de messages
Créez des modèles avec des noms significatifs (par exemple, notification_livraison)
Sélectionnez la catégorie "Utilitaire" pour les messages transactionnels (moins cher que le marketing)
Utilisez des variables ({{1}}, {{2}}, etc.) pour le contenu dynamique
Soumettez pour approbation (processus de révision jusqu'à 48 heures)

Exigences pour les modèles multilingues

Factor critique pour l'intégration Urbantz: Lors de la création de modèles dans plusieurs langues:

❗ Même nom de modèle: Toutes les versions linguistiques doivent avoir exactement le même nom

✅ Paramètre de langue différent: Définissez le champ de langue pour chaque version

✅ Contenu différent: Personnalisez le texte pour chaque langue

Exemple :

Nom du modèle : notification_livraison (Langue : Anglais)
Nom du modèle : notification_livraison (Langue : Français)
Nom du modèle : notification_livraison (Langue : Espagnol)

Pourquoi c'est important : Urbantz utilise le nom du modèle pour trouver toutes les versions linguistiques et envoie automatiquement le message dans la langue préférée du destinataire. Si les noms des modèles diffèrent, la fonctionnalité multilingue ne fonctionnera pas.

5.Configuration des notifications dans Urbantz

Une fois vos modèles approuvés, vous pouvez configurer des notifications automatiques :

Étape 1: Créer une nouvelle configuration

Depuis votre plateforme, allez dans Administration > Messagerie > Configurations
Créez une nouvelle configuration:

Nom: par exemple, "Notifications de livraison WhatsApp"
Déclencheur: Sélectionnez le type d'événement déclencheur (par exemple, "Informer le consommateur lorsque le livreur a démarré sa tournée")
Règles: Configurez des règles et conditions d'envoi supplémentaires
Mode de livraison: WhatsApp

Étape 2: Configurer le contenu

Sélectionnez l'onglet Contenu
Choisissez le modèle approuvé (vous devez avoir configuré ce modèle dans votre compte WhatsApp Business pour qu'il apparaisse dans le menu déroulant)
Sélectionnez une langue par défaut
Mappez les variables du modèle aux champs Urbantz (par exemple, mappez {{1}} au nom du destinataire, {{2}} à la date de livraison, etc.)
Cliquez sur Save

Vous pouvez personnaliser le contenu de vos notifications dans différentes langues et ajouter des informations automatiques appelées "variables" (jour de livraison, créneau horaire, nom du client, lien vers la page de suivi, etc.).

Pour toutes les notifications, vous devez spécifier le flux, l'expéditeur (client), ainsi que le type de tâche (livraison/collecte/service). Cela définira qui reçoit une notification.

ℹ Pour plus d'informations sur les déclencheurs de notification et la configuration, veuillez consulter l'article : Notifications SMS et e-mail - configuration, types et déclencheurs

6.Configuration du basculement SMS (Facultatif)

Les messages WhatsApp peuvent échouer si le destinataire n'a pas WhatsApp installé. Vous pouvez configurer un basculement automatique vers SMS ou e-mail.

Création d'une notification de basculement

Créer une notification de basculement:

Cliquez sur le signe "+" pour ajouter une autre notification
Créez une nouvelle notification avec le MÊME type de déclencheur que votre notification WhatsApp
Sélectionnez SMS ou e-mail comme mode de livraison

Adaptez votre contenu:

Créez du contenu adapté aux contraintes de format SMS et e-mail

Configurer l'ordre des notifications (CRITIQUE) :

L'ordre de la liste de notifications sur le côté gauche détermine la priorité
La notification WhatsApp DOIT être AU-DESSUS de la notification SMS
Urbantz essaie les notifications dans l'ordre : d'abord WhatsApp, puis SMS si WhatsApp échoue
Utilisez le glisser-déposer pour réorganiser les notifications si nécessaire
Toujours cliquer sur Save après la réorganisation

Fonctionnement du basculement

Lorsqu'une notification au destinataire est déclenchée:

Urbantz tente d'abord d'envoyer via WhatsApp
Si WhatsApp échoue parce que le destinataire n'a pas WhatsApp installé, le basculement est déclenché

Limitation actuelle: Le basculement ne s'active actuellement que pour les erreurs "le destinataire n'a pas WhatsApp"
Amélioration future: Des types d'erreur supplémentaires pourront déclencher le basculement dans les futures mises à jour

Urbantz essaie automatiquement la notification suivante dans la liste (SMS/E-mail)
Le destinataire reçoit le message via le premier canal réussi

7.Surveillance des notifications

Vous pouvez surveiller les notifications WhatsApp de la même manière que les autres types de notifications.

Surveillance au niveau de la plateforme

Depuis votre plateforme, allez dans : Administration > Moniteur système, et sélectionnez l'onglet Notifications

Surveillance au niveau de la tâche

Depuis votre plateforme, ouvrez l'élément Tâches dans le menu
Sélectionnez n'importe quelle tâche et ouvrez l'onglet Notifications
À partir de là, vous pouvez vérifier l'historique des tentatives de notification liées à la tâche (réussies ou échouées) et obtenir plus d'informations sur le processus de livraison des notifications pour chaque tentative

À partir des différents outils de surveillance, vous pouvez vérifier si un échec de livraison WhatsApp est suivi d'une tentative SMS.

8.Bonnes pratiques

Catégories de modèles et tarification

Lors de la création de modèles WhatsApp dans votre compte WhatsApp Business, vous devez sélectionner une catégorie : Marketing, Utilitaire ou Authentification.

Directives de sélection de catégorie

Pour les notifications de livraison, sélectionnez toujours "Utilitaire" car :

Les modèles utilitaires sont nettement moins chers que les modèles marketing
Les mises à jour de livraison sont transactionnelles, pas promotionnelles
Les notifications de livraison entrent dans le cadre des messages utilitaires

Révision des catégories par Meta

⚠ Meta examine et peut reclasser vos modèles :

Même si vous sélectionnez "Utilitaire", Meta peut le reclasser en "Marketing"
Cela se produit si votre modèle semble promotionnel plutôt qu'informatif

Prévention du spam

❗ L'envoi répété du même modèle marketing déclenchera la détection de spam de Meta

❗ Les messages peuvent être bloqués après très peu d'envois marketing répétés

✅ Les modèles utilitaires ont des limites plus souples pour une utilisation transactionnelle

9.FAQ

Q : Puis-je utiliser WhatsApp pour les notifications internes aux opérateurs de trafic ?

R : Non, l'intégration WhatsApp est actuellement limitée aux notifications aux destinataires uniquement. Les notifications internes doivent continuer à utiliser les SMS ou les e-mails.

Q : Puis-je voir les réponses des destinataires aux messages WhatsApp ?

R : Non, la communication bidirectionnelle n'est pas prise en charge dans la première version. Les réponses ne sont pas affichées dans Urbantz, et vous ne pouvez pas y accéder via l'application WhatsApp non plus, car le numéro est contrôlé via l'API.

Q : Que se passe-t-il si mon message WhatsApp échoue ?

R : Si vous avez configuré le basculement SMS et que l'échec est dû au fait que le destinataire n'a pas WhatsApp, Urbantz enverra automatiquement un SMS à la place.

Q : Comment savoir quelle version linguistique de mon modèle sera envoyée ?

R : Urbantz sélectionne automatiquement la langue du modèle en fonction de la langue préférée du destinataire. Assurez-vous que toutes les versions linguistiques ont le même nom de modèle pour que cela fonctionne correctement.

Q : Puis-je utiliser le même numéro de téléphone pour l'API WhatsApp et l'application mobile WhatsApp?

R : Non, une fois qu'un numéro de téléphone est connecté à l'API WhatsApp Business, il ne peut être utilisé que pour la messagerie API. Vous ne pouvez pas l'utiliser avec les applications mobiles ou WhatsApp Web.