Integrar o Canto com o BigCommerce é usar o DAM como repositório oficial dos conteúdos e levar as imagens aprovadas para o catálogo da loja através da API, sem carregamentos manuais produto a produto. O Canto guarda e aprova; o BigCommerce publica.
Há uma particularidade que muda o desenho do projeto: o BigCommerce não mantém uma ligação viva ao ficheiro de origem, faz uma cópia. Na Avafa tratamos estas ligações dentro da nossa área de integração de DAM com ecommerce, e este guia mostra o que essa particularidade implica.
Vamos ver como o BigCommerce recebe imagens e vídeos, o que o Canto pode fornecer, que limites existem, que passos seguir e que riscos evitar. Os factos de plataforma vêm da documentação oficial de cada fornecedor, citada no texto sem ligações externas.
O Canto tem conector para o BigCommerce?
Nas páginas públicas do Canto que consultámos não está descrito um conector próprio para o BigCommerce. 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 Catálogo do BigCommerce. Confirme com o Canto o que é suportado no seu plano antes de fechar o âmbito.
Como é que o BigCommerce recebe as imagens?
Pela API de Catálogo, com um pedido por imagem. Segundo a documentação do BigCommerce, o endpoint de imagens do produto exige o campo image_file ou o campo image_url, e só aceita uma imagem por pedido. Uma chamada GET ao mesmo endpoint devolve todas as imagens do produto.
Com o image_url, o BigCommerce descarrega uma cópia da imagem e serve-a a partir da sua própria CDN. A documentação é explícita: usar um URL não faz do ficheiro uma referência ao original. Com o image_file, o ficheiro é enviado no pedido e podem definir-se outros parâmetros em pares chave-valor.
O registo de alterações do BigCommerce de 24 de agosto de 2023 indica que o limite de tamanho para image_file e image_url passou a 8 MB. Um produto só pode ter uma miniatura, que aparece nas categorias e nas pesquisas; se tiver apenas uma imagem, essa serve de miniatura e de imagem principal.
O que isto significa para uma integração com o Canto?
Significa que o URL do Canto serve apenas de origem para a importação. Se alguém substituir o ficheiro no Canto, a loja continua a mostrar a cópia antiga até a integração voltar a importar a imagem.
Por isso, a integração precisa de detetar alterações no Canto e de repetir a importação. Guarde no BigCommerce, num campo personalizado do produto, o identificador do ficheiro no Canto e a data da última versão importada, para comparar antes de cada sincronização.
Use o Media Delivery Cloud do Canto como origem das cópias, não como endereço final. Segundo o Canto, cria uma imagem mestre a partir do original, por omissão na ordem dos 2000 píxeis de largura e configurável, e gera outras versões alterando parâmetros no endereço. Assim pede-se ao Canto exatamente o tamanho que o tema precisa, abaixo dos 8 MB do BigCommerce. A configuração exige uma chave de API com o modo Client Credentials e demora cerca de três dias úteis.
E os vídeos?
Aqui o BigCommerce limita mais do que o Canto. A documentação do BigCommerce indica que os vídeos de produto têm de estar alojados no YouTube e que o identificador é o valor do parâmetro v do endereço do vídeo. Os endereços públicos são aceites como parâmetros, mas o vídeo tem de ser carregado através do YouTube.
O Canto afirma que o seu Media Publisher incorpora vídeos diretamente a partir do Canto, sem alojamento de terceiros. Para um produto do BigCommerce, isso só serve em páginas de conteúdo ou em código personalizado do tema, não no campo de vídeo do catálogo. Decida de início onde cada vídeo vai aparecer.
Que dados circulam entre o Canto e o BigCommerce?
| Dado | Sistema mestre | Sentido |
|---|---|---|
| Ficheiro da imagem | Canto | Canto para loja |
| Código do produto (SKU) | ERP ou PIM | Origem para Canto e loja |
| Miniatura e ordem | PIM ou Canto | Origem para loja |
| Vídeo de produto | YouTube | Referência na loja |
| Versão importada | Loja | Loja para integração |
Como detetar que um ficheiro mudou no Canto?
Há duas abordagens, e a escolha depende do volume. A primeira é a verificação periódica: uma rotina pergunta ao Canto que ficheiros foram alterados desde a última execução e reimporta apenas esses. É simples de manter e suficiente para a maioria dos catálogos.
A segunda é reagir a notificações do Canto assim que alguém aprova uma nova versão. Consulte a documentação da API do Canto para ver que mecanismos de notificação estão disponíveis no seu plano antes de a escolher; se não existirem, a verificação periódica é a opção segura.
Em ambos os casos, a reimportação deve substituir a imagem antiga do produto e não acrescentar uma segunda. Como o BigCommerce aceita uma imagem por pedido e permite atualizar ou eliminar uma imagem existente, a rotina deve localizar a imagem anterior, atualizá-la ou eliminá-la, e só depois criar a nova, para a galeria não crescer com versões repetidas.
Que passos seguir para integrar?
- Tornar o SKU um metadado obrigatório no Canto.
- Definir a imagem miniatura e a ordem das restantes.
- Criar uma chave de API dedicada no Canto, com o modo Client Credentials.
- Criar no BigCommerce uma conta de API só com permissões de catálogo.
- Importar um lote de teste, com um pedido por imagem, e verificar o limite de 8 MB.
- Guardar o identificador e a versão do ficheiro em cada produto.
- Agendar a deteção de alterações e a reimportação.
- Criar alertas para falhas e para produtos sem imagem.
Que riscos tem e como se evitam?
| Risco | Como se evita |
|---|---|
| Cópia antiga na loja | Reimportar quando o Canto muda |
| Ficheiro acima de 8 MB | Pedir ao Canto uma versão mais leve |
| Muitos pedidos de uma vez | Lotes pequenos em fila |
| Duas miniaturas no mesmo produto | Regra única para a miniatura |
| Chave de API partilhada | Chave dedicada e com responsável |
Lista de verificação antes de arrancar
- Todos os ficheiros têm SKU e estado no Canto.
- Está definido como se deteta uma imagem alterada.
- O tamanho máximo pedido ao Canto cabe nos limites do BigCommerce.
- A miniatura de cada produto está definida.
- Os vídeos têm destino decidido.
- Alguém lê o registo de erros todas as semanas.
Como trabalhamos na Avafa
Começamos por mapear ficheiros, SKU 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 o DAM ou a plataforma ainda não estão decididos, estes guias comparam alternativas:
- Brandfolder com BigCommerce: guia de integração
- Widen como DAM com BigCommerce
- OpenText DAM para assets no BigCommerce
- Bynder com BigCommerce: imagens e vídeos
- Plytix com BigCommerce: PIM leve
Perguntas frequentes
O BigCommerce usa a imagem diretamente do Canto?
Não. Segundo a documentação do BigCommerce, o URL serve para descarregar uma cópia, que é servida a partir da CDN do BigCommerce. A imagem não fica como referência ao original.
Qual é o limite de tamanho das imagens?
O registo de alterações do BigCommerce de 24 de agosto de 2023 indica 8 MB para image_file e image_url. Confirme o valor atual na documentação antes de arrancar.
Posso enviar várias imagens num só pedido?
Não. A documentação indica que só se cria uma imagem por pedido. Planeie lotes em fila para catálogos grandes.
Os vídeos do Canto podem ir para o catálogo?
Não diretamente. Os vídeos de produto do BigCommerce têm de estar no YouTube. Os vídeos do Canto servem para páginas de conteúdo ou código do tema.
Como sei se a loja tem a versão atual de uma imagem?
Compare o identificador e a data da versão guardados no produto com os do Canto. Se diferirem, reimporte a imagem.