# NetHunt

Conecta NetHunt para que el agente encuentre contactos por su teléfono y cree otros nuevos en la carpeta que elijas

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

NetHunt es un CRM basado en Gmail, así que se autentica con el email de la cuenta más una clave API. Una vez vinculado, el agente encuentra contactos por su número de teléfono y crea otros nuevos en la carpeta de NetHunt que elijas.

## Antes de empezar [#before-you-start]

* **Cuenta de NetHunt** con un plan de pago: la API está disponible en todos los planes de pago.
* **Email de la cuenta** y una **clave API** (ver abajo).
* **Espacio de trabajo de HAPP** con al menos un agente configurado para hablar con clientes.
* **Carpetas decididas**: en qué carpeta de NetHunt buscar contactos y en cuál crearlos.

## Obtener tu clave API [#get-your-api-key]

1. En el panel de NetHunt, haz clic en **Settings** en la parte inferior de la barra lateral izquierda.
2. En el grupo **INTEGRATIONS** elige **Apps and other integrations**.
3. Desplázate hasta abajo, haz clic en **GENERATE API KEY** y copia el token.

<img alt="La clave API al final de Apps and other integrations en NetHunt" src="__img0" />

## Conectar [#connect]

1. En HAPP abre **Integraciones** y busca NetHunt en **Añadir un CRM**.
2. Haz clic en **Conectar**: el modal pide dos campos.
3. Introdúcelos y haz clic en **Conectar**.

| Campo     | Valor                                            |
| --------- | ------------------------------------------------ |
| Email     | El email de tu cuenta de NetHunt                 |
| Clave API | El token generado en la configuración de NetHunt |

NetHunt pasa a **Mis integraciones** como una tarjeta que muestra su **Información de la cuenta**: el nombre del espacio de trabajo y la fecha y hora de conexión.

## Configuración [#settings]

Abre el icono de engranaje de la tarjeta para configurar lo que el agente puede hacer.

* **Buscar**: elige la **carpeta donde buscar contactos** y el **campo de búsqueda** que contiene el número de teléfono. El agente busca contactos por teléfono en esa carpeta.
* **Crear**: elige la **carpeta donde crear contactos** y luego configura la **asignación de campos**: para cada parámetro del agente, elige el campo de NetHunt en el que escribe, su tipo y si es obligatorio.

La asignación de campos es lo que hace que funcione la creación de contactos. Si un campo obligatorio de NetHunt no tiene parámetro asignado, el contacto no se creará.

## Solución de problemas [#troubleshooting]

| Error                                       | Causa                                                      | Solución                                                                                                                                                                                                                  |
| ------------------------------------------- | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `INVALID_API_KEY`                           | Clave mal escrita o copiada con espacios                   | Vuelve a copiar el token de NetHunt > Settings > Apps and other integrations.                                                                                                                                             |
| La autenticación falla con una clave válida | El email no coincide con la cuenta propietaria de la clave | El email y la clave API deben pertenecer a la misma cuenta de NetHunt.                                                                                                                                                    |
| `TOKEN_REVOKED` (401)                       | Un administrador rotó o revocó la clave                    | Genera una clave nueva en NetHunt y vuelve a conectar en HAPP.                                                                                                                                                            |
| `RATE_LIMITED` (429)                        | Se alcanzó el límite de peticiones de la API de NetHunt    | Espera 1–2 minutos y reintenta. Si sigue pasando, [contacta con soporte](https://happ.tools/contacts): podemos limitar las peticiones por nuestra parte.                                                                  |
| No se crean contactos                       | Carpeta o asignación mal configuradas                      | Revisa tres cosas, en orden: hay una carpeta de creación seleccionada en **Configuración**; cada campo obligatorio de NetHunt tiene un parámetro asignado; los campos asignados siguen activos en NetHunt, no archivados. |

¿Sigues atascado? [Contacta con soporte](https://happ.tools/contacts) con el texto del error y te indicaremos la solución exacta.

## Desconectar y volver a conectar [#disconnect-and-reconnect]

**Para desconectar:** abre **Integraciones** > **NetHunt**, haz clic en **Desconectar** junto al espacio de trabajo conectado y confirma.

Después de desconectar:

* Los contactos nuevos del chat dejan de enviarse a NetHunt.
* Los contactos existentes en NetHunt no se tocan.
* El agente sigue funcionando en el chat: solo se detiene la sincronización con NetHunt.
* La clave API **no** se revoca en NetHunt. Revócala allí por separado si lo necesitas.

**Para volver a conectar:** abre **Integraciones** > **NetHunt**, haz clic en **Conectar** y vuelve a introducir el email y la clave API.

Se conserva al volver a conectar: la selección de carpetas, la asignación de campos, la vinculación agente–espacio de trabajo y la analítica de la integración.

## Siguiente [#next]

* [CRM](/docs/integrations/crm): todas las integraciones de CRM
* [Herramientas](/docs/agents/tools): llama al CRM durante las conversaciones
* [Integraciones](/docs/integrations): el catálogo completo