> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.laposta.org/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.laposta.org/_mcp/server.

# Een AI-assistent koppelen aan je account

> Laat een AI-assistent via de API veilig werken in je lijsten en campagnes.

Een AI-assistent kan twee dingen voor je doen met Laposta. Hij kan [deze handleiding lezen](/handleiding-als-ai-bron-gebruiken) en je vragen erover beantwoorden, en hij kan via [de API](/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](/hoe-kom-ik-aan-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.

> **Warning**
>
> 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.

#### [De Laposta-skill installeren voor je AI-assistent](/de-laposta-skill)

Hoe je de skill per programma installeert, je sleutel meegeeft en wat de skill zelf controleert.

### 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](/api). 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.

> **Warning**
>
> 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](/api).

| Onderdeel  | Wat de assistent ermee kan                                | Voorbeeldopdracht                                                     |
| ---------- | --------------------------------------------------------- | --------------------------------------------------------------------- |
| Lijsten    | Aanmaken, bekijken, leegmaken, verwijderen                | "Hoeveel actieve relaties staan er in elk van mijn lijsten?"          |
| Velden     | Extra velden aanmaken en aanpassen                        | "Voeg een veld Klantnummer toe aan de nieuwsbrieflijst."              |
| Relaties   | Toevoegen, bijwerken, opzoeken, afmelden, labelen         | "Zet deze twaalf adressen erbij, met de voornaam in het juiste veld." |
| Segmenten  | Uitlezen en hergebruiken                                  | "Welke segmenten heb ik, en wat selecteren ze?"                       |
| Campagnes  | Aanmaken, vullen met html, testmail, inplannen, versturen | "Maak een campagne van dit bestand en stuur mij een test."            |
| Resultaten | Openingen, kliks en afmeldingen opvragen                  | "Vergelijk de open- en klikratio van mijn laatste vijf campagnes."    |
| Webhooks   | Aanmaken, bekijken, verwijderen                           | "Laat mijn webshop weten wanneer iemand zich aanmeldt."               |

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](/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](/api-limieten-en-foutmeldingen).

## 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.

#### [Zapier koppelen](/zelf-een-zapier-koppeling-een-zap-maken)

Zapier heeft een kant-en-klare Laposta-app met triggers en acties.

#### [Automatiseringsplatform kiezen](/pabbly-connect)

De platforms met een voorbereide Laposta-integratie naast elkaar.

#### [API gebruiken voor koppelingen](/wat-is-een-api)

Wat een API is, wat je ermee kunt koppelen en waar je de sleutel en de documentatie vindt.

#### [Een webhook naar een extern systeem versturen](/automation-bouwstuk-webhook)

Andersom kan ook: een automation in Laposta start een flow bij het platform.

## 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.

> **Warning**
>
> 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.

## Gerelateerde artikelen

#### [De Laposta API](/api)

Koppel Laposta aan je eigen software: relaties synchroniseren, campagnes versturen en…

#### [Een API-sleutel aanmaken](/hoe-kom-ik-aan-een-api-sleutel)

Je kunt je API-sleutels aanmaken en beheren op de pagina Koppelingen. Let op: een…

#### [Wat kan de helpdesk-chatbot van Laposta?](/de-helpdesk-chatbot-van-laposta)

Stel direct je vragen over het gebruik van het programma op de website, in de…

#### [Zapier koppelen aan Laposta](/zelf-een-zapier-koppeling-een-zap-maken)

Koppel Laposta zonder programmeerkennis aan duizenden andere applicaties voor…