Pular para o conteúdo principal

2.2. Configuração Completa de Integração com Magento 2.

Este guia detalha o processo de estabelecimento de uma conexão segura e bidirecional entre sua loja Magento 2 e Fozzels. Você gerará os Tokens de API necessários e configurará permissões, garantindo importação contínua de dados de produtos e exportação de conteúdo.

A integração Magento 2 requer a criação de uma Nova Integração dedicada no painel de administração Magento para gerar quatro chaves essenciais: Consumer Key, Consumer Secret, Access Token e Access Token Secret. Também configuraremos o atributo fozzels_completion_date necessário para rastrear sincronização de conteúdo.

Parte 1: Configuração Magento 2 (Criando a Integração e Tokens)​

Você deve criar uma nova integração e definir permissões específicas no seu painel de administração Magento.

Etapa 1: Crie uma Nova Integração​

  1. Faça login em seu painel de administração Magento.

  2. Vá para System / Integrations.

  3. Clique no botão "Add New Integration".

Etapa 2: Preencha as Informações da Integração​

  1. Navegue para a guia Integration Info (Configurações básicas).

  2. Preencha os campos obrigatórios: 2.1. Digite Name: Fozzels. 2.2. Digite E-mail: info@fozzels.com. 2.3. Digite sua senha de administrador Magento para confirmação.

  3. Ignore campos opcionais (Callback URL, Identity link URL).

Etapa 3: Configure Permissões de API (Escopos)​

  1. Clique na guia "API".

  2. No menu suspenso, selecione "Custom".

  3. Marque apenas estas caixas de seleção (para acesso Read/Write): 3.1. Catalog: Categories, Inventory, Products, Update Attributes, Edit Product Design. 3.2. Stores: Settings, All Stores. 3.3. Attributes: Product, Attribute Set.

Etapa 4: Salve e Ative a Integração​

  1. Clique no botão "Save" no canto superior direito.

  2. Na página de lista de Integrations, localize a nova integração Fozzels.

  3. Clique no link "Activate".

  4. Na página de detalhe de ativação, verifique se as APIs corretas (da Etapa 3) foram selecionadas e clique em "Allow".

Etapa 5: Copie e Armazene as Chaves de API​

  1. Após clicar em "Allow", você será redirecionado para a página "Integration tokens for extensions".

  2. Copie e armazene com segurança todos os quatro valores preenchidos automaticamente: 2.1. Consumer Key 2.2. Consumer Secret 2.3. Access Token 2.4. Access Token Secret

  3. Clique em "Done".

  4. Verifique ou edite detalhes de integração mais tarde ao pressionar o botão "Edit" na página Integrations.

Parte 3: Ativação de Fozzels e Sincronização de Dados​

Etapa 6: Verifique Acesso à API​

Antes de conectar o Fozzels, certifique-se de que seu servidor não bloqueia nem limita as solicitações do Fozzels para a API REST do Magento (/rest/) e a API GraphQL (/graphql). Firewalls, WAFs e serviços de segurança como Cloudflare ou Sucuri podem bloquear essas solicitações.

O que fazer:​

  1. Libere os endereços IP do Fozzels (IPv4 e IPv6) e o User-Agent do Fozzels, e exclua-os do rate limiting. Todos os endereços e configurações, incluindo instruções para o Cloudflare, estão em 2.1.1. Requisitos de conexão: endereços IP, User-Agent e configurações de firewall.
  2. Encaminhe essa página para seu provedor de hospedagem ou administrador de servidor.

Se isso não for feito, você receberá um erro 401 (Unauthorized) ao criar a integração no Fozzels ou um erro 429 (Too Many Requests) durante o Pull Products, e a conexão ou a sincronização não será concluída.

Após confirmar as alterações, prossiga para criar a integração no Fozzels.

Etapa 8: Crie Nova Integração no Fozzels​

  1. Faça login em sua conta Fozzels.

  2. Vá para Integrations.

  3. Clique em "Create New Integration".

  4. Escolha "Magento" das opções disponíveis.

Etapa 9: Preencha os Detalhes de Conexão​

Você usará as chaves da Parte 1 para conectar Fozzels e iniciar a importação de dados.

  1. Nomeie sua integração claramente.

  2. Digite a URL do seu site Magento.

  3. Preencha as quatro chaves copiadas na Etapa 5 nos campos correspondentes.

  4. Clique em "Save".

Etapa 10: Ative e Sincronize Lojas​

  1. Ative o toggle 'Active' no canto superior direito. Sem isso, a conexão não funcionará.

  2. Navegue para a guia "Websites & Stores".

  3. Clique no botão "Pull websites and stores". Seus sites e lojas devem aparecer agora.

  4. Verifique se a integração tem os seguintes status: Authorized: yes e REST API Connected: yes.

  5. Ative os sites e lojas atuais usando o toggle para continuar.

Etapa 11: Extraia Produtos e Verifique​

  1. Clique no botão "Pull Products" para iniciar o processo de importação do seu catálogo de produtos.

  2. Aguarde até que os produtos sejam carregados (o progresso será mostrado na barra de progresso).

  3. Vá para a guia "Attributes" para configurar suas regras de sincronização.

  4. Leia mais sobre trabalhar com atributos de produtos e personalizar campos de dados aqui.