🛍️ Sincronização Shopify

A extensão de Sincronização Shopify do Botoscope permite que você conecte sua loja Shopify existente ao seu bot do Telegram. Os produtos são importados do Shopify para o WooCommerce automaticamente, e os pedidos feitos através do bot são enviados de volta para o Shopify — mantendo seu gerenciamento de inventário e pedidos em um só lugar.

✨ Principais Funcionalidades

• 🔄 Sincronização automática de produtos — importe todos os produtos ativos do Shopify para o WooCommerce
• 📦 Envio de pedidos de volta — pedidos do bot são enviados de volta para o Shopify automaticamente
• 🖼️ Sincronização de mídia — imagens dos produtos são importadas junto com os produtos
• 🏷️ Suporte a variantes — variantes de produtos do Shopify tornam-se produtos variáveis no WooCommerce
• 🔔 Webhooks — atualizações em tempo real quando produtos são criados, atualizados ou excluídos no Shopify
• 🛒 Modo catálogo pronto — URLs de produtos do Shopify são armazenadas para que os clientes possam ser redirecionados para sua loja Shopify para concluir a compra (opcional)

🔧 Etapa 1: Ativar a Extensão

1. Vá para a aba Extensões no Botoscope
2. Encontre Sincronização Shopify e ative-a LIGADA
3. A aba Sincronização Shopify aparecerá na navegação superior

🏪 Etapa 2: Criar um App Shopify

O Botoscope se conecta à sua loja Shopify através de um App Personalizado Legado. Isso lhe dá um token de API permanente — sem fluxo OAuth, sem Painel de Parceiros, sem processo de revisão.

Vá para o seu Admin do Shopify:

https://admin.shopify.com/store/SUA-LOJA/settings/apps/development

Você verá duas opções. Clique em “Permitir desenvolvimento de app personalizado legado” — isso deve ser ativado antes que você possa criar o app.

💡 Por que legado? A partir de janeiro de 2026, o Shopify moveu todo o desenvolvimento de novos apps para o seu Painel de Desenvolvimento, que requer aprovação de Dados de Cliente Protegidos para acesso a pedidos. Apps Personalizados Legados ignoram completamente esse requisito, já que o app é privado apenas para sua loja.

🔑 Etapa 3: Configurar Permissões do App

Após habilitar o desenvolvimento legado, clique em “Criar um app” e preencha com qualquer nome (por exemplo, Botoscope).

Em seguida, vá para Credenciais de API → Escopos de acesso da API Admin e ative:

Clique em Salvar e depois em Instalar app.

📋 Etapa 4: Copiar Suas Credenciais

Após a instalação, vá para Credenciais de API. Você verá três valores — copie todos eles:

⚠️ Importante: O token de acesso da API Admin é mostrado apenas uma vez. Copie-o imediatamente e armazene-o com segurança — você não poderá recuperá-lo novamente sem reinstalar o app.

⚙️ Etapa 5: Inserir Credenciais no Botoscope

Vá para Botoscope → aba Extensões e preencha:

💡 Dica: Se o campo Token de Acesso da API estiver preenchido, o Botoscope o usa diretamente. O ID do Cliente e o Segredo são usados apenas como alternativa se nenhum token for fornecido.

Clique em Salvar.

🔄 Etapa 6: Sincronizar Produtos

Vá para a aba Sincronização Shopify e clique em “Sincronizar Produtos” para importar todos os produtos ativos da sua loja Shopify para o WooCommerce.

A barra de progresso mostrará:

Encontrados 42 produtos. Sincronizando...
Sincronizados 42 de 42 produtos. Concluído!

Os produtos são importados com:

• Título, descrição, preço
• Imagens
• Variantes → produtos variáveis no WooCommerce
• Categorias (do tipo de produto Shopify)
• Tags
• SKU

🛒 Modo Catálogo

Se você usar o Botoscope em modo apenas catálogo (sem checkout WooCommerce), as URLs dos produtos do Shopify são armazenadas automaticamente durante a sincronização. Quando um cliente toca no botão “Detalhes” na loja do telegrama, ele é levado diretamente para a página do produto na sua loja Shopify para concluir a compra lá.

Para habilitar isso:

1. Vá para Botoscope → Controles do Sistema
2. Ative “Desativar carrinho e checkout”
3. Ative “Mostrar botão Ver no Site”

✅ Melhores Práticas

• 🔄 Re-sincronizar após grandes mudanças — se você editar produtos em massa no Shopify, execute uma sincronização manual para atualizar o WooCommerce
• 🔑 Armazene seu token com segurança — o token shpat_ não pode ser recuperado, apenas regenerado
• 🧹 Limpe o cache do token se trocar de loja — execute isso no seu banco de dados se você mudar as credenciais da loja (para solução de problemas):

DELETE FROM wp_options WHERE option_name = 'botoscope_shopify_access_token_cache';

• 🏪 Uma loja por instalação do Botoscope — cada site WordPress se conecta a uma loja Shopify
• 📦 Variantes tornam-se produtos variáveis — produtos Shopify com múltiplas variantes são totalmente suportados

❓ Solução de Problemas

⚠️ Falha no registro do Webhook

• Certifique-se de que o campo Token de Acesso da API está preenchido (não apenas ID/Segredo do Cliente)
• Verifique se todos os quatro escopos estão habilitados no seu app Shopify
• Se você alterou as credenciais, limpe o cache do token (comando SQL acima) e tente novamente

Produtos não aparecem após a sincronização

• Verifique se os produtos estão Ativos no Shopify (produtos em rascunho não são importados)
• Certifique-se de que a extensão Sincronização Shopify está ativada na aba Extensões
• Nota: o plano gratuito suporta até 9 produtos (ordenados por ordem de menu).

Pedidos não enviados para o Shopify

• Verifique se o escopo write_orders está habilitado nas credenciais do seu app Shopify