# Kommo

Verbinden Sie Kommo (amoCRM), damit der Agent Anrufer anhand der Telefonnummer erkennt, Kontakte und Leads anlegt und jeden Anruf als Notiz festhält

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

Kommo (amoCRM) wird über ein langlebiges Token einer privaten Integration verbunden, die Sie in Ihrem Konto erstellen. Danach begrüßt der Agent bekannte Kunden mit Namen und hat ihren letzten Lead parat, legt einen Kontakt und einen Lead an, wenn jemand eine Anfrage hinterlässt, und trägt das Ergebnis jedes Anrufs in den Datensatz des Kunden ein.

## Was der Agent kann [#what-the-assistant-can-do]

* **Anrufer erkennen** — zu Beginn eines Anrufs sucht er die Telefonnummer in Kommo und erhält Name, E-Mail und Unternehmen des Kontakts sowie seinen letzten Lead (Name, Phase, Budget).
* **Lead anlegen** — findet den Kontakt über die Telefonnummer oder legt einen neuen an und erstellt dann einen Lead in der gewählten Pipeline und Phase. Die Anfrage, die Lieferadresse, die Produkte und die Anzeige, über die der Kunde gekommen ist, landen als Notiz im Lead.
* **Anrufe protokollieren** — nach jedem Anruf fügt er dem offenen Lead des Kunden (oder dem Kontakt) eine Notiz hinzu: Richtung, Dauer, Ergebnis, Zusammenfassung, Link zur Aufzeichnung und auf Wunsch das vollständige Transkript.

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

* **Kommo-Administrator** — nur ein Administrator kann das Token erstellen.
* **HAPP-Workspace** mit mindestens einem Agenten.
* **Kommo für Ihren Workspace freigeschaltet** — die Integration wird pro Unternehmen freigeschaltet. Bitten Sie den HAPP-Support um die Aktivierung.

## Token erstellen [#create-the-token]

1. Öffnen Sie in Kommo **Settings > Integrations** und klicken Sie auf **Create integration**.
2. Wählen Sie eine private Integration, geben Sie ihr den Namen `HAPP` und speichern Sie. Redirect-URL und Widerrufs-Webhook können leer bleiben.
3. Klicken Sie im Tab **Keys and scopes** auf **Generate long-lived token**, wählen Sie die Gültigkeitsdauer (bis zu 5 Jahre) und kopieren Sie das Token — Kommo zeigt es nur einmal an.

## Verbinden [#connect]

1. Öffnen Sie in HAPP **Integrationen** und suchen Sie Kommo unter **CRM hinzufügen**.
2. Klicken Sie auf **Verbinden**, geben Sie Ihre Kontoadresse ein (`acme`, `acme.kommo.com` oder die `amocrm.ru`-Adresse) und fügen Sie das Token ein.
3. Kommo erscheint unter **Meine Integrationen** mit Ihrem Kontonamen.

## Einstellungen [#settings]

Klicken Sie im Tab **Integrationen** des Agenten auf das Zahnradsymbol der Karte.

* **Suchen** — den Anrufer anhand der Telefonnummer erkennen.
* **Erstellen** — Leads anlegen. Wählen Sie **Pipeline**, **Phase** und **Verantwortlich**; ohne diese Angaben landet der Lead in der ersten Phase Ihrer Hauptpipeline. **Incoming leads**, **Closed – won** und **Closed – lost** stehen als Phase nicht zur Auswahl.
* **Anrufnotizen** — eine Notiz nach jedem Anruf. **Vollständiges Transkript** fügt den Gesprächstext hinzu.

## Einschränkungen [#limits]

* Kommo speichert Telefonnummern so, wie sie eingegeben wurden; der Agent vergleicht die letzten 9 Ziffern, daher gelten `050 111 22 33` und `+380501112233` als derselbe Kunde.
* Zu einer Nummer, die es in Kommo nicht gibt, wird keine Anrufnotiz angelegt — es gibt keinen Datensatz, dem sie zugeordnet werden könnte.
* Ab dem gewählten Ablaufdatum funktioniert das Token nicht mehr — generieren Sie rechtzeitig vorher ein neues.

## Fehlerbehebung [#troubleshooting]

| Problem                                                        | Ursache                                                                       | Lösung                                                                                 |
| -------------------------------------------------------------- | ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| „Enter the Kommo account address, e.g. acme or acme.kommo.com“ | Die Adresse gehört zu keinem Kommo- oder amoCRM-Konto                         | Kopieren Sie die Adresse aus der Adresszeile des Browsers, während Kommo geöffnet ist. |
| „Kommo account not found“                                      | Tippfehler in der Adresse                                                     | Prüfen Sie die Kontoadresse.                                                           |
| „Kommo: the token is invalid or expired“                       | Das Token ist abgelaufen oder die Integration wurde gelöscht                  | Generieren Sie ein neues langlebiges Token und klicken Sie erneut auf **Verbinden**.   |
| „Kommo: the account is not paid“                               | Das Abonnement ist abgelaufen — Kommo sperrt dann die API                     | Verlängern Sie das Abonnement.                                                         |
| „Kommo: no access“                                             | Der Benutzer des Tokens hat seine Rechte verloren oder das Konto ist gesperrt | Generieren Sie das Token als Administrator.                                            |

## Trennen [#disconnect]

Trennen Sie die Karte in HAPP und löschen Sie die private Integration unter **Settings > Integrations**. Kontakte, Leads und Notizen, die bereits in Kommo sind, bleiben erhalten.

## Weiter [#next]

* [CRM](/docs/integrations/crm) — alle CRM-Integrationen
* [Tools](/docs/agents/tools) — was der Agent während des Gesprächs aufruft