Integrar o Brandfolder com o Adobe Commerce é fazer com que o catálogo da loja use as imagens aprovadas no DAM, sem carregamentos manuais produto a produto. Não há um conector da Brandfolder para esta plataforma na lista oficial; a ligação faz-se com a API da Brandfolder e a API REST do Adobe Commerce, através de um serviço que valida e envia os ficheiros.
O interesse para a empresa está no controlo: as equipas de marketing aprovam num sítio e a loja reflete a versão certa, em todos os idiomas e vistas de loja. Na Avafa abordamos estes projetos na nossa área de integração de DAM com ecommerce, e este guia foca-se no que é específico do Adobe Commerce.
Vê aqui como funciona o carregamento de imagens por REST, o que acontece nas vistas de loja, os passos do projeto, os erros a evitar e uma lista final de verificação.
Há um conector da Brandfolder para o Adobe Commerce?
Não consta da página oficial de integrações da Brandfolder, consultada em outubro de 2026. O único conector de comércio ali listado é o do Shopify, e a Brandfolder indica a sua API pública e plataformas como o Zapier e o Tray.ai para quem constrói ligações próprias.
Por isso, quem escolhe o Adobe Commerce tem de decidir entre desenvolvimento à medida e uma plataforma de integração. A escolha depende do volume de produtos, do número de vistas de loja e da equipa técnica disponível.
Como o Adobe Commerce recebe imagens por REST
Segundo a documentação para programadores da Adobe, a imagem adiciona-se com um pedido POST ao endereço de media do produto, identificado pelo SKU, dentro do caminho /rest/default/V1/products. O corpo do pedido leva o tipo de media, a etiqueta, a posição, se está desativada, as funções da imagem e o conteúdo.
O ponto que mais surpreende as equipas é o conteúdo. A documentação mostra o ficheiro enviado codificado em base64, com o tipo e o nome do ficheiro. Isto significa que o serviço intermédio tem de descarregar o ficheiro da Brandfolder, convertê-lo e só depois enviá-lo para a loja.
A Adobe avisa que o pedido pode demorar cerca de 30 segundos, consoante o alojamento. Em lotes grandes, isto pesa no tempo total e justifica processar por fila e em paralelo controlado.
| Campo do pedido | Valor típico | Origem no DAM |
|---|---|---|
| Tipo de media | Imagem | Anexo do ativo |
| Etiqueta | Texto da imagem | Nome do ativo |
| Posição | Número inteiro | Campo ordem |
| Funções | Base, miniatura | Campo principal |
| Conteúdo | Ficheiro em base64 | Anexo descarregado |
O que acontece nas vistas de loja
No Adobe Commerce, o âmbito da loja influencia o que se vê, e um pedido mal desenhado pode apagar mais do que se pretende. A Adobe documenta que o código de loja vai no caminho do pedido, que uma imagem nova aparece em todas as vistas de loja e que eliminar uma imagem a remove de todas.
Há um aviso que merece destaque. Segundo a Adobe, enviar uma lista vazia de entradas de galeria remove todas as imagens de todas as vistas de loja, enquanto omitir a lista não faz alterações. Um erro no serviço que envie uma lista vazia por falha de leitura pode esvaziar o catálogo.
Para repor a herança de valores, a Adobe indica que se pode enviar a etiqueta, a posição ou o estado de desativação como nulos, voltando a usar o valor por defeito. As funções da imagem não constam dessa tabela de reposição.
Regras de proteção que recomendamos
- Nunca enviar uma lista vazia de imagens: se a leitura do DAM falhar, o serviço pára e avisa.
- Trabalhar ao nível do SKU e da imagem individual, sem reescrever a galeria inteira.
- Distinguir o que é alteração global do que é específico de uma vista de loja.
- Guardar o identificador devolvido pela loja para atualizar ou apagar a mesma imagem mais tarde.
- Testar primeiro numa cópia do catálogo.
O que a API da Brandfolder fornece
A API v4 usa token de autenticação e organiza os dados em organização, Brandfolder, secção e coleção, ativo e anexo. Os campos personalizados são pares chave-valor de texto num ativo, ideais para o SKU, a ordem e a vista de loja de destino.
Para ser avisado de alterações, a Brandfolder oferece webhooks de criação, atualização e eliminação de ativos. O aviso identifica o ativo e o evento, não traz os dados, e pode chegar fora de ordem. O endereço de retorno tem de ser público e responder de imediato com 2xx, senão há até 15 novas tentativas.
Como tratar aprovações, validade e versões
O estado do ativo no DAM deve decidir o que a loja mostra. Segundo a documentação dos webhooks, o evento de atualização cobre alterações ao nome, à descrição, à secção, ao estado de aprovação, à expiração, às etiquetas e aos campos personalizados. Ou seja, um ativo que perde a aprovação gera um aviso que o serviço pode tratar.
Recomendamos que o serviço compare sempre o estado atual com o que a loja tem. Se o ativo deixou de estar aprovado ou expirou, a imagem desativa-se na loja em vez de ser apagada, o que permite reverter sem novo carregamento. Em catálogos com vários idiomas, a etiqueta da imagem também deve vir do DAM, para não ficar em branco nas vistas de loja.
Passo a passo do projeto
- Definir os campos personalizados do DAM: SKU, ordem, principal e vista de loja.
- Listar as vistas de loja e decidir o que é igual em todas e o que muda.
- Criar o utilizador de integração no Adobe Commerce com permissões mínimas.
- Criar a chave de API da Brandfolder para um utilizador técnico.
- Construir o serviço: recebe o aviso, consulta o ativo, descarrega, converte e envia.
- Testar com um conjunto de produtos que inclua variantes e imagens múltiplas.
- Ativar a carga completa e uma reconciliação diária.
Quando a integração compensa
Compensa quando há muitos produtos, várias lojas e um processo de aprovação que a loja deve respeitar. Com poucas referências, uma importação planeada pode custar menos a manter do que um serviço permanente.
Um sinal claro de que compensa é o tempo que a equipa gasta a carregar ficheiros e a corrigir versões antigas. Outro é a existência de mercados com imagens diferentes para o mesmo produto.
Lista de verificação antes de ir para produção
- Os campos SKU, ordem e principal estão preenchidos e validados no DAM.
- O serviço nunca envia uma lista vazia de imagens.
- Está decidido o que é global e o que é por vista de loja.
- O utilizador de integração só tem as permissões necessárias.
- O tempo de resposta dos pedidos foi medido em lote.
- O serviço trata os avisos repetidos sem duplicar imagens.
- O identificador de cada imagem na loja fica guardado.
- Há reconciliação diária entre DAM e catálogo.
- Os erros chegam a alguém com responsabilidade definida.
- Existe plano de reposição se a carga falhar.
Como trabalhamos na Avafa
Começamos pelos campos do DAM e pela estrutura de vistas de loja, e só depois escolhemos a forma de ligação. Revemos as regras de proteção do catálogo antes de qualquer desenvolvimento. Para ver como abordamos estes projetos, comece pela página de integração de DAM com ecommerce.
Guias relacionados do mesmo cluster
Se ainda não decidiu o DAM, estes guias analisam outras combinações:
- Widen com Adobe Commerce
- OpenText DAM com Adobe Commerce
- Canto com Adobe Commerce
- Brandfolder com Magento
- Brandfolder com SAP Commerce Cloud
Perguntas frequentes
O Adobe Commerce aceita imagens por URL?
A documentação da Adobe que consultámos mostra o envio do ficheiro em base64. Para outras formas, consulte a referência da API na sua versão.
Uma imagem nova aparece em todas as vistas de loja?
Sim, segundo a Adobe, uma imagem adicionada aparece em todas as vistas de loja. Os valores específicos de cada vista podem depois ser ajustados.
O que acontece se enviar uma lista vazia de imagens?
Segundo a documentação da Adobe, remove todas as imagens de todas as vistas de loja. Por isso o serviço deve bloquear este caso.
A Brandfolder tem conector para o Adobe Commerce?
Não consta da sua página oficial de integrações, que lista apenas o Shopify como conector de comércio.
Qual o melhor momento para sincronizar?
Em tempo quase real, com webhooks, para alterações diárias, e em lote, fora de horas, para cargas grandes.