WhatsApp-Nachricht mit Foto oder PDF senden per API
Die meisten Anleitungen zur WhatsApp-API hören bei reinem Text auf. Aber viele der nützlichen Automatisierungen, die Unternehmen wirklich wollen — Rechnungen, „Dein Auto ist fertig“-Fotos, Buchungsbestätigungen mit angehängtem Reiseplan — brauchen eine Datei, nicht nur einen Satz. So sendest du Medien-Nachrichten mit TextMeFlow und worauf du achten solltest.
Das eine Feld, das du brauchst
Der Endpunkt POST /v1/messages von TextMeFlow akzeptiert eine normale Textnachricht. Um daraus eine Medien-Nachricht zu machen, fügst du ein einziges Feld hinzu: 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": "Deine Rechnung für Juli ist angehängt.",
"media_url": "https://example.com/invoices/2026-07.pdf"
}'
Es gibt keinen separaten Upload-Schritt und keine Multipart-Formulardaten. Du hostest die Datei irgendwo per HTTPS erreichbar, gibst die URL mit, und TextMeFlow holt sie ab und stellt sie über WhatsApp zu. Das Feld text wird zur Bildunterschrift, die zur Datei angezeigt wird.
Wenn du bereits Textnachrichten aus PHP, Python oder Node.js sendest, ist das Hinzufügen von Medien eine Änderung von einer Zeile — sieh dir die Codebeispiele für diese drei Sprachen an, falls du den Basisaufruf noch nicht eingerichtet hast.
Was wie dargestellt wird
WhatsApp wählt die Darstellung anhand des Content-Types der Datei, nicht anhand der Endung:
- Bilder (JPEG, PNG, WebP) — inline als Foto angezeigt, mit deinem Text als Bildunterschrift
- Video (MP4) — inline, abspielbar, mit Bildunterschrift
- Audio (MP3, OGG) — ein Player im Stil einer Sprachnachricht
- Alles andere (PDF, DOCX, XLSX, ZIP, …) — ein Dokumentanhang mit Dateinamen
Die letzte Kategorie nutzen die meisten Business-Workflows tatsächlich: PDF-Rechnungen, unterschriebene Verträge, Tabellen, Bordkarten. Du musst vorab keinen „Nachrichtentyp“ wählen — zeig einfach auf die Datei, und TextMeFlow erledigt den Rest.
Wo du die Datei hostest
Die URL muss öffentlich per HTTPS erreichbar sein und unter 2.000 Zeichen lang. Sie muss aber nicht für immer öffentlich bleiben. Signierte, kurzlebige URLs funktionieren problemlos und sind der empfohlene Weg für alles Private:
- S3- oder GCS-Presigned-URLs mit kurzer Gültigkeit
- Laravel Signed Routes (
URL::temporarySignedRoute(...)) - Das Äquivalent in jedem Framework: ein zeitlich begrenzter, manipulationssicherer Link
Das ist wichtig, wenn die Datei eine Kundenrechnung ist oder ein Dokument mit personenbezogenen Daten — du willst nicht, dass sie unbefristet unter einer dauerhaft öffentlichen URL liegt. Erzeuge den Link direkt vor dem Senden mit einer Gültigkeit von ein paar Stunden, dann bist du auf der sicheren Seite.
Limits und Kontingent
Drei Zahlen, die du im Kopf behalten solltest:
- 100 MB maximale Dateigröße
- Eine Medien-Nachricht zählt als eine Nachricht auf dein monatliches Kontingent — genau wie reiner Text, ohne Multiplikator
- Die Rate Limits pro Nummer gelten unverändert: 1 Nachricht/Sekunde, 60/Minute, 1.000/Stunde
Ein PDF an eine Bestätigungsnachricht zu hängen kostet dich also kein zusätzliches Kontingent — es bleibt ein einziger Versand.
Praxismuster zum Abschauen
Ein paar reale Setups, die sich direkt darauf abbilden lassen:
- Abrechnungssysteme — die PDF-Rechnung erzeugen, in einen Bucket hochladen, eine Presigned-URL holen, die API aufrufen. Funktioniert aus einem Cronjob genauso wie aus einem Webhook, der durch ein Zahlungsereignis ausgelöst wird.
- Werkstätten — ein Mechaniker macht mit dem Handy ein Foto der fertigen Reparatur, ein internes Tool lädt es hoch und löst den API-Aufruf mit
text: "Dein Auto ist abholbereit"aus. - Buchungen und Gastgewerbe — schicke den Reiseplan oder die Türcode-Anleitung als PDF zusammen mit dem Bestätigungstext mit, statt Gäste im Postfach suchen zu lassen.
- Webshops — hänge ein Produktfoto an eine Bestellstatus-Nachricht, damit Kunden bestätigen können, dass es der richtige Artikel ist, bevor er versendet wird.
All das funktioniert auch mit No-Code-Tools — das HTTP-Modul von Make.com, n8n oder Zapier braucht nur das zusätzliche Feld media_url im JSON-Body, ohne anderes Setup.
Zustellstatus verarbeiten
Medien-Nachrichten durchlaufen dieselben Webhook-Zustellereignisse wie Textnachrichten — sent, delivered, read, failed. Wenn du etwas baust, das auf diese Events reagiert (etwa einen fehlgeschlagenen Rechnungsversand erneut versuchen), stelle zuerst sicher, dass du die Webhook-Signatur korrekt prüfst; die Anleitung zur Prüfung von HMAC-Webhook-Signaturen zeigt, wie du gefälschte oder doppelte Events vermeidest.
Probier es aus
Die vollständige Referenz und die Feldliste findest du in den Medien-Docs. Wenn du das heute noch mit einer echten Nummer testen willst: Der Gratis-Tarif enthält 50 Nachrichten pro Monat — genug, um einen Rechnungs- oder Foto-Bestätigungs-Flow aufzubauen und funktionieren zu sehen, bevor du dich auf etwas Kostenpflichtiges festlegst.
Selbst WhatsApp-Nachrichten per API senden?
Für immer gratis bis 50 Nachrichten/Monat. QR scannen und in 5 Minuten die erste Nachricht senden.
Für immer gratis