Steg 2: anslut KlickTipp

Det här workflowet använder många KlickTipp-verktygsnoder för kontakt-, fält-, opt-in- och taggoperationer. Anslut autentiseringsuppgifter en gång och tillämpa dem på alla KlickTipp-verktyg.

1. Öppna valfri KlickTipp-verktygsnod, till exempel Fetch Contact Identifier.
2. Credential Required: anslut era klickTippApi-autentiseringsuppgifter.
3. Tillämpa samma klickTippApi-autentiseringsuppgifter på alla KlickTipp-verktygsnoder (20+ noder hanterar kontaktoperationer, taggar, fält och opt-in-processer).

Steg 3: konfigurera verktyg för datumkonvertering

Workflowet innehåller två kodverktyg för tidsstämpelkonvertering. Dessa exponeras som AI-verktyg på MCP Listener Trigger.

1. Öppna Convert Unix to Date och verifiera att fältet Code innehåller den angivna JavaScript-koden för att konvertera Unix-sekunder till dd.MM.yyyy HH:mm:ss ZZZ i Europe/Berlin.
2. Öppna Parse Date to Unix och verifiera att fältet Code innehåller den angivna JavaScript-koden för att tolka mänskligt läsbara datum till Unix-sekunder.
3. Lämna autentiseringsuppgifter tomma för dessa verktygsnoder; de körs lokalt som kodverktyg.

Steg 4: konfigurera kontaktoperationer

Dessa verktyg hanterar kontaktsökning, profilhämtning, skapa/uppdatera, uppdateringar, borttagning och avregistreringsåtgärder.

1. I Fetch Contact Identifier, behåll Resource som subscriber och Operation som search, med Email satt till ={{ $fromAI("email", "The contact's email address.", "string", "") }}.
2. I Retrieve Contact Profile, ställ in Resource till subscriber och Operation till get, med Subscriber ID satt till ={{ $fromAI("contactId", "The contact's ID", "string", "") }}.
3. I Upsert Contact Record, behåll Operation som subscribe och mappa fält med uttryck som ={{ $fromAI("fieldFirstName", "Contact’s first name.", "string", "") }} och ={{ $fromAI("fieldBirthday", "Unix seconds for the contact’s birthday — supply **only** when the user explicitly asks to set a birthday (keywords: birthday / birth date / set birthday). Otherwise leave undefined.", "number", undefined) ?? undefined }}.
4. I Modify Contact Details, behåll Operation som update och Subscriber ID satt till ={{ $fromAI("contactId", "The contact's ID.", "number", "") }}; säkerställ att fältmappningarna speglar ert önskade uppdateringsbeteende.
5. I Remove Contact Record och Disable Contact Messaging, bekräfta Operation-värdena delete respektive unsubscribe med lämpliga Email- eller Subscriber ID-uttryck.

Steg 5: konfigurera verktyg för taggar, fält och opt-in

Dessa verktyg hanterar taggar, taggning av kontakter, datafält och opt-in-processer, som alla exponeras via MCP-triggern.

1. För taggningsåtgärder, bekräfta att Apply Contact Tags använder ={{ JSON.parse($fromAI("tagIds","Return ONLY a JSON array of numeric tag IDs. Absolutely nothing else — no markdown, no back-ticks. Example: [12042204,12054769]","string")).map(Number) }} i Tag ID.
2. Använd Remove Contact Tags med Operation satt till untag och Tag ID satt till ={{ $fromAI("tagId", "The tag ID.", "number", "") }}.
3. För hantering av taggar, verifiera att Retrieve Tag List, Fetch Tag Details, Generate New Tag, Revise Tag och Remove Tag är konfigurerade med sina respektive operationer och uttryck.
4. För datafält, bekräfta att Retrieve Data Fields listar alla fält och att Fetch Data Field använder ={{ $fromAI("fieldId", "The data field ID.", "string", "") }}.
5. För opt-in-processer, använd Retrieve Opt-In Processes, Fetch Opt-In Process med ={{ $fromAI("optInId", "The opt-in process ID.", "number", "") }} och Fetch Redirect Link med ={{ $fromAI("email", "The contact's email address.", "string", "") }}.

Steg 6: testa och aktivera ert workflow

Verifiera MCP-verktygsanropen och aktivera sedan workflowet för produktionsbruk.

1. Klicka på Execute Workflow och använd er MCP-klient för att anropa ett verktyg (t.ex. Retrieve Tag List eller Fetch Contact Identifier).
2. Bekräfta att körningen lyckades genom att kontrollera nodens utdata för förväntad KlickTipp-svarspayload.
3. Om ett verktyg returnerar tom data, verifiera indatauttrycket (till exempel ={{ $fromAI("email", "The contact's email address.", "string", "") }}) och era KlickTipp-autentiseringsuppgifter.
4. Växla workflowet till Active för att tillåta MCP-anrop i produktion.