Zoom para recuperar o VTT da reunião correta

API and Webhooks
1

Olá equipe Zoom,

Estou desenvolvendo uma automação no Make (Integromat) utilizando um aplicativo OAuth Server-to-Server criado no Zoom Marketplace.

O fluxo atual é:

  1. Recebo o webhook meeting.ended.
  2. O webhook entrega corretamente:
    • Meeting ID
    • Meeting UUID
    • Start Time
    • End Time
    • Host ID
    • Host Email
  3. Após alguns minutos, faço chamadas à API do Zoom para localizar o arquivo VTT (Closed Caption ou Audio Transcript) da reunião que acabou de terminar.

Problema encontrado:

A chamada:

GET /v2/meetings/{meetingId}/recordings

não está retornando a ocorrência da reunião que gerou o webhook.

Exemplo real:

Webhook recebido:

  • Meeting ID: 88557851768
  • UUID: PrJF50fkTjeu6XfBiGV7OQ==
  • Start Time: 2026-06-04T18:05:39Z
  • End Time: 2026-06-04T18:12:13Z

Porém a chamada de recordings retorna:

  • UUID: Tb5mMp8ETpunfvSuJmfLhw==
  • Start Time: 2026-05-28T22:54:20Z

Ou seja, uma ocorrência anterior da mesma reunião.

Nosso objetivo é identificar e baixar automaticamente o arquivo VTT correspondente exatamente à reunião que disparou o webhook meeting.ended.

Gostaríamos de entender:

  1. Qual é a forma recomendada pelo Zoom para localizar a transcrição (VTT) da ocorrência específica da reunião que acabou de encerrar?
  2. Existe algum endpoint mais apropriado do que GET /meetings/{meetingId}/recordings para esse cenário?
  3. Existe alguma relação entre o UUID recebido no webhook e os arquivos VTT disponibilizados pela API?
  4. Caso este não seja o fluxo recomendado, qual seria a abordagem sugerida pelo Zoom para recuperar a transcrição correta de reuniões recorrentes ou reuniões que possuem múltiplas ocorrências com o mesmo Meeting ID?
  5. Existe algum requisito específico de configuração do aplicativo OAuth Server-to-Server ou escopo adicional necessário para recuperar a transcrição da ocorrência correta?

Nosso objetivo não é necessariamente seguir uma implementação específica, mas sim entender qual é a arquitetura recomendada oficialmente pelo Zoom para recuperar o VTT da reunião correta após o evento meeting.ended.

Obrigado.