- Blog da Bruxel.AI
- Caso de uso: sincronizar o conteúdo com o Adobe Commerce sem editar a loja à mão
Caso de uso: sincronizar o conteúdo com o Adobe Commerce sem editar a loja à mão
Por Manuel Mattar4 min de leitura
Em resumo
É um cenário de exemplo. Uma loja no Adobe Commerce instala o módulo Bruxel_Sync, que manda seus produtos para a Bruxel e recebe de volta o conteúdo publicado nos atributos e nas visões de loja que mapeou. A loja continua dona do catálogo e a Bruxel só escreve a descrição.
Este caso é um exemplo, não um cliente: uma loja imaginária e um catálogo de cenário para mostrar como funciona o módulo Bruxel_Sync do início ao fim. As versões, as permissões e as travas são as do guia de ajuda atual.
A situação
Uma loja de artigos para casa vende 4.000 produtos no Adobe Commerce 2.4.8, com duas visões de loja: uma em espanhol e outra em inglês. As descrições são escritas por uma equipe de duas pessoas, coladas no painel do Magento produto por produto e traduzidas depois. Quando chega uma temporada, o catálogo cresce mais rápido que a equipe.
A loja quer gerar o conteúdo na Bruxel e que ele chegue sozinho à ficha certa, no idioma certo, sem sobrescrever o que já funciona.
O que viaja e em que direção
Antes de instalar qualquer coisa, a equipe entende a regra do módulo: duas coisas vão e vêm, cada uma em um sentido.
- Da loja para a Bruxel: os produtos — SKU, nome, categoria e os atributos escolhidos. É a matéria-prima para gerar. Viajam os habilitados e visíveis; as variantes ocultas de um configurável ficam de fora, para não gastar créditos em fichas que a loja não mostra.
- Da Bruxel para a loja: o conteúdo já publicado, escrito na ficha do produto, na visão de loja de cada idioma.
A loja é dona do catálogo. Se alguém edita na Bruxel um nome ou uma categoria, o próximo envio da loja o sobrescreve.
Passo 1: a chave e a instalação
Uma administradora cria em Canais → Chaves de API uma chave com permissões de catálogo, atributos e exportação. Depois, o desenvolvedor da loja instala o módulo com Composer. O módulo é instalado desligado: nada se move até ser habilitado.
No painel do Magento, em Stores → Configuration → Bruxel → Sincronización, ele faz os quatro passos:
- Cola a chave. «Testar conexão» confirma que responde e em qual conta entra.
- Mapeia cada idioma para sua visão de loja: espanhol para a visão em espanhol, inglês para a de inglês.
- Escolhe quais atributos viajam para a Bruxel como contexto para gerar: material, medidas, cor.
- Mapeia os campos de conteúdo: qual campo da Bruxel é escrito em qual atributo do Magento.
Passo 2: gerar e publicar na Bruxel
Com os produtos na Bruxel, a equipe configura sua voz da marca e gera em lotes a partir do catálogo. Em lote, cada produto custa 7 créditos por idioma de saída; com dois idiomas, 14. O que se publica na Bruxel é o que o módulo vai escrever; se a organização tem a aprovação ligada, nada sai sem que um administrador aprove.
Passo 3: a primeira sincronização, sem sustos
A primeira escrita sobre um catálogo que já tem descrições é o momento delicado. O módulo vem com duas travas de fábrica, e a equipe as usa:
- O modo de teste mostra o que mudaria — produto, campo, visão de loja, valor atual e novo — sem escrever nada.
- Uma opção ligada por padrão que não sobrescreve os campos que já têm texto e que a Bruxel nunca tocou.
Além disso, antes de escrever um campo pela primeira vez, o módulo guarda o valor anterior, e um comando de restauração o devolve exatamente como estava. Antes da primeira sincronização grande, o desenvolvedor coloca os indexadores em «Update on Schedule», porque cada escrita invalida o cache daquela ficha.
Passo 4: o aviso em tempo real
Para que a loja saiba no momento em que algo é publicado, a administradora registra em Canais → Webhooks o endereço do módulo, inscrito no aviso de descrição atualizada. Ela faz isso depois de habilitar o módulo e colar o segredo: se o endpoint falhar várias vezes seguidas, a Bruxel o desativa sozinha. Mesmo que o webhook falhe, o conteúdo chega, porque o módulo verifica por conta própria a cada hora.
O que fica resolvido e o que não
Fica resolvido: a equipe não copia e cola mais descrições no Magento. O módulo escreve só nos atributos de texto com escopo de visão de loja que ela mapeou, nunca muda a URL do produto e nunca apaga: um campo vazio ou um produto despublicado deixam a ficha como está.
Nem tudo fica resolvido:
- As imagens não viajam para a loja nesta versão.
- Vários sites na mesma loja pedem revisar o mapeamento à mão.
- O Adobe Commerce as a Cloud Service não está coberto; o Adobe Commerce ou o Magento Open Source 2.4.7, 2.4.8 e 2.4.9, sim.
- Content Staging: uma campanha programada que é aplicada sobrescreve o que a Bruxel escreveu; é preciso publicar de novo depois.
- Os idiomas que sincroniza são espanhol, inglês, francês e português.
Os guias de Adobe Commerce e de webhooks trazem a configuração completa. As páginas de integrações, canais e conteúdo com IA mostram o resto do caminho.
Perguntas frequentes
A Bruxel entra no meu Magento?
Não. O módulo é instalado na sua loja e é ele quem chama a Bruxel. A Bruxel nunca entra no seu Magento.
O que acontece se eu editar o nome do produto na Bruxel?
A loja é dona do catálogo: o próximo envio da loja sobrescreve o nome, a marca, a categoria e os atributos. O que a Bruxel manda para a loja é o conteúdo gerado, e nada mais.
O módulo sobe as imagens para a loja?
Não nesta versão. As imagens não viajam para a loja; o módulo escreve apenas o conteúdo de texto nos atributos que você mapeou.
Fontes
Sobre o autor
Manuel Mattar
Fundador da Bruxel.AI
Fundou em 2014 a Wolf Sellers, agência de comércio eletrônico na Cidade do México, e depois a Bruxel.AI, o PIM com IA.
Ver todos os artigos de Manuel MattarExperimente com o seu catálogo
Crie sua conta grátis e experimente a Bruxel com seus próprios produtos usando os créditos de boas-vindas.
Continue lendo
· 4 min de leitura
Caso de uso: o mesmo catálogo em três marketplaces, com as fotos de cada um
Um cenário de exemplo: uma marca de calçados vende na Amazon, no Mercado Libre e no Walmart México. Colunas, fotos por destino e o que o Bruxel ainda não cobre.
· 4 min de leitura
Canais e modelos de marketplace na Bruxel: um arquivo pronto por destino
Como funcionam os canais da Bruxel: colunas, valores por destino, modelos de Walmart México e Mercado Libre, o que falta a cada produto e feeds assinados.
· 4 min de leitura
Imagens por destino na Bruxel: uma foto, o formato de cada marketplace
Como a Bruxel prepara as fotos dos seus produtos para cada marketplace: tamanho, fundo, peso e nome, com um assistente de três passos e uma fila de revisão.