Een AI-assistent koppelen aan je account
Een AI-assistent kan twee dingen voor je doen met Laposta. Hij kan deze handleiding lezen en je vragen erover beantwoorden, en hij kan via de API daadwerkelijk in je account werken: relaties opzoeken en bijwerken, een campagne klaarzetten en resultaten uitrekenen.
Je account koppelen aan een assistent
Om een assistent in je account te laten werken, heb je een API-sleutel nodig. Wie die sleutel heeft, kan je hele relatiebestand lezen en namens jou verzenden. Een assistent met zo’n sleutel kan dus alles wat jij kunt. Behandel hem als een wachtwoord.
Maak een aparte sleutel voor je assistent, zodat je die kunt intrekken zonder dat je andere koppelingen stukgaan. Er is geen proefomgeving: elke aanroep raakt direct het echte account dat bij de sleutel hoort. Begin daarom op een testlijst met een handvol eigen adressen, niet op je echte bestand.
Koppelen met de Laposta-skill
Er bestaat een kant-en-klare skill die de hele API al kent: alle endpoints, de verplichte velden, de foutcodes en de valkuilen. Je hoeft niets uit te leggen en typt gewoon wat je wilt. In Claude Code installeer je de skill met twee regels. Hij werkt ook op claude.ai en in andere assistenten die de Agent Skills-standaard volgen.
De skill vraagt uit zichzelf om bevestiging voordat hij iets verwijdert, inplant of verstuurt. Ook stuurt hij altijd eerst een testmail en leest hij je sleutel uit de omgeving in plaats van uit het gesprek.
Zonder skill koppelen met ChatGPT
In ChatGPT maak je een eigen GPT met een Action en geef je het OpenAPI-schema van de Laposta-API mee. Dat schema staat in de API-referentie. ChatGPT stelt wel eisen: beschrijvingen mogen maximaal 300 tekens per endpoint zijn. OpenAI geeft zelf aan dat die grens kan veranderen, dus je kunt het schema het beste inkorten tot de endpoints die je echt gebruikt.
Bij een custom GPT is de sleutel gekoppeld aan de GPT en niet aan de gebruiker. Iedereen die zo’n GPT mag gebruiken, werkt dus in jouw account. Deel een GPT met je Laposta-sleutel nooit publiek.
Wat je aan de assistent kunt vragen
De API bestaat uit zeven onderdelen. Alle details staan in de API-referentie.
Je kunt deze onderdelen ook combineren. “Zoek in de resultaten van de laatste drie campagnes wie nooit heeft geopend, en zet die op een aparte lijst” is één zin voor jou en een reeks aanroepen voor de assistent.
Wat een assistent niet kan
Een assistent kan niet meer dan de API kan. De belangrijkste grenzen:
- Labels kan een assistent wel toekennen, maar niet zelf aanmaken. Labels staan in de API als een veld bij de relatie, en alleen labels die de lijst al heeft worden geaccepteerd. Een nieuw label kun je zelf aanmaken bij de lijst, via Relaties → je lijst → ‘Labels’.
- Campagnes uit de editor kun je niet vullen via de assistent. Een assistent kan wel de html plaatsen van een campagne die via de API of via een import is gemaakt, maar niet die van een campagne die je in de drag & drop-editor hebt gebouwd.
- Segmenten aanmaken lukt niet betrouwbaar. Uitlezen en hergebruiken gaat goed, maar een nieuwe segmentdefinitie samenstellen niet. Maak het segment in de app en laat de assistent het daarna gebruiken.
- Er geldt een limiet van 30 aanvragen per minuut op een gratis account en 120 op een betaald account. Bij grote hoeveelheden relaties duurt het dus even. Zie: Limieten en foutmeldingen van de API.
AI gebruiken in een automatiseringsplatform
Werk je liever met een vaste flow dan met een gesprek, dan kun je Laposta ook koppelen aan een automatiseringsplatform en daar een AI-stap tussen zetten. Denk aan een inschrijving die binnenkomt, een model dat de branche van het e-mailadres bepaalt, en Laposta die het resultaat in een veld zet.
Veilig werken met een assistent
Een assistent voert uit wat hij denkt dat je bedoelt. Dat gaat vrijwel altijd goed en soms niet, en bij het verzenden merk je het verschil pas achteraf.
Laat een assistent nooit zelfstandig verzenden. Een campagne die de deur uit is kun je niet terughalen, en een tweede poging stuurt hem nog een keer. Spreek af dat de assistent eerst een testmail stuurt, daarna vertelt hoeveel mensen het betreft, en pas verstuurt nadat jij dat bevestigt.
Spreek daarnaast het volgende af met je assistent:
- Verwijderen gebeurt alleen als je akkoord geeft. Dat geldt ook voor het leegmaken van een lijst en voor het weghalen van een veld, want daarmee verdwijnen de gegevens van al je relaties in dat veld.
- Afmelden is niet hetzelfde als verwijderen. “Haal Sanne van de nieuwsbrief” betekent meestal afmelden. Zeg welke van de twee je bedoelt.
- Vraag niet om het hele bestand. Relatiegegevens zijn persoonsgegevens. Laat de assistent alleen ophalen wat voor je vraag nodig is en niet meer.
- Trek de sleutel in als je klaar bent of als hij ergens terecht is gekomen waar hij niet hoort. Dat kun je zelf doen in je account.