✅ Nieuw platform toevoegen — Checklist

• Domein gekocht en bij OVH geregistreerd? (anders DNS handmatig regelen)
• Brand-kleur + tagline bepaald
• Heb je toegang tot het platform om webhook-events terug te sturen? (optioneel, voor self-learning loop)

• Run het add-domain script:
  

  node /home/jojo/mailplatform/scripts/add-domain.cjs \
    nieuwplatform.nl NieuwPlatform "#3498db" "#3498db" "#2980b9" \
    "Wat het platform doet in 1 zin"

  Output bevat het mailbox-wachtwoord — bewaar dat direct.
• Verificeer DNS bij Resend (kan paar minuten duren):
  

  curl -s -H "Authorization: Bearer $(cat /home/jojo/.credentials/resend-api-key)" \
    https://api.resend.com/domains | jq '.data[] | {name, status}'

  Status moet "verified" worden.
• Mailbox-wachtwoord toevoegen aan credentials:
  /home/jojo/.credentials/mail-users.json — voeg {"email":"info@nieuwplatform.nl","password":"<uit add-domain output>"}

• Open /home/ubuntu/mailplatform/orchestrator/orchestrator.js op VPS (via ssh vindlokaal-mail)
• Vind function wrapEmailHtml, voeg theme toe aan themes-map:

  'nieuwplatform.nl': {
    brand: 'NieuwPlatform',
    tagline: 'Tagline hier',
    gradient: 'linear-gradient(135deg,#3498db 0%,#2980b9 100%)',
    accent: '#3498db',
    footer_text: 'Vragen? Mail naar',
    footer_email: 'info@nieuwplatform.nl',
    website: 'https://nieuwplatform.nl',
  },

• Restart orchestrator:
  sudo systemctl restart mailplatform-orchestrator
• Check logs:
  sudo journalctl -u mailplatform-orchestrator -n 20 --no-pager

Het add-domain script maakt een basis-agent aan. Verfijn 'm via dashboard:

• Open mail-dashboard → tab Agents
• Vind agent voor info@nieuwplatform.nl en klik om te bewerken
• system_prompt aanpassen: toon, productuitleg, wat AI wel/niet mag beantwoorden
• classify_categories instellen — categorieën die AI mag toekennen (bv claim_pagina, premium_interesse, klacht, spam, anders)
• auto_actions per categorie:
  • spam → {"action": "delete"}
  • bounce → {"action": "log_only"}
  • klacht → {"action": "escalate"}
  • urgency_5 → {"action": "escalate_telegram"}
• Herhaal voor facturen@nieuwplatform.nl met facturatie-prompt

• Open marketing-dashboard → tab 📚 Kennis docs
• Klik "+ Document toevoegen", upload:
  • Handleiding voor klanten
  • FAQ-document
  • Voorwaarden / over-ons / pricing
  • Eventueel: interne SOP / cheat-sheets (markeer als internal)
• Per doc: scope instellen via knop "🔒 Scope":
  • customer_facing → AI mag in klant-replies citeren
  • internal → alleen voor jou/agents, NIET naar klant
  • both → mag beide kanten op
• Of via API/CLI als je meerdere files tegelijk wil uploaden — zie API docs

• Marketing-dashboard → tab 🎯 Categorie regels → "+ Nieuwe regel"
• Per categorie uit step 3 een regel maken:
  • Welke KB-docs mag AI raadplegen (kies uit step 4)
  • Strictness: STRICT_DOCS / SOEPEL_DOCS / ALTIJD_ESCALATE / AUTO_RESPOND / AUTO_DELETE
  • Min confidence (0.7 = streng, 0.5 = soepel)
  • Escalatie-instructie (wat mens moet doen bij escalate)
• Klacht → ALTIJD_ESCALATE (geen AI-antwoord, altijd mens)
• Spam / bounce → AUTO_DELETE

Voor de meest gestelde, simpele vragen — kant-en-klare antwoorden zonder AI-call.

• Mail-dashboard → tab FAQ (komt uit faq_templates collection)
• Maak per veelgestelde vraag:
  • code: unieke naam (claim_proces, prijsmodel, etc.)
  • triggers: keywords array (["claim", "claimen", "overnemen"])
  • subject + body_html van het antwoord
  • help_url: link naar handleiding-sectie (optioneel)

• Stuur testmail naar info@nieuwplatform.nl vanuit je Gmail of een ander extern adres
  Niet vanuit een van onze eigen verified domeinen — Resend bouncet anders door anti-self-loop.
• Wacht max 60s — orchestrator pollt elke minuut
• Check mail-dashboard → tab 📥 Inbox → mail moet verschijnen
• Status zou moeten zijn:
  • replied als FAQ-match of auto-reply
  • processed met concept als AI antwoord heeft maar wacht op goedkeuring
  • escalated als KB-systeem niets vond
• Klik mail → check AI-categorie, concept-reply, sources
• Bij escalate: check Telegram-bericht én 🧠 Te leren tab op marketing-hub

• Marketing-dashboard → tab 🔀 Funnels → "+ Nieuwe funnel" of "📋 Kopieer bestaande funnel" (bv van vindlokaal)
• Tab 📨 Templates → "+ Nieuw template" voor welkom/onboarding-mails
  • Of via API: POST /api/templates (handig vanuit Claude Code met push-template.cjs script)
• API-token aanmaken: tab 🔑 API tokens → kies scope + platform_filter
• Lead-lijst importeren: tab 📋 Lijsten → CSV import → "Push naar funnel"

• Telegram — Watchman stuurt 08:00 dagelijks rapport + realtime alerts bij anomalieën
• Inbox-tab — "Wacht op JOU" KPI staat bovenaan, escalates rood
• Marketing → Lopende leads — check waar leads vastlopen in funnel
• Marketing → 🧠 Te leren — wekelijks checken: wat heeft AI vaak geëscaleerd? 1-klik aan KB toevoegen.