# NetHunt Verbinden Sie NetHunt, damit der Agent Kontakte anhand der Telefonnummer findet und neue im gewählten Ordner anlegt > Full REST + WebSocket API reference: https://api.happ.tools/reference NetHunt ist ein Gmail-basiertes CRM; die Anmeldung erfolgt daher mit der E-Mail-Adresse des Kontos und einem API-Schlüssel. Danach findet der Agent Kontakte anhand der Telefonnummer und legt neue in dem von Ihnen gewählten NetHunt-Ordner an. ## Bevor Sie beginnen [#before-you-start] * **NetHunt-Konto** mit kostenpflichtigem Tarif — die API ist in allen kostenpflichtigen Tarifen verfügbar. * **E-Mail-Adresse des Kontos** und ein **API-Schlüssel** (siehe unten). * **HAPP-Workspace** mit mindestens einem Agenten, der für Kundengespräche eingerichtet ist. * **Festgelegte Ordner** — in welchem NetHunt-Ordner Kontakte gesucht und in welchem sie angelegt werden. ## API-Schlüssel abrufen [#get-your-api-key] 1. Klicken Sie im NetHunt-Dashboard unten in der linken Seitenleiste auf **Settings**. 2. Wählen Sie in der Gruppe **INTEGRATIONS** den Punkt **Apps and other integrations**. 3. Scrollen Sie nach unten, klicken Sie auf **GENERATE API KEY** und kopieren Sie das Token. Der API-Schlüssel unten auf der Seite Apps and other integrations in NetHunt ## Verbinden [#connect] 1. Öffnen Sie in HAPP **Integrationen** und suchen Sie NetHunt unter **CRM hinzufügen**. 2. Klicken Sie auf **Verbinden** — der Dialog enthält zwei Felder. 3. Füllen Sie sie aus und klicken Sie auf **Verbinden**. | Feld | Wert | | ------------- | ------------------------------------------------- | | E-Mail | Die E-Mail-Adresse Ihres NetHunt-Kontos | | API-Schlüssel | Das in den NetHunt-Einstellungen generierte Token | NetHunt erscheint danach unter **Meine Integrationen** als Karte mit den **Kontoinformationen** — Name des Workspace sowie Datum und Uhrzeit der Verbindung. ## Einstellungen [#settings] Klicken Sie auf das Zahnradsymbol der Karte, um festzulegen, was der Agent tun darf. * **Suchen** — wählen Sie den **Ordner für die Kontaktsuche** und das **Suchfeld**, das die Telefonnummer enthält. Der Agent sucht Kontakte in diesem Ordner anhand der Telefonnummer. * **Erstellen** — wählen Sie den **Ordner für neue Kontakte** und richten Sie dann die **Feldzuordnung** ein: Legen Sie für jeden Parameter des Agenten fest, in welches NetHunt-Feld er schreibt, welchen Typ das Feld hat und ob es ein Pflichtfeld ist. Ohne Feldzuordnung lassen sich keine Kontakte anlegen. Hat ein Pflichtfeld in NetHunt keinen zugeordneten Parameter, wird der Kontakt nicht erstellt. ## Fehlerbehebung [#troubleshooting] | Fehler | Ursache | Lösung | | ----------------------------------------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `INVALID_API_KEY` | Schlüssel falsch eingegeben oder mit Leerzeichen kopiert | Kopieren Sie das Token erneut aus NetHunt > Settings > Apps and other integrations. | | Anmeldung schlägt trotz gültigem Schlüssel fehl | Die E-Mail-Adresse gehört nicht zu dem Konto, dem der Schlüssel gehört | E-Mail-Adresse und API-Schlüssel müssen zum selben NetHunt-Konto gehören. | | `TOKEN_REVOKED` (401) | Ein Administrator hat den Schlüssel rotiert oder widerrufen | Generieren Sie in NetHunt einen neuen Schlüssel und verbinden Sie die Integration in HAPP erneut. | | `RATE_LIMITED` (429) | Das API-Ratenlimit von NetHunt wurde erreicht | Warten Sie 1–2 Minuten und versuchen Sie es erneut. Tritt der Fehler weiterhin auf, [kontaktieren Sie den Support](https://happ.tools/contacts) — wir können die Anfragen auf unserer Seite drosseln. | | Kontakte werden nicht angelegt | Ordner oder Feldzuordnung falsch eingerichtet | Prüfen Sie der Reihe nach drei Punkte: In den **Einstellungen** ist ein Ordner für neue Kontakte gewählt; jedes Pflichtfeld in NetHunt hat einen zugeordneten Parameter; die zugeordneten Felder sind in NetHunt noch aktiv und nicht archiviert. | Kommen Sie nicht weiter? [Kontaktieren Sie den Support](https://happ.tools/contacts) mit dem Fehlertext, und wir nennen Ihnen die passende Lösung. ## Trennen und erneut verbinden [#disconnect-and-reconnect] **Trennen:** Öffnen Sie **Integrationen** > **NetHunt**, klicken Sie neben dem verbundenen Workspace auf **Trennen** und bestätigen Sie. Nach dem Trennen gilt: * Neue Kontakte aus dem Chat werden nicht mehr an NetHunt übertragen. * Vorhandene Kontakte in NetHunt bleiben unverändert. * Der Agent arbeitet im Chat weiter — nur die Synchronisierung mit NetHunt wird beendet. * Der API-Schlüssel wird in NetHunt **nicht** widerrufen. Widerrufen Sie ihn bei Bedarf dort separat. **Erneut verbinden:** Öffnen Sie **Integrationen** > **NetHunt**, klicken Sie auf **Verbinden** und geben Sie E-Mail-Adresse und API-Schlüssel erneut ein. Nach dem erneuten Verbinden bleiben erhalten: die Ordnerauswahl, die Feldzuordnung, die Zuordnung des Agenten zum Workspace und die Analysen der Integration. ## Weiter [#next] * [CRM](/docs/integrations/crm) — alle CRM-Integrationen * [Tools](/docs/agents/tools) — das CRM während des Gesprächs aufrufen * [Integrationen](/docs/integrations) — der vollständige Katalog