Messages WhatsApp de commande pour vos clients
Catégorie : Commandes · Plan min. : Pro · Slug : whatsapp-sender
L'add-on WhatsApp Sender écrit à votre client sur WhatsApp aux moments qui décident si un colis payé à la livraison est encaissé : quand la commande arrive, quand vous la confirmez, quand elle part avec le transporteur, quand le livreur n'a pas pu le joindre, et quand elle attend au point de retrait. Chaque message part du numéro WhatsApp Business vérifié de DZBuild, porte le nom de votre boutique et le numéro de commande, se termine par un bouton Suivre ma commande, et ne vous coûte un crédit que si WhatsApp le facture.
Pourquoi il fait monter le taux de confirmation et de livraison
Un client qui a commandé à 23 h depuis son téléphone ne sait plus à midi sur quelle page il a commandé. L'appel d'un numéro inconnu reste sans réponse, l'appel du livreur reste sans réponse, et le colis vous revient à vos frais. Chaque message de cet add-on supprime un de ces points de rupture :
- Commande reçue. Le client lit que votre boutique a bien reçu sa commande et qu'un appel de confirmation va suivre. Cet appel arrive maintenant chez quelqu'un qui l'attend.
- Commande en route. Le client apprend le nom du transporteur, le délai annoncé et le montant exact à préparer. Le message lui demande de rester joignable, donc l'appel du livreur aboutit.
- Le livreur ne vous a pas joint. Au lieu d'une deuxième tentative silencieuse, le client reçoit un message et peut répondre avec un nouvel horaire ou une nouvelle adresse. Sa réponse vous arrive sur Telegram et sur la page de la commande.
- Colis arrivé au bureau. Pour les commandes en point de retrait, le client apprend où se trouve le colis et qu'il n'y est gardé que quelques jours, ce qui lui permet de venir le chercher avant qu'il soit retourné.
Les messages laissent aussi quelque chose que l'appel téléphonique ne laisse pas : un fil WhatsApp au nom de votre boutique, avec le numéro de commande et un bouton vers la page de suivi. Un client qui ouvre WhatsApp quelques semaines plus tard et cherche le nom de votre boutique retrouve ce fil, et tout ce qu'il y écrit vous parvient avec la commande correspondante.
Ce que reçoit le client
Cinq messages, chacun lié à un événement de commande que vous activez ou désactivez. Les textes sont fixes car Meta les valide à l'avance ; vous choisissez la langue et le délai de livraison affiché dans le message « Commande en route ».
| Message | Quand il part | Par défaut |
|---|---|---|
| Commande reçue | La commande arrive dans votre boutique. Le client lit que vous allez l'appeler pour confirmer. | Désactivé |
| Commande confirmée | Vous passez la commande en confirmée. Le client lit qu'elle est en préparation, avec le montant à payer. | Désactivé |
| Commande en route | La commande part avec le transporteur. À domicile : le livreur appellera, rester joignable et préparer le montant. Point de retrait : le bureau vers lequel elle se dirige. | Activé |
| Le livreur ne vous a pas joint | Le transporteur signale une tentative échouée sur une livraison à domicile. Le client peut répondre pour changer l'horaire ou l'adresse. | Activé |
| Colis arrivé au bureau | Le colis arrive au point de retrait. Pour une commande Retrait en boutique, le message part quand vous passez la commande en expédiée. Le client est invité à venir le chercher avant qu'il soit retourné. | Activé |
À quoi ressemble le message « Commande en route », livraison à domicile, en français :
Bonjour Ahmed, votre commande n° 1024 chez Ma Boutique est en route avec Yalidine.
Livraison prévue sous 1 à 3 jours. Le livreur vous appellera avant d'arriver : restez joignable et préparez le montant de 3500 DA.
Appuyez sur le bouton pour suivre votre commande.
Règles valables pour tous les messages :
- Langue. Arabe ou français pour toute la boutique, au choix dans les réglages de l'add-on. La langue de la boutique est celle par défaut.
- Délai de livraison. Texte libre de 60 caractères maximum, affiché dans le message « Commande en route », par exemple « 1 à 3 jours ».
- Numéros mobiles algériens uniquement. Les numéros qui commencent par 05, 06 ou 07 reçoivent les messages. Tout autre numéro est ignoré et jamais débité.
- Un message par événement et par commande. Faire passer une commande d'un statut à l'autre puis revenir en arrière n'envoie jamais deux fois le même message.
- Suivre ma commande. Chaque message se termine par un bouton qui ouvre la page de suivi de votre boutique pour cette commande.
Ce que ça coûte
Les messages sont payés depuis un solde prépayé de crédits, un crédit par message. Vous rechargez en dinars, par carte internationale (paiement en USD) ou par carte CIB / EDAHABIA, par tranches de 100 DA :
| Montant rechargé | Prix par message |
|---|---|
| À partir de 2 000 DA | 4 DA |
| À partir de 8 000 DA | 3 DA |
Une recharge va jusqu'à 100 000 DA, et tous les messages de la recharge sont comptés au tarif du palier atteint.
Un crédit est réservé quand un message est mis en file d'attente. Il n'est gardé que si WhatsApp facture le message. Un message qui échoue, un message toujours non délivré après 30 jours, et un message que WhatsApp a délivré sans le facturer (par exemple envoyé alors que le client vous avait écrit dans les 24 heures précédentes) rendent tous leur crédit à votre solde. Dans l'historique, un message délivré mais non facturé porte la mention Gratuit ; un message échoué ou non délivré porte la mention Recrédité. Un numéro sans WhatsApp est ignoré et jamais débité.
La page de l'add-on affiche quatre compteurs sur les 30 derniers jours : livrés, lus, échoués et gratuits, plus le nombre de crédits débités ce mois.
Comment l'activer
- Ouvrez Tableau de bord → Add-ons et activez WhatsApp Sender. L'entrée Messages WhatsApp apparaît dans la barre latérale.
- Sur la page de l'add-on, rechargez votre solde. Les premiers messages partent dès que le solde est supérieur à zéro.
- Choisissez la langue et le texte du délai de livraison, puis activez les messages que vous voulez. « Commande en route », « Le livreur ne vous a pas joint » et « Colis arrivé au bureau » sont activés dès le départ.
- Liez votre compte Telegram dans Tableau de bord → Notifications pour recevoir les réponses des clients sur votre téléphone.
Rien ne change sur votre boutique. Les commandes arrivent comme avant ; l'add-on ne fait que suivre leur statut.
Réponses des clients
Un client qui répond à l'un de ces messages répond à votre boutique, pas à DZBuild. Sa réponse est enregistrée sur la page de la commande, dans la section WhatsApp, et si votre Telegram est lié elle y arrive sous forme de carte avec le texte du client, le numéro de commande et deux boutons : Répondre sur WhatsApp, qui ouvre une discussion avec le client depuis votre propre WhatsApp, et Ouvrir la commande, qui ouvre la commande dans votre tableau de bord.
Comme les messages partent du numéro DZBuild, votre réponse vient d'un autre numéro que celui auquel le client a écrit. Le client voit le nom de votre boutique dans le message d'origine et votre propre numéro dans la réponse.
Les notes vocales, images, vidéos et documents sont enregistrés comme une réponse avec leur type et leur légende, sans le fichier lui-même ; une position partagée par le client arrive sous forme de lien vers une carte. Une réaction emoji n'est pas enregistrée.
Quels transporteurs déclenchent les messages de livraison
« Commande reçue », « Commande confirmée » et « Commande en route » dépendent uniquement du statut de la commande dans votre tableau de bord : ils fonctionnent donc avec tous les transporteurs et avec les commandes que vous livrez vous-même.
Les deux autres messages dépendent de ce que le transporteur renvoie à DZBuild :
- Le livreur ne vous a pas joint part quand le statut de suivi indique une tentative échouée chez Yalidine, Yalitec, Guepex, Easy & Speed, Economiqua, We Can Services, ZR Express, Abex Express, Leopard Express, Colilog, Flash Delivery, NOEST, Zimou, Colivraison et les transporteurs qui passent par Ecotrack.
- Colis arrivé au bureau part quand Yalidine, Yalitec, Guepex, Easy & Speed, Economiqua, We Can Services, ZR Express, Abex Express, Leopard Express, Colilog ou Flash Delivery signalent que le colis est arrivé au point de retrait, et pour les commandes Retrait en boutique quand vous les passez en expédiées.
Avec un transporteur qui ne signale pas ces événements, rien n'est envoyé et rien n'est débité.
Pour les développeurs
L'add-on est disponible via l'API DZBuild, avec les mêmes modèles et le même solde que le tableau de bord. Une clé API avec les portées whatsapp:read et whatsapp:send s'obtient dans Tableau de bord → Développeurs → API sur le plan Enterprise, ou depuis une app installée sur n'importe quel plan.
| Endpoint | Portée | Ce qu'il renvoie |
|---|---|---|
GET /v1/whatsapp/templates | whatsapp:read | Les cinq modèles avec leur texte arabe et français et leur statut de validation |
GET /v1/whatsapp/balance | whatsapp:read | Le solde de crédits et les compteurs sur 30 jours |
GET /v1/whatsapp/messages | whatsapp:read | L'historique des messages, filtrable par commande, avec le champ billing : charged, free ou null tant que le message est ouvert |
POST /v1/orders/{id}/whatsapp | whatsapp:send | Met en file un modèle pour une commande, débité du solde comme un envoi automatique |
Envoyer le message « Commande confirmée » pour une commande :
curl -X POST https://api.dzbuild.app/v1/orders/6894/whatsapp \
-H "Authorization: Bearer $DZBUILD_API_KEY" \
-H "Content-Type: application/json" \
-d '{"template": "confirmed"}'
Le contrat complet, les codes d'erreur et les champs de l'historique des messages sont dans la référence API des messages WhatsApp. Les guides pour construire une app sur la plateforme sont sur dzbuild.dev.
FAQ
Quand les messages sont-ils envoyés, et à qui ? Uniquement aux moments que vous activez : réception de la commande, confirmation, en route, livreur sans réponse, et arrivée au point de retrait. Chaque message part une seule fois par commande, et seulement vers des numéros algériens qui commencent par 05, 06 ou 07.
Combien coûte un message ? 4 DA par message à partir de 2 000 DA, 3 DA par message à partir de 8 000 DA. Vous pouvez augmenter le montant librement : tous les messages de la recharge sont comptés au tarif du palier atteint. Un crédit est réservé par envoi.
Le client n'a pas WhatsApp ou l'envoi échoue : est-ce que je paie ? Non. Un numéro sans WhatsApp n'est pas débité et apparaît « Non envoyé ». Un message qui échoue ou n'est pas délivré sous 30 jours est recrédité automatiquement. Si WhatsApp ne facture pas un message délivré (par exemple envoyé alors que le client vous avait écrit dans les 24 heures), il est recrédité aussi et marqué « Gratuit ». Vous ne payez que ce que WhatsApp facture.
Le client peut-il répondre ? Oui. Sa réponse apparaît sur la page de la commande et vous arrive sur Telegram avec un bouton pour lui répondre depuis le WhatsApp de votre boutique. Les messages partent du numéro officiel DZBuild, la réponse ne vient donc pas du même numéro.
De quel numéro le client reçoit-il le message ? Du compte WhatsApp Business officiel de DZBuild (compte vérifié). Chaque message porte le nom de votre boutique et le numéro de commande : le client sait dès la première ligne qu'il s'agit de sa commande chez vous.
Le message « arrivé au bureau » ne part pas pour certaines commandes, pourquoi ? Il dépend de ce que le transporteur signale. Il fonctionne aujourd'hui avec Yalidine, ZR Express et les transporteurs qui envoient un statut « en attente du client ». Avec les autres, rien n'est envoyé et rien n'est débité.
Quels messages sont gratuits ? Chaque message que WhatsApp ne facture pas est gratuit pour vous aussi. Aujourd'hui, c'est tout message délivré dans les 24 heures qui suivent un message du client : un client qui vous répond rend les messages suivants gratuits. Il porte la mention Gratuit dans l'historique et le crédit reste sur votre solde. Un message qui échoue ou n'arrive pas est recrédité aussi et porte la mention Recrédité.
Puis-je modifier le texte des messages ? Non. Les textes sont fixes car Meta les valide à l'avance. Vous contrôlez la langue, les messages envoyés, et le délai de livraison annoncé dans le message « Commande en route ».