Sincronização de comércio externo

Visão geral

Canais e integrações → Comércio externo (/pt/integrations/commerce) mantém o checkout no Shopify ou WooCommerce enquanto espelha dados suportados no OrderInChat. O widget, WhatsApp e Instagram com IA, automações e etiquetas de envio opcionais usam os dados espelhados.

Esta integração não clona o tema de origem e não substitui o checkout externo.

Conexão Shopify

OrderInChat usa OAuth do Shopify para que você não precise copiar tokens manualmente.

1. No painel do parceiro Shopify, crie um aplicativo chamado Order in Chat.
2. Adicione a URL de callback https://app.orderinchat.com/api/store/commerce/shopify/oauth/callback a URLs de redirecionamento permitidas.
3. Conceda estes escopos da API Admin: read_products, write_products, read_inventory, write_inventory, read_orders, read_customers, read_content, read_legal_policies, read_discounts, read_shipping, read_files, read_locales, read_locations, read_script_tags, write_script_tags.
4. No OrderInChat, vá para Canais e integrações → Comércio externo, escolha Shopify, insira a URL da loja HTTPS (por exemplo, https://your-store.myshopify.com) e clique em Conectar com Shopify.
5. Aprove as permissões no Shopify. Você retorna ao OrderInChat automaticamente. Em seguida, clique em Testar conexão, Registrar webhooks e Sincronizar agora.

Se você não puder usar OAuth, expanda a seção Configuração manual de token e cole o token de acesso da API Admin e a chave secreta da API do aplicativo personalizado. A chave secreta da API é necessária para verificar as assinaturas HMAC do webhook do Shopify. OrderInChat criptografa credenciais e nunca as exibe novamente.

Guias oficiais: Aplicativos personalizados do Shopify e Tokens de acesso da API Admin.

Conexão WooCommerce

No WordPress, abra WooCommerce → Configurações → Avançado → REST API, crie uma chave com permissão de Leitura para sincronização apenas de espelhamento, ou permissão de Leitura/Escrita se as alterações do Editor em massa devem ser escritas de volta no WooCommerce, e insira a URL da loja HTTPS, a chave do consumidor e o segredo do consumidor. Para sincronizar páginas e postagens do WordPress, insira também um nome de usuário do WordPress e uma Senha de Aplicativo de Usuários → Perfil.

Guia oficial: API REST do WooCommerce.

Alguns hosts rejeitam a autenticação HTTP Basic. O conector pode tentar novamente as solicitações do WooCommerce com autenticação de string de consulta; as credenciais são ocultadas dos logs.

Comportamento de sincronização

1. Salve e teste a conexão.
2. Registrar webhooks — cria assinaturas na loja externa para que alterações de produto, pedido e cliente notifiquem o OrderInChat em tempo quase real. O OrderInChat também verifica alterações regularmente, caso um webhook seja perdido.
3. Selecione os recursos a serem espelhados.
4. Execute a sincronização inicial.

Por segurança, o OrderInChat verifica cada webhook e confere novamente os dados com o Shopify ou WooCommerce antes de salvá-los. As verificações regulares recuperam webhooks perdidos apenas enquanto Usar como fonte de comércio estiver habilitado. Se o status do webhook mostrar um erro e a conexão estiver inativa, use Registrar webhooks e Sincronizar agora após alterações na loja de origem; Testar conexão sozinho não atualiza produtos. Atualizações repetidas não criam registros duplicados.

O peso de envio da variante do Shopify é importado do peso da variante no Shopify; o editor de produtos o mostra na unidade de peso configurada da loja. Metacampos de dimensão chamados length, width ou height são convertidos em centímetros. As descrições dos produtos do Shopify vêm da descrição do próprio produto, não de seções ou banners de tema compartilhados; a cópia do tema não se torna uma descrição específica do produto. Produtos em rascunho e arquivados não são mostrados aos clientes.

Quando sua loja usa comércio externo, os clientes compram pela URL do produto de origem. O checkout do carrinho do OrderInChat e os fluxos de checkout do WhatsApp ficam desativados para essa loja.

Localizações de inventário

As localizações do Shopify e os níveis de inventário por variante são espelhados em registros de armazém/localização do OrderInChat. O estoque de produtos e variantes mostra o total de todas as localizações para chat e checkout. O núcleo do WooCommerce expõe um valor total de estoque, portanto, é espelhado em uma localização virtual padrão; estoque em várias localizações de plugins do WooCommerce requer um plugin suportado.

Você pode adicionar suas próprias localizações do OrderInChat em Catálogo → Inventário. As células de estoque do Editor em massa se expandem por localização. O envio de inventário para o Shopify atualiza apenas a localização selecionada e requer o escopo write_inventory. Campos de estoque bloqueados não são sobrescritos por uma sincronização de inventário posterior.

Etiquetas de envio

As etiquetas de envio do OrderInChat estão desativadas por padrão. Ative-as apenas se o OrderInChat deve ser o único lugar onde as etiquetas são criadas. Mesmo quando ativadas, o OrderInChat não compra uma etiqueta quando o pedido externo já possui informações de cumprimento ou rastreamento.

Snippet do widget

Shopify: Registrar webhooks também tenta instalar automaticamente o widget de chat na sua loja Shopify. Você ainda pode colar o snippet no Liquid Personalizado, se necessário. Conceda write_script_tags no aplicativo personalizado se a instalação automática falhar.

WooCommerce: A API REST não pode injetar scripts de tema. Copie o snippet JavaScript ou PHP da página de integração para o rodapé do tema ou functions.php.

Páginas → Base de Conhecimento

Quando Páginas e postagens está habilitado, páginas/artigos/políticas do Shopify e páginas/postagens do WooCommerce são adicionados (ou atualizados) na Base de Conhecimento do OrderInChat para respostas de IA. Títulos de políticas do Shopify correspondentes também preenchem campos de loja de retorno/termos. Isso não é uma clonagem completa de tema/CMS.

Limitações da API

A integração relata dados não suportados ou indisponíveis em vez de inventar valores. Limitações comuns incluem:

• O Shopify não expõe todas as configurações de pagamento através da API Admin.
• Preços de envio calculados por transportadora permanecem calculados no checkout externo.
• A REST do WooCommerce não inclui páginas do WordPress sem uma Senha de Aplicativo do WordPress.
• Avaliações e reservas requerem uma API de plataforma ou aplicativo que exponha esses recursos.
• Adicionais de produtos são espelhados apenas quando a API de origem tem um equivalente real.