Zum Inhalt

Was sind Magic Links?

Wenn du ein Business- oder Partnerkonto bei Kartensender hast, kannst du Magic Links verwenden, um deinen Kunden das Senden von Karten zu erleichtern.

Ein Magic Link ist ein spezieller URL-Link, der deine Kunden direkt zu einer vorgefertigten Karte führt. Wenn sie auf den Link klicken, wird die Karte automatisch in ihrem Browser geöffnet, und sie können sie mit nur wenigen Klicks senden.

Magic Links können alle Informationen enthalten, die zum Erstellen und Senden einer Karte erforderlich sind, einschließlich:

  • Empfängerinformationen (Name, Adresse)
  • Grußtext
  • Kartenbild
  • Gutscheincode

Sobald der Kunde auf den Link klickt, werden diese Informationen automatisch in die Postkarte eingefügt. Der Kunde muss dann nur noch die Karte überprüfen und den Versand bestätigen.

Um einen Magic Link zu erstellen, hast du zwei Möglichkeiten:

  1. Mit dem Magic Link Generator (empfohlen): Nutze unseren Magic Link Generator für eine einfache und benutzerfreundliche Erstellung.

  2. Manuell: Erstelle die URL selbst mit den gewünschten Parametern (siehe technische Details unten).

Wenn deine Kunden auf den Link klicken, wird die Karte automatisch mit den angegebenen Informationen vorausgefüllt.

Grundaufbau eines Magic Links:

https://ks-demo.neosw.de/studio/compose?
  pf_a1=<Name>&
  pf_a2=<Adresszusatz>&
  pf_a3=<Straße> <Hausnummer>&
  pf_a4=<PLZ> <Ort>&
  pf_a5=<Land>&
  pf_text=<Grußtext>

Alle Parameter werden als URL-Parameter (Query) übergeben. Hier sind die verfügbaren Parameter:

Paramter Beschreibung Pflichtfeld
pf_a1 Empfängername (1. Zeile) Ja*
pf_a2 Adresszusatz (2. Zeile) Nein
pf_a3 Straße und Hausnummer (3. Zeile) Ja*
pf_a4 Postleitzahl und Ort (4. Zeile) Ja*
pf_a5 Land (5. Zeile) Ja*
pf_text Grußtext für die Karte Nein
pf_image URL zum Kartenbild Nein
pf_voucher Gutscheincode Nein

URL-Encoding (*)

Bitte beachte, dass alle Parameter URL-kodiert sind, um Sonderzeichen korrekt zu übertragen.

Bei Empfängeradresse

Wenn eine Empfängeradresse angegeben wird, müssen alle pflichtigen Felder (pf_a1, pf_a3, pf_a4, pf_a5) ausgefüllt sein, oder gar keine.

Sicherheit und Datenschutz

Magic Links enthalten sensible Informationen wie Adressen und persönliche Nachrichten. Stelle sicher, dass du diese Links nur an vertrauenswürdige Personen weitergibst und sie nicht öffentlich zugänglich machst.

Beispiele

Mit Grußtext und vollständiger Adresse

https://ks-demo.neosw.de/studio/compose?
  pf_a1=Anna%20Schmidt&
  pf_a2=Wohnung%205&
  pf_a3=Beispielweg%2010&
  pf_a4=54321%20Beispielstadt&
  pf_a5=Deutschland&
  pf_text=Herzliche%20Grüße%20aus%20Berlin

Karte mit Grußtext und Adresse öffnen

Ohne Adresse, nur mit Motiv (von placedog.net)

https://ks-demo.neosw.de/studio/compose?
  pf_image=https://placedog.net/500/280?id=1&
  pf_text=Viel%20Spaß%20mit%20dieser%20süßen%20Hundekarte!

Karte mit Hundemotiv öffnen

Falls du einen Magic Link programmatisch aus deiner Anwendung heraus erstellen möchtest, findest du hier ein Beispiel in JavaScript, wie du eine solche Funktion implementieren könntest:

function createMagicLink({ name, addressExtra, street, postalCode, city, country, message, imageUrl, voucherCode }) {
  const baseUrl = "https://ks-demo.neosw.de/studio/compose";
  const params = new URLSearchParams();

  if (name) params.append("pf_a1", name);
  if (addressExtra) params.append("pf_a2", addressExtra);
  if (street) params.append("pf_a3", street);
  if (postalCode && city) params.append("pf_a4", `${postalCode} ${city}`);
  if (country) params.append("pf_a5", country);
  if (message) params.append("pf_text", message);
  if (imageUrl) params.append("pf_image", imageUrl);
  if (voucherCode) params.append("pf_voucher", voucherCode);

  return `${baseUrl}?${params.toString()}`;
}

Für eine einfache Erstellung von Magic Links steht dir unser Magic Link Generator zur Verfügung. Dieser ist direkt in deinem Kartensender integriert und ermöglicht es dir, Links mit nur wenigen Klicks zu erstellen.

Der Generator bietet folgende Vorteile:

  • Benutzerfreundliche Oberfläche: Keine manuelle URL-Kodierung erforderlich
  • Echtzeit-Vorschau: Sieh sofort, wie dein Magic Link aussehen wird
  • Validierung: Automatische Überprüfung der Pflichtfelder
  • Kopieren & Teilen: Magic Links mit einem Klick kopieren und weitergeben

Magic Link Generator öffnen

Empfehlung

Verwende den Magic Link Generator für eine schnelle und fehlerfreie Erstellung von Links. Für automatisierte Systeme oder Entwickler findest du weiter unten technische Details zur manuellen Erstellung.