✦ Migração de catálogo

Mude sua hospedagem de vídeos sem derrubar nenhuma aula, sem perder o progresso dos alunos e sem precisar mexer manualmente em cada módulo do seu curso.

4 etapas automáticas
Zero downtime
Leitura de 6 min

Se você hospeda cursos na Kiwify e quer ter mais controle sobre seus vídeos — com criptografia, entrega rápida e sem depender de plataformas de terceiros —, o OctaClip foi feito para isso. E para que a transição seja indolor, existe o OctaAir: o sistema de migração que cuida de tudo automaticamente, aula por aula.

Neste guia você vai entender como o processo funciona, o que precisa ter pronto antes de começar e como acompanhar cada etapa sem sustos.

O que é o OctaAir?

O OctaAir é o módulo de migração do OctaClip. Ele funciona diretamente dentro do Chrome por meio de uma extensão chamada Octaclip Bridge, que conecta sua conta na Kiwify ao OctaClip e executa todo o trabalho nos bastidores.

A migração acontece em quatro etapas sequenciais:

🗺️

Etapa 1

Mapear

A extensão lê a lista completa de vídeos do seu curso na Kiwify e monta um inventário com cada aula identificada.

⬇️

Etapa 2

Baixar

Os arquivos originais são copiados e salvos como backup antes de qualquer alteração ser feita no seu curso.

⚙️

Etapa 3

Processar

Cada vídeo é transcodificado para HLS e recebe criptografia AES-128, pronto para entrega pelo OctaClip.

🔄

Etapa 4

Substituir

O iframe antigo de cada aula é trocado pelo novo embed do OctaClip diretamente na Kiwify, sem intervenção manual.

Antes de começar

Garanta que você tem tudo isso em mãos antes de iniciar:

  • Uma conta ativa no OctaClip com espaço suficiente para seus vídeos
  • Acesso de administrador ao seu produto na Kiwify
  • Google Chrome instalado (versão recente)
  • A extensão Octaclip Bridge — solicite o link de instalação com o time
  • Conexão estável durante todo o processo (evite Wi-Fi instável)

Configuração: sua OctaAir API Key

Antes de rodar a primeira migração, você precisa conectar a extensão à sua conta. Isso é feito com a OctaAir API Key: uma chave exclusiva e secreta que vincula todas as migrações apenas aos seus dados.

🔑

OctaAir API Key

••••••••••••••••••••••••••••••••
👁

No painel a chave aparece oculta — clique no ícone de olho para revelá-la e no ícone ao lado para copiar.

  1. 1

    No painel do OctaClip, abra o OctaID e vá até a aba Integração. Localize o card OctaAir API Key, clique no olho para revelar e copie a chave. Se precisar de uma nova, use “Gerar nova chave” — atenção: a chave antiga deixa de funcionar imediatamente.
  2. 2

    Abra a extensão OctaAir (Octaclip Bridge) no Chrome, entre nas Configurações e cole a chave no campo da API Key (ela é enviada no cabeçalho x-api-key). A partir daí, todas as migrações ficam vinculadas à sua conta.
Card da OctaAir API Key na aba Integração do OctaID
1. Copie a chave em OctaID → Integração
Campo da API Key nas configurações da extensão OctaAir
2. Cole no campo da API Key dentro da extensão OctaAir

🔒
Mantenha sua chave em segredo

A OctaAir API Key permite criar migrações em nome da sua conta. Não compartilhe nem cole em lugares públicos. Se desconfiar que ela vazou, gere uma nova chave no painel — a anterior é invalidada na hora.

Passo a passo

1
Etapa 1 — Mapear

Mapear os vídeos do curso

Abra o Chrome com a extensão Octaclip Bridge ativa e acesse o painel do seu produto na Kiwify. A extensão detecta automaticamente os vídeos cadastrados e monta a lista de aulas. Você revisa o inventário antes de avançar — nada é alterado ainda.

Tela de mapeamento de vídeos na extensão Octaclip Bridge
A extensão exibe a lista de aulas identificadas antes de iniciar o processo

2
Etapa 2 — Baixar

Baixar e fazer backup dos arquivos

Com o mapeamento concluído, o OctaAir faz o download dos vídeos originais e os armazena como backup. Esse passo é a sua rede de segurança: se qualquer coisa sair diferente do esperado, você tem os arquivos originais para restaurar aula por aula.

Barra de progresso de download dos vídeos originais
O progresso do download é exibido em tempo real, com o status de cada aula individualmente

3
Etapas 3 e 4 — Processar e Substituir

Processar, criptografar e substituir os embeds

Cada vídeo é convertido para HLS (streaming adaptativo) e recebe criptografia AES-128 — o padrão de segurança do OctaClip. Assim que ficam prontos, a extensão troca o iframe antigo de cada aula pelo novo embed diretamente na Kiwify, aula por aula, em ciclos e sem tirar o curso do ar. Você acompanha tudo até a conclusão pelo próprio app OctaClip.

App OctaClip mostrando a migração concluída, com os embeds já substituídos na Kiwify
No app OctaClip você acompanha a migração até a conclusão, com os embeds já substituídos na Kiwify

💡
Backup e rollback por aula

O OctaAir nunca substitui um vídeo antes de confirmar que o novo está disponível e funcionando. Se quiser reverter uma aula específica, é possível fazer isso individualmente — sem precisar desfazer a migração inteira. Nenhum aluno fica sem acesso durante o processo.

Resumo

  • O OctaAir migra seu catálogo completo e funciona exclusivamente para cursos hospedados na Kiwify.
  • A configuração inicial é feita com a OctaAir API Key (OctaID → Integração), colada nas configurações da extensão.
  • A migração usa a extensão Octaclip Bridge para Chrome — solicite o link com o time.
  • 4 etapas automáticas: Mapear, Baixar, Processar e Substituir.
  • Vídeos transcodificados para HLS e protegidos com criptografia AES-128.
  • Rollback individual por aula e sem downtime para os alunos.
  • Nada é alterado no curso antes de o backup estar garantido.

Pronto para migrar?

Saia para uma hospedagem própria, criptografada e em streaming — no tempo de um ciclo de migração, com seus alunos assistindo normalmente.

Começar minha migração no OctaClip →