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.