Guia de integração com o Magento
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 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
- No admin do Magento, vá em System → Extensions → Integrations → Add New Integration.
- Dê o nome
Tajo, informe sua senha de administrador e, em API, conceda acesso de leitura aos recursos Customers, Sales e Catalog. - 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: status de implementação e notas técnicas
- Sincronização de clientes: como mapear os clientes do Magento no seu sistema de registro