Location messages WhatsApp : partager une adresse ou position GPS

Dans de nombreuses villes africaines, les adresses postales traditionnelles n'existent pas ou sont peu fiables. À Dakar, Abidjan, Douala ou Kinshasa, on indique un quartier, un carrefour, un bâtiment connu — pas un numéro de rue. WhatsApp a résolu ce problème pour des millions d'utilisateurs grâce aux messages de localisation : partager sa position GPS en un clic, voir l'adresse s'ouvrir directement dans Google Maps. Pour les entreprises, l'API WhatsApp permet d'intégrer cette fonctionnalité dans leurs workflows : partager l'adresse d'un point de retrait, confirmer une adresse de livraison, ou afficher la localisation d'un représentant commercial en déplacement.

Types de messages de localisation

L'API WhatsApp supporte deux types de messages de localisation :

Messages de localisation statique : vous envoyez des coordonnées GPS (latitude/longitude) avec un nom et une adresse optionnels. WhatsApp affiche une carte miniature avec un marqueur, et l'utilisateur peut ouvrir les coordonnées dans son application de navigation préférée.

Messages de localisation live (partage en temps réel) : les utilisateurs peuvent partager leur position en temps réel depuis l'application WhatsApp standard. Via l'API, vous ne pouvez pas initier un partage live, mais vous pouvez recevoir les positions en temps réel partagées par vos clients via les webhooks.

Envoyer un message de localisation

async function sendLocationMessage(to, latitude, longitude, name = '', address = '') {
    const payload = {
        messaging_product: 'whatsapp',
        to: to,
        type: 'location',
        location: {
            latitude: latitude,
            longitude: longitude,
            name: name,       // Nom du lieu (ex: "Boutique Centrale Abidjan")
            address: address  // Adresse textuelle (ex: "Plateau, Avenue Noguès, Abidjan")
        }
    };
    
    const response = await axios.post(API_URL, payload, { headers: HEADERS });
    return response.data;
}

// Exemples concrets

// 1. Confirmer l'adresse d'un point de retrait
await sendLocationMessage(
    '225071234567',
    5.3539,
    -4.0014,
    'Point Retrait Express CI - Plateau',
    'Immeuble Sogefiha, Rue du Commerce, Plateau, Abidjan'
);

// 2. Envoyer la localisation d'un agent commercial en tournée
await sendLocationMessage(
    '221771234567',
    14.6928,
    -17.4467,
    'Représentant: Moussa Diallo',
    'Quartier Médina, Dakar'
);

// 3. Partager l'adresse d'un entrepôt pour la livraison
await sendLocationMessage(
    '237671234567',
    3.8667,
    11.5167,
    'Entrepôt Logistique Yaoundé',
    'Zone Industrielle, Biyem-Assi, Yaoundé'
);

Recevoir et traiter les localisations envoyées par les clients

Quand un client vous envoie sa position GPS via WhatsApp, votre webhook reçoit un événement de type location :

function handleLocationMessage(message) {
    const { from, location, timestamp } = message;
    const { latitude, longitude, name, address } = location;
    
    console.log(`📍 Localisation reçue de ${from}:`);
    console.log(`   Coordonnées: ${latitude}, ${longitude}`);
    console.log(`   Nom: ${name || 'Non renseigné'}`);
    console.log(`   Adresse: ${address || 'Non renseignée'}`);
    
    // Stocker en base de données
    saveClientLocation(from, latitude, longitude, name, address, timestamp);
    
    // Calculer la distance au point de livraison le plus proche
    const nearestStore = findNearestStore(latitude, longitude);
    
    sendTextMessage(from, 
        `📍 Position reçue !\n\n` +
        `Le point de retrait le plus proche de vous est :\n` +
        `*${nearestStore.name}*\n` +
        `${nearestStore.address}\n` +
        `Distance : ${nearestStore.distance} km\n\n` +
        `Souhaitez-vous confirmer la livraison à cette adresse ?`
    );
}

function findNearestStore(clientLat, clientLon) {
    const stores = [
        { name: 'Boutique Plateau', lat: 5.3539, lon: -4.0014, address: 'Plateau, Abidjan' },
        { name: 'Boutique Cocody', lat: 5.3612, lon: -3.9978, address: 'Cocody, Abidjan' },
        { name: 'Boutique Marcory', lat: 5.2981, lon: -3.9792, address: 'Marcory, Abidjan' }
    ];
    
    return stores
        .map(store => ({
            ...store,
            distance: calculateDistance(clientLat, clientLon, store.lat, store.lon)
        }))
        .sort((a, b) => a.distance - b.distance)[0];
}

function calculateDistance(lat1, lon1, lat2, lon2) {
    // Formule de Haversine
    const R = 6371;
    const dLat = (lat2 - lat1) * Math.PI / 180;
    const dLon = (lon2 - lon1) * Math.PI / 180;
    const a = Math.sin(dLat/2) * Math.sin(dLat/2) +
              Math.cos(lat1 * Math.PI / 180) * Math.cos(lat2 * Math.PI / 180) *
              Math.sin(dLon/2) * Math.sin(dLon/2);
    const c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1-a));
    return Math.round(R * c * 10) / 10; // km avec 1 décimale
}

Cas d'usage business pour l'Afrique

Livraison à domicile avec confirmation de position : dans les villes africaines où les adresses sont imprécises, demandez à vos clients de partager leur position GPS avant la livraison. Le livreur reçoit les coordonnées exactes et peut naviguer directement sans chercher une adresse introuvable.

Réseau d'agents et de vendeurs : partagez les emplacements de vos points de vente, agents mobiles ou représentants commerciaux avec vos clients. Quand un client demande "Où est votre magasin le plus proche ?", votre chatbot peut répondre avec une carte interactive.

Confirmation d'adresse de livraison : avant d'expédier, envoyez un message de localisation avec l'adresse de livraison prévue et demandez au client de confirmer. Évitez des livraisons ratées coûteuses.

Check-in field force : pour les équipes terrain (commerciaux, techniciens, livreurs), configurez un système où ils partagent leur position WhatsApp en début et fin de journée. Centralisez ces données pour le reporting.

Pour enrichir votre stratégie marketing avec d'autres formats, consultez le guide marketing WhatsApp 2025 et la documentation API WhatsApp Business.

FAQ

Q: WhatsApp API peut-il envoyer un itinéraire de navigation (directions) ?

R: Non directement. WhatsApp envoie des points de localisation (coordonnées GPS), pas des itinéraires. En revanche, quand l'utilisateur reçoit une localisation et clique dessus, son application de navigation s'ouvre automatiquement avec la destination pré-remplie. C'est fonctionnellement équivalent pour l'utilisateur final.

Q: Comment obtenir des coordonnées GPS précises pour mes points de vente en Afrique ?

R: Plusieurs options : Google Maps (clic droit sur la carte → "Plus d'informations sur cet endroit" → coordonnées), What3Words (excellent pour les adresses africaines), OpenStreetMap, ou les API de géocodage (Google Maps Geocoding API, Mapbox) qui convertissent une adresse textuelle en coordonnées. Pour les zones peu cartographiées, What3Words est particulièrement adapté.

Q: Les messages de localisation WhatsApp fonctionnent-ils dans les templates HSM ?

R: Non, les messages de type location ne sont pas disponibles comme type de template HSM. Pour envoyer une localisation hors de la fenêtre 24h, utilisez d'abord un template texte pour rouvrir la conversation, puis envoyez la localisation dans la session ouverte. Alternativement, incluez un lien Google Maps dans votre template texte.

Q: Comment demander à un client de partager sa position via un chatbot WhatsApp ?

R: Envoyez un message texte lui demandant de cliquer sur l'icône de localisation dans WhatsApp et de partager sa position. WhatsApp ne permet pas de déclencher le partage de localisation programmatiquement — c'est toujours une action volontaire de l'utilisateur. Vous pouvez envoyer un bouton interactif "Je partage ma position" qui, une fois cliqué, ouvre l'interface de partage de localisation dans WhatsApp.

Q: Peut-on envoyer plusieurs points de localisation dans un seul message (liste de magasins) ?

R: Non, un message API ne peut contenir qu'un seul point de localisation. Pour une liste de points de vente, envoyez plusieurs messages de localisation successifs ou créez un lien vers une page web avec une carte multi-marqueurs. Un message de liste interactive (type list) avec les adresses textuelles est également une bonne alternative.

---

Intégrez la géolocalisation dans vos workflows WhatsApp avec Whakup. Automatisez la confirmation de livraison, le guidage vers vos points de vente et le suivi de vos équipes terrain.