WhatsApp pour les plateformes de fidélité : gérer l'envoi de documents via l'API

L'envoi de documents via WhatsApp sur une plateforme de fidélité permet de délivrer instantanément cartes de membre, bons de réduction, reçus de transaction ou CGU directement dans la messagerie du client. Ces fichiers sont accessibles sans connexion au compte, sans email à retrouver dans les spams, et sans application supplémentaire à télécharger.

Quels documents une plateforme de fidélité peut-elle envoyer via WhatsApp ?

L'API WhatsApp Business supporte plusieurs types de médias en pièce jointe. Pour une plateforme de fidélité, les documents les plus utiles sont :

Type de document	Format recommandé	Taille max	Cas d'usage
Carte de membre numérique	PDF ou image PNG	5 MB (image) / 100 MB (PDF)	Inscription au programme
Bon de réduction	PDF ou image	5 MB	Récompense fidélité
Reçu de transaction	PDF	100 MB	Confirmation d'achat
Conditions du programme	PDF	100 MB	Inscription / mise à jour CGU
Facture de prestation	PDF	100 MB	Services premium
Carte cadeau numérique	Image PNG	5 MB	Événements, anniversaires

Pour les documents visuels à fort impact (cartes, bons), privilégiez l'image ou le sticker : l'affichage est immédiat dans la conversation, sans action de l'utilisateur. Pour les documents contractuels (CGU, factures), le PDF est le format de référence.

Implémentation technique : envoyer un document via l'API WhatsApp Cloud

Upload du fichier media

Avant d'envoyer un document, vous devez l'uploader sur les serveurs Meta pour obtenir un media_id. Cet identifiant est ensuite référencé dans votre appel de message.

POST /v18.0/{phone-number-id}/media
Content-Type: multipart/form-data

{
  "messaging_product": "whatsapp",
  "type": "application/pdf",
  "file": <binary_content>
}

La réponse contient un id (le media_id) valide 30 jours. Pour des documents récurrents (carte de membre standard, CGU), uploadez une fois et réutilisez le media_id.

Envoi du document dans un template ou un message direct

Dans une fenêtre de session (24 h après le dernier message utilisateur), vous pouvez envoyer le document directement :

POST /v18.0/{phone-number-id}/messages
{
  "messaging_product": "whatsapp",
  "to": "33612345678",
  "type": "document",
  "document": {
    "id": "1234567890123456",
    "caption": "Votre bon de réduction - valable jusqu'au 31/07/2026",
    "filename": "bon-reduction-20-pourcent.pdf"
  }
}

Hors fenêtre de session (message initié par la marque), vous devez utiliser un template avec un header media. Le document ou l'image est défini dans le composant header du template.

Génération dynamique de documents

Pour les cartes de membre personnalisées (avec nom, numéro de membre, code QR), votre plateforme génère le PDF ou l'image à la volée avant l'envoi. Workflow typique :

1. Événement déclencheur (inscription du membre).
2. Génération du document personnalisé (bibliothèque PDF côté serveur).
3. Upload sur Meta via l'API media.
4. Envoi du template avec le media_id obtenu.
5. Stockage du media_id en base pour ne pas regénérer à chaque envoi si le document est identique.

Gestion multi-tenant des documents pour les éditeurs de plateformes fidélité

Chaque marque cliente de votre plateforme a ses propres documents : sa charte graphique, son logo, ses CGU. En architecture multi-tenant :

• Les médias uploadés sont liés à un phone-number-id spécifique : un PDF uploadé pour la marque A n'est pas accessible depuis le numéro de la marque B.
• Les templates header media doivent être soumis par WABA : chaque marque soumet son template avec son propre document d'exemple.
• La génération dynamique peut être mutualisée côté plateforme, mais l'upload et l'envoi doivent utiliser les credentials du bon WABA.

Whakup, en tant que Meta Tech Provider certifié, permet à votre plateforme de gérer des dizaines de WABA depuis une seule intégration API, avec un routage transparent par marque cliente. Pour aller plus loin sur l'architecture multi-tenant, consultez le guide complet de l'API WhatsApp Business.

Bonnes pratiques pour l'envoi de documents sur WhatsApp

• Nommez le fichier de façon lisible : bon-reduction-printemps-2026.pdf est plus utile que doc_3847291.pdf. Le nom de fichier s'affiche dans la conversation WhatsApp.
• Ajoutez une caption : le champ caption permet d'ajouter un texte de contexte sous le document. Utilisez-le pour indiquer la date de validité, le montant ou les conditions d'utilisation.
• Compressez les PDF : visez moins de 5 MB pour garantir un téléchargement rapide sur mobile, même en 3G.
• Testez l'affichage sur Android et iOS : le rendu des PDF et des images varie légèrement selon les versions de WhatsApp.
• Ne doublez pas l'email : si la plateforme envoie déjà le document par email, WhatsApp peut servir de rappel ou de canal alternatif, pas de duplication systématique.

Pour comprendre les règles de contenu applicables aux templates avec media, référez-vous à notre guide templates WhatsApp et règles Meta.

FAQ

Peut-on envoyer un document WhatsApp sans template Meta pré-approuvé ?

Oui, si l'envoi se produit dans la fenêtre de session de 24 heures (après un message entrant de l'utilisateur). Hors fenêtre, tout document envoyé de façon proactive doit utiliser un template approuvé avec un header media.

Quelle est la durée de validité d'un media_id uploadé sur Meta ?

Un media_id est valide 30 jours après l'upload. Passé ce délai, le fichier est supprimé des serveurs Meta et l'identifiant devient invalide. Pour des documents récurrents, planifiez une tâche de ré-upload mensuel automatique.

Peut-on envoyer un code QR de carte de fidélité via WhatsApp ?

Oui. Générez l'image PNG du QR code côté serveur, uploadez-la sur Meta, et envoyez-la via un message de type image. L'utilisateur peut scanner le code directement depuis la conversation WhatsApp ouverte sur son téléphone.

L'envoi de documents via WhatsApp est-il conforme au RGPD ?

Les messages et pièces jointes transitent par les serveurs Meta (US). Si le document contient des données personnelles (nom, numéro de membre), vous devez mentionner ce traitement dans votre politique de confidentialité et vous assurer d'un mécanisme de transfert adéquat vers les États-Unis. Whakup héberge ses propres données en EU.

---

Whakup fournit l'API WhatsApp Business aux éditeurs de plateformes de fidélité qui souhaitent intégrer l'envoi de documents : cartes, bons, reçus, CGU. Infrastructure multi-tenant, marque blanche, hébergement EU. Consultez l'offre Whakup et intégrez l'envoi de documents WhatsApp dans votre plateforme.