---
name: hiwalter-verification
description: Bewertet die Zustellbarkeit von E-Mail-Adressen über den HiWalter A-bis-F-Risiko-Score und entscheidet, an wen gesendet wird. Nutze diesen Skill, wenn jemand vor dem Versand prüfen will, welche deutschen B2B-Adressen sicher zustellbar sind, oder eine Liste nach Risiko gaten will.
---

# HiWalter Verification

Gated eine Liste nach Zustellbarkeit, bevor gesendet wird. Grundlage ist der HiWalter E-Mail-Risiko-Score (A bis F), der an jedem Datensatz hängt. Ziel: an A/B senden, D unterdrücken, C/F bewusst behandeln, Absenderreputation schützen.

## Warum ein Score statt valid/invalid

Seit Microsoft 2026 SMTP-Prüfungen blockiert, markieren klassische Verifizierer (NeverBounce, ZeroBounce u. a.) zustellbare Postfächer fälschlich als "ungültig". HiWalter vergibt stattdessen einen Risiko-Score aus dem, was tatsächlich über die Zustellbarkeit bekannt ist.

## Die Skala

| Score | Bedeutung | Empfehlung |
| --- | --- | --- |
| A | Gültig, bekannte Antwort, Öffnung oder Klick | Senden |
| B | Bekannter Versand ohne Bounce | Wahrscheinlich senden |
| C | Catch-All, nicht bestätigbar | Deine Entscheidung, vorsichtig |
| D | Hart ungültig, Bounce, Beschwerde, Spam-Trap | Nicht senden |
| F | Keine Daten | Deine Entscheidung, wie C behandeln |

## Voraussetzungen

- API-Key `hw_XXXXXXXXXXX`, Basis-URL `https://api.hiwalter.de/api/v1/tools/`, Header `Authorization: Bearer hw_...`.

## Ablauf

### Adressen aus HiWalter

Kontakte aus dem Discovery-Skill tragen den Score bereits. Beim Ziehen über `email_risk` gaten, z. B. `["A","B"]` für nur sichere Adressen. Keine Nachverifizierung nötig.

### Extern beschaffte Namen (Impressum, Messe, LinkedIn)

Für Namen ohne Score leitet `find_email` aus `first_name`, `last_name` und `domain` die Adresse ab, prüft sie und gibt sie mit Risiko-Score zurück. Bis 500 Personen pro Aufruf (größer asynchron über `get_task`).

```
POST /find_email
{ "people": [ { "first_name": "Anna", "last_name": "Becker", "domain": "becker-gmbh.de" } ],
  "email_risk": ["A","B"] }
```

Jeder Datensatz in der Antwort trägt den Score; damit gaten.

## Gating-Regeln

- A: sofort anschreibbar.
- B: solide für regelmäßigen Versand; bei neuer Absenderdomain mit kleiner Batch starten.
- C: getrennt von A/B segmentieren, mit geringem Volumen anwärmen, nach 1 bis 2 Versuchen Nicht-Antwortende unterdrücken.
- D: niemals senden, automatisch auf Listenebene unterdrücken.
- F: als unbekanntes Risiko wie C behandeln, nicht als sicher.

## Zusätzliche Hygiene

- Score ist Filter, keine Garantie: immer mit eigener Domain-Reputation und sauberer Listenpflege kombinieren.
- Bounce-Rate je Score über die Zeit beobachten, um das Gating für den eigenen Fall zu bestätigen.
- Neue Versanddomains unabhängig vom Score anwärmen.

## Grenzen (ehrlich)

- Dies ist ein Zustellbarkeits-Score, kein eigenständiger SMTP-Verifizierer und keine Garantie.
- HiWalter liefert keine Telefonnummern.
- Standalone-Nachverifizierung großer Fremdlisten ist Roadmap; hier wird auf den vorhandenen Score und `find_email` gegatet.
