Ce guide explique comment configurer la fonctionnalité Demande de géolocalisation WhatsApp dans Urbantz. Cette fonctionnalité permet au système de demander automatiquement la localisation précise d'un destinataire via WhatsApp lorsque l'adresse de livraison de la tâche ne peut pas être géocodée avec une précision suffisante.
Quand cette fonctionnalité se déclenche-t-elle ?
Important : La demande de géolocalisation n'est pas envoyée pour chaque tâche. Elle n'est déclenchée que lorsque le système détecte que l'adresse de livraison de la tâche n'est pas géocodée avec une précision suffisante.
Lorsque cette condition est remplie, le système initie automatiquement une conversation WhatsApp avec le destinataire pour collecter sa localisation précise.
WhatsApp uniquement, sans solution de secours
Contrairement aux notifications standards destinées aux destinataires (voir Documentation de la fonctionnalité WhatsApp), la demande de géolocalisation ne prend pas en charge le basculement vers les SMS. Le système tentera de contacter le destinataire exclusivement via WhatsApp. Si le destinataire ne dispose pas de WhatsApp sur le numéro de téléphone associé à la tâche, la demande ne sera tout simplement pas délivrée.
Cette limitation existe parce que la fonctionnalité repose sur la capacité de partage de localisation interactif de WhatsApp, qui n'est pas disponible par SMS.
Une conversation en 3 étapes. Pourquoi ?
L'API WhatsApp de Meta ne permet pas aux entreprises d'envoyer des demandes de localisation interactives directement aux destinataires sans conversation active préalable. Il n'est pas possible d'envoyer un message de modèle avec un bouton « Partager ma localisation » sans contexte.
Pour contourner cette contrainte, la fonctionnalité utilise une conversation en 3 étapes :
Initier la conversation en envoyant un message de modèle avec un bouton « Continuer »
Une fois que le destinataire clique sur le bouton, une fenêtre de conversation de 24 heures s'ouvre, nous permettant d'envoyer une demande de localisation interactive. Lorsque le destinataire partage sa localisation, l'adresse de la tâche est mise à jour avec les coordonnées reçues.
Envoyer un message de remerciement pour confirmer que la localisation a bien été reçue
Étape
Action du système
Action du destinataire
Résultat
1. Initiation
Envoie un message de modèle expliquant la situation, avec un bouton « Continuer »
Appuie sur « Continuer »
Ouvre une fenêtre de conversation de 24h
2. Demande de localisation
Envoie un message de demande de localisation interactif
Appuie sur « Partager la localisation », sélectionne ou ajuste le repère, confirme
Localisation reçue, adresse de la tâche mise à jour
3. Remerciement
Envoie un message de confirmation/remerciement
—
Conversation terminée
Coût
Seule l'étape 1 (le message de modèle) est facturée en tant que conversation initiée par l'entreprise. Les étapes 2 et 3 sont envoyées dans la fenêtre de 24 heures ouverte par le clic du destinataire sur le bouton, ce qui les rend gratuites.
Prérequis
Avant de configurer les demandes de géolocalisation, assurez-vous que :
L'intégration WhatsApp est déjà configurée sur la plateforme
Vous êtes familier avec la création de modèles de messages dans Meta Business Suite
Étape 1 : Créer des modèles dans Meta Business Suite
Vous devez créer 3 modèles de messages dans votre compte WhatsApp Business. Chaque modèle correspond à une étape spécifique de la conversation.
Rappel : Pour la prise en charge multilingue, utilisez toujours le même nom de modèle pour toutes les versions linguistiques. Seuls le paramètre de langue et le contenu doivent différer. Urbantz sélectionne automatiquement la langue appropriée en fonction de la langue préférée du destinataire.
Modèle 1 : Initiation de la conversation
Il s'agit du premier message que le destinataire recevra. Il présente le contexte (la livraison) et invite le destinataire à interagir en cliquant sur un bouton.
Configuration dans Meta Business Suite :
Paramètre
Valeur
Catégorie
Utility
Nom
ex. : confirm_delivery_location_init
Langue(s)
Une version par langue prise en charge
Corps
Un message court et convivial expliquant que vous avez besoin d'aide pour confirmer l'adresse de livraison
Nous préparons votre livraison de la part de {{sender}}.
Pour nous assurer que tout se passe bien, pourriez-vous confirmer quelques détails avec nous ?
Modèle 2 : Demande de localisation
Ce modèle fournit le texte du corps pour le message de demande de localisation. Vous n'avez qu'à rédiger le texte demandant au destinataire de partager sa localisation. Le bouton « Partager la localisation » est ajouté automatiquement par Urbantz lors de l'envoi de ce message. Vous n'avez pas besoin de définir ce bouton dans l'éditeur de modèles Meta, et vous n'avez pas besoin de le configurer dans Urbantz non plus. Il est entièrement automatique lors de l'utilisation du déclencheur TASK_LOCATION_REQUEST_ASK.
Configuration dans Meta Business Suite :
Paramètre
Valeur
Catégorie
Utility
Nom
ex. : confirm_delivery_location_ask
Langue(s)
Une version par langue prise en charge
Corps
Un message demandant au destinataire de partager sa localisation de livraison
Boutons
Aucun (le bouton « Partager la localisation » est ajouté automatiquement par Urbantz)
Exemple de texte du corps :
Veuillez partager l'emplacement où vous souhaitez recevoir votre livraison. Appuyez sur le bouton ci-dessous pour envoyer votre localisation.
Modèle 3 : Confirmation / Remerciement
Ce message est envoyé après que le destinataire a partagé sa localisation. Il confirme que la localisation a bien été reçue et que l'adresse de livraison a été mise à jour.
Configuration dans Meta Business Suite :
Paramètre
Valeur
Catégorie
Utility
Nom
ex. : confirm_delivery_location_thanks
Langue(s)
Une version par langue prise en charge
Corps
Un court message de confirmation et de remerciement
Boutons
Aucun
Exemple de texte du corps :
Merci ! Nous avons mis à jour votre adresse de livraison avec la localisation que vous avez partagée. Votre colis sera livré au bon endroit.
Étape 2 : Configurer les notifications dans Urbantz
Une fois vos modèles approuvés dans Meta, vous devez créer 3 configurations de notifications dans Urbantz, une pour chaque étape de la conversation.
Depuis votre plateforme, accédez à Administration > Plateforme > Messagerie
Créez les 3 notifications suivantes :
Notification 1 : Initiation de la conversation
Paramètre
Valeur
Nom
ex. : « Géo - Initiation de la demande de localisation »
Déclencheur
« Demander au destinataire de démarrer une conversation concernant l'adresse de livraison de la tâche »
Mode de livraison
WhatsApp
Dans l'onglet Contenu :
Paramètre
Valeur
Modèle
Sélectionnez votre modèle confirm_delivery_location_init (ou le nom que vous avez choisi précédemment)
Langue par défaut
Sélectionnez votre langue par défaut
Correspondance des variables
Associez les variables du modèle aux champs Urbantz (ex. : {{address}} → adresse de la tâche)
Notification 2 : Demande de localisation
Paramètre
Valeur
Nom
ex. : « Géo - Demande de localisation »
Déclencheur
« Demander au destinataire l'adresse de livraison de la tâche »
Mode de livraison
WhatsApp
Dans l'onglet Contenu :
Paramètre
Valeur
Modèle
Sélectionnez votre modèle confirm_delivery_location_ask (ou le nom que vous avez choisi précédemment)
Langue par défaut
Sélectionnez votre langue par défaut
Remarque : Vous n'avez pas besoin de configurer le bouton « Partager la localisation ». Il est ajouté automatiquement par Urbantz lorsque ce déclencheur est utilisé.
Notification 3 : Remerciement
Paramètre
Valeur
Nom
ex. : « Géo - Remerciement pour la demande de localisation »
Déclencheur
« Notifier le destinataire lorsque la demande de localisation de la tâche est terminée »
Mode de livraison
WhatsApp
Dans l'onglet Contenu :
Paramètre
Valeur
Modèle
Sélectionnez votre modèle confirm_delivery_location_thanks (ou le nom que vous avez choisi précédemment)
Langue par défaut
Sélectionnez votre langue par défaut
Important : Ne PAS configurer de notifications de secours
Ne créez PAS de notifications de secours par SMS ou e-mail pour ces déclencheurs.
Contrairement aux notifications WhatsApp standard, pour lesquelles vous pouvez configurer un basculement vers les SMS, la demande de géolocalisation est exclusivement réservée à WhatsApp.
Si le destinataire ne dispose pas de WhatsApp :
Le message initial échouera à être délivré
Aucune solution de secours ne sera tentée
L'adresse de la tâche restera inchangée (une intervention manuelle pourra être nécessaire)
Surveillance
Surveillance au niveau de la tâche
Ouvrez le menu Tâches sur votre plateforme
Sélectionnez la tâche concernée
Ouvrez l'Onglet Notifications pour voir les tentatives de notification pour chaque étape de la conversation (jusqu'à 3 entrées)
Ouvrez l'Onglet Historique pour voir le journal d'activité de la tâche, y compris la mise à jour de l'adresse/GPS résultant du partage de localisation par le destinataire
Surveillance au niveau de la plateforme
Accédez à Administration > Moniteur système et sélectionnez l'Onglet Notifications. Cette vue affiche les échecs de livraison sur l'ensemble de la plateforme, ce qui est utile pour identifier les destinataires qui n'ont pas pu être contactés (par exemple, parce qu'ils ne disposent pas de WhatsApp).
Expérience du destinataire
Étape 1 : Message initial
Le destinataire reçoit un message WhatsApp expliquant que son adresse de livraison doit être confirmée. Le message comprend un bouton « Continuer ».
Étape 2 : Partage de la localisation
Après avoir appuyé sur « Continuer », le destinataire reçoit un message lui demandant de partager sa localisation. Un bouton « Partager la localisation » apparaît automatiquement (ajouté par Urbantz lors de l'envoi du message, non configuré dans Meta ni dans les paramètres de notification Urbantz).
Lorsque le destinataire appuie sur « Partager la localisation », WhatsApp ouvre son sélecteur de localisation intégré :
Le destinataire peut partager sa position actuelle
ou choisir une localisation différente sur la carte
Sur Android : le repère peut être déplacé librement vers n'importe quel endroit. Les lieux publics apparaissent sous forme de points sur la carte
Sur iOS : la vue par défaut affiche la position actuelle. Pour l'ajuster, le destinataire doit faire glisser le panneau inférieur vers le bas pour révéler la carte et déplacer le repère. Ce geste n'est pas indiqué visuellement, ce qui peut prêter à confusion
Une fois que le destinataire partage sa localisation, l'adresse de livraison de la tâche est immédiatement mise à jour avec les coordonnées reçues.
Étape 3 : Remerciement
Une fois l'adresse de la tâche mise à jour, le destinataire reçoit un message de remerciement confirmant que la localisation a bien été reçue.
Référence : Déclencheurs de notifications
Déclencheur (libellé dans l'interface)
Étape
Description
« Demander au destinataire de démarrer une conversation concernant l'adresse de livraison de la tâche »
1
Message de modèle avec le bouton « Continuer »
« Demander au destinataire l'adresse de livraison de la tâche »
2
Message de demande de localisation interactif (avec le bouton automatique « Partager la localisation »)
« Notifier le destinataire lorsque la demande de localisation de la tâche est terminée »
3
Message de remerciement / confirmation
FAQ
Que se passe-t-il si le destinataire ne clique pas sur « Continuer » ?
La conversation reste ouverte mais aucun autre message n'est envoyé. Le destinataire peut cliquer sur le bouton à tout moment. S'il ne répond jamais, l'adresse de la tâche reste inchangée.
Le destinataire peut-il partager une localisation différente de sa position actuelle ?
Oui, sur Android comme sur iOS. Cependant, l'expérience est nettement meilleure sur Android, où le repère peut être déplacé librement. Sur iOS, la façon d'ajuster la localisation n'est pas intuitive (cela nécessite de faire glisser un panneau vers le bas sans indication visuelle).
Que se passe-t-il si le destinataire n'a pas WhatsApp ?
La demande de géolocalisation ne sera pas délivrée. Aucun basculement vers les SMS ou l'e-mail n'est tenté. L'adresse de la tâche reste inchangée et peut nécessiter une correction manuelle.
La fenêtre de 24 heures est-elle un problème ?
En pratique, non. La fenêtre de 24 heures démarre lorsque le destinataire clique sur « Continuer ». Chaque interaction ultérieure du destinataire (comme le partage de sa localisation) réinitialise la fenêtre pour 24 heures supplémentaires. Étant donné qu'Urbantz répond immédiatement après chaque action du destinataire, le système se trouve toujours dans la fenêtre active. Même si le destinataire prend un certain temps entre les étapes, chaque interaction prolonge la fenêtre.
Puis-je utiliser des variables dans le corps du modèle ?
Oui, pour le Modèle 1 (initiation) vous pouvez utiliser des variables nommées (ex. : {{address}} pour l'adresse de la tâche, {{reference}} pour un numéro de référence) et les associer dans Urbantz. Notez qu'Urbantz requiert des variables nommées (et non des variables numérotées comme {{1}}). Les modèles 2 et 3 n'ont généralement pas besoin de variables dynamiques, mais peuvent en inclure si souhaité.
Commentaires
0 commentaire
Vous devez vous connecter pour laisser un commentaire.