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.

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 three blocks below — or use our visual guide for an easier setup.

  1. Open your Gmail account (make sure you’re signed in to the correct account)
  2. Generate an API key in the Dashboard, if you haven’t already.
📜 View full script

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

👀 Open visual step-by-step guide to create Google Apps Script
  1. Go to Google Apps Script and click “New Project”.
  2. Paste the script, then find this line:
    // ───────────────────────────────
// 🔑 Paste your API key here
// ───────────────────────────────

const KIWACHT_API_KEY = 'kws_YOUR_API_KEY_HERE';

    Replace 'kws_YOUR_API_KEY_HERE' with your real key from the Dashboard.

  3. Click “Save”, then click the “Run” button (▶️), select classifyAndLabel, and run it once manually.
  4. Then go to the trigger symbol (typically on the left) and set up a time-based trigger (every 5 minutes) so the script runs automatically, as explained in Block 3.
Block 3

Set up trigger & test

👀 Open visual step-by-step guide

💡 Note: When you first save the trigger, Google will show a permission warning. Follow the instructions in the Trigger Guide — this is normal and safe.

  1. Test manually: Click the green “Run” button → select classifyAndLabel → run it.
  2. Check your inbox after 30 seconds for an email from “KIWacht Assistant”.
  3. Set up the 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!

✅ Success Checklist

  • • Applied kiwacht-ticket label 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 – URGENT 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.

📨

Outlook / Microsoft 365

Use Microsoft Power Automate (formerly Flow).

📘 Full 11-step guide with images

  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
    • Headers:
      Authorization: Bearer kws_YOUR_KEY_HERE Content-Type: application/json
    • Body:
      {"ticket": "@{triggerBody()?['Body']}}
  6. Use the response to route or categorize the email.
📩

Zoho Mail

Connect KIWacht to your Zoho Mail account via Zoho Flow — no extra license costs. Setup takes about 3 minutes.

📘 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
  7. Body (raw):
    { "ticket": "{{mail_content}}" }
  8. Response type: JSON
  9. Click “Switch on flow”.
  10. Done! New emails will be analyzed automatically.

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

📊

Zendesk

  1. Go to Admin Center → Objects and rules → Automations.
  2. Create a new Automation for “New Ticket”.
  3. Add an action: “Call webhook”.
  4. URL:
    https://kiwacht.de/api/classify
  5. Headers:
    Authorization: Bearer kws_YourKeyHere
Content-Type: application/json
  6. Body:
    {
"ticket": "{{ticket.description}}"
}
  7. Use the response to automatically set tags or priorities.
📞

Freshdesk

  1. Go to Admin → Workflows.
  2. Create a workflow for “Ticket created”.
  3. Add an action: “Call webhook”.
  4. URL:
    https://kiwacht.de/api/classify
  5. Headers:
    Authorization: Bearer kws_YourKeyHere
Content-Type: application/json
  6. Body:
    {
"ticket": "{{ticket.description}}"
}
  7. Use the response for automatic categorization.

💡 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