Guía de Instalación del Servidor del Motor de Transcripción 3CX

Introducción

Esta guía explica cómo instalar y configurar el Servidor del Motor de Transcripción de 3CX para su uso On-Premise o en la nube.

El Motor de Transcripción 3CX incorpora transcripción basada en IA, detección de interlocutores y análisis de transcripciones a su Sistema Telefónico 3CX. Se puede implementar On-Premise o en la nube y se integra directamente con la Consola de Administración.

Nota: Disponible para la edición IA con 16SC o superior.

Acerca de los Ejemplos de Este Documento

Este documento utiliza example.com como FQDN de 3CX y wmr.3cx-example.com como FQDN de la máquina de Transcripción; deberá sustituirlos por sus propios FQDNs.

Requisitos del Equipo Huésped

Especificaciones del Hardware

  • GPU: Mínimo Recomendado (Rápido): Nvidia 24GB RTX GPU.
  • CPU: Mínimo: 4vCPU, Recomendado: 6vCPU.
  • RAM: Mínimo: 24GB.
  • Almacenamiento: Mínimo: 20GB de Espacio Libre en Disco.
  • On-premise o en la Nube.

Ajustes de la BIOS

  • Arranque Seguro: Desactivado.
  • CSM: Desactivado.
  • Cambiar el Tamaño del BAR Soporte: Desactivado (puede requerir un reinicio doble).
  • IOMMU: Habilitado.

Sistema Operativo

  • OS: Debian 12 (Totalmente Actualizado).

Configuración del Cortafuegos (‘Firewall’)

Abra los siguientes puertos TCP para el tráfico entrante a la máquina:

  • TCP 61443 – permitir solo desde la IP del PBX.
  • TCP 80 – para la creación / renovación de certificados SSL de Let’s Encrypt; normalmente esto no es necesario si utiliza certificados SSL personalizados.

Configurar su Sistema

  • Inicie sesión en su máquina de transcripción a través de SSH y obtenga privilegios de root.
  • Actualice su sistema:

apt-get update

apt-get upgrade

  • Instale los requisitos previos necesarios:

apt -y install curl apt-transport-https gnupg gpg wget iptables-persistent build-essential dkms

  • Para garantizar que todas las actualizaciones del sistema surtan efecto (en particular, las actualizaciones de la imagen del núcleo), reinicie el sistema ahora:

reboot

  • Comprobar si los controladores NVIDIA ya están instalados y funcionando:

nvidia-smi

  • Si recibe una respuesta de command not found, deberá instalar los controladores NVIDIA:

apt -y install linux-headers-$(uname -r)

wget https://developer.download.nvidia.com/compute/cuda/repos/debian12/x86_64/cuda-keyring_1.1-1_all.deb

dpkg -i cuda-keyring_1.1-1_all.deb

apt update

apt -y install nvidia-open

apt -y install nvidia-driver-cuda nvidia-kernel-open-dkms

reboot

  • Después de reiniciar, confirme que todo funciona correctamente:

nvidia-smi

  • ...que le mostrará el estado actual de la máquina:

user@wmr-3cx-example-com:~$ nvidia-smi

Mon Jan 26 09:04:40 2026      

+-----------------------------------------------------------------------------------------+

| NVIDIA-SMI 590.48.01              Driver Version: 590.48.01      CUDA Version: 13.1     |

+-----------------------------------------+------------------------+----------------------+

| GPU  Name                 Persistence-M | Bus-Id          Disp.A | Volatile Uncorr. ECC |

| Fan  Temp   Perf          Pwr:Usage/Cap |           Memory-Usage | GPU-Util  Compute M. |

|                                         |                        |               MIG M. |

|=========================================+========================+======================|

|   0  NVIDIA L4                      On  |   00000000:00:03.0 Off |                    0 |

| N/A   40C    P8             12W /   72W |       0MiB /  23034MiB |      0%      Default |

|                                         |                        |                  N/A |

+-----------------------------------------+------------------------+----------------------+

+-----------------------------------------------------------------------------------------+

| Processes:                                                                              |

|  GPU   GI   CI              PID   Type   Process name                        GPU Memory |

|        ID   ID                                                               Usage      |

|=========================================================================================|

|  No running processes found                                                             |

+-----------------------------------------------------------------------------------------+

user@wmr-3cx-example-com:~$

Ejecutar Comando de Instalación

Seleccionando el Motor de Transcripción 3CX

  • Desde su Consola de Administración 3CX, navegue a "Admin → Integraciones → Transcripción".
  • Defina el Proveedor de Transcripción a el Motor de Transcripción de 3CX (Instalado Localmente).
  • Haga clic en el botón Continuar.

Ejecutar Comando de Instalación

  • La página Transcripción mostrará ahora el comando de instalación que debe ejecutar en su máquina de transcripción; haga clic en el botón Copiar para copiar el comando al portapapeles.
  • Inicie sesión en su máquina de transcripción a través de SSH y obtenga privilegios de root.
  • Ejecute el comando de instalación, similar al siguiente ejemplo:

source <(curl -s https://example.com/webmeeting/onboardai/99887766-aabb-1122-ccdd-abcdef123456)

Asistente de Instalación de Transcripción

Se le pedirá que elija entre utilizar Certificados SSL Personalizados o certificados generados con Let's Encrypt.

Uso de Certificados SSL Personalizados

  • Coloque sus archivos de certificado en formato PEM en /opt/3cxwm/cert:
  • server.crt debe contener su clave pública (y posiblemente su cadena de certificados).
  • server.key debe contener su clave privada.
  • Asegúrese de que los permisos adecuados estén configurados en sus archivos de certificado:

sudo chown www-data:www-data /opt/3cxwm/cert/server.*

sudo chmod 600 /opt/3cxwm/cert/server.*

Creación de Certificados con Certbot

Para crear sus propios certificados con Let's Encrypt Certbot:

  • Inicie sesión en su máquina de transcripción a través de SSH y obtenga privilegios de root.
  • Ejecute los siguientes comandos:

sudo apt-get install certbot

sudo certbot certonly --standalone --preferred-challenges http -d wmr.3cx-example.com

cp /etc/letsencrypt/live/wmr.3cx-example.com/fullchain.pem /opt/3cxwm/cert/server.crt

cp /etc/letsencrypt/live/wmr.3cx-example.com/privkey.pem /opt/3cxwm/cert/server.key

Renovación Automática de Certificados

Para automatizar la renovación de certificados con Let's Encrypt Certbot:

  • Inicie sesión en su máquina de transcripción a través de SSH y obtenga privilegios de root.
  • Ejecute nano /root/certupdate.sh para crear el script y configure el contenido de la siguiente manera:

#!/bin/bash

cp /etc/letsencrypt/live/wmr.3cx-example.com/fullchain.pem /opt/3cxwm/cert/server.crt

cp /etc/letsencrypt/live/wmr.3cx-example.com/privkey.pem /opt/3cxwm/cert/server.key

chown www-data:www-data /opt/3cxwm/cert/server.*

chmod 600 /opt/3cxwm/cert/server.*

  • Haga que el script sea ejecutable:

chmod +x /root/certupdate.sh

  • Edite el crontab:

crontab -e

  • Agregue lo siguiente al crontab:

0 3 * * * /root/certupdate.sh

Política de FQDN Proporcionada por 3CX

Si utiliza un FQDN proporcionado por 3CX (por ejemplo: durante la instalación mediante la Opción 1), tenga en cuenta que:

  • El FQDN se eliminará si se elimina el Motor de Transcripción de la Interfaz de Usuario del PBX.
  • Si su PBX no se conecta a wmr.3cx.net en un plazo de 30 días, el FQDN se eliminará automáticamente.

Verificar la Conectividad con el Servidor de Transcripción

Para verificar la conectividad entre el PBX y el Servidor de Transcripción, puede ejecutar el siguiente comando en el PBX:

[email protected]:~$ curl -w "\n" https://wmr.3cx-example.com:61443/webmeeting

OK

[email protected]:~$

... que debería mostrarse OK si la respuesta ha sido satisfactoria.

Estado del Motor de Transcripción

También puede ir a "Admin → Integraciones → Transcripción" en la Consola de Administración de 3CX para comprobar el Estado del Motor de Transcripción.

Actualizaciones del Servidor de Transcripción

Programadas

El Servidor de Transcripción comprueba y actualiza automáticamente a la última versión. La tarea de actualización automática se ejecuta todos los Domingos a la 1:00 AM (hora del Servidor).

Bajo Demanda

Si desea actualizar a la última versión antes de la ventana de actualización programada:

  • Inicie sesión en su máquina de transcripción a través de SSH y obtenga privilegios de root.
  • Ejecute los siguientes comandos:

sudo apt update

sudo apt -y upgrade

Última Actualización

Este documento se actualizó por última vez el 23 de Abril de 2026

https://www.3cx.es/docs/servidor-motor-transcripcion/