Guia de Instalação do Servidor Transcription Engine 3CX

Introdução

Este guia explica como instalar e configurar o servidor 3CX Transcrição Engine para uso local ou na nuvem.

O 3CX Transcrição Engine adiciona transcrição com tecnologia de IA, detecção de locutor e análise de transcrição ao seu sistema telefônico 3CX. Ele pode ser implantado localmente ou na nuvem e se integra diretamente ao Console de Administração.

Observação: disponível para a Edição IA ou superior, com 16SC ou superior.

Sobre os exemplos neste documento

Este documento usa example.com como o FQDN do 3CX e wmr.3cx-example.com como o FQDN da máquina de transcrição; você precisará substituir por seus próprios FQDNs.

Requisitos do host da máquina

Especificações de hardware

  • GPU: Mínimo recomendado (rápido): GPU Nvidia 24 GB RTX
  • CPU: Mínimo: 4 vCPU, recomendado: 6 vCPU
  • RAM: Mínimo: 24 GB
  • Armazenamento: Mínimo: 20 GB de espaço livre em disco
  • Local ou nuvem

Configurações da BIOS

  • Inicialização segura: desativada
  • CSM: desativado
  • Suporte para redimensionamento de BAR: desativado (pode exigir uma reinicialização dupla)
  • IOMMU: ativado

Sistema operacional

  • SO: Debian 12 (totalmente atualizado)

Configuração do firewall

Abra as seguintes portas TCP para tráfego de entrada na máquina:

  • TCP 61443 – permitir apenas a partir do IP do PABX
  • TCP 80 – para criação/renovação de certificado SSL Let’s Encrypt; normalmente, isso não é necessário se você estiver usando certificados SSL personalizados

Configure seu sistema

  • Faça login na sua máquina de transcrição via SSH e eleve para root
  • Atualize seu sistema:

apt-get update

apt-get upgrade

  • Instale os pré-requisitos necessários:

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

  • Para garantir que todas as atualizações do sistema tenham efeito (especialmente as atualizações da imagem do kernel), reinicie o sistema agora:

reboot

  • verifique se os drivers NVIDIA já estão instalados e funcionando:

nvidia-smi

  • Se você receber uma resposta de comando não encontrado, será necessário instalar os drivers da 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

  • Após a reinicialização, confirme se tudo está funcionando corretamente:

nvidia-smi

  • ...que mostrará o status atual da 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:~$

Executar Comando de Instalação

Instalando Transcription Engine 3CX

  • No Console de Admin 3CX, navegue até “Admin → Integrações → Transcrição”.
  • Defina o Provedor de Transcrição como 3CX Transcription Engine (Instalado Localmente).
  • Clique no botão Continuar.

Execute o comando para efetuar a instalação

  • A página Transcrição exibirá agora o comando de instalação a ser executado na sua máquina transcritora; clique no botão Copiar para copiar o comando para a área de transferência
  • Faça login na sua máquina de transcrição via SSH e eleve para root
  • Execute o comando de instalação, semelhante ao seguinte exemplo:

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

Assistente de Instalação da Transcrição

Você será solicitado a escolher entre usar Certificados SSL Personalizados ou certificados gerados com o Let's Encrypt.

Usando Certificados SSL Personalizados

  • Coloque seus arquivos de certificado no formato PEM em /opt/3cxwm/cert:
  • server.crt deve conter sua chave pública (e possivelmente sua cadeia de certificados)
  • server.key deve conter sua chave privada
  • Certifique-se de que as permissões adequadas estejam definidas em seus arquivos de certificado:

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

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

Criando Certificados com o Certbot

Para criar seus próprios certificados com o Let's Encrypt Certbot:

  • Faça login na sua máquina de transcrição via SSH e eleve para root
  • execute os seguintes 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

Renovação Automática do Certificado

Para automatizar a renovação do certificado com o Let's Encrypt Certbot:

  • Faça login na sua máquina de transcrição via SSH e eleve para root
  • Execute nano /root/certupdate.sh para criar o script e defina o conteúdo da seguinte forma:

#!/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.*

  • Torne o script executável:

chmod +x /root/certupdate.sh

  • Edite o crontab:

crontab -e

  • Adicione o seguinte ao crontab:

0 3 * * * /root/certupdate.sh

Política de FQDN Fornecida pela 3CX

Se você estiver usando um FQDN fornecido pela 3CX (por exemplo, durante a instalação pela Opção 1), lembre-se de que:

  • O FQDN será excluído se o Mecanismo de Transcrição for removido da Interface do Usuário do PABX.
  • Se o seu PABX não entrar em contato com wmr.3cx.net dentro de 30 dias, o FQDN será excluído automaticamente.

Verifique a Conectividade com o Servidor de Transcrição

Para verificar a conectividade do PABX ao Servidor de Transcrição, você pode executar o seguinte comando no PABX:

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

OK

[email protected]:~$

... que deve aparecer como OK para uma resposta bem-sucedida.

Status do Mecanismo de Transcrição

Você também pode navegar até “Admin → Integrações → Transcrição” no Console de Admin 3CX para verificar o Status do seu Mecanismo de Transcrição.

Atualizações do Servidor de Transcrição

Programado

O Servidor de Transcrição verifica e atualiza automaticamente para a versão mais recente. A tarefa de atualização automática é executada todos os domingos às 1:00 da manhã (Hora do Servidor).

Sob Demanda

Se você deseja atualizar para a versão mais recente antes do período de atualização programado:

  • Faça login na sua máquina de transcrição via SSH e eleve para root.
  • Execute os seguintes comandos:

sudo apt update

sudo apt -y upgrade

Configurar a Transcrição

Acesse este documento para saber como habilitar e configurar a transcrição para os endpoints de sua escolha.

Veja Também

Última atualização

Este documento foi atualizado pela última vez em 13 de julho de 2026.

https://www.3cx.com.br/docs/servidor-mecanismo-transcricao/