· 5 min · TextMeFlow Team

Envoyer photos, factures et PDF par WhatsApp via API

La plupart des guides sur l'API WhatsApp s'arrêtent au texte brut. Pourtant, bon nombre des automatisations vraiment utiles pour les entreprises — factures, photos « votre voiture est prête », confirmations de réservation avec un itinéraire en pièce jointe — nécessitent un fichier, pas seulement une phrase. Voici comment envoyer des messages avec média via TextMeFlow, et les points d'attention.

Le seul champ dont vous avez besoin

Le endpoint POST /v1/messages de TextMeFlow accepte un message texte classique. Pour en faire un message avec média, ajoutez un seul champ : media_url.

curl -X POST https://api.textmeflow.eu/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+32470000000",
    "text": "Votre facture de juillet est jointe à ce message.",
    "media_url": "https://example.com/invoices/2026-07.pdf"
  }'

Il n'y a pas d'étape d'upload distincte ni de formulaire multipart. Vous hébergez le fichier à un endroit accessible en HTTPS, vous transmettez l'URL, et TextMeFlow le récupère et le remet via WhatsApp. Le champ text devient la légende affichée avec le fichier.

Si vous envoyez déjà des messages texte depuis PHP, Python ou Node.js, ajouter un média revient à modifier une seule ligne — consultez les exemples de code pour ces trois langages si vous n'avez pas encore mis en place l'appel de base.

Ce qui s'affiche comment

WhatsApp choisit l'affichage d'après le type de contenu du fichier, pas son extension :

  • Images (JPEG, PNG, WebP) — affichées directement comme une photo, avec votre texte en légende
  • Vidéo (MP4) — directement lisible, avec légende
  • Audio (MP3, OGG) — un lecteur de type message vocal
  • Tout le reste (PDF, DOCX, XLSX, ZIP, …) — une pièce jointe de type document, avec son nom de fichier

Cette dernière catégorie est celle que la plupart des flux professionnels utilisent réellement : factures PDF, contrats signés, tableurs, cartes d'embarquement. Inutile de choisir un « type de message » à l'avance : pointez simplement vers le fichier et TextMeFlow s'occupe du reste.

Où héberger le fichier

L'URL doit être publique en HTTPS et faire moins de 2 000 caractères. Elle n'a toutefois pas besoin de rester publique indéfiniment. Les URL signées à courte durée de vie fonctionnent très bien et constituent l'approche recommandée pour tout ce qui est privé :

  • URL présignées S3 ou GCS avec une courte expiration
  • Routes signées Laravel (URL::temporarySignedRoute(...))
  • L'équivalent, dans n'importe quel framework, d'un lien temporaire et infalsifiable

C'est important si le fichier est une facture client ou un document contenant des données personnelles : vous ne voulez pas qu'il reste indéfiniment sur une URL publique permanente. Générez le lien juste avant l'envoi, avec une expiration de quelques heures, et vous êtes couvert.

Limites et quota

Trois chiffres à garder en tête :

  • 100 Mo de taille de fichier maximale
  • Un message avec média compte pour un seul message sur votre quota mensuel — comme un texte simple, sans multiplicateur
  • Les limites de débit par numéro s'appliquent sans changement : 1 message/seconde, 60/minute, 1 000/heure

Joindre un PDF à un message de confirmation ne vous coûte donc rien de plus en quota : cela reste un seul envoi.

Des schémas pratiques à reprendre

Quelques mises en place réelles qui s'y adaptent directement :

  • Systèmes de facturation — générez la facture PDF, déposez-la dans un bucket, obtenez une URL présignée, appelez l'API. Fonctionne de la même façon depuis une tâche cron que depuis un webhook déclenché par un événement de paiement.
  • Garages — un mécanicien prend en photo la réparation terminée avec son téléphone, un outil interne la téléverse et déclenche l'appel API avec text: "Votre voiture est prête à être récupérée".
  • Réservations et hôtellerie — envoyez l'itinéraire ou les instructions du code de la porte en PDF avec le texte de confirmation, au lieu de faire fouiller les clients dans leur boîte mail.
  • Boutiques en ligne — joignez une photo du produit à un message de suivi de commande pour que le client confirme qu'il s'agit du bon article avant l'expédition.

Tout cela fonctionne aussi depuis des outils no-code — le module HTTP de Make.com, n8n ou Zapier n'a besoin que du champ supplémentaire media_url dans le corps JSON, sans autre configuration.

Gérer le statut de livraison

Les messages avec média passent par les mêmes événements webhook de livraison que les messages texte — sent, delivered, read, failed. Si vous construisez quelque chose qui réagit à ces événements (par exemple relancer l'envoi d'une facture échouée), vérifiez d'abord correctement la signature du webhook ; consultez le guide de vérification des signatures webhook HMAC pour éviter de traiter des événements usurpés ou en double.

À vous de jouer

La référence complète et la liste des champs se trouvent dans la documentation sur les médias. Si vous voulez tester dès aujourd'hui sur un vrai numéro, le forfait gratuit comprend 50 messages par mois — de quoi mettre en place un flux de facture ou de confirmation par photo et le voir fonctionner avant de vous engager sur un forfait payant.

Envie d'envoyer des messages WhatsApp via API ?

Gratuit pour toujours jusqu'à 50 messages/mois. Scannez un QR et envoyez votre premier message en 5 minutes.

Gratuit pour toujours