---
title: "Guia de integração com o Magento | Tajo"
description: "Conecte o Adobe Commerce (Magento) à Tajo pela API REST do Commerce para sincronizar clientes, pedidos e produtos"
url: https://tajo.io/pt/docs/ecommerce-platforms/magento/
markdown: https://tajo.io/pt/docs/ecommerce-platforms/magento.md
lang: pt-BR
author: "Set Noa"
author_url: https://tajo.io/pt/set-noa/
robots: noindex
---

Solicite acesso antecipado

Indique o seu nome e endereço de e-mail profissional. Enviaremos um link para confirmar o seu pedido de acesso ao Tajo.

# Guia de integração com o Magento

[Set Noa](https://tajo.io/pt/set-noa/)

A Tajo se conecta ao Adobe Commerce (Magento 2) pela **API REST do Commerce**. Não existe nenhuma extensão da Tajo para instalar no código do seu Magento: a conexão usa um token de integração, o que mantém o pipeline de deploy da sua loja intocado.

O Magento é hoje uma **conexão montada no onboarding**: diferente de Shopify e WooCommerce, ainda não é self-service, e o time da Tajo configura a sincronização durante o onboarding. O [status de implementação do conector](https://tajo.io/docs/connectors/magento/) mostra em que ponto isso está. A preparação do lado da loja descrita abaixo é tudo o que o Magento precisa da sua parte, e funciona com o Magento padrão, sem alterações de código.

## Pré-requisitos

- **Adobe Commerce / Magento Open Source 2.4+**
- Acesso de administrador para criar um token de integração
- HTTPS na sua loja (obrigatório para a autenticação por token)
- **Conta Tajo** com uma assinatura ativa

## Passo 1: crie um token de integração no Magento

1. No admin do Magento, vá em **System → Extensions → Integrations → Add New Integration**.
2. Dê o nome `Tajo`, informe sua senha de administrador e, em **API**, conceda acesso de leitura aos recursos **Customers**, **Sales** e **Catalog**.
3. Salve, depois **ative** a integração e copie o **Access Token**.

A Tajo se autentica com `Authorization: Bearer <access token>` na URL base REST da sua loja (`https://yourstore.com/rest/V1/`).

## Passo 2: entregue a conexão ao time da Tajo

Compartilhe com seu contato de onboarding da Tajo:

| Campo | Valor |
| --- | --- |
| **URL da loja** | `https://yourstore.com` |
| **Access token** | O token de integração do Passo 1 |

A conexão é validada com uma requisição somente leitura antes de qualquer sincronização começar. Gire o token no Magento a qualquer momento para revogar o acesso.

## O que uma conexão Magento sincroniza

- **Clientes**: campos de identidade e metadados da conta para a resolução de contatos; o consentimento de marketing nunca é inferido da existência de uma conta
- **Pedidos**: histórico de compras, totais, moeda, status e itens do pedido para segmentação por ciclo de vida e automações de recuperação de clientes
- **Produtos e categorias**: estrutura do catálogo para segmentação por interesse e campanhas orientadas a produto

A importação do histórico roda primeiro, depois a sincronização incremental mantém a Tajo atualizada consultando os registros modificados. Eventos de vitrine em tempo real (carrinhos, checkouts em andamento) exigem uma extensão instalada na loja, que o Magento não recebe hoje. As automações baseadas em pedidos seguem plenamente disponíveis por meio da sincronização.

## Automação de marketing

As automações (e-mail, SMS, WhatsApp via Brevo e outros provedores) são configuradas na Tajo a partir dos dados sincronizados, por exemplo mensagens de acompanhamento pós-compra em novos pedidos, recuperação de clientes inativos e campanhas por interesse de produto com base no histórico de categorias.

## Solução de problemas

| Sintoma | Causa e correção |
| --- | --- |
| 401 vindo da loja | O token de integração foi gerado novamente ou a integração foi desativada. Reative e atualize o token na Tajo |
| Os clientes sincronizam, mas os pedidos não | Faltam as permissões de API do recurso **Sales** na integração |
| Importação inicial lenta | Lojas grandes são importadas em páginas; seu contato na Tajo pode informar o progresso a qualquer momento |

## Próximos passos

- [Referência do conector Magento](https://tajo.io/docs/connectors/magento/): status de implementação e notas técnicas
- [Sincronização de clientes](https://tajo.io/pt/docs/skills/data-sync/customer-sync/): como mapear os clientes do Magento no seu sistema de registro