Newsletter-Kontakte über die Kontakte-API anbinden

Vorher nötig

• Die Rolle Leitung
• Der Bereich Newsletter ist eingeschaltet. Ohne ihn nimmt die API nichts an.
• Ein Entwickler oder eine Agentur, die die Anbindung baut. Die API ist für deren Server gedacht, nicht für Code im Browser.

Einen Zugang anlegen

1. 1

   Öffnen Sie Einrichtung › Verbindungen › Kontakte-API.

2. 2

   Geben Sie unter Neuer Zugang einen Namen ein und klicken Sie auf Anlegen.

   Legen Sie je Anbindung einen eigenen Zugang an. Ein Widerruf trifft dann nur diese eine.

3. 3

   Kopieren Sie die Marke und geben Sie sie auf sicherem Weg weiter.

   Diese Marke legt Kontakte an und löst Mails aus. Sie gilt nur für die Kontakte-API, eine Marke der Website-API funktioniert hier nicht.

4. 4

   Schicken Sie die Endpunkte mit.

   Sie stehen unter Endpunkte & Dokumentation, dazu eine Beispiel-Anfrage mit der Marke als Platzhalter.

Wie eine Anmeldung wirksam wird

Ohne weitere Angabe schickt HANS dem Kontakt die Bestätigungsmail, wie beim Newsletter-Widget. Erst sein Klick macht die Anmeldung wirksam. Bis dahin legt HANS für eine neue Adresse nichts an.

Kann Ihr Haus die Einwilligung schon belegen, etwa aus dem Meldeschein mit Unterschrift, schalten Sie Bestätigte Kontakte annehmen ein. Dabei bestätigen Sie, dass Sie den Nachweis vorlegen können. Die Anbindung schickt dann Zeitpunkt und Quelle der Einwilligung mit, und HANS verschickt keine Bestätigungsmail.

Viele Kontakte auf einmal, bis zu 500 je Aufruf, nimmt HANS nur mit Nachweis an oder als reine Aktualisierung der Stammdaten. An einen ganzen Bestand verschickt HANS nie auf einen Schlag Bestätigungsmails.

Aufenthalte aus Ihrem PMS mitschicken

Die Anbindung kann zu jedem Kontakt mitschicken, wie oft er bei Ihnen war, wie viele Nächte, wann zuletzt und wann er wiederkommt. Dann wählen Sie für eine Kampagne gezielt Stammgäste oder Gäste, die seit einem Jahr nicht mehr da waren.

Wer laut Ihrem PMS gerade im Haus ist oder in den nächsten Tagen anreist, bekommt keine Kampagne. Wie viele Tage, stellen Sie bei den Empfängern der Kampagne ein.

Hat Ihr Haus auch Aufenthalte in HANS, zählt HANS nichts doppelt. Für jeden Wert gilt die größere Zahl bzw. das jüngere Datum.

Stichworte mitschicken

Ihre Anbindung kann jedem Kontakt Stichworte mitgeben, etwa „Deutschland“ oder „Stammgast“. Unbekannte Stichworte legt HANS an. Ein Aufruf fügt nur hinzu und nimmt nie eines weg. Entfernen geht in HANS unter Newsletter › Kontakte.

Was HANS dabei schützt

• Eine Adresse auf der Sperrliste bekommt keine Mail. Nach einem Bounce, einer Spam-Meldung oder einer Sperre von Hand bleibt sie gesperrt.
• Hat sich jemand abgemeldet, hebt nur ein neuer Klick in einer Bestätigungsmail die Abmeldung auf.
• Jede Adresse bekommt höchstens eine Bestätigungsmail in 24 Stunden. Über die API verschickt Ihr Haus höchstens 200 am Tag.
• Rollenadressen wie info@ und Wegwerf-Adressen weist HANS ab.

Abmeldungen zurückmelden

Meldet sich ein Kontakt in HANS ab, soll auch das andere System das erfahren. Sonst schickt es den Kontakt beim nächsten Abgleich wieder. Dafür richten Sie die HANS mit Zapier, Make oder n8n verbinden mit den Ereignissen Kontakt abgemeldet und Kontakt angemeldet ein. Schalten Sie dort Gästedaten mitsenden ein, sonst fehlt die E-Mail-Adresse.

Wenn es nicht klappt