KeyCRM
Connectez KeyCRM pour que l'assistant trouve les acheteurs par téléphone et crée des cartes de pipeline ou des commandes
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
- 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
- Depuis le tableau de bord KeyCRM, ouvrez Paramètres dans la barre latérale gauche.
- Allez dans Général > API.
- Cliquez sur Générer s'il n'y a pas encore de clé, puis copiez le jeton.
Connecter
- Dans HAPP, ouvrez Intégrations et trouvez KeyCRM sous Ajouter un CRM.
- Cliquez sur Connecter — la fenêtre demande un seul champ.
- 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
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
| 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 — 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 avec le texte de l'erreur et nous vous indiquerons la solution exacte.
Déconnecter et reconnecter
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
- CRM — toutes les intégrations CRM
- Outils — appelez le CRM pendant les conversations
- Intégrations — le catalogue complet
Help me solve it
Happ answers right away and hands over to a manager when needed.