# KeyCRM

Connectez KeyCRM pour que l'assistant trouve les acheteurs par téléphone et crée des cartes de pipeline ou des commandes

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

KeyCRM se connecte avec une seule clé API. Une fois la liaison faite, l'assistant recherche les acheteurs par numéro de téléphone en pleine conversation et dépose les nouvelles commandes directement dans votre pipeline de vente.

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

* **Compte KeyCRM** avec un forfait payant — l'API est disponible sur tous les forfaits payants.
* **Clé API** issue des paramètres KeyCRM (voir ci-dessous).
* **Espace de travail HAPP** avec au moins un assistant configuré pour parler aux clients.
* **Pipeline et statut de départ** — décidez où les nouvelles cartes doivent arriver.

## Obtenir votre clé API [#get-your-api-key]

1. Depuis le tableau de bord KeyCRM, ouvrez **Paramètres** dans la barre latérale gauche.
2. Allez dans **Général** > **API**.
3. Cliquez sur **Générer** s'il n'y a pas encore de clé, puis copiez le jeton.

<img alt="Le champ de la clé API dans les paramètres KeyCRM, avec le bouton de copie" src="__img0" />

## Connecter [#connect]

1. Dans HAPP, ouvrez **Intégrations** et trouvez KeyCRM sous **Ajouter un CRM**.
2. Cliquez sur **Connecter** — la fenêtre demande un seul champ.
3. Collez la **Clé API** et cliquez sur **Connecter**.

KeyCRM passe dans **Mes intégrations** sous forme de carte affichant ses **Informations du compte** — nom de l'espace de travail ainsi que la date et l'heure de connexion.

| Champ   | Valeur                                        |
| ------- | --------------------------------------------- |
| Clé API | Le jeton de KeyCRM > Settings > General > API |

## Paramètres [#settings]

Ouvrez l'icône d'engrenage de la carte pour configurer ce que l'assistant est autorisé à faire.

* **Rechercher** — l'assistant recherche les acheteurs existants par numéro de téléphone et renvoie leurs données.
* **Créer** — l'assistant crée de nouvelles fiches. Choisissez le **mode de création** (carte de pipeline ou commande), le **pipeline de vente**, le **statut de carte** vers lequel la fiche est déplacée et la **source de la commande**.

## Dépannage [#troubleshooting]

| Erreur                                   | Cause                                           | Solution                                                                                                                                                                                                                                                                                             |
| ---------------------------------------- | ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `INVALID_API_KEY`                        | Clé mal saisie ou copiée avec des espaces       | Recopiez le jeton depuis KeyCRM > Settings > General > API. Assurez-vous de l'avoir généré avant de le copier.                                                                                                                                                                                       |
| `TOKEN_REVOKED` (401)                    | Un administrateur a renouvelé ou révoqué la clé | Générez une nouvelle clé dans KeyCRM et reconnectez-vous dans HAPP.                                                                                                                                                                                                                                  |
| `RATE_LIMITED` (429)                     | Limite de requêtes de l'API KeyCRM atteinte     | Attendez 1–2 minutes et réessayez. Si cela persiste, [contactez le support](https://happ.tools/contacts) — nous pouvons limiter les requêtes de notre côté.                                                                                                                                          |
| Les commandes n'arrivent pas dans KeyCRM | Synchronisation mal configurée                  | Vérifiez trois choses, dans l'ordre : le pipeline et le statut de départ sont sélectionnés dans **Paramètres** ; les champs acheteur KeyCRM utilisés dans le mapping sont actifs, pas archivés ; la liste blanche d'IP dans KeyCRM > Settings > API est vide **ou** inclut les IP sortantes de HAPP. |

Toujours bloqué ? [Contactez le support](https://happ.tools/contacts) avec le texte de l'erreur et nous vous indiquerons la solution exacte.

## Déconnecter et reconnecter [#disconnect-and-reconnect]

**Pour déconnecter :** ouvrez **Intégrations** > **KeyCRM**, cliquez sur **Déconnecter** à côté de l'espace de travail connecté et confirmez.

Après la déconnexion :

* Les nouvelles commandes issues des conversations ne sont plus envoyées à KeyCRM.
* Les commandes existantes dans KeyCRM restent intactes.
* L'assistant continue de fonctionner dans les conversations — seule la synchronisation KeyCRM s'arrête.
* La clé API n'est **pas** révoquée dans KeyCRM. Révoquez-la là-bas séparément si nécessaire.

**Pour reconnecter :** ouvrez **Intégrations** > **KeyCRM**, cliquez sur **Connecter** et collez à nouveau la clé API.

Conservés après la reconnexion : le choix du pipeline et du statut, le mapping des champs, la liaison assistant–espace de travail et les statistiques de commandes de l'intégration.

## Ensuite [#next]

* [CRM](/docs/integrations/crm) — toutes les intégrations CRM
* [Outils](/docs/agents/tools) — appelez le CRM pendant les conversations
* [Intégrations](/docs/integrations) — le catalogue complet