# Integração com o Vimeo


A integração com o Vimeo transfere sua biblioteca de mídia para o Kinescope usando uma chave de API e permite trazer novos vídeos sem exportações repetidas nem downloads manuais. Os vídeos são salvos na pasta escolhida no catálogo, na qualidade original.

## O que a integração oferece

O card do Vimeo na seção Integrações abre na aba **Descrição**, que lista os principais recursos:

1. **Escolha onde salvar.** Indique o projeto ou a pasta no Kinescope para onde os vídeos do Vimeo serão transferidos — veja [«Organização da biblioteca de mídia»](https://docs-br.kinescope.com/catalog-and-video-management/organizing-media-library/).
2. **Proteção e acesso.** Configure a privacidade: [domínios permitidos e links seguros](https://docs-br.kinescope.com/content-protection/access-restrictions/), proteção por senha e, se necessário, [criptografia DRM](https://docs-br.kinescope.com/content-protection/drm-encryption/) e [marcas d'água dinâmicas](https://docs-br.kinescope.com/content-protection/watermarks/).
3. **Analytics e marketing.** Acompanhe visualizações, geografia e ações dos espectadores — os dados de [analytics](https://docs-br.kinescope.com/catalog-and-video-management/analytics/) servem para retargeting e otimização de conteúdo.
4. **Aparência do player.** Envie seu logotipo, escolha o esquema de cores e configure os controles do player conforme sua marca — veja [«Personalização do player»](https://docs-br.kinescope.com/video-player/player-customization/).

## Para quem é este artigo

* **Proprietários de bibliotecas no Vimeo** — precisam mover os vídeos para o Kinescope e trabalhar em um só lugar
* **Administradores de plataformas** — precisam trazer regularmente novos vídeos da conta do Vimeo
* **Criadores de cursos** — precisam transferir materiais de ensino sem perder o acesso aos vídeos no site
* **Desenvolvedores** — precisam da tabela de correspondência de IDs para substituir os links no site ou na aplicação

> **Информация:**

A integração funciona com contas Vimeo que têm acesso à API — plano Pro ou superior. Você pode verificar seu plano atual [na seção de edição de perfil do Vimeo](https://vimeo.com/settings/profile/general). Se estiver em outro plano, a transferência pode ser feita pelo suporte — veja [«Migrando vídeos para o Kinescope de outras plataformas»](https://docs-br.kinescope.com/getting-started/migrating-from-other-platforms/).



## O que você vai precisar

* Uma conta Vimeo com acesso à API (Pro ou superior)
* Um token de acesso do Vimeo com permissão de leitura de vídeos
* Um projeto ou pasta no catálogo do Kinescope para salvar os vídeos

## Passo 1. Crie um token de acesso no Vimeo

1. Faça login no [portal do desenvolvedor do Vimeo](https://developer.vimeo.com/).
2. Crie um aplicativo e gere um token de acesso pessoal.
3. Nas permissões do token, mantenha ao menos o acesso de leitura aos vídeos — **Public** e **Private** para o escopo **Videos**.
4. Copie o token — o Vimeo o exibe apenas uma vez.

> **Внимание:**

**Importante:** sua biblioteca no Vimeo pode estar organizada em pastas ou em álbuns. Por padrão, usamos a estrutura de pastas. Se você usa álbuns, o token deve incluir também a permissão **Edit**. São transferidos apenas os vídeos enviados à Team Library.



![Configuração das permissões do token de API do Vimeo: permissão Edit para migração de álbuns](images/int-vimeo-token-scopes.png)

## Passo 2. Conecte a integração no Kinescope

1. Abra a seção **Integrações** no [painel do Kinescope](https://app.kinescope.io/integrations) e selecione **Vimeo** — a integração está na categoria "Redes sociais".
2. Clique em **Conectar** ou vá para a aba **Configurações** — todos os campos necessários estão no bloco **Conexão**.
3. No campo **Chave de API do Vimeo**, cole o token de acesso das configurações do seu aplicativo Vimeo.
4. No bloco **Onde salvar os vídeos no Kinescope?**, clique em **Selecionar** e escolha o projeto ou a pasta para os arquivos enviados.
5. Clique em **Salvar**.

O botão **Salvar** fica ativo somente quando os dois campos estão preenchidos — a chave e a pasta. Depois de salvar, o Kinescope valida a chave e suas permissões: se a chave for válida, você verá quantos vídeos serão baixados e a transferência da biblioteca começa. Se a chave foi revogada, expirou ou não tem permissões suficientes, a integração informa que o token é inválido — gere um novo no Vimeo e salve novamente.

> **Информация:**

A quantidade de vídeos na integração pode diferir do que você vê na interface do Vimeo: a API também retorna vídeos com erros de processamento.



## Passo 3. Sincronize novos vídeos

O botão **Sincronizar** traz apenas os vídeos que apareceram na conta do Vimeo após a última sincronização. Vídeos excluídos no Vimeo permanecem no Kinescope — a sincronização nunca remove conteúdo.

1. Abra as configurações da integração com o Vimeo na seção Integrações.
2. Clique em **Sincronizar**. O botão fica disponível apenas quando há uma chave válida salva.
3. Acompanhe o progresso: ao lado do botão, um contador mostra `5 de 1005`, em que `5` é quantos vídeos novos já foram enviados e `1005` é quantos vídeos novos foram encontrados no Vimeo.

### Status da sincronização

| Status | O que significa |
| --- | --- |
| Sincronização não iniciada | A integração está configurada e o botão Sincronizar está ativo |
| Sincronizando, `{N} de {Total}` | `N` vídeos novos enviados de `Total` encontrados |
| Sucesso | Sincronização concluída, todos os vídeos novos foram enviados |
| Sincronizado `{N} de {Total}` | Sincronização concluída, parte dos vídeos não foi enviada |
| Erro | Problema com a chave, o acesso ou a API do Vimeo — o texto do erro aparece na dica |

Se parte dos vídeos não foi enviada (por exemplo, por erros de rede, limites da API do Vimeo ou problemas com um arquivo específico), clique em **Sincronizar** novamente — os vídeos faltantes serão trazidos na próxima execução. Não são criadas duplicatas: os vídeos são comparados pelo ID do Vimeo.

## O que acontece com os vídeos depois da transferência

* Os vídeos são salvos na pasta escolhida no catálogo e enviados na qualidade original.
* Cada vídeo indica **Vimeo** como origem.
* Os metadados dos vídeos são transferidos como nas outras integrações.
* Ao final do envio, você pode baixar a tabela de correspondência de IDs (Vimeo ID ↔ Kinescope ID) — uma forma prática de substituir automaticamente os links dos vídeos no site ou na aplicação, sem perder o acesso.

## Perguntas frequentes

{{< faq >}}
{{< faq-item q="A chave parou de funcionar — o que fazer?" >}}
Gere um novo token no [portal do desenvolvedor do Vimeo](https://developer.vimeo.com/), cole-o no campo "Chave de API do Vimeo", clique em Salvar e execute a sincronização.
{{< /faq-item >}}

{{< faq-item q="Os vídeos que já estavam no Vimeo antes da conexão serão enviados?" >}}
Sim. Ao salvar a chave pela primeira vez, o Kinescope transfere a biblioteca da conta; depois disso, o botão Sincronizar traz apenas os vídeos novos.
{{< /faq-item >}}

{{< faq-item q="O que acontece se eu executar a sincronização duas vezes?" >}}
Nada demais: os vídeos são comparados pelo ID do Vimeo, então não são criadas cópias duplicadas.
{{< /faq-item >}}

{{< faq-item q="E se meu plano do Vimeo for inferior ao Pro?" >}}
Escreva para o suporte — a transferência será feita manualmente a partir de uma lista de links de download. Veja mais em [«Migrando vídeos para o Kinescope de outras plataformas»](https://docs-br.kinescope.com/getting-started/migrating-from-other-platforms/).
{{< /faq-item >}}

{{< faq-item q="Se eu excluir um vídeo no Vimeo, ele será excluído no Kinescope?" >}}
Não. A sincronização apenas adiciona vídeos novos — excluir algo no Vimeo não afeta o catálogo do Kinescope.
{{< /faq-item >}}
{{< /faq >}}

## O que fazer a seguir?

Depois de transferir os vídeos do Vimeo, recomendamos:

1. **[Organizar a biblioteca de mídia](https://docs-br.kinescope.com/catalog-and-video-management/organizing-media-library/)** — distribua os vídeos transferidos em projetos e pastas
2. **[Configurar a proteção de conteúdo](https://docs-br.kinescope.com/content-protection/)** — ative criptografia DRM, marcas d'água e restrições por domínio
3. **[Configurar analytics](https://docs-br.kinescope.com/catalog-and-video-management/analytics/)** — acompanhe visualizações e engajamento
4. **[Personalizar o player](https://docs-br.kinescope.com/video-player/player-customization/)** — ajuste a aparência do player à sua marca
5. **[Migração de outras plataformas](https://docs-br.kinescope.com/getting-started/migrating-from-other-platforms/)** — se também precisar mover vídeos do YouTube, Wistia e outros serviços

Ainda tem dúvidas? Escreva para o chat de suporte na interface do Kinescope — nossos especialistas vão ajudar!