Suporte: seg. a sex., das 9h às 18h

Como funciona a integração com o DigitalOcean Spaces

Atualizado em 20/10/2026

A integração com o DigitalOcean Spaces conecta a loja a um espaço de armazenamento (o bucket) que fica na conta da DigitalOcean da sua empresa. Com ela ativa, você envia vídeos em MP4 direto do computador para o cadastro de fotos do produto, e a loja os exibe no player da própria loja na página do produto, sem depender do Vimeo.

Você a encontra em Marketing & SEO > Integrações, no bloco Outros, no item DigitalOcean Spaces.

O que muda para você

  • A conta é sua. O armazenamento e o tráfego dos vídeos são cobrados pela DigitalOcean, e os valores atuais estão no site deles. A Braavo não guarda o arquivo.
  • O vídeo precisa estar pronto. A Braavo não converte nem comprime o arquivo, então você envia o MP4 já no tamanho e no formato certos (veja o artigo sobre como preparar o vídeo do produto).
  • Os vídeos do Vimeo e do YouTube continuam funcionando. Quem já tem links cadastrados não precisa mudar nada.

Passo 1: criar o bucket

No painel da DigitalOcean, em Spaces Object Storage, crie um bucket e escolha a região e o nome dele. Use um bucket só para os vídeos da loja: isso deixa a conta organizada e permite limitar a chave de acesso (passo 2) a ele.

  • Região — a mesma que você vai escolher na tela da Braavo. Se tiver dúvida, escolha a mais próxima dos seus clientes.
  • Nome — de 3 a 63 caracteres, só com letras minúsculas, números e hifens, começando e terminando com letra ou número. Informe só o nome, sem endereço.
  • CDN (opcional) — nas configurações do bucket, você pode ligar o CDN da DigitalOcean, que entrega os vídeos mais rápido. O endereço do CDN (algo como nome-do-bucket.regiao.cdn.digitaloceanspaces.com) vai no campo Domínio do CDN da tela. Sem CDN, os vídeos saem pelo endereço do próprio bucket.

Passo 2: criar a chave de acesso

Nas configurações do bucket, na seção Access Keys, use Create Access Key. Dê um nome à chave e deixe as permissões Read/Write/Delete limitadas a esse bucket (o tipo Limited Access).

Atenção: a chave secreta só aparece no momento em que a chave é criada. Copie as duas (a chave de acesso e a secreta) antes de fechar a janela. Se perder a secreta, crie uma chave nova. Evite usar uma chave com acesso a toda a conta: a chave limitada só alcança este bucket, e é isso que a torna segura.

Passo 3: preencher a tela

A tela tem três seções, e o selo ao lado do título Conexão mostra o estado da integração: Não configurada, Desligada, Falta o CORS ou Conectada.

  • Enviar vídeos para o Spaces — o interruptor que liga a integração. Desligado, o cadastro de fotos deixa de enviar vídeo, e os vídeos já publicados continuam na loja.
  • Chave de acesso e Chave secreta — as duas chaves do passo 2. Por segurança, a chave secreta gravada nunca é exibida de novo: a tela mostra só os quatro últimos caracteres dela, e o campo fica vazio. Preencha-o só se quiser trocar a chave.
  • Região do bucket e Nome do bucket — os mesmos que você usou ao criar o bucket.
  • Domínio do CDN — o endereço do CDN, se você o ligou, sempre com https (o vídeo só toca na loja por https). Em branco, os vídeos saem pelo endereço do bucket.
  • Endereços (seção Domínios autorizados) — um endereço por linha, com https://. São as páginas de onde você envia os vídeos, ou seja, o endereço do painel da loja. Em branco, vale só o endereço atual da loja, que a tela mostra no campo.

Atenção: ao publicar a loja em um endereço novo (por exemplo, https://www.minhaloja.com.br), volte aqui e revise a lista de domínios. Se o endereço do painel não estiver na lista, o navegador bloqueia o envio.

Para ligar a integração, a tela exige a chave de acesso, a chave secreta, a região e o nome do bucket. Um campo fora da regra (um nome de bucket com letra maiúscula, um CDN em http://, uma linha que não é um endereço na lista de domínios) é apontado na tela, e nada é gravado até você corrigir.

Ao gravar com a integração ligada, a Braavo testa a conexão: grava e apaga um arquivo pequeno no bucket. Se o teste falhar, a integração é desligada e o aviso no topo da tela diz o motivo (por exemplo, credencial recusada ou bucket não encontrado).

Passo 4: liberar o envio no bucket (CORS)

O navegador só envia arquivos para um endereço diferente do da página quando esse endereço permite. No Spaces, essa permissão se chama CORS. A Braavo tenta criar a regra sozinha, mas uma chave limitada a um bucket não tem permissão para mexer nessa configuração.

Quando isso acontece, a conexão é feita mesmo assim, o selo mostra Falta o CORS e a tela abre com um aviso amarelo, com a regra a criar. Nesse caso, crie a regra à mão: no painel da DigitalOcean, abra o bucket, vá em Settings > CORS Configurations > Add e preencha:

  • Origin — um endereço da lista de domínios autorizados, escrito exatamente igual (com https:// e, se houver, a porta). Crie uma regra para cada endereço.
  • Allowed Methods — marque PUT.
  • Allowed Headers — adicione content-type.
  • Access Control Max Age — 3600.

Atenção: sem essa regra, o envio do vídeo falha com um erro de rede. O erro mais comum é o Origin escrito de forma diferente da lista, por exemplo sem o https://. Depois de criar a regra, o aviso sai e o selo passa a Conectada no primeiro vídeo enviado pelo cadastro de fotos, porque é esse envio que prova a regra. Gravar a tela de novo com a chave limitada volta a mostrar o aviso até o envio seguinte.

Como enviar o vídeo

Em Estoques > Fotos, na edição (ou no cadastro) de uma foto do produto, a seção Vídeo ganha o bloco Enviar vídeo:

  1. Arraste o MP4 para a área de envio ou clique nela para escolher o arquivo. O limite é de 50 MB.
  2. A tela analisa o arquivo. Se encontrar algo que pode pesar ou não tocar bem, mostra avisos e deixa você escolher entre Enviar mesmo assim e Escolher outro arquivo. Sem avisos, o envio começa sozinho.
  3. Acompanhe a barra de progresso. Enquanto o envio não termina, o botão Gravar fica bloqueado com um aviso.
  4. Ao terminar, a tela informa que o vídeo será publicado quando você clicar em Gravar. É o Gravar que torna o vídeo público e coloca o endereço dele no campo Link do vídeo.

Atenção: se você fechar a tela sem gravar, o envio é descartado e o vídeo não é publicado.

Trocar ou remover o vídeo

  • Trocar — envie outro vídeo e grave. O arquivo antigo é apagado do bucket. Se, depois de enviar, você colar outro link no campo Link do vídeo ou escolher um vídeo na Galeria Vimeo, vale a última escolha: o vídeo enviado é descartado.
  • Remover — apague o endereço do campo Link do vídeo e grave. O arquivo também é apagado.
  • Apagar a foto — o vídeo dela é apagado junto.

A Braavo só apaga os vídeos que ela mesma publicou para aquele produto. Um link de fora (Vimeo, YouTube) e o vídeo de outro produto nunca são apagados.

Ao excluir um produto inteiro, porém, os vídeos dele continuam no bucket. Se quiser liberar o espaço, apague a pasta do produto no painel da DigitalOcean.

Se algo der errado

  • Credencial recusada — confira a chave de acesso, a chave secreta e se a chave tem permissão neste bucket.
  • Bucket não encontrado — confira o nome do bucket e a região.
  • "Não foi possível enviar o arquivo ao Spaces" — quase sempre é o domínio fora da lista de domínios autorizados ou a regra de CORS ausente ou escrita de outro jeito. Revise os dois.
  • A integração desligou sozinha ao gravar — o teste de conexão falhou, e o aviso no topo da tela diz o motivo. Corrija e grave de novo.

Envios que não foram gravados

Quando você escolhe um vídeo e fecha a tela sem gravar, o arquivo já enviado fica em uma pasta de rascunhos do bucket (videos/rascunhos). Você não precisa fazer nada com ele: sempre que um novo vídeo é enviado, a Braavo apaga os rascunhos com 1 dia ou mais, com qualquer tipo de chave.