# ThreeCX

La integración con **3CX** permite importar automáticamente las grabaciones de tu sistema telefónico a **Salescaling** para su análisis. La conexión requiere algunos pasos técnicos adicionales.

**¿Cómo conectar tu cuenta de 3CX?**

1. Accede a tu cuenta de **Salescaling.**
2. Dirígite a la sección de [**Integrations**](https://app.salescaling.com/settings/integrations) en **Settings**.
3. Localiza la integración de **3CX** y haz clic en **Connect**.
4. Se abrirá una ventana con dos métodos de conexión posibles: **Username-Password o SFTP.** Elige el que mejor se adapte a tu configuración.

### 1.Conexión por Usuario y Contraseña

Este método es el más directo si tienes acceso a las credenciales de la instancia.

* **Username:** Introduce tu nombre de usuario de 3CX.
* **Password:** Introduce tu contraseña.
* **Instance** **URL:** Escribe la URL de tu instancia de 3CX.

<figure><img src="/files/A4CUohYgkgLKjdfZjeI9" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
**Nota Importante sobre Permisos:**\
Para garantizar una conexión segura y completa, la cuenta de **3CX** que se utilice para la autenticación debe tener privilegios de Administrador. Solo los administradores pueden conceder los permisos necesarios para que aplicaciones de terceros, como **Salescaling**, puedan acceder a los datos de las llamadas.
{% endhint %}

### 2. Conexión por SFTP (Recomendado)

Este método es el **más seguro y recomendado** para transferir las grabaciones de 3CX a Salescaling. Utiliza el protocolo SFTP con autenticación de clave pública SSH.

#### ¿Por qué se necesita una SSH Public Key?

La clave pública SSH es un método de autenticación seguro que permite a tu sistema 3CX conectarse automáticamente al servidor SFTP de Salescaling sin necesidad de contraseñas. Esto garantiza:

* **Seguridad**: Las claves SSH son mucho más seguras que las contraseñas tradicionales
* **Automatización**: 3CX puede exportar grabaciones automáticamente sin intervención manual
* **Aislamiento**: Cada cliente tiene su propio espacio aislado en el servidor SFTP

#### Pasos para configurar SFTP

**1. Generar tu par de claves SSH**

Necesitas generar un par de claves SSH (pública y privada). La clave **pública** se comparte con Salescaling, mientras que la clave **privada** permanece en tu servidor 3CX.

**En Windows:**

1. Abre PowerShell como administrador
2. Ejecuta el siguiente comando:

   ```powershell
   ssh-keygen -t ed25519 -C "3cx-salescaling"
   ```
3. Cuando te pregunte dónde guardar la clave, presiona Enter para usar la ubicación por defecto
4. Puedes agregar una contraseña adicional o dejarla en blanco
5. Esto generará dos archivos:
   * `id_ed25519` (clave privada - **NO compartir**)
   * `id_ed25519.pub` (clave pública - compartir con Salescaling)

**En Linux/macOS:**

1. Abre una terminal
2. Ejecuta el siguiente comando:

   ```bash
   ssh-keygen -t ed25519 -C "3cx-salescaling"
   ```
3. Sigue las mismas instrucciones que en Windows
4. Las claves se guardarán en `~/.ssh/`

**2. Configurar la conexión en Salescaling**

1. Accede a [**Integrations**](https://app.salescaling.com/settings/integrations) en **Settings**
2. Haz clic en **Connect** en la integración de **3CX**
3. Selecciona la pestaña **SFTP (Recommended)**
4. Copia el contenido del archivo `.pub` (tu clave pública) y pégalo en el campo **SSH Public Key**
5. Completa el mapeo de usuarios (Extension Mapping)
6. Haz clic en **Save**

{% hint style="info" %}
**Información Importante:**

* El **SFTP Username** se genera automáticamente y es único para tu organización
* Solo necesitas proporcionar tu **SSH Public Key**
* **Nunca** compartas tu clave privada (el archivo sin `.pub`)
  {% endhint %}

**3. Configurar 3CX para exportar a SFTP**

Una vez conectado en Salescaling, recibirás las credenciales SFTP (host, puerto, username). Ahora debes configurar 3CX para exportar grabaciones:

1. Accede a tu panel de administración de 3CX
2. Sigue la guía oficial de 3CX para configurar la exportación SFTP: [Manual de 3CX - Copia de seguridad y restauración](https://www.3cx.es/docs/manual/copia-de-seguridad-restaurar-pbx-failover/)
3. Usa las credenciales SFTP proporcionadas por Salescaling
4. Configura la clave privada SSH que generaste en el paso 1

{% hint style="warning" %}
**Método Deprecado:**

El método de **Username-Password** está deprecado y será eliminado en futuras versiones. Recomendamos encarecidamente usar **SFTP** para mayor seguridad y confiabilidad.
{% endhint %}

#### **Mapeo de Usuarios (User Mapping)**

Este paso es obligatorio para ambos métodos de conexión. Consiste en asociar la **Extension ID** (el número de extensión) de cada usuario en 3CX con su **User** en Salescaling.

Haz clic en **+ Add User Mapping** para añadir tantas filas como necesites, asegurándote de que cada usuario de **3CX** cuyas llamadas quieras importar esté correctamente mapeado.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.salescaling.com/configuraciones-de-la-plataforma/integraciones/conectar-plataformas-de-llamadas/threecx.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.