Fehlerbehebung
HubSpot-Datei-Links laufen nach 7 Tagen ab Neu
Problem: Datei-Links, die in deinen generierten PDFs eingebettet sind, funktionieren für die ersten 7 Tage, danach geben sie einen 404-Fehler oder eine "Zugriff verweigert"-Seite zurück. Das betrifft Dateien, die über Formular-Uploads an HubSpot-Datensätze angehängt wurden — zum Beispiel Dokumente, die Besucher über ein HubSpot-Formular hochgeladen haben.
Warum tritt das auf
HubSpot speichert über Formulare hochgeladene Dateien standardmäßig als privat. Private Dateien in HubSpot sind nur über signierte URLs erreichbar, die nach 7 Tagen ablaufen — das ist eine harte Grenze, die von HubSpots Plattform vorgegeben wird, nicht von PDF CreateMate.
Wenn PDF CreateMate ein PDF generiert, das eine HubSpot-Datei als klickbaren Link enthält, verwendet es die URL, die HubSpot zu diesem Zeitpunkt bereitstellt. Da diese URL ein eingebautes 7-Tage-Ablaufdatum hat, hört der Link im PDF auf zu funktionieren, sobald die URL abgelaufen ist.
Die gute Nachricht: Das lässt sich dauerhaft beheben, indem du die Sichtbarkeit der Datei in HubSpot änderst. Sobald eine Datei auf öffentlich gesetzt ist, stellt HubSpot sie über eine permanente URL bereit, die niemals abläuft. Jedes PDF, das danach für diese Datei generiert wird, hat dann einen permanent funktionierenden Link.
Die Lösung — Dateisichtbarkeit in HubSpot ändern
Das ist eine einmalige Aktion pro Datei, die du innerhalb von HubSpot durchführst:
- Navigiere in HubSpot zu Content → Datei-Manager.
- Finde die Datei (oder Dateien), die in deinem Template referenziert wird. Du kannst das Suchfeld oben verwenden, um sie nach Name oder ID zu finden.
- Setze den Haken neben jeder Datei, die du aktualisieren möchtest. Du kannst mehrere Dateien gleichzeitig auswählen.
- Klicke unten auf der Seite auf Dateisichtbarkeit ändern.
- Wähle im Seitenpanel, das sich öffnet, Öffentlich – noindex.
- Klicke auf Speichern.
Die Datei hat jetzt eine permanente URL. Du kannst das bestätigen, indem du:
- Die Datei in HubSpot öffnest — unter Zugriff und URLs sollte die Sichtbarkeit als Öffentlich – noindex angezeigt werden.
- Die Datei-URL in einem privaten/Inkognito-Browserfenster einfügst — sie sollte die Datei direkt laden, ohne zu einer HubSpot-Anmeldung weiterzuleiten.
Betroffene PDFs neu generieren
Um permanente Links in bestehende PDFs zu bekommen, musst du sie neu generieren, nachdem du die Dateisichtbarkeit geändert hast:
- Ändere die Sichtbarkeit der betroffenen Dateien in HubSpot (siehe Schritte oben).
- Generiere das PDF neu — entweder indem du:
- Den Dokumentengenerierungs-Workflow in HubSpot erneut auslöst, oder
- Das Dokument manuell aus PDF CreateMate erneut generierst.
- Das neu generierte PDF bettet die permanente URL anstelle der ablaufenden ein.
Wenn du viele PDFs neu generieren musst und Hilfe benötigst, wende dich an den Support — wir können bei der Massengenerierung helfen.
Wie du das in Zukunft verhinderst
Um dieses Problem mit zukünftigen Datei-Uploads zu vermeiden:
- Setze Dateien aus Formular-Uploads als Routine auf "Öffentlich – noindex". Ändere nach jeder Formular-Einreichung, bei der eine Datei hochgeladen wird, die Sichtbarkeit, bevor du PDFs generierst, die darauf verweisen.
- Oder lade Dateien außerhalb des Formular-Workflows hoch. Dateien, die direkt über HubSpots Datei-Manager (statt über ein Formular) hochgeladen werden, können von Anfang an mit öffentlicher Sichtbarkeit erstellt werden.
- Überprüfe die Dateisichtbarkeit, bevor du wichtige Dokumente generierst. Wenn ein PDF an externe Empfänger gesendet wird, die langfristigen Zugriff benötigen, stelle sicher, dass die verknüpften Dateien zuerst auf "Öffentlich – noindex" gesetzt sind.
Warum dies nicht allein durch PDF CreateMate behoben werden kann
Vielleicht fragst du dich, warum PDF CreateMate nicht einfach eine andere URL verwendet oder HubSpots Ablauf umgeht. Zwei Gründe:
- HubSpots API erlaubt es Drittanbietern (einschließlich PDF CreateMate) nicht, die Dateisichtbarkeit von Formular-Uploads zu ändern. Nur der HubSpot-Kontoinhaber kann das ändern, und zwar nur über HubSpots Web-Oberfläche.
- Private Dateien in HubSpot haben keine permanente URL. Die 7-Tage-signierte URL ist die langlebigste URL, die HubSpot für private Dateien anbietet. Jede dauerhafte Lösung erfordert, dass die Datei auf HubSpot-Seite öffentlich gemacht wird.