Postcard Studio

Das Postcard Studio ist der eingebaute Design-Editor von PostPal. Statt eine fertige Druckdatei hochzuladen, gestaltest du deine Postkarte direkt im Browser.

Was du im Studio gestaltest:

• Textfelder & Hintergrund der Postkarte. Textfelder können statischen Text und bei Bedarf Variablen wie {{first_name}} enthalten.
• API-Markdown für API-Flows, dessen Inhalt pro Empfänger über die API geliefert wird. Designs mit Markdown-Flächen stehen in normalen Kampagnen nicht zur Auswahl.
• QR-Codes als URL-QR oder API-QR. URL-QRs speichern ihre Ziel-URL im Design; API-QRs definieren API-Feldnamen, deren Werte pro API-Request über qr_codes geliefert werden.
• Linien und einfache Layout-Elemente.

Dein hochgeladenes Design bleibt unverändert. Über Text fügst du nur Inhalte hinzu, die über dem Design liegen oder sich je Empfänger ändern sollen.

Das Studio ist formatbewusst: Es kennt Beschnitt, Adress-Zone und ob ein Format zweiseitig ist, und prüft dein Layout gegen die Druckvorgaben. So landet kein Element in einer unzulässigen Zone, und dein Design bleibt sauber druckbar. Alternativ kannst du weiterhin eine fertige Druckdatei hochladen.

API-Markdown zeigt im Editor einen gespeicherten Beispielinhalt. Dieser Beispieltext hilft nur bei Layout und Vorschau; er wird nicht als Fallback für echte API-Aussendungen verwendet. Der echte Markdown-Inhalt muss beim Versand über den passenden content-Schlüssel der API kommen. Studio-Variablen wie {{first_name}} sind in Markdown-Flächen nicht erlaubt.

Beim Hinzufügen eines QR-Codes wählst du zwischen URL-QR und API-QR. Ein URL-QR ist für CSV, Klaviyo, feste Links oder URL-Vorlagen gedacht; seine Ziel-URL liegt im Design und kann bekannte Platzhalter wie {{voucher_code_1}} enthalten. Ein API-QR ist für API-Flows gedacht. Er erhält einen eigenen API-Feldnamen, und der QR-Inhalt wird exakt auf den Platzhalter dieses Feldnamens gesetzt, zum Beispiel {{voucher_url_1}}. Der echte Wert kommt später pro Empfänger über den passenden qr_codes-Schlüssel der API und muss eine vollständige HTTP(S)-URL sein. Mehrere neu eingefügte API-QRs werden im Studio automatisch durchnummeriert, zum Beispiel voucher_url_1, voucher_url_2.

Wenn dein Design API-Markdown-Flächen oder API-QRs enthält, kannst du im Studio über API-Beispiel einen aktuellen Beispiel-Payload und einen passenden cURL-Aufruf erzeugen. Die Ausgabe übernimmt die API-Feldnamen und Markdown-Beispielinhalte aus dem aktuellen Editor-Stand. Die Flow-ID, der API-Token und der Idempotency-Key sind bewusst nur Platzhalter. URL-QRs und andere nicht API-gebundene Elemente werden nicht als dynamische API-Felder ausgegeben.