# NetHunt

Connectez NetHunt pour que l'assistant trouve les contacts par téléphone et en crée de nouveaux dans le dossier de votre choix

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

NetHunt est un CRM basé sur Gmail ; il s'authentifie donc avec l'e-mail du compte plus une clé API. Une fois la liaison faite, l'assistant trouve les contacts par numéro de téléphone et en crée de nouveaux dans le dossier NetHunt que vous choisissez.

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

* **Compte NetHunt** avec un forfait payant — l'API est disponible sur tous les forfaits payants.
* **E-mail du compte** et **clé API** (voir ci-dessous).
* **Espace de travail HAPP** avec au moins un assistant configuré pour parler aux clients.
* **Dossiers choisis** — dans quel dossier NetHunt rechercher les contacts, et dans lequel les créer.

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

1. Depuis le tableau de bord NetHunt, cliquez sur **Paramètres** en bas de la barre latérale gauche.
2. Dans le groupe **INTEGRATIONS**, choisissez **Apps and other integrations**.
3. Faites défiler jusqu'en bas, cliquez sur **GENERATE API KEY** et copiez le jeton.

<img alt="La clé API en bas de Apps and other integrations dans NetHunt" src="__img0" />

## Connecter [#connect]

1. Dans HAPP, ouvrez **Intégrations** et trouvez NetHunt sous **Ajouter un CRM**.
2. Cliquez sur **Connecter** — la fenêtre demande deux champs.
3. Remplissez-les et cliquez sur **Connecter**.

| Champ   | Valeur                                      |
| ------- | ------------------------------------------- |
| E-mail  | L'e-mail de votre compte NetHunt            |
| Clé API | Le jeton généré dans les paramètres NetHunt |

NetHunt 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.

## Paramètres [#settings]

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

* **Rechercher** — choisissez le **dossier où rechercher les contacts** et le **champ de recherche** contenant le numéro de téléphone. L'assistant recherche les contacts par téléphone dans ce dossier.
* **Créer** — choisissez le **dossier où créer les contacts**, puis configurez le **mapping des champs** : pour chaque paramètre de l'assistant, choisissez le champ NetHunt dans lequel il écrit, son type et s'il est obligatoire.

C'est le mapping des champs qui fait fonctionner la création de contacts. Si un champ NetHunt obligatoire n'a pas de paramètre associé, le contact ne sera pas créé.

## Dépannage [#troubleshooting]

| Erreur                                        | Cause                                                       | Solution                                                                                                                                                                                                                          |
| --------------------------------------------- | ----------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `INVALID_API_KEY`                             | Clé mal saisie ou copiée avec des espaces                   | Recopiez le jeton depuis NetHunt > Settings > Apps and other integrations.                                                                                                                                                        |
| L'authentification échoue avec une clé valide | L'e-mail ne correspond pas au compte propriétaire de la clé | L'e-mail et la clé API doivent appartenir au même compte NetHunt.                                                                                                                                                                 |
| `TOKEN_REVOKED` (401)                         | Un administrateur a renouvelé ou révoqué la clé             | Générez une nouvelle clé dans NetHunt et reconnectez-vous dans HAPP.                                                                                                                                                              |
| `RATE_LIMITED` (429)                          | Limite de requêtes de l'API NetHunt 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 contacts ne sont pas créés                | Dossier ou mapping mal configuré                            | Vérifiez trois choses, dans l'ordre : un dossier de création est sélectionné dans **Paramètres** ; chaque champ NetHunt obligatoire a un paramètre associé ; les champs associés sont toujours actifs dans NetHunt, pas archivés. |

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** > **NetHunt**, cliquez sur **Déconnecter** à côté de l'espace de travail connecté et confirmez.

Après la déconnexion :

* Les nouveaux contacts issus des conversations ne sont plus envoyés à NetHunt.
* Les contacts existants dans NetHunt restent intacts.
* L'assistant continue de fonctionner dans les conversations — seule la synchronisation NetHunt s'arrête.
* La clé API n'est **pas** révoquée dans NetHunt. Révoquez-la là-bas séparément si nécessaire.

**Pour reconnecter :** ouvrez **Intégrations** > **NetHunt**, cliquez sur **Connecter** et saisissez à nouveau l'e-mail et la clé API.

Conservés après la reconnexion : le choix des dossiers, le mapping des champs, la liaison assistant–espace de travail et les statistiques 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