Dokumentation
Medien senden
Fotos, Videos, Audio und Dokumente bis zu 100 MB pro Nachricht. Es gibt keinen separaten Upload-Schritt: Du übergibst eine URL, TextMeFlow holt die Datei und stellt sie via WhatsApp zu.
1. Ein zusätzliches Feld
Füge media_url zu einem normalen POST /v1/messages-Call hinzu. Der text wird zur Caption:
POST https://api.textmeflow.eu/v1/messages
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"to": "+32470000000",
"text": "Your invoice for July is attached.",
"media_url": "https://example.com/invoices/2026-07.pdf"
}
Die URL muss öffentlich über HTTPS erreichbar sein (max. 2.000 Zeichen). Signierte, kurzlebige URLs — S3 Presigned Links, Laravel Signed Routes — funktionieren problemlos und sind der empfohlene Weg, private Dateien zu teilen.
2. Was wird wie dargestellt
- Bilder (JPEG, PNG, WebP) — Inline-Foto mit deinem Text als Caption
- Video (MP4) — direkt abspielbares Video mit Caption
- Audio (MP3, OGG) — Player im Sprachnotiz-Stil
- Alles andere (PDF, DOCX, XLSX, ZIP, …) — Dokument-Anhang mit Dateiname
Der Typ wird aus dem Content-Type der Datei abgeleitet. Eine PDF-Rechnung, ein Foto einer fertigen Reparatur, eine PDF-Bordkarte — alles läuft über dasselbe Feld.
3. Limits und Quota-Anrechnung
- Maximale Dateigröße: 100 MB
- Eine Media-Nachricht zählt als eine Nachricht gegen dein Monatskontingent — genau wie reiner Text
- Rate-Limits pro Nummer gelten unverändert (1 Nachricht/Sek., 60/Min., 1.000/Stunde)
4. Häufige Anwendungsfälle
- Rechnungen und Belege als PDF direkt aus deinem Abrechnungssystem
- „Dein Auto ist fertig"-Fotos aus einem Werkstatt-Workflow
- Buchungsbestätigungen mit PDF-Reiseplan oder Türcode-Anweisungen
- Produktfotos in Bestellupdates aus einem Webshop
All das funktioniert auch aus No-Code-Tools — die HTTP-Module von Make.com, n8n und Zapier fügen einfach das zusätzliche JSON-Feld hinzu. Siehe Integrationen für fertige Beispiele.
Kurz gesagt
Hoste die Datei auf einer HTTPS-URL, füge media_url zu deiner Nachricht hinzu, fertig. Bis zu 100 MB, zählt als eine Nachricht. Probier es im Gratis-Plan.