Integrar o Brandfolder com o BigCommerce significa que as imagens aprovadas no DAM passam a alimentar as fichas de produto da loja sem que alguém as carregue uma a uma. A Brandfolder não lista o BigCommerce entre as suas integrações de comércio, por isso a ligação faz-se pela API da Brandfolder e pela API de catálogo do BigCommerce, com um serviço que decide o que enviar e quando.
Para a empresa, o ganho está em evitar o trabalho duplicado e os erros de versão: o ficheiro certo no DAM e outro, mais antigo, na loja. Na Avafa acompanhamos este tipo de ligações dentro da nossa área de integração de DAM com ecommerce, e este guia explica o essencial para planear um projeto no BigCommerce.
Vê aqui o que dizem as documentações oficiais, como se mapeiam os campos entre os dois sistemas, os passos de implementação, os limites a ter em conta e uma lista de verificação final.
Há integração direta entre Brandfolder e BigCommerce?
Não consta da página oficial de integrações da Brandfolder, consultada em outubro de 2026. Nessa página, o único conector de comércio é o do Shopify, e a empresa refere a sua API pública e plataformas como o Zapier e o Tray.ai para quem quer construir ligações próprias.
Isto não impede a integração; apenas significa que alguém tem de a construir e manter. Há três caminhos habituais: desenvolvimento à medida, uma plataforma de integração ou um conector de terceiros. Se avaliar um conector de terceiros, peça a lista de campos que sincroniza e o que acontece quando um ativo é retirado.
O que o BigCommerce aceita do lado das imagens
O BigCommerce trata as imagens como um recurso do produto, com ordem, miniatura e descrição. Segundo a referência da API de catálogo, o endpoint de imagens de um produto é o recurso de imagens dentro de /v3/catalog/products/{id}, autenticado com o cabeçalho X-Auth-Token e com o âmbito de leitura ou de modificação de produtos.
Cada imagem devolve o campo que a marca como miniatura, a ordem de apresentação, a descrição, o caminho do ficheiro e endereços de CDN para vários tamanhos: padrão, miniatura, muito pequeno e ampliação. Ou seja, a loja gera os tamanhos por si, e o DAM não precisa de enviar uma versão para cada um.
A listagem é paginada, com um máximo de 250 resultados por página e 50 por omissão, segundo a documentação. Para catálogos grandes, isto pesa no desenho da reconciliação.
O que a API da Brandfolder oferece
A API v4 usa um token como credencial e organiza os dados em organização, Brandfolder, secção, coleção, ativo e anexo. O anexo é o ficheiro; o ativo é o registo que o agrupa e onde vivem os campos personalizados.
Segundo a documentação oficial, os campos personalizados são pares chave-valor de texto ligados a um único ativo. É ali que deve ficar o SKU do BigCommerce, a ordem da imagem e a indicação de qual é a principal. A listagem dos ativos de uma secção pode incluir os anexos na mesma chamada, o que poupa pedidos.
Para detetar alterações, existem webhooks com os eventos de criação, atualização e eliminação de ativos. O aviso não traz os dados do ativo, apenas o seu identificador e o tipo de evento, e pode chegar fora de ordem.
Mapa de campos entre os dois sistemas
Este mapa é o ponto de partida de qualquer projeto e deve ficar escrito antes de se programar.
| Brandfolder | BigCommerce | Regra |
|---|---|---|
| Campo SKU | Produto da loja | Obrigatório |
| Campo ordem | Ordem de apresentação | Número inteiro |
| Campo principal | Marca de miniatura | Só uma por produto |
| Nome do ativo | Descrição da imagem | Texto curto |
| Ficheiro do anexo | Imagem do produto | Versão aprovada |
Sem o SKU preenchido, a integração não tem forma de saber a que produto pertence cada ficheiro. Por isso recomendamos tornar esse campo obrigatório antes de um ativo poder ser aprovado.
Como implementar passo a passo
Um piloto curto reduz o risco e mostra cedo onde estão as lacunas de dados.
- Criar no Brandfolder os campos personalizados do mapa acima.
- Escolher 30 produtos representativos, com variantes e imagens múltiplas.
- Criar uma conta de API no BigCommerce apenas com o âmbito de produtos.
- Criar um utilizador técnico na Brandfolder com acesso só ao Brandfolder necessário.
- Construir o serviço que lê o aviso, consulta o ativo, valida o SKU e atualiza as imagens do produto.
- Comparar a loja com o DAM e corrigir as diferenças antes de alargar.
- Programar uma reconciliação diária para o catálogo completo.
Como lidar com os webhooks da Brandfolder
O serviço deve responder de imediato e processar depois. A documentação indica que o endereço de retorno tem de ser público e devolver um código 2xx; sem resposta, a Brandfolder repete o envio até 15 vezes, com esperas crescentes.
Um ativo novo gera um evento de criação e, quando está pronto para uso, um de atualização. Como as mensagens podem chegar fora de ordem, o serviço deve usar a hora do evento para decidir qual é a mais recente e ignorar a mais antiga.
Há ainda um detalhe operacional: se a chave de API perder o acesso ao recurso, a subscrição é desativada em cerca de 30 minutos. Quem muda permissões ou rotaciona chaves deve avisar a equipa que mantém a integração.
Quando compensa automatizar e quando não
Automatizar compensa quando o catálogo muda com frequência e as imagens vêm de várias equipas. Com poucas referências e pouca alteração, uma importação periódica feita à mão ou por ficheiro pode ser mais barata de manter.
Compensa, em regra, quando:
- há centenas de produtos com várias imagens cada um;
- as imagens mudam por campanha, estação ou mercado;
- o processo de aprovação existe e deve ser respeitado pela loja;
- hoje alguém passa horas a carregar ficheiros e a corrigir erros.
Se nenhum destes pontos se aplica, comece por organizar o DAM e adie a automação.
Lista de verificação antes de ir para produção
- O SKU é obrigatório e validado no DAM.
- Cada produto tem uma só imagem marcada como principal.
- A ordem das imagens está definida em todos os ativos.
- A conta de API do BigCommerce só tem o âmbito necessário.
- O serviço responde ao webhook de imediato e usa fila.
- O mesmo aviso, recebido duas vezes, não cria imagens duplicadas.
- Os ativos retirados do DAM deixam de aparecer na loja, segundo uma regra escrita.
- A paginação de 250 resultados está tratada na reconciliação.
- Há registo de erros e alguém que o recebe.
- Existe um plano para repor as imagens se a carga falhar.
Como trabalhamos na Avafa
Começamos pelo mapa de campos e pelos responsáveis de cada dado, e só depois escolhemos como ligar os sistemas. Revemos o fluxo antes do desenvolvimento, para que o projeto não arranque com o DAM e a loja a corrigirem o mesmo campo. Para ver como abordamos estes projetos, comece pela página de integração de DAM com ecommerce ou pela nossa agência de SEO para BigCommerce.
Guias relacionados do mesmo cluster
Se ainda não decidiu o DAM ou a plataforma, estes guias comparam outras combinações:
- Widen DAM com BigCommerce
- OpenText DAM com BigCommerce
- Canto com BigCommerce
- Brandfolder com Salesforce Commerce Cloud
- Brandfolder com Adobe Commerce
Perguntas frequentes
A Brandfolder tem integração oficial com o BigCommerce?
Não consta da página de integrações da Brandfolder, que apenas lista o Shopify como conector de comércio. A ligação faz-se pela API ou por uma plataforma de integração.
Preciso de enviar vários tamanhos de cada imagem?
Não necessariamente. Segundo a referência do BigCommerce, a API devolve endereços de CDN para vários tamanhos da mesma imagem. Confirme na sua loja o tamanho que o tema usa.
Como sei a que produto pertence cada ficheiro?
Pelo SKU guardado num campo personalizado do ativo. Sem esse campo, a integração não tem como associar o ficheiro ao produto.
O que acontece se o webhook falhar?
A Brandfolder tenta de novo até 15 vezes e acaba por desativar a subscrição se a falha persistir. Por isso a reconciliação diária é essencial.
Quanto custa manter a integração?
Depende do volume e do número de regras. Peça sempre uma estimativa de manutenção, além do custo de desenvolvimento.