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

L'envoi de documents WhatsApp via CRM consiste à transmettre automatiquement des fichiers (contrats, devis, factures, rapports, guides) directement dans la conversation WhatsApp d'un contact, déclenché par un événement dans le CRM. L'API WhatsApp Business supporte les pièces jointes PDF, images, vidéos et documents bureautiques, avec accusé de réception et confirmation de lecture. Pour les équipes commerciales et support, c'est une alternative plus rapide et plus sûre à l'email pour les documents sensibles ou urgents.

Types de documents supportés par l'API WhatsApp Business

L'API supporte un large spectre de formats de fichiers. Voici les plus utilisés dans un contexte CRM :

Format	Taille max	Cas d'usage CRM
PDF	100 Mo	Contrat, devis, facture, rapport
JPEG / PNG	5 Mo	Bon de commande visuel, infographie
MP4 (vidéo)	16 Mo	Tuto produit, démo commerciale
DOCX / XLSX	100 Mo	Proposition commerciale, tableau de bord
PPTX	100 Mo	Présentation commerciale

Le fichier doit être accessible via une URL HTTPS publique (ou temporaire signée) au moment de l'envoi. L'API télécharge le fichier depuis cette URL et le livre dans la conversation WhatsApp. Il n'est pas nécessaire d'héberger les documents sur l'infrastructure de Whakup : votre propre stockage cloud (S3, GCS, Azure Blob) suffit, à condition de générer des URLs accessibles.

Flux d'intégration CRM — envoi de document WhatsApp

Scénario type : envoi automatique d'un devis après qualification

1. Un commercial qualifie un lead dans le CRM et marque l'opportunité "Devis à envoyer"
2. Le CRM déclenche un webhook ou un trigger qui appelle l'API REST Whakup
3. Le payload contient : numéro WhatsApp du prospect, URL du PDF du devis, message d'accompagnement
4. Whakup envoie le message avec la pièce jointe dans la conversation WhatsApp du prospect
5. Le webhook Whakup notifie le CRM quand le message est livré et quand il est lu
6. La fiche CRM est mise à jour : "Devis envoyé le [date], lu à [heure]"

Cette boucle remplace l'envoi email manuel et ajoute la confirmation de lecture en temps réel — information précieuse pour le suivi commercial.

Catégorie Meta du message : les messages avec document envoyés à l'initiative de l'entreprise sont en général classés utility (si liés à une transaction ou une relation contractuelle en cours) ou marketing (si c'est une proposition commerciale non sollicitée). La différence de coût est notable : ~0,0336 €/message en utility contre ~0,08 €/message en marketing pour un numéro français.

Pour approfondir les règles de catégorisation, consultez notre article sur les catégories de templates WhatsApp.

Bonnes pratiques pour l'envoi de documents sensibles

Les documents CRM contiennent souvent des données confidentielles (données contractuelles, informations financières, données personnelles). Voici les précautions à prendre :

• URLs temporaires signées : ne générez pas d'URLs permanentes pour les documents sensibles. Utilisez des URLs signées avec expiration (ex. 1h) pour limiter l'exposition.
• Chiffrement en transit : WhatsApp chiffre les messages de bout en bout. Le document est chiffré entre le serveur WhatsApp et l'application du destinataire.
• Confirmation d'identité : vérifiez que le numéro WhatsApp dans le CRM correspond bien au contact attendu avant d'envoyer un document confidentiel.
• Log des envois : conservez un log horodaté de chaque document envoyé (quelle fiche CRM, quel numéro, quel document, statut de livraison) pour la traçabilité et la conformité.
• Hébergement EU : Whakup héberge son infrastructure en Europe, ce qui facilite la conformité RGPD pour les documents contenant des données personnelles.

Pour les éditeurs de CRM déployés chez plusieurs clients, l'architecture multi-tenant de Whakup permet d'isoler les flux d'envoi par compte, avec des numéros WhatsApp dédiés et des journaux séparés.

Intégration dans les flux commerciaux et support

Au-delà du simple envoi automatisé, l'API WhatsApp permet de construire des flux documentaires plus riches :

• Signature électronique : envoyez le contrat en PDF avec un bouton "Signer" renvoyant vers votre plateforme de signature (DocuSign, Yousign). Le statut de signature peut être récupéré et remonté dans le CRM.
• Validation de devis : incluez des boutons "Accepter le devis" / "Demander des modifications" directement dans le message WhatsApp. La réponse est captée par webhook et met à jour le statut de l'opportunité CRM.
• Partage de rapport mensuel : pour les clients SaaS, envoyez automatiquement le rapport d'activité mensuel en PDF via WhatsApp, avec un message personnalisé incluant les métriques clés.

Pour comparer les solutions disponibles sur le marché, notre guide sur le meilleur BSP WhatsApp en France détaille les critères techniques à évaluer.

FAQ

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

Non. L'API WhatsApp ne supporte qu'une seule pièce jointe par message. Pour envoyer plusieurs documents, envoyez plusieurs messages successifs dans la même conversation, en espaçant légèrement les envois (quelques secondes) pour respecter l'ordre de livraison.

Faut-il un template approuvé pour envoyer un document WhatsApp ?

Oui, si c'est l'entreprise qui initie la conversation. Un template avec media (document) doit être soumis à Meta pour approbation. Si la conversation est déjà ouverte (le contact a envoyé un message en premier dans les 24 dernières heures), vous pouvez envoyer le document sans template dans la fenêtre de session.

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

Whakup expose des webhooks pour trois statuts : message envoyé (sent), message livré sur l'appareil (delivered), message lu (read). Le statut "lu" confirme que le contact a ouvert la conversation et vu le message. En revanche, il ne confirme pas que le document PDF a été ouvert.

Quelle taille maximale pour un document PDF envoyé via WhatsApp ?

La limite est de 100 Mo par document. Pour les contrats et devis standard, cette limite n'est pas contraignante. Pour les présentations commerciales volumineuses, optimisez le PDF avant envoi (compression des images, suppression des polices embarquées inutiles).

---

Pour automatiser l'envoi de documents depuis votre CRM via WhatsApp, l'API WhatsApp Business de Whakup propose une API REST simple, des webhooks de statut en temps réel et une infrastructure hébergée en EU. Whakup est Meta Tech Provider certifié : la relation avec Meta est gérée pour vous.