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

Envoyer une facture, un contrat, un bon de garantie ou un rapport par SMS est impossible. L'utilisateur reçoit un lien, ouvre un navigateur, télécharge le fichier sur son appareil — si la page charge. Sur WhatsApp, le document arrive directement dans la conversation : il s'affiche, peut être téléchargé en un tap, et reste accessible dans l'historique. Pour les plateformes SMS qui veulent élargir leur proposition de valeur, l'envoi de documents est un cas d'usage distinctif que le SMS ne peut tout simplement pas couvrir.

Les documents qu'une plateforme peut envoyer via WhatsApp API

WhatsApp Business API supporte plusieurs types de fichiers selon le type de message utilisé.

Types de fichiers supportés dans les messages sortants :

Type	Extensions	Taille max
Document	PDF, DOCX, XLSX, PPTX, TXT	100 Mo
Image	JPEG, PNG, WEBP	5 Mo
Audio	MP3, OGG, AAC	16 Mo
Vidéo	MP4, 3GPP	16 Mo

Pour les cas d'usage documentaires B2B et B2C, le PDF est le format pivot. C'est celui qui couvre 90 % des besoins : factures, contrats, tickets, bons de commande, relevés, rapports.

Cas d'usage concrets par secteur :

• E-commerce : facture PDF après chaque achat, bon de retour, étiquette de colis.
• Assurance : attestation d'assurance, avenant de contrat, relevé annuel.
• Santé : ordonnance, compte-rendu de consultation, résultats d'analyse.
• Immobilier : bail à signer, état des lieux, quittance de loyer.
• Finance : relevé de compte, confirmation d'opération, RIB.
• Formation : certificat de complétion, support de cours, programme.

Architecture technique : envoyer un document via l'API WhatsApp

Deux modes d'envoi

Mode 1 : URL publique (recommandé)

Le document est hébergé sur un serveur accessible (CDN, storage cloud). L'API WhatsApp télécharge le fichier depuis l'URL fournie et l'envoie au destinataire. Le fichier n'est pas uploadé sur les serveurs Meta au préalable.

{
  "to": "+336XXXXXXXX",
  "type": "document",
  "document": {
    "link": "https://cdn.example.com/factures/FAC-2026-4821.pdf",
    "filename": "Facture_FAC-2026-4821.pdf",
    "caption": "Votre facture du 22 juin 2026 — Montant : 89,90 €"
  }
}

Mode 2 : Media ID (pour les documents récurrents)

Un document identique envoyé à plusieurs destinataires (CGV, catalogue produit) peut être uploadé une fois via l'API Media et référencé par son media_id dans les envois suivants. Cela évite de retélécharger le fichier à chaque fois.

Envoi via template (initié hors session)

Si le document est envoyé sans que le client ait d'abord écrit (hors fenêtre de session 24h), il faut un template approuvé par Meta. Un template de type document utilise un header de type document.

Structure d'un template avec document en header :

Composant	Contenu
Header	Type : document (le PDF est fourni à l'envoi)
Body	"Bonjour {{1}}, voici votre {{2}} du {{3}}. Vous pouvez le télécharger directement."
Bouton	"Contacter le support" (optionnel)

Ce template doit être soumis à approbation Meta. La catégorie est UTILITY pour les documents transactionnels (factures, contrats, confirmations).

Pour aller plus loin sur les règles de templates, voir l'article sur les catégories de templates WhatsApp.

Intégration dans le flux documentaire de la plateforme

Les plateformes SMS qui intègrent l'envoi de documents WhatsApp n'ont généralement pas à repenser leur pipeline documentaire. L'intégration se fait en aval de la génération du document.

Flux typique :

1. L'événement business déclenche la génération du document (facture créée, contrat signé, rapport généré).
2. Le document est stocké sur le CDN ou storage de la plateforme avec une URL accessible.
3. La plateforme détermine si le destinataire a WhatsApp (vérification optionnelle ou routing conditionnel).
4. Appel API WhatsApp avec l'URL du document.
5. Webhook de confirmation de livraison (delivered/read) stocké pour audit.

Ce flux est compatible avec toute architecture micro-services. Le seul prérequis côté plateforme : générer une URL accessible publiquement pour le document (ou via un token signé à durée limitée pour les documents sensibles).

Pour les plateformes qui veulent maîtriser l'ensemble des capacités de l'API avant d'intégrer, consulter le guide complet de l'API WhatsApp Business.

Sécurité et RGPD : points de vigilance pour les documents sensibles

L'envoi de documents via WhatsApp soulève des questions légitimes sur la confidentialité, en particulier pour les secteurs comme la santé ou la finance.

Ce que WhatsApp offre nativement :

• Chiffrement de bout en bout sur tous les messages, y compris les fichiers.
• Le document n'est accessible que dans la conversation entre l'entreprise et le destinataire.

Ce que la plateforme doit gérer :

• URL sécurisée : utiliser des URLs signées avec expiration (AWS S3 presigned URL, Azure SAS token) pour que le document ne reste pas accessible indéfiniment sur le CDN après envoi.
• Journalisation : conserver les logs d'envoi (date, heure, numéro destinataire, nom du document) pour répondre aux demandes RGPD (droit d'accès, de suppression).
• Hébergement EU : pour les clients dans des secteurs régulés, l'infrastructure WhatsApp doit être hébergée en Europe.

Whakup héberge son infrastructure en EU. C'est un critère de sélection important pour les plateformes qui servent des clients dans la santé, la finance ou le secteur public.

Consultez la page API WhatsApp Whakup pour les détails techniques de l'infrastructure.

Tarification et volume : ce que coûte l'envoi de documents

Le coût d'un message WhatsApp avec document est identique à un message texte : seul le type de conversation (UTILITY vs MARKETING) impacte le prix, pas la taille ou le type de pièce jointe.

Scénario	Catégorie	Coût indicatif (numéro FR)
Facture post-achat	UTILITY	0,0336 €
Contrat à signer envoyé proactivement	MARKETING ou UTILITY selon contexte	0,08 € ou 0,0336 €
Réponse à une demande de document	Session (24h)	0 €
Certificat de formation (mass send)	MARKETING	0,08 €

Pour la plupart des documents transactionnels, la catégorie UTILITY s'applique. Le coût reste inférieur à 0,04 €/document envoyé, ce qui est compétitif face à l'envoi postal ou à l'email avec relances.

Pour le détail des prix 2026, voir Prix de l'API WhatsApp Business en 2026.

FAQ

Peut-on envoyer un document signé électroniquement via WhatsApp ?

Oui, si le document signé est exporté en PDF. WhatsApp envoie le fichier tel quel. La signature électronique (via DocuSign, YouSign, etc.) est générée en amont par la plateforme documentaire ; WhatsApp est simplement le canal de livraison du PDF signé.

La taille maximale de 100 Mo est-elle suffisante pour tous les cas d'usage ?

Pour la quasi-totalité des documents B2C et B2B courants : oui. Une facture PDF fait rarement plus de 500 Ko. Un contrat de 50 pages reste sous 5 Mo. Les cas limites sont les catalogues produits ou les dossiers techniques. Pour ces formats, préférer un lien vers la version en ligne.

Peut-on demander à l'utilisateur d'envoyer un document (sens inverse) ?

Oui. Dans une fenêtre de session ouverte, l'utilisateur peut envoyer n'importe quel document directement dans la conversation. La plateforme reçoit le fichier via un webhook et peut le traiter (stockage, OCR, transmission à un service interne). Ce cas d'usage est particulièrement intéressant pour la collecte de justificatifs (assurance, banque, administration).

Doit-on indiquer un nom de fichier dans l'API ?

Oui, le champ filename est recommandé. Il s'affiche dans WhatsApp sous le document avant téléchargement. Un nom de fichier explicite ("Facture_Janvier_2026.pdf" plutôt que "doc_a7f3b2.pdf") améliore l'expérience utilisateur et facilite l'organisation des téléchargements.

---

L'envoi de documents est un cas d'usage que les plateformes SMS ne peuvent pas couvrir seules. En intégrant WhatsApp API, vous offrez à vos clients la capacité d'envoyer des factures, contrats et rapports directement dans la conversation. Démarrez l'intégration avec l'API WhatsApp Whakup, conçue pour les éditeurs de plateformes.