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:
- Arraste o MP4 para a área de envio ou clique nela para escolher o arquivo. O limite é de 50 MB.
- 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.
- Acompanhe a barra de progresso. Enquanto o envio não termina, o botão Gravar fica bloqueado com um aviso.
- 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.