# Kommo

Connectez Kommo (amoCRM) pour que l'assistant reconnaisse les appelants par téléphone, crée des contacts et des leads, et consigne chaque appel en note

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

Kommo (amoCRM) se connecte avec un jeton longue durée d'une intégration privée que vous créez dans votre compte. Une fois la liaison faite, l'assistant salue les clients connus par leur nom en ayant leur dernier lead sous les yeux, crée un contact et un lead quand quelqu'un laisse une demande, et écrit le résultat de chaque appel dans la fiche du client.

## Ce que l'assistant peut faire [#what-the-assistant-can-do]

* **Reconnaître l'appelant** — au début d'un appel, il recherche le numéro de téléphone dans Kommo et obtient le nom, l'e-mail, l'entreprise du contact et son dernier lead (nom, étape, budget).
* **Créer un lead** — trouve le contact par téléphone ou en crée un nouveau, puis crée un lead dans le pipeline et l'étape de votre choix. La demande, l'adresse de livraison, les produits et l'annonce qui a amené le client sont ajoutés au lead sous forme de note.
* **Consigner les appels** — après chaque appel, il ajoute une note au lead ouvert du client (ou au contact) : sens, durée, résultat, résumé, lien vers l'enregistrement et, si vous le souhaitez, la transcription complète.

## Avant de commencer [#before-you-start]

* **Administrateur Kommo** — seul un administrateur peut créer le jeton.
* **Espace de travail HAPP** avec au moins un assistant.
* **Kommo activé pour votre espace de travail** — l'intégration est activée par entreprise. Demandez au support HAPP de l'activer.

## Créer le jeton [#create-the-token]

1. Dans Kommo, ouvrez **Settings > Integrations** et cliquez sur **Create integration**.
2. Choisissez une intégration privée, nommez-la `HAPP` et enregistrez. L'URL de redirection et le webhook de révocation peuvent rester vides.
3. Dans l'onglet **Keys and scopes**, cliquez sur **Generate long-lived token**, choisissez l'expiration (jusqu'à 5 ans) et copiez le jeton — Kommo ne l'affiche qu'une seule fois.

## Connecter [#connect]

1. Dans HAPP, ouvrez **Intégrations** et trouvez Kommo sous **Ajouter un CRM**.
2. Cliquez sur **Connecter**, saisissez l'adresse de votre compte (`acme`, `acme.kommo.com` ou l'adresse `amocrm.ru`) et collez le jeton.
3. Kommo apparaît sous **Mes intégrations** avec le nom de votre compte.

## Paramètres [#settings]

Ouvrez l'icône d'engrenage de la carte dans l'onglet **Intégrations** de l'assistant.

* **Rechercher** — reconnaître l'appelant par téléphone.
* **Créer** — des leads. Choisissez le **pipeline**, l'**étape** et le **propriétaire** ; sans eux, le lead va dans votre pipeline principal, à la première étape. **Incoming leads**, **Closed – won** et **Closed – lost** ne sont pas proposés comme étape.
* **Notes d'appel** — une note après chaque appel. **Transcription complète** ajoute le texte de la conversation.

## Limites [#limits]

* Kommo stocke les numéros de téléphone tels qu'ils ont été saisis ; l'assistant compare les 9 derniers chiffres, donc `050 111 22 33` et `+380501112233` sont le même client.
* Un numéro absent de Kommo ne reçoit pas de note d'appel — il n'y a aucune fiche à laquelle l'attacher.
* Le jeton cesse de fonctionner à la date d'expiration choisie — générez-en un nouveau avant.

## Dépannage [#troubleshooting]

| Problème                                                         | Cause                                                             | Solution                                                                      |
| ---------------------------------------------------------------- | ----------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| « Enter the Kommo account address, e.g. acme or acme.kommo.com » | L'adresse n'est pas celle d'un compte Kommo ou amoCRM             | Copiez l'adresse depuis votre navigateur lorsque vous êtes dans Kommo.        |
| « Kommo account not found »                                      | Faute de frappe dans l'adresse                                    | Vérifiez l'adresse du compte.                                                 |
| « Kommo: the token is invalid or expired »                       | Le jeton a expiré ou l'intégration a été supprimée                | Générez un nouveau jeton longue durée et cliquez à nouveau sur **Connecter**. |
| « Kommo: the account is not paid »                               | L'abonnement a pris fin — Kommo ferme l'API                       | Renouvelez l'abonnement.                                                      |
| « Kommo: no access »                                             | L'utilisateur du jeton a perdu ses droits ou le compte est bloqué | Générez le jeton en tant qu'administrateur.                                   |

## Déconnecter [#disconnect]

Déconnectez la carte dans HAPP et supprimez l'intégration privée dans **Settings > Integrations**. Les contacts, leads et notes déjà dans Kommo restent.

## Ensuite [#next]

* [CRM](/docs/integrations/crm) — toutes les intégrations CRM
* [Outils](/docs/agents/tools) — ce que l'assistant appelle pendant les conversations