Como conectar o n8n ao Magento 2 usando token de integração

Crie a Integration no admin

No admin, vá em System > Extensions > Integrations e clique em Add New Integration. Preencha o nome (algo como n8n), e a sua senha de admin no campo Your Password.

Na aba API, escolha o que essa integração pode tocar. Comece pequeno: se o fluxo só lê pedido, marque Sales e nada mais. Salve, volte para a lista de Integrations e clique em Activate na linha da sua integração. Vai abrir um popup com o resumo das permissões — clique em Allow e o Magento mostra os tokens.

O que interessa é o Access Token. Copie e guarde, porque essa tela não volta.

Falta um detalhe que morde desde o 2.4.4: por padrão o Magento não aceita mais o token de integração sozinho no header Authorization: Bearer. Ligue de volta:

php bin/magento config:set oauth/consumer/enable_integration_as_bearer 1
php bin/magento cache:clean config

Pelo admin, é Stores > Configuration > Services > OAuth > Consumer Settings, na opção Allow OAuth Access Tokens to be used as standalone Bearer tokens. Sem isso, todo request do n8n volta 401.

Plugue no n8n

No n8n, adicione um node Magento 2 e crie a credencial. São dois campos:

• Host: a URL da loja, tipo https://sualoja.com.br. Sem barra no fim e sem /rest — o node monta o caminho sozinho.
• Access Token: o que você copiou no passo anterior.

Aqui vem a pegadinha que faz muita gente desistir. O botão de testar a credencial no n8n bate em GET /rest/default/V1/modules, e essa rota exige o recurso Magento_Backend::admin — ou seja, permissão de tudo. Se você marcou só Sales na aba API, o teste pode falhar mesmo com o token perfeitamente válido para pedidos.

Antes de sair mexendo na permissão, confirme com curl se o token funciona no endpoint que você realmente vai usar:

curl -sS -o /dev/null -w "%{http_code}\n" \
  -H "Authorization: Bearer SEU_TOKEN" \
  "https://sualoja.com.br/rest/V1/orders?searchCriteria[pageSize]=1"

Deu 200? Ignore o teste do n8n e siga. Eu prefiro conviver com o botão vermelho a dar acesso total para uma automação que só lê pedido.

O que o node já faz, e o resto

O node de Magento 2 do n8n cobre quatro recursos:

Dá para montar bastante coisa com isso. Um fluxo que uso muito: Schedule Trigger a cada 10 minutos, Magento 2 → Order → Get Many filtrando por status, e um If decidindo quem vai para o Slack e quem vira linha de planilha.

Para o que não está na tabela — estoque MSI, regra de carrinho, CMS, qualquer endpoint de módulo de terceiro — use o node HTTP Request com Authentication em Predefined Credential Type e escolha a mesma credencial Magento 2 API. Você reaproveita o token sem colar header na mão, e a paginação do node cuida do searchCriteria.

Um aviso de quem já se queimou: automação de escrita (criar produto, cancelar pedido) merece ambiente de teste antes. E se o fluxo vai passar dado de cliente para um serviço de IA, vale ler o guia de IA no Magento e Adobe Commerce antes de sair mandando CPF e endereço para fora.