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.

Emojis kannst du überall verwenden, wo Text gedruckt wird: in statischem Text, in Variablen wie {{first_name}} und in API-Markdown. PostPal druckt sie als farbige Google-Noto-Grafiken — in der Vorschau genauso wie im finalen Druck-PDF. Ein Emoji wird nie als Fragezeichen gedruckt.

Der Emoji-Bestand ist fest in PostPal hinterlegt und kann sehr neue Zeichen noch nicht enthalten. Deshalb wird ein noch nicht unterstütztes Zeichen bereits beim Speichern abgelehnt, wenn es in statischem Text oder im Markdown-Beispielinhalt steht — dort kannst du es direkt austauschen. Werte, die erst pro Empfänger über die API kommen, lassen sich beim Speichern nicht prüfen: Dort zeigt die Vorschau einen entsprechenden Hinweis, und beim Druck wird nur dieser eine Empfänger übersprungen und gemeldet, während alle übrigen normal gedruckt werden.

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.

Ein URL-QR mit fester Ziel-URL wird im Editor direkt als scanbarer QR-Code angezeigt, unabhängig davon, ob die allgemeine Vorschau ein- oder ausgeschaltet ist. URL-Vorlagen werden in der QR-Vorschau mit Beispieldaten aufgelöst. Über die QR-Vorschau kannst du die aktuell angezeigte Ziel-URL außerdem direkt öffnen.

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.