Integrar o Canto com o Adobe Commerce é ligar o DAM, onde os conteúdos de marca são aprovados e versionados, às lojas, aos idiomas e aos canais que o Adobe Commerce gere. O objetivo é que cada vista de loja mostre a imagem certa para o seu mercado, sem que alguém tenha de a procurar, exportar e carregar à mão.
Em empresas com várias lojas, o problema raramente é a falta de imagens. É haver demasiadas versões em sítios diferentes e ninguém saber qual é a atual. Na Avafa tratamos estas ligações dentro da nossa área de integração de DAM com ecommerce, e este guia resume o que decidir antes de arrancar.
Vamos ver o que o Canto oferece para publicar em vários canais, que arquitetura escolher, como tratar vistas de loja e idiomas, que passos seguir e que erros evitar. As referências a documentação oficial estão citadas no texto, sem ligações externas.
Que ligação existe entre o Canto e o Adobe Commerce?
Nas páginas públicas do Canto que consultámos não está descrito um conector próprio para o Adobe Commerce. Em março de 2026 o Canto anunciou integrações com a Shopify e com a Amazon e disse que vai alargar o ecossistema de parceiros a mais canais de comércio, sem os nomear.
A ligação faz-se, por isso, pela API REST do Canto, que o fabricante descreve como totalmente documentada, e pela API de Commerce da Adobe. O Canto oferece ainda um pacote de chamadas comuns, o Universal Connector, que reúne a autenticação OAuth, a pesquisa global de assets e os filtros por pastas e álbuns, e funciona com qualquer aplicação com JavaScript.
Como é que o Canto publica para vários canais?
O Canto tem um produto de publicação, o Media Publisher, que entrega conteúdos aprovados a lojas e outros canais a partir da biblioteca. Segundo a página do produto, converte os ficheiros em formatos web, entrega-os por uma CDN, ajusta tamanhos e recortes a cada plataforma, sincroniza alterações e remove automaticamente os assets desatualizados.
A documentação técnica fala em Media Delivery Cloud. Cria uma imagem mestre a partir do original, com uma largura por omissão na ordem dos 2000 píxeis e configurável, e todas as versões saem dela. Para obter outro tamanho muda-se o endereço, sem entrar no Canto. A instalação pede uma chave de API com o modo Client Credentials ativo, uma imagem alternativa e, no modelo com conta AWS própria, acesso temporário a essa conta. Demora cerca de três dias úteis.
Copiar ficheiros ou usar o endereço de entrega?
Para uma operação com várias lojas, a pergunta decisiva é onde deve viver a versão oficial do ficheiro. Esta matriz resume como decidimos:
| Situação | Copiar para o Commerce | Endereço do Canto |
|---|---|---|
| Poucas lojas, imagens estáveis | Adequado | Excessivo |
| Muitas lojas e idiomas | Pesado de manter | Adequado |
| Mesmo ficheiro em vários canais | Duplica versões | Adequado |
| Tema sem suporte a URL externo | Adequado | Exige adaptação |
| Sem equipa técnica interna | Mais simples | Depende de parceiro |
Se optar por copiar, a documentação de Commerce da Adobe descreve o pedido de adição de imagem: um POST ao endpoint de media do produto, /V1/products/{sku}/media, com o tipo de media, a etiqueta, a posição, o estado, os papéis da imagem e o conteúdo em base64 com tipo MIME e nome do ficheiro. O exemplo da documentação usa o código de loja default no caminho do pedido, o que mostra que o pedido se dirige a uma vista de loja concreta. A página avisa ainda que um pedido pode demorar cerca de 30 segundos.
Como tratar vistas de loja e idiomas?
Trate o ficheiro e o texto como duas coisas separadas. A fotografia é a mesma em todas as lojas; a etiqueta, a descrição e o nome dependem do idioma. Se o DAM só guardar um idioma, a loja portuguesa acaba com etiquetas em inglês.
Por isso, defina no Canto campos de metadados por idioma, ou deixe os textos no PIM e use o Canto apenas para o ficheiro. Se existirem imagens específicas de um mercado, por exemplo uma embalagem com texto legal diferente, guarde-as com um metadado de mercado e deixe que seja esse metadado a decidir a que vista de loja chegam.
O SKU continua a ser a chave de associação. Sem ele, nenhum processo consegue ligar o ficheiro do Canto ao produto do Commerce.
Que permissões e que segurança devem existir?
A integração deve ter o mínimo de acesso possível. No Canto, use uma chave de API criada só para este fim, em vez de reutilizar a de um utilizador. No Adobe Commerce, crie uma ligação de integração limitada ao catálogo e às imagens, para que uma falha ou uma fuga de credenciais não dê acesso a encomendas ou a clientes.
Registe quem é o responsável por cada credencial e quando expira. Parece um pormenor, mas é a causa mais comum de sincronizações que páram sem aviso meses depois de o projeto ser entregue.
Como medir se a integração compensa?
Meça o antes e o depois com indicadores simples, recolhidos durante um mês antes de arrancar e outro depois. Não prometa ganhos que não consegue demonstrar; use apenas o que consegue contar.
- Tempo médio entre a aprovação de uma imagem no Canto e a sua publicação na loja.
- Número de produtos publicados sem imagem ou com a imagem errada.
- Pedidos internos para exportar ou reenviar ficheiros.
- Imagens antigas encontradas online numa amostra semanal.
Se, ao fim de dois meses, estes números não melhoraram, o problema está quase sempre nos metadados e não na tecnologia.
Que passos seguir para integrar?
- Listar as lojas, os idiomas e os canais que vão consumir os conteúdos.
- Definir os metadados obrigatórios no Canto: SKU, mercado, idioma e estado.
- Escolher entre copiar os ficheiros e usar o endereço de entrega.
- Criar uma chave de API dedicada, com o modo Client Credentials, e guardá-la fora do código.
- Criar no Adobe Commerce uma ligação de integração só com as permissões necessárias.
- Testar com produtos de pelo menos duas vistas de loja e dois idiomas.
- Validar o que acontece quando um ficheiro é retirado ou substituído no Canto.
- Escalar para o catálogo completo e agendar a sincronização com alertas.
Que erros se repetem nestes projetos?
| Erro | Consequência |
|---|---|
| Sem metadado de mercado | Imagem errada numa vista de loja |
| Textos só num idioma | Etiquetas em inglês na loja portuguesa |
| Chave de API partilhada | Risco de acesso e difícil auditoria |
| Sem regra de retirada | Imagens antigas ficam online |
| Teste só com um produto | Variantes e kits falham em produção |
Quase todos se evitam com decisões tomadas antes de programar: quem manda em cada dado, que metadados são obrigatórios e o que acontece quando uma peça é retirada.
Lista de verificação antes de arrancar
- Cada ficheiro tem SKU, mercado e estado no Canto.
- Está definido quem aprova uma substituição de imagem.
- A chave de API tem responsável e data de renovação.
- Há uma imagem alternativa para produtos sem fotografia aprovada.
- A retirada de um ficheiro foi testada até à loja.
- Alguém lê o registo de erros todas as semanas.
Como trabalhamos na Avafa
Começamos por mapear lojas, idiomas, ficheiros e responsáveis, e só depois escolhemos a forma de ligação. Validamos o desenho com um lote pequeno antes de escalar. Para ver como abordamos estes projetos, comece pela página de integração de DAM com ecommerce.
Guias relacionados do mesmo cluster
Se a plataforma de destino ainda não está decidida, estes guias comparam alternativas:
- Canto com Magento: DAM para o catálogo
- Bynder e Adobe Commerce: fluxos de conteúdo
- CELUM com Adobe Commerce: catálogos multi-país
- Widen com Adobe Commerce: experiência multicanal
- OpenText DAM com Adobe Commerce
Perguntas frequentes
O Canto tem conector oficial para o Adobe Commerce?
Nas páginas públicas do Canto que consultámos não encontrámos um conector descrito. Confirme com o Canto, porque a lista de integrações é atualizada com frequência.
Posso usar o mesmo ficheiro em várias lojas?
Sim, desde que o ficheiro seja o mesmo e os textos sejam tratados à parte. Com o endereço de entrega, as várias lojas apontam para a mesma imagem mestre.
O Universal Connector serve para esta integração?
Pode servir de base. Segundo o Canto, reúne a autenticação OAuth, a pesquisa de assets e os filtros por pastas e álbuns, mas a ligação ao Commerce continua a ter de ser desenvolvida.
E se o tema não aceitar imagens de um endereço externo?
Terá de adaptar o tema ou copiar os ficheiros para a galeria. Valide este ponto com o programador antes de escolher a arquitetura.
Como sei que um ficheiro retirado do Canto saiu da loja?
Teste-o antes de arrancar: retire um ficheiro de teste no Canto e confirme que desaparece da vista de loja. Repita o teste depois de cada alteração ao processo.