# SalesDrive

Conecta SalesDrive para que el agente encuentre pedidos por su teléfono, cree otros nuevos y pueda leer tu catálogo de productos

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

SalesDrive se conecta con una clave API más el subdominio de tu tienda. Una vez vinculado, el agente encuentra pedidos por número de teléfono, crea otros nuevos desde el chat y, si lo activas, puede sugerir productos de tu catálogo.

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

* **Cuenta de SalesDrive** con un plan que tenga el acceso a la API activado en **Settings** > **API**. Los planes gratuitos no ofrecen la API.
* **Clave API general** de SalesDrive, no la clave Form-API: son distintas.
* **Espacio de trabajo de HAPP** con al menos un agente configurado para hablar con clientes.
* **Embudo y estado inicial**: decide dónde deben caer los pedidos nuevos.

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

1. En el panel de administración de SalesDrive, ve a **Settings** > **General settings & integrations**.
2. Navega a **Own sites & marketplaces** y elige **API**.
3. Haz clic en **API keys*&#x2A; y, en la tabla, elige la fila &#x2A;*"For website integration (system)"** y copia esa clave.

<img alt="La tabla de claves API de SalesDrive: la fila que hay que copiar es &#x22;For website integration (system)&#x22;" src="__img0" />

## Conectar [#connect]

1. En HAPP abre **Integraciones** y busca SalesDrive 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                                                                    |
| --------- | ------------------------------------------------------------------------ |
| Clave API | La clave API general de SalesDrive > Settings > API                      |
| Dominio   | Solo el subdominio: para `happstore.salesdrive.me` introduce `happstore` |

SalesDrive pasa a **Mis integraciones** como una tarjeta que muestra su **Información de la cuenta**: el dominio de la tienda 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**: el agente busca pedidos por número de teléfono y devuelve los datos del contacto.
* **Crear**: el agente crea pedidos nuevos con el nombre, el teléfono y el comentario del cliente.
* **Catálogo**: el agente obtiene acceso a tu catálogo de productos y puede sugerir productos. Esto requiere una **clave pública del catálogo YML**: en SalesDrive ve a **Settings** > **Integrations** > **YML Export** y copia la clave pública.

## Solución de problemas [#troubleshooting]

| Error                              | Causa                                                      | Solución                                                                                                                                                                                                                                                                                               |
| ---------------------------------- | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `INVALID_API_KEY`                  | Clave incorrecta o copiada con espacios                    | Vuelve a copiar la clave. Usa la clave API **general** de SalesDrive > Settings > API, no la clave Form-API.                                                                                                                                                                                           |
| `WRONG_DOMAIN`                     | Se introdujo el dominio completo en lugar del subdominio   | Introduce solo el subdominio. Para `happstore.salesdrive.me` el valor es `happstore`.                                                                                                                                                                                                                  |
| `TOKEN_REVOKED` (401)              | Un administrador rotó o revocó la clave                    | Genera una clave nueva en SalesDrive > Settings > API y vuelve a conectar en HAPP.                                                                                                                                                                                                                     |
| `RATE_LIMITED` (429)               | Se alcanzó el límite de peticiones de la API de SalesDrive | Espera 1–2 minutos y reintenta. Si sigue pasando, [contacta con soporte](https://happ.tools/contacts): podemos limitar las peticiones por nuestra parte.                                                                                                                                               |
| Los pedidos no llegan a SalesDrive | Sincronización mal configurada                             | Revisa tres cosas, en orden: el embudo y el estado inicial están seleccionados en **Configuración**; los campos de cliente de SalesDrive usados en la asignación están activos, no archivados; la lista blanca de IP en SalesDrive > Settings > API está vacía **o** incluye las IP de salida de HAPP. |

¿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** > **SalesDrive**, haz clic en **Desconectar** junto a la tienda conectada y confirma.

Después de desconectar:

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

**Para volver a conectar:** abre **Integraciones** > **SalesDrive**, haz clic en **Conectar** y vuelve a introducir tu dominio y la clave API.

Se conserva al volver a conectar: la selección de embudo y estado inicial, la asignación de campos, la vinculación agente–tienda y la analítica de pedidos 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
