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:

  1. Cola a chave. «Testar conexão» confirma que responde e em qual conta entra.
  2. Mapeia cada idioma para sua visão de loja: espanhol para a visão em espanhol, inglês para a de inglês.
  3. Escolhe quais atributos viajam para a Bruxel como contexto para gerar: material, medidas, cor.
  4. 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

  1. Magento (Wikipedia, em inglês)
  2. Webhook (Wikipedia, em inglês)

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 Mattar

Experimente 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

Caso de uso: sincronizar o conteúdo com o Adobe Commerce sem editar a loja à mão