Einen KI-Assistenten mit Ihrem Konto verbinden

Ein KI-Assistent kann mit Laposta zwei Dinge für Sie tun. Er kann diese Anleitung lesen und Ihre Fragen dazu beantworten, und er kann über die API direkt in Ihrem Konto arbeiten: Abonnenten suchen und aktualisieren, eine Kampagne vorbereiten und Ergebnisse berechnen.

Ihr Konto mit einem Assistenten verbinden

Damit ein Assistent in Ihrem Konto arbeiten kann, benötigen Sie einen API-Schlüssel. Wer diesen Schlüssel besitzt, kann Ihren gesamten Abonnentenbestand lesen und in Ihrem Namen E-Mails versenden. Ein Assistent mit einem solchen Schlüssel kann also alles, was Sie auch können. Behandeln Sie ihn wie ein Passwort.

Erstellen Sie einen separaten Schlüssel für Ihren Assistenten, damit Sie diesen widerrufen können, ohne dass Ihre anderen Verbindungen unterbrochen werden. Es gibt keine Testumgebung: Jeder Aufruf wirkt sich direkt auf das echte Konto aus, das zu dem Schlüssel gehört. Beginnen Sie daher mit einer Testliste mit einer Handvoll eigener E-Mail-Adressen und nicht mit Ihrem echten Bestand.

Verbinden mit dem Laposta-Skill

Es gibt einen fertigen Skill, der die gesamte API bereits kennt: alle Endpoints, die Pflichtfelder, die Fehlercodes und die Fallstricke. Sie müssen nichts erklären und tippen einfach ein, was Sie möchten. In Claude Code installieren Sie den Skill mit zwei Zeilen. Er funktioniert auch auf claude.ai und in anderen Assistenten, die dem Agent-Skills-Standard folgen.

Der Skill bittet von sich aus um Bestätigung, bevor er etwas löscht, einplant oder versendet. Außerdem sendet er immer zuerst eine Test-E-Mail und liest Ihren Schlüssel aus der Umgebung statt aus dem Gespräch aus.

Den Laposta-Skill für Ihren KI-Assistenten installieren

Wie Sie den Skill je nach Programm installieren, Ihren Schlüssel übergeben und was der Skill selbst überprüft.

Ohne Skill mit ChatGPT verbinden

In ChatGPT erstellen Sie einen eigenen GPT mit einer Action und übergeben das OpenAPI-Schema der Laposta-API. Dieses Schema finden Sie in der API-Referenz. ChatGPT stellt jedoch Anforderungen: Beschreibungen dürfen maximal 300 Zeichen pro Endpoint lang sein. OpenAI gibt selbst an, dass sich diese Grenze ändern kann. Kürzen Sie das Schema daher am besten auf die Endpoints, die Sie wirklich nutzen.

Bei einem Custom GPT ist der Schlüssel an den GPT gebunden und nicht an den Benutzer. Jeder, der einen solchen GPT nutzen darf, arbeitet also in Ihrem Konto. Teilen Sie einen GPT mit Ihrem Laposta-Schlüssel niemals öffentlich.

Was Sie den Assistenten fragen können

Die API besteht aus sieben Bereichen. Alle Details finden Sie in der API-Referenz.

Bereich	Was der Assistent damit tun kann	Beispielauftrag
Listen	Erstellen, ansehen, leeren, löschen	„Wie viele aktive Abonnenten sind in jeder meiner Listen?“
Felder	Zusätzliche Felder erstellen und bearbeiten	„Füge der Newsletter-Liste ein Feld Kundennummer hinzu.“
Abonnenten	Hinzufügen, aktualisieren, suchen, abmelden, mit Labels versehen	„Füge diese zwölf E-Mail-Adressen hinzu, mit dem Vornamen im richtigen Feld.“
Segmente	Auslesen und wiederverwenden	„Welche Segmente habe ich und was wählen sie aus?“
Kampagnen	Erstellen, mit HTML füllen, Test-E-Mail, einplanen, versenden	„Erstelle eine Kampagne aus dieser Datei und schicke mir einen Test.“
Ergebnisse	Öffnungen, Klicks und Abmeldungen abrufen	„Vergleiche die Öffnungs- und Klickrate meiner letzten fünf Kampagnen.“
Webhooks	Erstellen, ansehen, löschen	„Informiere meinen Webshop, wenn sich jemand anmeldet.“

Sie können diese Bereiche auch kombinieren. „Suche in den Ergebnissen der letzten drei Kampagnen, wer nie geöffnet hat, und setze diese Personen auf eine separate Liste“ ist ein einziger Satz für Sie und eine Reihe von Aufrufen für den Assistenten.

Was ein Assistent nicht kann

Ein Assistent kann nicht mehr als die API. Die wichtigsten Grenzen:

Labels kann ein Assistent zwar zuweisen, aber nicht selbst erstellen. Labels stehen in der API als Feld beim Abonnenten, und es werden nur Labels akzeptiert, die in der Liste bereits vorhanden sind. Ein neues Label können Sie selbst bei der Liste erstellen, über Abonnenten → Ihre Liste → „Labels“.
Kampagnen aus dem Editor können Sie nicht über den Assistenten füllen. Ein Assistent kann zwar den HTML-Code einer Kampagne einfügen, die über die API oder über einen Import erstellt wurde, aber nicht den einer Kampagne, die Sie im Drag-and-Drop-Editor gebaut haben.
Segmente zu erstellen gelingt nicht zuverlässig. Das Auslesen und Wiederverwenden funktioniert gut, das Zusammenstellen einer neuen Segmentdefinition jedoch nicht. Erstellen Sie das Segment in der App und lassen Sie den Assistenten es anschließend verwenden.
Es gilt ein Limit von 30 Anfragen pro Minute bei einem kostenlosen Konto und 120 bei einem bezahlten Konto. Bei großen Mengen an Abonnenten dauert es also einen Moment. Siehe: Limits und Fehlermeldungen der API.

KI in einer Automatisierungsplattform nutzen

Wenn Sie lieber mit einem festen Flow als mit einem Gespräch arbeiten, können Sie Laposta auch mit einer Automatisierungsplattform verbinden und dort einen KI-Schritt dazwischenschalten. Denken Sie etwa an eine eingehende Anmeldung, ein Modell, das die Branche anhand der E-Mail-Adresse bestimmt, und Laposta, das das Ergebnis in ein Feld einträgt.

Zapier verbinden

Zapier verfügt über eine fertige Laposta-App mit Triggern und Aktionen.

Automatisierungsplattform wählen

Die Plattformen mit einer vorbereiteten Laposta-Integration im Vergleich.

API für Verbindungen nutzen

Was eine API ist, was Sie damit verbinden können und wo Sie den Schlüssel und die Dokumentation finden.

Einen Webhook an ein externes System senden

Umgekehrt geht es auch: Eine Automatisierung in Laposta startet einen Flow bei der Plattform.

Sicher arbeiten mit einem Assistenten

Ein Assistent führt aus, was Sie seiner Meinung nach meinen. Das geht fast immer gut und manchmal nicht, und beim Versenden bemerken Sie den Unterschied erst im Nachhinein.

Lassen Sie einen Assistenten niemals selbstständig versenden. Eine Kampagne, die einmal raus ist, können Sie nicht zurückholen, und ein zweiter Versuch sendet sie noch einmal. Vereinbaren Sie, dass der Assistent zuerst eine Test-E-Mail sendet, danach mitteilt, wie viele Personen betroffen sind, und erst versendet, nachdem Sie dies bestätigt haben.

Vereinbaren Sie darüber hinaus Folgendes mit Ihrem Assistenten:

Gelöscht wird nur nach Ihrer Zustimmung. Das gilt auch für das Leeren einer Liste und das Entfernen eines Feldes, denn damit verschwinden die Daten all Ihrer Abonnenten in diesem Feld.
Abmelden ist nicht dasselbe wie Löschen. „Nimm Sanne aus dem Newsletter“ bedeutet meistens Abmelden. Sagen Sie, was von beidem Sie meinen.
Fragen Sie nicht nach dem gesamten Bestand. Abonnentendaten sind personenbezogene Daten. Lassen Sie den Assistenten nur das abrufen, was für Ihre Frage nötig ist, und nicht mehr.
Widerrufen Sie den Schlüssel, wenn Sie fertig sind oder wenn er irgendwo gelandet ist, wo er nicht hingehört. Das können Sie selbst in Ihrem Konto erledigen.