# KeyCRM

Verbinden Sie KeyCRM, damit der Agent Käufer anhand der Telefonnummer findet und Pipeline-Karten oder Bestellungen erstellt

> Full REST + WebSocket API reference: https://api.happ.tools/reference

KeyCRM wird mit einem einzigen API-Schlüssel verbunden. Danach sucht der Agent Käufer während des Gesprächs anhand der Telefonnummer und legt neue Bestellungen direkt in Ihrer Vertriebspipeline an.

## Bevor Sie beginnen [#before-you-start]

* **KeyCRM-Konto** mit kostenpflichtigem Tarif — die API ist in allen kostenpflichtigen Tarifen verfügbar.
* **API-Schlüssel** aus den KeyCRM-Einstellungen (siehe unten).
* **HAPP-Workspace** mit mindestens einem Agenten, der für Kundengespräche konfiguriert ist.
* **Pipeline und Anfangsstatus** — entscheiden Sie, wo neue Karten landen sollen.

## API-Schlüssel abrufen [#get-your-api-key]

1. Öffnen Sie im KeyCRM-Dashboard **Settings** in der linken Seitenleiste.
2. Gehen Sie zu **General** > **API**.
3. Klicken Sie auf **Generate**, falls noch kein Schlüssel existiert, und kopieren Sie dann das Token.

<img alt="Das Feld für den API-Schlüssel in den KeyCRM-Einstellungen mit der Kopier-Schaltfläche" src="__img0" />

## Verbinden [#connect]

1. Öffnen Sie in HAPP **Integrationen** und finden Sie KeyCRM unter **CRM hinzufügen**.
2. Klicken Sie auf **Verbinden** — das Dialogfenster enthält nur ein Feld.
3. Fügen Sie den **API-Schlüssel** ein und klicken Sie auf **Verbinden**.

KeyCRM erscheint danach unter **Meine Integrationen** als Karte mit den **Kontoinformationen** — Workspace-Name sowie Datum und Uhrzeit der Verbindung.

| Feld          | Wert                                            |
| ------------- | ----------------------------------------------- |
| API-Schlüssel | Das Token aus KeyCRM > Settings > General > API |

## Einstellungen [#settings]

Klicken Sie auf das Zahnradsymbol der Karte, um festzulegen, was der Agent tun darf.

* **Suchen** — der Agent sucht vorhandene Käufer anhand der Telefonnummer und gibt ihre Daten zurück.
* **Erstellen** — der Agent erstellt neue Datensätze. Wählen Sie den **Erstellungsmodus** (Pipeline-Karte oder Bestellung), die **Vertriebspipeline**, den **Kartenstatus**, in den der Datensatz verschoben wird, und die **Bestellquelle**.

## Fehlerbehebung [#troubleshooting]

| Fehler                              | Ursache                                                     | Lösung                                                                                                                                                                                                                                                                                                  |
| ----------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `INVALID_API_KEY`                   | Schlüssel falsch eingegeben oder mit Leerzeichen kopiert    | Kopieren Sie das Token erneut aus KeyCRM > Settings > General > API. Stellen Sie sicher, dass Sie es vor dem Kopieren generiert haben.                                                                                                                                                                  |
| `TOKEN_REVOKED` (401)               | Ein Administrator hat den Schlüssel rotiert oder widerrufen | Generieren Sie in KeyCRM einen neuen Schlüssel und verbinden Sie in HAPP erneut.                                                                                                                                                                                                                        |
| `RATE_LIMITED` (429)                | API-Ratenlimit von KeyCRM erreicht                          | Warten Sie 1–2 Minuten und versuchen Sie es erneut. Tritt der Fehler wiederholt auf, [wenden Sie sich an den Support](https://happ.tools/contacts) — wir können Anfragen auf unserer Seite drosseln.                                                                                                    |
| Bestellungen erreichen KeyCRM nicht | Synchronisierung falsch konfiguriert                        | Prüfen Sie drei Dinge in dieser Reihenfolge: Pipeline und Anfangsstatus sind in den **Einstellungen** gewählt; die im Mapping verwendeten KeyCRM-Käuferfelder sind aktiv, nicht archiviert; die IP-Whitelist in KeyCRM > Settings > API ist leer **oder** enthält die ausgehenden IP-Adressen von HAPP. |

Kommen Sie nicht weiter? [Wenden Sie sich an den Support](https://happ.tools/contacts) und geben Sie den Fehlertext an — wir nennen Ihnen die genaue Lösung.

## Trennen und erneut verbinden [#disconnect-and-reconnect]

**Zum Trennen:** Öffnen Sie **Integrationen** > **KeyCRM**, klicken Sie neben dem verbundenen Workspace auf **Trennen** und bestätigen Sie.

Nach dem Trennen:

* Neue Chat-Bestellungen werden nicht mehr an KeyCRM gesendet.
* Vorhandene Bestellungen in KeyCRM bleiben unverändert.
* Der Agent arbeitet im Chat weiter — nur die Synchronisierung mit KeyCRM wird beendet.
* Der API-Schlüssel wird in KeyCRM **nicht** widerrufen. Widerrufen Sie ihn dort bei Bedarf separat.

**Zum erneuten Verbinden:** Öffnen Sie **Integrationen** > **KeyCRM**, klicken Sie auf **Verbinden** und fügen Sie den API-Schlüssel erneut ein.

Nach dem erneuten Verbinden bleiben erhalten: Auswahl von Pipeline und Status, Feldzuordnung, die Zuordnung des Agenten zum Workspace und die Bestellanalysen 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