WhatsApp pour l'envoi de documents via l'API : cas pratique pour les éditeurs

L'API WhatsApp Business permet d'envoyer des documents directement dans la conversation d'un utilisateur : PDF, contrats, devis, factures ou guides produit. Pour un éditeur de plateforme, cette capacité ouvre des cas d'usage très concrets que d'autres canaux — email ou SMS — ne couvrent pas aussi bien.

Cas pratique 1 : une plateforme de facturation envoie les PDFs en temps réel

Un éditeur de logiciel de facturation SaaS veut que ses clients PME reçoivent chaque facture générée directement sur WhatsApp, sans attendre un email qui finira en spam.

Flux technique :

1. La facture est générée côté serveur (PDF hébergé temporairement sur un bucket S3 ou équivalent).
2. Une requête POST est envoyée à l'API WhatsApp avec le type document et l'URL publique du fichier.
3. L'utilisateur reçoit le PDF dans WhatsApp, avec le nom du fichier et un aperçu.
4. Un webhook confirme la livraison (delivered) et la lecture (read).

Exemple de payload simplifié :

{
  "type": "document",
  "document": {
    "link": "https://cdn.exemple.com/factures/facture-2026-0451.pdf",
    "filename": "Facture-0451.pdf",
    "caption": "Votre facture du 15 août 2026 — Montant : 1 240 €"
  }
}

Ce cas montre que l'intégration est directe : pas de conversion de format, pas de pièce jointe email, pas de portail client à ouvrir. Le document arrive là où l'utilisateur lit déjà ses messages.

Cas pratique 2 : un CRM envoie un devis signable après une démo

Un éditeur de CRM B2B intègre WhatsApp dans son module de suivi commercial. Après une démo, le commercial envoie un devis PDF depuis l'interface CRM — le message part automatiquement via l'API.

Ce que cela change concrètement :

• Le délai entre la démo et la réception du devis passe de plusieurs heures à quelques secondes.
• Le taux d'ouverture des documents WhatsApp est nettement supérieur à celui de l'email.
• Le commercial reçoit une notification webhook quand le prospect ouvre le fichier.

Points d'attention pour l'intégration :

Paramètre	Valeur recommandée
Taille maximale du fichier	100 Mo (limite Meta)
Formats acceptés	PDF, DOCX, XLSX, PPTX, ZIP, et autres
Durée de vie de l'URL	URL doit rester accessible pendant la livraison
Nom du fichier (filename)	Toujours renseigner pour l'affichage

Cas pratique 3 : une plateforme RH envoie les contrats de travail

Un éditeur de solution RH automatise l'onboarding des nouveaux employés. Dès que le contrat est généré, il est envoyé via WhatsApp avec un message d'accompagnement structuré.

Avantages par rapport à l'email :

• Le document est reçu sur le téléphone personnel, sans compte entreprise à configurer.
• Le collaborateur peut répondre directement dans le fil pour confirmer réception.
• Le statut de lecture est trackable via webhook, ce qui évite les relances manuelles.

Structure du message avec template pre-approuvé :

L'envoi d'un document hors fenêtre de 24h nécessite un template HSM de catégorie utility. Le template doit être approuvé par Meta avant l'envoi. Pour cela, l'éditeur passe par un Meta Tech Provider comme Whakup — qui gère la soumission et le suivi des templates sans que l'éditeur ait besoin d'une certification Meta propre.

Voir le guide des catégories de templates WhatsApp pour structurer correctement vos templates document.

Ce qu'il faut retenir pour l'implémentation

Quelques points structurants avant de lancer l'intégration dans votre plateforme :

• Hébergez les fichiers sur une URL publique et stable avant d'appeler l'API. WhatsApp télécharge le fichier au moment de l'envoi.
• Ne réutilisez pas les media IDs entre comptes WhatsApp Business différents. Chaque WABA a son propre espace de médias.
• Suivez les webhooks de livraison et lecture pour tracer l'engagement document, pas seulement l'envoi.
• Prévoyez un fallback (email ou SMS) si le numéro destinataire n'est pas sur WhatsApp.

Pour les éditeurs multi-tenant, l'API Whakup supporte le multi-numéros : chaque client de votre plateforme peut avoir son propre numéro WhatsApp Business, géré depuis une seule intégration API. Consultez la page de l'API WhatsApp Whakup pour les détails techniques.

FAQ

Quels formats de fichiers sont acceptés par l'API WhatsApp pour l'envoi de documents ?

WhatsApp accepte un large éventail de formats : PDF, DOCX, XLSX, PPTX, ZIP, CSV, TXT et d'autres. La limite de taille est de 100 Mo par fichier. Pour les usages courants (factures, contrats, devis), le PDF reste le format le plus fiable pour la compatibilité affichage.

Faut-il uploader le fichier sur les serveurs Meta avant l'envoi ?

Pas obligatoirement. Vous pouvez passer une URL publique directe via le paramètre link. Meta télécharge le fichier au moment de l'envoi. Vous pouvez aussi pré-uploader le fichier via l'API Media pour obtenir un media_id, ce qui est utile si le même document est envoyé à plusieurs destinataires.

Comment savoir si le destinataire a bien reçu et ouvert le document ?

Les webhooks de statut de message (delivered, read) sont envoyés par Meta vers votre endpoint. Le statut read indique que le message a été ouvert dans WhatsApp — mais pas nécessairement que le fichier a été téléchargé. Il n'existe pas de webhook spécifique "fichier téléchargé".

Est-ce qu'un template est obligatoire pour envoyer un document ?

Seulement hors de la fenêtre de 24h après le dernier message du contact. Si l'utilisateur vous a écrit dans les dernières 24h, vous pouvez envoyer un document en message libre. Au-delà, il faut utiliser un template HSM de type utility ou marketing approuvé par Meta, selon le contexte de l'envoi.

---

L'envoi de documents via l'API WhatsApp est l'un des cas d'usage les plus rapides à intégrer et les plus appréciés des utilisateurs finaux. Si vous développez une plateforme SaaS et souhaitez ajouter ce canal, Whakup fournit l'accès API en marque blanche, avec embedded signup et hébergement EU conforme RGPD. Tarif : 0,0088 €/msg (hors frais Meta).