KIWacht.de
🇬🇧 English🇩🇪 Deutsch

Help & Guides

Everything you need to successfully integrate and use KIWacht.

🚀

Getting Started

Set up quickly

🔌

Integrations

Connect with your tools

❓

FAQ

Frequently asked questions

💬

Chat Integration

Coming soon - perhaps

🚀

Getting Started

Get started in just a few steps:

  1. Go to the Dashboard.
  2. Click “Generate new key”.
  3. Copy your API key (starts with kws_).
  4. Use it in your support system.
Go to Dashboard
🔌

Integrations

💡 Free alternative to Zapier

Use Google Apps Script (for Gmail), Power Automate (for Outlook), or Zoho Flow (for Zoho Mail) to integrate KIWacht for free — no subscription required.

📧

Gmail with Google Apps Script

Automate your emails with Google Apps Script — free and GDPR-compliant.

Step-by-step guide: Create Gmail label
Block 1

Create labels in Gmail

👀 Open visual step-by-step guide

💡 Important: Without this label, the script won’t find any emails!

Block 2

Set up Google Apps Script

Follow the instructions below — or use our visual guides.

👀 Visual “Google Apps Script” Step-by-Step Guide🎥 Video Tutorial: Google Apps Script Setup
  1. 1. Open your Gmail account (the one you want to use with Kiwacht).
  2. 2. Copy the Kiwacht script using the “📋 Copy Script” button below.
📜View Full Script

💡 TIP: You don’t need to read the script — just copy and paste it into Google Apps Script.

  1. 3. Go to Google Apps Script and click “New Project”.
  2. 4. Paste the script into Google Apps Script. Find this line around line 14:
    // ─────────────────────────────── // 🔑 Insert your API key here // ─────────────────────────────── const KIWACHT_API_KEY = 'kws_YOUR_API_KEY_HERE';

    Replace kws_YOUR_API_KEY_HERE with your API key from the Dashboard.

  1. 5. Click “Save”, then click the “Run” button (▶️), select classifyAndLabel, and run it once manually.
  2. 6. Go to the Trigger icon (left sidebar) and set up a time-based trigger (every 5 minutes).
Block 3

Set up & test trigger

👀 Open Visual “Trigger” Step-by-Step Guide

💡 Note: After creating the trigger, Google will ask for permissions. Follow the guide — this is normal and secure.

  1. Test manually: Click the green “Run” button → choose classifyAndLabel → execute.
  2. Check your inbox after 30 seconds for an email from “KiWacht Assistant”.
  3. Set up time-based trigger:
    • Go to “Triggers” in the left sidebar
    • Click “+ Add Trigger”
    • Function: classifyAndLabel
    • Event source: Time-driven
    • Time interval: Minutes timer → Every 5 minutes
    • Click “Save”

⚠️ Without this step, the script will not run automatically!

Block 4

How to avoid duplicate emails in your inbox

To ensure your “KiWacht Assistant” analysis emails don’t clutter your primary inbox, use a Gmail filter to move them automatically to a dedicated folder.

📌 Step-by-step:
🎥 Video Tutorial: Set up filter (prevents duplicates)
  1. Open Gmail.
  2. Copy this search command and paste it into the search bar at the top:
    from:me subject:("KiWacht Assistant" OR "– DRINGEND" OR "– Nachfassen" OR "KIWacht: Verarbeitet")
  3. Click the filter icon (three dots) in the search bar.
    ⚠️ Do not press Enter — click the icon instead!
  4. Click “Create filter”.
  5. In the filter form, check:
    • ✅ Skip Inbox (recommended)
    • ✅ Apply label
    • ✅ Mark as read
  6. Click the label dropdown → “Create new”.
  7. Enter: KiWacht/Analyse
    (Gmail auto-creates folder “KiWacht” with subfolder “Analyse”)
  8. Click “Create filter”.

✅ Now:

  • Original emails stay in your Inbox
  • Kiwacht analyses go straight to “KiWacht/Analyse” — no inbox clutter

✅ Success Checklist

  • • Applied label kiwacht-ticket to a test email
  • • API key correctly inserted and saved
  • • Manual test successful (received “KiWacht Assistant” email)
  • • Time-based trigger set up (every 5 minutes)
  • • Label like !URGENT – DRINGEND was added?

If all items are complete, Kiwacht is working correctly.

📨

Forward web.de / GMX to Gmail

If you use web.de or GMX, you can simply forward your emails to a Gmail account and use KIWacht there.

💡 Tip: Even if your email provider doesn’t support scripting: Just forward all requests to a Gmail account — and use Google Apps Script there to automatically sort, analyze, and optionally forward.

  1. Go to the settings of web.de or GMX.
  2. Enable Email forwarding under “Mail” → “Forwarding”.
  3. Enter your Gmail address as the destination.
  4. Confirm the forwarding (if required).
  5. Now use the Gmail Script as described in the Gmail with Google Apps Script section below.

💡 Tip: This way you can use KIWacht with your existing email provider — no extra tools needed.

📨

Connect web.de / GMX with Zapier

Since web.de and GMX don’t offer their own scripting platform, use Zapier to automatically send incoming emails to KIWacht.

  1. Go to zapier.com and create a free account.
  2. Create a new Zap.
  3. As Trigger, choose: “Email by IMAP” → “New Email”.
  4. Connect your web.de or GMX account:
    • Server: imap.web.de or imap.gmx.de
    • Port: 993
    • Encryption: SSL/TLS
    • Username: Your full email address
    • Password: Your email password
  5. As Action, choose: “Webhooks by Zapier” → “POST”.
  6. Webhook URL:
    https://kiwacht.de/api/classify
  7. Headers:
    Authorization: Bearer kws_YourKeyHere
Content-Type: application/json
  8. Body:
    {
"ticket": "{{bodyPlain}}"
}
  9. You can optionally send a reply or create a ticket in a support system.

💡 Tip: Use “Body (Plain Text)” from the IMAP trigger for best results.

Jira Webhook Setup Guide
Jira Integration

KiWacht for Jira – No App Installation Required

Use KiWacht directly in Jira – without any Atlassian Marketplace app and fully GDPR-compliant.

💡 Why this matters:
The Atlassian Marketplace is filled with apps that
→ store personal data,
→ lack GDPR certification.
KiWacht is different: No storage, no review – just your ticket + AI.

⚠️ Note: Jira cannot automatically act on KiWacht’s response.
For visible actions (e.g., tagging), use Gmail + Apps Script,
where KiWacht sends an email with the analysis.

  1. Go to Jira “Settings → System → Webhooks → Create webhook”
    (Works in Jira Cloud, Server, and Data Center)
  2. Configure the webhook:
    • Name: KiWacht Triage
    • URL: https://kiwacht.de/api/classify
    • Header: Authorization: Bearer kws_YOUR_API_KEY
    • Trigger: Issue created
    • Content: { "ticket": "{{issue.description}}" }
  3. Test manually: Create a new ticket – KiWacht receives and processes it instantly.

✅ Advantages over Marketplace apps:

  • No Atlassian app needed – no installation in Marketplace
  • No data sharing – KiWacht stores nothing, is stateless
  • 80 free requests/month included

ℹ️ This method uses native Jira features (Webhooks).
For visible analysis, we recommend the Gmail integration.

Outlook Power Automate Setup Guide
Outlook Integration

KiWacht for Outlook – with Power Automate

Connect KiWacht to Outlook via Microsoft Power Automate – ideal for companies in the Microsoft 365 ecosystem.

💡 Note: Outlook does not display KiWacht’s analysis in your inbox. Instead, emails are automatically sorted into folders(Support, Sales, Billing, Urgent).

📘 Full 11-step visual guide
  1. Go to Power Automate.
  2. Sign in with your Outlook.com or Microsoft 365 account.
  3. Create a new Cloud Flow: “When a new email arrives in Inbox”
  4. Add an action: “Send an HTTP request”
  5. Configure:
    • Method: POST
    • URI: https://kiwacht.de/api/classify
    • Header:
      Authorization: Bearer kws_YOUR_API_KEY
    • Body:
      {"ticket": "@{triggerBody()?['Body']}}
  6. Use KiWacht’s response to move emails into folders like “KiWacht/Sales” or “KiWacht/Urgent”.

🔒 GDPR-compliant: KiWacht stores no data. Every request is processed in <300 ms and discarded.

Zoho Mail Integration Guide
Zoho Mail Integration

💡 Market Share: Zoho Mail holds a 12% market share among SMEs in the DACH region(Source: Statista 2025), thanks to EU data storage, transparent pricing, and GDPR compliance.

⚠️ Important: The free Zoho Flow plan only allows 100 tasks/month – insufficient for support inboxes. Use KiWacht with a paid Zoho plan (e.g., Mail Lite from €1.25/user/month).

📘 Full 14-step guide with images
  1. Go to Zoho Flow and sign in.
  2. Create a new flow with trigger: “When a new email is received” (Zoho Mail).
  3. Add an action: Webhooks → POST.
  4. URL: https://kiwacht.de/api/classify
  5. Authentication: No authentication
  6. Header:
    Authorization: Bearer kws_YOUR_API_KEY_HERE
Content-Type: application/json
    Body (raw):
    { "ticket": "{{mail_content}}" }
  7. Response type: JSON
  8. Click “Switch on flow”.
  9. Done! New emails will be analyzed automatically.

🔒 GDPR-compliant & stateless: KiWacht stores no emails, no metadata, no logs. Every request is processed in under 300 ms and immediately discarded – no storage, no tracking, no profiling.

💡 Tip: Replace kws_YOUR_API_KEY_HERE with your real key from the Dashboard.

Zendesk Webhook Setup Guide
Zendesk Integration

Connect KiWacht with Zendesk – ideal for support teams on Professional or Enterprise plans.

⚠️ Plan required: Webhooks are only available from Zendesk Professional plan. Free or Team plans do not support this feature.

  1. Go to Admin Center → Apps and integrations → Webhooks → Create webhook.
  2. Choose “Webhook” → “New Webhook”.
  3. Configure:
    • Name: KIWACHT Analysis
    • Endpoint URL: https://kiwacht.de/api/classify
    • Request Method: POST
    • Authentication: No authentication
  4. Click “Add Header” and add:
    Authorization: Bearer kws_YOUR_API_KEY_HERE
Content-Type: application/json
    Under “JSON Body”, enter:
    {
  "ticket": "{{ticket.description}}"
}
  5. Click “Create Webhook”.
  6. Go to Admin Center → Objects and rules → Automationsand create a new automation for “New Ticket”.
  7. Add an action: “Notify target” → select your KIWACHT Webhook.
  8. Note: Zendesk cannot evaluate the KiWacht response. For visible actions (e.g., tagging), you’ll need a custom Zendesk appor use Gmail + Apps Script for instant analysis.

🔒 GDPR Notice: KiWacht stores no data. All requests are processed in under 300 ms and discarded – fully stateless and GDPR-compliant.

💡 Tip: Replace kws_YOUR_API_KEY_HEREwith your API key from the Dashboard.

Freshdesk Webhook Setup Guide
Freshdesk Integration

Connect KiWacht with Freshdesk – ideal for DACH SMEs seeking transparent pricing and GDPR-compliant automation.

⚠️ Plan required: Webhooks are only available from Freshdesk Garden plan (~€15/agent/month). Free or Blossom plans do not support this feature.

💡 Why Freshdesk in DACH?
Freshdesk has a strong market presence among German SMEs – especially in e-commerce and IT support.

  1. Go to Admin → Automations → Workflow Rules.
  2. Create a new rule with trigger: “Ticket is Created”.
  3. Add an action: “Trigger Webhook”.
  4. URL:
    https://kiwacht.de/api/classify
  5. Header:
    Authorization: Bearer kws_YOUR_API_KEY_HERE
Content-Type: application/json
    Body:
    {
  "ticket": "{{ticket.description}}"
}
  6. Click “Save”.
    Note: Freshdesk cannot evaluate the KiWacht response. For visible actions (e.g., tagging), you’ll need a custom Freshdesk appor use Gmail + Apps Script.

🔒 GDPR Notice: KiWacht stores no data. All requests are processed in under 300 ms and discarded.

💡 Tip: Replace kws_YOUR_API_KEY_HERE with your real key from the Dashboard.

💡 Note: This method works with any system that supports webhooks or automations – such as Yahoo, Apple Mail (via Shortcuts), or any CRM system.

❓

Frequently Asked Questions

We do not store any personal data. Every request is processed independently and not saved. Our AI only analyzes content to categorize it, without retaining any information.

💬

Need more help?

Our support team is happy to assist you

Contact Support