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 Fozzels, certifique-se de que seu servidor:

1. Não bloqueia solicitações externas para a API REST do Magento.

Se seu servidor tem firewall, WAF ou serviço de segurança (Cloudflare, Sucuri, etc.) configurados — eles podem bloquear solicitações recebidas do Fozzels para sua loja.

O que fazer:​

  1. Solicite a lista atual de endereços IP do Fozzels em support@fozzels.com. Para adicionar à whitelist, você pode usar o endereço IP Fozzels: 49.13.117.118

  2. Encaminhe esta lista para seu provedor de hospedagem ou administrador de servidor para adicioná-los à whitelist.

Se isso não for feito — você receberá um erro 401 (Unauthorized) ao criar a integração no Fozzels e não conseguirá completar a conexão.

2. Não limita o número de solicitações de API do user agent: fozzels** .** O user-agent completo é Mozilla/5.0 (Windows NT 10.0; Win64; x64; fozzels/5.1.2; +https://app.fozzels.com/) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36

Durante a sincronização, Fozzels envia um grande número de solicitações, especialmente com catálogos de produtos grandes. Se seu servidor tiver limites rigorosos no número de solicitações por minuto ou segundo (rate limiting) — algumas delas serão rejeitadas.

O que fazer:​

  1. Entre em contato com seu provedor de hospedagem ou administrador de servidor.
  2. Peça-lhes para aumentar o limite de solicitações da API ou excluir endereços IP Fozzels e/ou User Agent Fozzels do rate limiting.

Se isso não for feito — você receberá um erro 429 (Too Many Requests) durante Pull Products e a sincronização de produtos 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.