Transcrição do Google Cloud Storage & Speech API V2 para Gravações/Correio de voz no 3CX V20

Observação: As etapas 1 e 2 podem ser ignoradas se você já tiver uma conta do GCloud com os direitos apropriados e os compartimentos do Google.

Observações:

• As etapas 1 e 2 podem ser ignoradas se você já tiver uma conta no GCloud com os direitos adequados e buckets do Google.
• Oferecemos uma integração guiada por um assistente para os serviços do Google; este documento serve como um guia básico para quem desejar configurar esse componente manualmente.

Etapa 1: Acesso Necessário à Conta

Para configurar os buckets de armazenamento do Google, acesse "IAM & Admin" > "IAM" no painel do Google Cloud e verifique se sua conta tem, no mínimo, essas funções atribuídas:

• "Administrador da Conta de Serviço".
• "Administrador da Chave da Conta de Serviço".
• "Administrador do IAM do Projeto".
• "Administrador de Armazenamento".

Etapa 2: Criar um Bucket de Armazenamento

Você pode pular esta parte se já tiver configurado os Storage Buckets em seu projeto

Se você tiver uma assinatura ativa com opções de pagamento configuradas, prossiga para criar um novo bucket de armazenamento em seu projeto de nuvem do Google:

No menu de navegação principal, selecione "Storage" (Armazenamento) > "Browser" (Navegador) e clique em "Create Bucket" (Criar Compartimento) para criar um novo compartimento de armazenamento.

• Na página "Criar um bucket", configure:
• Nome - insira um nome permanente globalmente exclusivo.
• Onde armazenar os dados - selecione o tipo de local de armazenamento de acordo com suas necessidades.
• Classe de armazenamento - selecione a classe de armazenamento apropriada para seu uso.
• Controle de acesso - defina como controlar o acesso aos objetos no bucket de armazenamento.
• Configurações avançadas - opcionalmente, defina preferências de política de criptografia e retenção para o bucket de armazenamento.
• Clique em "Create" (Criar) para configurar o novo bucket de armazenamento.
• Depois de criar o compartimento de armazenamento, você pode clicar em "Create folder" (Criar pasta) para adicionar novas pastas para manter os backups e as gravações arquivadas, por exemplo, "3cx_backups".

Prossiga para usar sua chave JSON salva e defina o bucket de armazenamento do Google Cloud configurado como um local para armazenar backups do 3CX e arquivar gravações.

⚠ Importante:

Os arquivos de backup armazenados ou as gravações arquivadas no estado "Em espera" ou armazenadas/arquivadas devido à política de retenção efetiva não podem ser excluídos ou substituídos pelo PABX.

Etapa 3: Habilitar a API de Fala-para-Texto da Nuvem para seu Projeto

No Console do Google, navegue até APIs e serviços > Biblioteca e pesquise a API Cloud Speech-to-Text. Selecione-a e clique em "Enable" (Ativar).

Etapa 4: Criar uma Conta de Serviço e uma Chave com Armazenamento e Acesso ao Speech

Em seu projeto do GCloud, navegue até IAM & Admin > Contas de serviço e clique em "Criar Conta de Serviço". Dê um nome a ela e clique em "Create and Continue" (Criar e Continuar).

Adicione as seguintes funções à sua conta de serviço e clique em "Continue" (Continuar) e depois em "Done" (Concluído):

1. Administrador de Armazenamento
2. Administrador do Speech na Nuvem

Edite a conta de serviço recém-criada e selecione a guia "Keys" (Chaves) e, em seguida, "Add Key" (Adicionar chave)

Selecione o tipo JSON e clique em "Create" (Criar).

Um arquivo json será baixado. Salve-o em um local seguro, pois você não poderá baixá-lo novamente.

Etapa 5: Ativar o Arquivamento Remoto e a Transcrição

1. Para configurar o 3CX para usar a transcrição de mensagens de voz e/ou gravações, acesse Console de Admin > Sistema > Armazenamento.
2. Ative “Armazenamento e Arquivamento Remoto de Dados” e selecione “Google Storage” (Armazenamento Google) como Tipo de localização (obrigatório).
3. Carregue o arquivo JSON baixado na etapa anterior no campo Chave privada (tipo JSON) e selecione uma pasta/caminho dentro do seu bucket do Google Storage.
4. Marque as caixas de seleção “Gravações” e “Mensagens de Voz” para ativar o arquivamento automático no Google Storage.
5. Salve e, em seguida, acesse Admin > Integrações > Transcrição.
6. Selecione “Google Speech” como mecanismo de transcrição.
7. Selecione o menu suspenso “Idioma da Fala” para definir o idioma da transcrição.
8. Selecione o que deseja transcrever:

1. “Apenas mensagens de voz” — restringe às mensagens de voz.
2. “Apenas gravações” – restringe às gravações.
3. “Mensagens de voz e gravações”

9. Clique em “OK” para aplicar as configurações. Após ativar a transcrição de mensagens de voz, o texto transcrito é incluído no corpo do e-mail para as mensagens de voz recebidas. Além disso, nas seções “Mensagens de voz” e “Gravações” do Cliente Web 3CX, o texto transcrito é exibido ao lado de cada mensagem de voz/gravação.

As gravações são transcritas na íntegra no momento do arquivamento remoto (imediatamente/no horário programado). O 3CX inclui o Arquivamento no Bucket e, portanto, o arquivo pode ser transcrito na íntegra.

Veja Também

• API de Controle de Chamadas para Linux
• API de Controle de Chamadas para Windows
• Criação de um Script de Processamento de Chamadas
• Script de Processamento de Chamadas para Entrada de DTMF 

Última Atualização

Este documento foi atualizado pela última vez em 10 de setembro de 2026

https://www.3cx.com.br/docs/manual/google-speech-api-v2/