# Integração da transcrição Zoom Receba e automatize facilmente as transcrições de reuniões do Zoom no Botpress para reuniões organizadas por utilizadores específicos do Zoom. ## Como funciona 1. **A reunião do Zoom termina** → O Zoom envia um webhook quando a transcrição está pronta. 2. **Filtros de integração `host_id`** → Permite apenas eventos do(s) usuário(s) especificado(s) do Zoom. 3. **A transcrição é obtida e limpa** → Descarregada do Zoom e convertida em texto simples. 4. **Evento emitido** → Um evento `transcriptReceived` com `meetingUUID` e `transcript` está disponível para seus fluxos. --- ## Utilização - Desencadear fluxos de trabalho** → Adicionar um cartão "Listen to Event" para `transcriptReceived`. - Aceder aos dados** → Utilizar `event.payload.meetingUUID` e `event.payload.transcript` nos fluxos. - Armazenar transcrições** → Guardar em tabelas para posterior análise ou relatório. --- ## Pré-requisitos Você deve ser: - Um **proprietário da conta Zoom**, **administrador**, ou ter a função **"Zoom para desenvolvedores "** para poder criar o aplicativo Zoom OAuth - Em um **plano Zoom Premium** (o nível gratuito não suporta gravações na nuvem) --- ## Configuração passo a passo ### 1. Criar um aplicativo Zoom OAuth - Visite: [https://marketplace.zoom.us/](https://marketplace.zoom.us/) - Vá para **Desenvolver > Criar aplicativo** → Escolha **Server-to-Server OAuth** → Nomeie seu aplicativo - Na página **App Credentials**, copie: - **ID da conta** - **ID do cliente** - **Segredo do cliente** Utilizá-los-á mais tarde na configuração da integração Botpress . - Em **Informação**, preencha as informações necessárias sobre si e a aplicação. - Em **Features**, copie o **Secret Token** - Em **Scopes**, adicione: cloud_recording:read:list_user_recordings:admin cloud_recording:read:list_recording_files:admin cloud_recording:read:recording:admin - Ativar a aplicação no separador **Activation** ### 2. Obter Zoom `host_id` O `host_id` do Zoom pode ser encontrado diretamente no portal web Zoom. #### Passos: 1. Efetue login na sua conta Zoom e navegue até: **Painel de administração do Zoom > Gerenciamento de usuários > Usuários** 2. Clique no nome do usuário para o qual deseja obter o `host_id`. 3. Veja o URL na barra de endereços do seu browser. Ele terá o seguinte formato: https://yourdomain.zoom.us/user/xxxxxxxxxxxxx/profile. Deves copiar o xxxxxxxxxxxxxxxxx, pois esse é o teu host_id --- ### 3. Configurar a integração Botpress - Instale esta integração no seu Bot - Colar: - `ID do Cliente Zoom` - `Segredo do cliente Zoom` - `ID da conta Zoom` - `Token secreto` - `IDs de usuário Zoom permitidos` → Cole seu `host_id` (você pode incluir vários) Clique em **Salvar configuração**. --- ### 4. Definir Webhook no Zoom De volta ao seu aplicativo Zoom OAuth: - Vá para **Caraterísticas** → Habilitar **Subscrições de eventos** - Nome: `Transcrição recebida` (pode escolher um nome diferente também) - Método: Webhook - URL do ponto final: use o ** URL de integração do Botpress - Adicionar eventos: - Em **Gravação**: - `Todas as gravações foram concluídas` - `As gravações de ficheiros de transcrição foram concluídas` - Clique em **Concluído** - Clique em **Validate** junto ao URL do ponto final (deverá ver Validated) - Clique em **Salvar** --- ## Feito! Seu bot Botpress agora receberá transcrições para usuários Zoom permitidos quando as gravações na nuvem forem concluídas. Certifique-se de que: - Você **gravou na nuvem** - Você está num **plano Zoom pago** - Você adicionou corretamente todos os `host_id`s pretendidos
