WhatsApp pour l'envoi de documents via l'API : guide complet pour les éditeurs

L'API WhatsApp Business permet d'envoyer des fichiers directement dans les conversations : factures PDF, devis, contrats, bulletins de paie, bons de commande, attestations. Pour les éditeurs de plateformes de gestion documentaire, ERP, CRM ou comptabilité, c'est une fonctionnalité qui remplace l'envoi par email sur un canal que les utilisateurs consultent plus régulièrement.

Ce guide couvre tout ce qu'un éditeur doit savoir pour intégrer l'envoi de documents WhatsApp dans sa plateforme.

Types de documents supportés et contraintes techniques

L'API WhatsApp Business supporte plusieurs types de médias pour les documents :

Type	Formats acceptés	Taille max
Document	PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, ZIP, CSV, TXT	100 Mo
Image	JPG, PNG, WEBP	5 Mo
Audio	MP4, AAC, OGG, AMR	16 Mo
Vidéo	MP4, 3GP	16 Mo

Le PDF est de loin le format le plus utilisé pour l'envoi de documents métier. Il est affiché directement dans l'interface WhatsApp avec une prévisualisation du nom de fichier et la possibilité de l'ouvrir dans l'application de lecture du téléphone.

Contraintes à connaître :

La taille maximale d'un document est de 100 Mo. Au-delà, vous devez passer par un lien URL dans le corps du message.
Le fichier doit être accessible via une URL HTTPS publique au moment de l'envoi (Meta le télécharge et le stocke sur ses serveurs).
Les fichiers sur des URLs avec authentification (token dans le header) ne sont pas supportés directement.

Architecture pour l'envoi de documents

Hébergement des fichiers

Avant d'appeler l'API, votre fichier doit être accessible via une URL publique. Deux approches :

1. Upload préalable via l'API Media Whakup Meta propose un endpoint d'upload qui stocke le fichier sur ses CDN et retourne un media_id. C'est l'approche recommandée : le fichier est envoyé une fois, stocké 30 jours, et référençable dans plusieurs messages sans ré-upload.

curl -X POST \
  "https://graph.facebook.com/v19.0/{phone-number-id}/media" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -F "file=@/path/to/facture-2026-001.pdf;type=application/pdf" \
  -F "messaging_product=whatsapp"

La réponse contient un id (media_id) que vous utilisez dans votre message.

2. URL publique directe Si votre infrastructure génère des URLs publiques temporaires (S3 presigned URLs, Azure Blob SAS), vous pouvez les passer directement dans le payload du message. Assurez-vous que l'URL reste valide pendant les quelques secondes que prend Meta pour télécharger le fichier.

Payload d'envoi d'un document

{
  "messaging_product": "whatsapp",
  "to": "+33612345678",
  "type": "document",
  "document": {
    "id": "MEDIA_ID_ICI",
    "filename": "Facture-2026-001.pdf",
    "caption": "Votre facture du mois de janvier 2026. N'hésitez pas à nous contacter pour toute question."
  }
}

Le champ filename contrôle le nom affiché dans l'interface WhatsApp. Le champ caption est le texte accompagnant le document dans le fil de conversation.

Templates vs messages libres pour les documents

Quand utiliser un template

Si vous initiez la conversation (envoi proactif sans message préalable de l'utilisateur dans les dernières 24h), vous devez passer par un template approuvé. Un template peut contenir un document en composant header :

{
  "template": {
    "name": "envoi_facture_mensuelle",
    "language": { "code": "fr" },
    "components": [
      {
        "type": "header",
        "parameters": [
          {
            "type": "document",
            "document": {
              "id": "MEDIA_ID_ICI",
              "filename": "Facture-Janvier-2026.pdf"
            }
          }
        ]
      },
      {
        "type": "body",
        "parameters": [
          { "type": "text", "text": "Marie Dupont" },
          { "type": "text", "text": "janvier 2026" }
        ]
      }
    ]
  }
}

La catégorie appropriée pour une facture ou un document de gestion est UTILITY. La catégorie MARKETING s'applique si le document contient une offre commerciale (brochure produit, catalogue promotionnel).

Pour le détail des catégories, consultez l'article sur les catégories de templates WhatsApp.

Quand envoyer en message libre

Si l'utilisateur a envoyé un message dans les dernières 24h (fenêtre de service), vous pouvez envoyer un document libre sans passer par un template. C'est le cas typique d'une conversation support où l'agent envoie un document en réponse à une demande.

Cas d'usage par type de plateforme

Les éditeurs qui intègrent l'envoi de documents WhatsApp couvrent généralement ces cas :

Plateforme de facturation / comptabilité

Envoi automatique de la facture PDF dès la génération
Envoi du devis pour signature ou validation
Rappel de paiement avec la facture en pièce jointe

CRM / Gestion commerciale

Envoi d'une proposition commerciale suite à un devis
Partage d'une fiche produit ou d'un catalogue PDF
Transmission d'un contrat pour relecture

RH / Gestion des salariés

Bulletin de paie mensuel en PDF
Attestation employeur, contrat de travail
Documents d'onboarding (règlement intérieur, chartes)

E-commerce

Bon de livraison ou confirmation de commande en PDF
Facture TVA pour les achats professionnels
Certificat de garantie ou manuel utilisateur

Pour chacun de ces cas, le modèle économique est clair : un document UTILITY coûte 0,0336 €/message depuis la France, soit moins qu'un envoi postal et sans délai de délivrabilité. Pour la grille tarifaire complète, lisez l'article sur les prix de l'API WhatsApp Business en 2026.

Multi-tenant pour les éditeurs

Si votre plateforme sert plusieurs entreprises clientes, chacune doit avoir son propre WABA pour envoyer des documents sous sa propre identité (nom d'affichage, numéro dédié). Le modèle multi-tenant Whakup permet cette gestion centralisée : vos clients s'onboardent via l'embedded signup que vous intégrez dans votre interface, et vous gérez l'ensemble des WABA depuis une seule API.

L'architecture globale de l'accès multi-tenant est détaillée dans le guide du Meta Tech Provider WhatsApp.

FAQ

Peut-on envoyer plusieurs documents dans un seul message WhatsApp ?

Non. L'API WhatsApp Business ne supporte qu'un document par message. Pour envoyer plusieurs fichiers, vous devez envoyer plusieurs messages successifs. Il n'y a pas de limite au nombre de messages dans une conversation, mais envoyez-les avec un délai court entre chaque pour éviter l'effet spam.

Le document est-il stocké côté Meta après envoi ?

Oui. Les médias uploadés via l'API sont stockés 30 jours sur les serveurs Meta. Après ce délai, le media_id n'est plus valide et le document n'est plus accessible depuis les anciens messages. Vos propres serveurs restent la source de vérité pour l'archivage long terme.

Peut-on envoyer un document protégé par mot de passe PDF ?

Techniquement oui : l'API envoie le fichier tel quel. Mais l'expérience utilisateur est dégradée — WhatsApp ne peut pas afficher la prévisualisation d'un PDF chiffré. Préférez des liens sécurisés par token plutôt que des PDF protégés par mot de passe.

Faut-il un opt-in spécifique pour l'envoi de documents ?

L'opt-in standard WhatsApp suffit. Vous n'avez pas besoin d'un opt-in séparé pour les documents si votre opt-in général mentionne les "notifications et documents". En revanche, si vous envoyez des documents à caractère commercial (catalogues, offres), assurez-vous que l'opt-in couvre explicitement les communications marketing.

Pour intégrer l'envoi de documents WhatsApp dans votre plateforme, accédez à l'API WhatsApp Business Whakup : API REST complète, upload de médias, webhooks de livraison, multi-tenant et hébergement EU/RGPD. Testez l'envoi de votre premier document PDF en sandbox dès aujourd'hui.