Der zentrale Schlüssel ist das von MAPP bereitgestellte Segment-Schema. Es beschreibt, wie ein gültiger Segmentplan aufgebaut sein muss. Dadurch kann eine KI aus natürlicher Sprache einen technischen, API-fähigen Segmentplan erzeugen.
Segmentlogik war stark UI-getrieben. Die korrekte JSON-Struktur, Kriterien, Gruppen, Zeiträume und Operatoren manuell zu bauen war sehr komplex und fehleranfällig.
Das Schema gibt der KI die Regeln: erlaubte Felder, Pflichtfelder, gültige Werte und die Struktur für Gruppen und Kriterien.
Der Nutzer beschreibt den Wunsch im Chat. Die Demo baut den API-Plan, ruft MAPP auf und zeigt Ergebnis, Status, Selection Term ID und Count in Klartext.
„Erstelle ein Segment für Kontakte, die nie geöffnet oder geklickt haben.“
Die KI erkennt Zielgruppe, Zeitraum, Kriterien und gewünschte Aktion.
Aus Sprache entsteht ein schema-konformer JSON-Plan.
n8n führt die passenden MAPP API Calls aus und verarbeitet die Antwort.
Segment, Count, Details oder Fehler werden verständlich im Chat angezeigt.
Ein Segmentplan ist die technische Bauanleitung für ein MAPP Segment: Name, Gruppenlogik, Kriterien, Zeiträume, Operatoren und weitere Einstellungen.
n8n ist der Prozess-Motor zwischen Demo und MAPP API. Es nimmt den Plan entgegen, ruft die richtigen API-Endpunkte auf, behandelt Fehler und gibt eine saubere Antwort zurück.
Die Demo nutzt diese MAPP API Calls im Hintergrund. Kurz gesagt:
GET /segmentation/schemaLiefert das Schema. Das ist die Bauanleitung, mit der die KI gültige Segmentpläne erzeugen kann.POST /segmentation/createErstellt ein neues Segment bzw. einen neuen Segmentplan aus dem von der KI gebauten JSON.POST /segmentation/findSucht Segmente, z.B. nach Name, Status, Label, Datum, Creator oder Selection Term ID.GET /segmentation/getLädt ein einzelnes Segment mit allen Details und Selektionskriterien.GET /segmentation/previewZeigt eine reduzierte Vorschau des Segmentplans.GET /segmentation/getCountLiefert den aktuellen Count eines veröffentlichten Segments über die Selection Term ID.POST /segmentation/triggerCountStartet eine neue Count-Berechnung für ein veröffentlichtes Segment.PUT /segmentation/updateAktualisiert einen Segmentplan. Wichtig: Der ganze Plan wird überschrieben, deshalb vorher laden und gezielt ändern.POST /segmentation/publishVeröffentlicht ein Segment. Erst danach entsteht die Selection Term ID für UI-Suche und Count.DELETE /segmentation/deleteLöscht einen Segmentplan. Das ist destruktiv und sollte in der Demo nur bewusst genutzt werden.Mit dem neuen MAPP Segment-Schema wird eine vormals sehr komplexe API für KI nutzbar. Die Demo zeigt, wie aus natürlicher Sprache ein valider Segmentplan entsteht, der über n8n und die MAPP Segmentation API real ausgeführt wird.