WhatsApp pour les SaaS e-commerce : gérer l'envoi de documents via l'API

L'envoi de documents via l'API WhatsApp Business permet à un SaaS e-commerce de transmettre automatiquement factures, bons de livraison, conditions générales et confirmations de commande directement dans la messagerie du client ou du marchand — sans passer par l'email, sans portail client supplémentaire à ouvrir. L'API supporte les fichiers PDF, les images et plusieurs autres formats, avec des messages qui restent consultables dans l'historique de conversation WhatsApp.

Ce que l'API WhatsApp Business permet en matière de documents

L'API Cloud de Meta supporte l'envoi de messages dits "media" avec pièce jointe. Voici les formats pertinents pour un SaaS e-commerce :

Type de document	Format supporté	Taille max	Usage typique
Facture	PDF	100 MB	Envoi automatique post-paiement
Bon de livraison	PDF ou image	100 MB / 5 MB	Confirmation d'expédition
Conditions générales	PDF	100 MB	Onboarding nouveau client
Contrat marchand	PDF	100 MB	Signature électronique
Étiquette de retour	PDF ou image	100 MB	Processus de retour produit
Catalogue produit	PDF	100 MB	Prospection B2B

Les documents sont hébergés temporairement par Meta lors de l'envoi via l'API Cloud, ou servis depuis votre URL publique selon la méthode d'envoi choisie (hosted vs. URL). Pour les documents sensibles (contrats, factures), privilégiez l'upload préalable via l'API Media et l'utilisation du media_id retourné.

Architecture d'envoi de documents dans un SaaS multi-marchands

Génération du document Le document est généré côté SaaS au moment de l'événement déclencheur (paiement confirmé → génération PDF facture avec les données de commande). Les librairies de génération PDF côté serveur (Puppeteer, wkhtmltopdf, etc.) restent indépendantes de l'API WhatsApp.

Upload via l'API Media Avant l'envoi, uploadez le PDF vers l'API Meta via l'endpoint /media. Vous recevez un media_id valable 30 jours. Stockez ce media_id en base pour éviter de ré-uploader le même document en cas de renvoi.

Envoi du message document Appelez l'endpoint /messages avec type: "document", le media_id, un nom de fichier lisible (filename) et un caption optionnel. Le caption apparaît sous le document dans la conversation WhatsApp.

Routing multi-tenant Chaque envoi est routé via le waba_id du marchand concerné. Un marchand ne peut pas accéder aux documents envoyés par un autre. Votre backend gère le mapping commande_id → waba_id marchand.

Confirmation de réception Le webhook de statut vous indique si le message document a été envoyé (sent), délivré (delivered) ou lu (read). Pour les factures, ce log constitue une preuve d'envoi utile en cas de litige.

Pour comprendre les mécanismes de webhook en détail, consultez le guide complet de l'API WhatsApp Business.

Cas d'usage prioritaires pour un SaaS e-commerce

Factures automatiques C'est le cas d'usage le plus simple à justifier : chaque paiement confirmé génère une facture PDF envoyée sur WhatsApp dans les 5 minutes. Le client reçoit son justificatif sans chercher dans sa boîte mail, sans se connecter à un espace client. Le taux d'ouverture des documents WhatsApp dépasse largement celui des emails avec pièce jointe.

Documents de retour Quand un client initie un retour, l'API envoie automatiquement l'étiquette de retour prépayée en PDF. Cela remplace un email qui finit souvent dans les spams. Avec WhatsApp, le client peut aussi répondre pour confirmer l'expédition du retour, déclenchant un webhook qui met à jour le statut dans votre SaaS.

Contrats et CGV marchands Pour l'onboarding de nouveaux marchands dans votre SaaS, vous pouvez envoyer les CGV ou un récapitulatif contractuel en PDF via WhatsApp. Le marchand peut répondre "LU ET APPROUVÉ" ou cliquer sur un bouton Quick Reply, ce qui constitue une trace d'acceptation (à combiner avec une signature électronique pour les contrats à valeur légale forte).

Bons de livraison pour le B2B Les SaaS e-commerce qui servent des marchands en B2B peuvent automatiser l'envoi de bons de livraison dématérialisés aux acheteurs professionnels de leurs clients. Plus de papier, preuve de livraison horodatée dans WhatsApp.

Tarification et optimisation des coûts

L'envoi d'un message document avec un template utility revient à environ 0,0336 €/message pour les numéros FR. À noter :

• L'upload Media ne génère pas de coût supplémentaire.
• Si le document est envoyé dans la fenêtre de session de 24h (réponse à une conversation initiée par le client), aucun template n'est requis et le coût est réduit.
• Pour les envois en masse (campagnes catalogue, CGV à tous les marchands), planifiez les envois en dehors des heures de pointe pour maximiser la délivrabilité.

Pour une analyse complète des tarifs et catégories de messages, l'article sur le prix de l'API WhatsApp Business 2026 détaille tous les scenarios.

Whakup est un Meta Tech Provider certifié qui vous évite de décrocher vous-même la certification Meta. L'infrastructure est hébergée en EU, RGPD-conforme, et les documents transitent de manière sécurisée. Découvrez l'API WhatsApp Whakup pour intégrer l'envoi de documents dans votre SaaS e-commerce.

FAQ

Quelle est la taille maximale d'un document envoyable via l'API WhatsApp ?

L'API WhatsApp Business accepte des documents jusqu'à 100 MB. En pratique, les factures et bons de livraison dépassent rarement 500 KB. Pour les catalogues produits volumineux, privilégiez un lien vers un document hébergé plutôt qu'une pièce jointe si la taille dépasse 10 MB.

Les documents envoyés via WhatsApp sont-ils accessibles longtemps par le destinataire ?

Les médias WhatsApp ont une durée de stockage limitée sur les serveurs de Meta (environ 30 jours pour les messages non téléchargés). Une fois téléchargé sur le téléphone du destinataire, le document est conservé dans sa galerie ou ses téléchargements. Pour les documents à valeur légale, prévoyez un accès permanent depuis votre espace client en complément.

Peut-on envoyer des documents sans template approuvé ?

Oui, si le message est envoyé dans la fenêtre de session de 24h (le client a d'abord initié la conversation ou répondu récemment). Pour les envois proactifs (facture envoyée automatiquement sans interaction préalable), un template de catégorie utility ou marketing est obligatoire.

Comment s'assurer que la facture PDF envoyée est conforme aux exigences légales françaises ?

WhatsApp est un canal de livraison, pas un outil de génération de facture. La conformité légale (mentions obligatoires, numérotation, format) est de la responsabilité de votre SaaS au niveau de la génération du PDF. WhatsApp livre simplement le fichier que vous lui transmettez.