Se já tentou ligar um mercado em linha ao Claude, a versão WooCommerce vai parecer errada, no bom sentido. Não há um programa de programadores a que aderir, uma aplicação para submeter, nem uma revisão pela qual esperar. O motivo é estrutural: o WooCommerce funciona na sua própria instalação do WordPress, pelo que não há uma plataforma entre si e a API.
O que faz na prática
No painel de administração do WordPress, aceda a WooCommerce → Settings → Advanced → REST API e crie uma chave para um utilizador da loja com as permissões necessárias. Recebe uma Consumer Key e um Consumer Secret. Com o URL da loja, esse é todo o conjunto de credenciais.
Compare com os vizinhos. O Etsy exige uma aplicação aprovada para Seller API Access. O eBay exige uma aplicação do Developers Program e um conjunto de chaves de produção. A Amazon exige um plano Professional Selling, um perfil de programador aprovado e uma aplicação SP-API privada. O WooCommerce exige um seletor e um botão.
As duas coisas que ainda correm mal
O URL da loja. Introduza o endereço HTTPS de raiz da loja. Se o WordPress estiver num subdiretório abaixo do domínio, mantenha o subdiretório. Não acrescente /wp-json/wc/v3 — esse é o caminho da API, e o cliente adiciona-o. Colar o caminho completo é a causa mais comum de uma ligação que parece configurada e não devolve nada de útil.
O segredo aparece uma vez. O Consumer Secret é gerado juntamente com a chave e apresentado uma única vez. Não existe «mostrar novamente». Se fechar a página antes de o copiar, a solução é revogar a chave e emitir outra — rápido, mas surpreendente na primeira vez.
Read não é Read/Write
Ao criar a chave, o seletor de permissões decide tudo o que a ligação poderá fazer. Read permite responder a perguntas sobre produtos, encomendas e clientes. Read/Write é o que permite alterar um preço, ajustar o stock, atualizar uma encomenda ou emitir um reembolso.
É a mesma divisão entre leitura e escrita que separa os conectores alojados dos que realmente agem, só que aqui controla de que lado está, e a escolha faz-se num seletor, não numa revisão de âmbitos de acesso. Escolha conscientemente: uma chave Read é um bom começo se só pretende relatórios, e emitir uma segunda chave mais tarde não custa nada.
O conector do Orkas abrange produtos, taxonomias, stock, encomendas, clientes, cupões, avaliações, reembolsos e relatórios. As credenciais ficam cifradas no seu dispositivo, e tudo o que escreve numa loja ativa passa por um pedido de permissão no cliente.
Quando outra coisa é a melhor resposta
Quer execução agendada sem supervisão: esta é uma aplicação de computador; fechar a janela interrompe tudo. Um cron do WordPress ou uma tarefa agendada no seu servidor é a solução adequada.
Quer que o assistente trabalhe no site, não na loja: os dados do WooCommerce são produtos e encomendas. Editar publicações, modelos ou plugins é trabalho de WordPress, outra área com ferramentas próprias.
Quer editar dados de produtos em massa: o WooCommerce já inclui importação e exportação CSV, e para uma atualização coluna a coluna isso é mais rápido do que qualquer conversa.
O mesmo catálogo abrange Etsy, eBay, Walmart Marketplace, Amazon Seller Central, Shopify e as plataformas chinesas, pelo que, se tem uma loja WooCommerce a par de um mercado em linha, as credenciais ficam num só lugar.