Como usar a Shopify com Composer
O que você vai aprender
Aprenda a usar o conector nativo da Shopify no Composer para verificar os produtos, o estoque e os pedidos da sua loja e fazer alterações compatíveis na Shopify. Por exemplo, você pode verificar o estoque de uma promoção, escolher produtos e criar uma coleção antes de redigir a campanha no Klaviyo.
Antes de começar
Você precisa ter acesso ao Composer e a uma loja da Shopify conectada à conta da Klaviyo que você está usando. Se a sua loja não estiver conectada, siga Guia de introdução ao Shopify.
O conector usa sua integração existente com a Shopify. Você não precisa criar um conector personalizado nem inserir um token de API da Shopify no Composer. Se você gerencia várias contas da Klaviyo, mude para a conta conectada à loja que você quer usar.
As ações disponíveis dependem das permissões concedidas pela sua loja. Uma conexão que consegue recuperar informações do produto ainda pode precisar de permissões atualizadas para que o Composer possa alterar produtos ou criar coleções.
Entenda o que o conector faz
Sua integração com a Shopify sincroniza os dados da loja com a Klaviyo para uso em perfis, segmentação, fluxos e relatórios. O conector nativo também fornece ao Composer ferramentas para recuperar informações diretamente da Shopify e realizar ações compatíveis na sua loja.
Você pode usar isso para:
- Encontre produtos e revise descrições, variantes, preços e tags.
- Verifique o estoque, incluindo quantidades para uma variante ou um local específico.
- Pesquise pedidos e revise informações de pagamento, processamento e rastreamento.
- Crie coleções a partir de produtos selecionados ou de regras de seleção de produtos.
- Atualize detalhes de produtos compatíveis, tags, metacampos e preços de variantes.
- Crie códigos de desconto por percentual ou valor fixo para todo o pedido.
Uma solicitação para inspecionar informações não altera sua loja. Já uma solicitação para atualizar um produto, criar uma coleção ou criar um desconto altera. O Composer só escreve no Shopify quando você pede explicitamente e não solicita uma confirmação separada antes de fazer a alteração. Quando você quiser explorar uma ideia primeiro, peça ao Composer para mostrar a recomendação sem aplicá-la. Revise a proposta e, depois, envie uma instrução separada para aplicar a alteração quando estiver pronto.
O conector oferece ferramentas específicas em vez de todos os recursos da Shopify. Para revisar as ferramentas disponíveis na sua conta, abra Personalizar > Conectores no Composer, selecione Shopify e expanda a contagem de ferramentas.
Verifique ou atualize sua conexão com a Shopify
Gerencie o acesso ao Shopify pelas configurações da sua integração com o Klaviyo. Nas configurações do conector do Composer, a ação Gerenciar configurações do Shopify abre essas configurações. Você também pode abrir Integrações no Klaviyo e selecionar Shopify.
Se a sua loja precisar de permissões adicionais:
- Abra as configurações de integração da Shopify no Klaviyo.
- Clique em Atualizar no aviso solicitando que você atualize as integrações. Você também pode clicar em Atualizar configurações para iniciar o fluxo de atualização das configurações.
- Conclua as solicitações de autorização do Shopify e revise o acesso solicitado.
- Quando você voltar ao Klaviyo, confirme se a conta do Klaviyo e a loja da Shopify corretas estão sendo exibidas e, em seguida, clique em Atualizar integração.
- Volte para sua conversa do Composer e peça para ele tentar a solicitação novamente.
Se você não conseguir atualizar a integração, peça ajuda a alguém que tenha permissão para gerenciar integrações no Klaviyo. A pessoa que concluir a autorização também precisa ter permissão para aprovar o acesso solicitado na Shopify.
Após a configuração, comece com uma solicitação que recupere informações, como “Mostre os detalhes do produto da Shopify para Everyday Tote”. Confira se o Composer encontrou o produto desejado antes de continuar com uma alteração.
Planeje uma promoção usando os dados da sua loja
O exemplo a seguir passa da pesquisa de produtos para uma coleção e um rascunho de campanha. Substitua a tag de exemplo, os nomes dos produtos e o limite de inventário pelos detalhes da sua loja.
Encontre produtos e confira o estoque
Comece definindo a seleção que você quer que o Composer investigue:
Encontre produtos ativos da Shopify com atividade marcados com a tag “gift”. Mostre os preços e o inventário disponível por variante no nosso depósito principal. Sugira produtos para um guia de presentes de fim de ano e sinalize variantes com menos de 20 unidades. Não mude nada ainda.
Revise os produtos correspondentes e, em seguida, refine a seleção na mesma conversa. Um produto pode estar com atividade enquanto suas variantes estão esgotadas. Se a sua promoção destacar um tamanho ou uma cor específicos, verifique essa variante em vez de confiar no estoque combinado do produto. Informe o local de atendimento quando o estoque desse local afetar sua decisão.
Para uma investigação de pedido, forneça critérios igualmente específicos. Por exemplo: “Encontre pedidos do Shopify feitos de 1 a 7 de outubro de 2026 com a tag holiday-preview. Resuma os status de pagamento e de atendimento e informe os filtros que você usou.”
Escolha como organizar a coleção
Você pode solicitar uma coleção que contenha uma seleção fixa de produtos ou uma coleção cuja associação segue regras.
Use uma seleção fixa quando você quiser escolher exatamente quais produtos aparecem na promoção:
Crie uma coleção da Shopify chamada “Holiday gift guide” contendo o Everyday Tote, o Travel Pouch e o Canvas Organizer que acabamos de analisar. Ordene os produtos por preço, do menor para o maior.
Use regras quando quiser que o Shopify mantenha a seleção conforme os produtos correspondentes mudarem:
Crie uma coleção do Shopify chamada “Presentes por menos de $ 50”. Inclua produtos com a tag “gift” e com o preço da variante abaixo de $ 50 na moeda da nossa loja. Exija as duas condições e ordene por preço, do menor para o maior.
Em uma coleção baseada em regras, informe se os produtos precisam atender a todas as condições ou a qualquer condição. Essa escolha muda quais produtos se qualificam. Para adicionar ou remover produtos individuais de uma coleção existente, use uma coleção com uma lista de produtos selecionados manualmente; a inclusão com base em regras é controlada pelas condições dela.
As coleções criadas pelo conector começam como não publicadas. Revise os produtos ou regras incluídos no Shopify e, quando estiver pronta, publique a coleção nos canais de vendas apropriados. Criar a coleção não a torna disponível na sua vitrine.
Continuar com um rascunho de campanha
Depois de revisar a coleção e o destino dela na vitrine, continue a conversa:
Crie um rascunho de campanha de e-mail com recursos da coleção do guia de presentes de fim de ano. Use os detalhes do produto que revisamos, inclua o link para a coleção e não inclua um desconto.
Revise o texto, as imagens, os links, o público e as configurações de envio antes de usar a campanha. Criar uma coleção na Shopify e preparar um rascunho de campanha no Klaviyo são ações separadas. Verifique a coleção na Shopify e o rascunho da campanha no Klaviyo.
Atualizar informações do produto
Você pode pedir ao Composer para atualizar campos de produto compatíveis, incluindo o título, a descrição, o tipo de produto, o fornecedor, o status e as informações da listagem do mecanismo de pesquisa. Ele também pode adicionar ou remover tags de produto, definir metacampos do produto e atualizar os preços das variantes.
Para alterações de copy, separe a redação sugerida da atualização:
Mostre para mim a descrição atual do Shopify para a Everyday Tote. Sugira uma versão mais clara usando apenas fatos que já estejam nas informações do produto e aguarde minha revisão antes de atualizá-la.
Depois de revisar o texto, peça ao Composer para aplicar a versão que você escolheu. Abra o produto no Shopify para conferir a descrição salva.
Tenha esses detalhes em mente para outras atualizações:
- Para preços, identifique as variantes exatas e os valores na moeda da sua loja. O conector pode definir um compare-at price, mas não pode remover um. Para limpar um compare-at price ao encerrar uma promoção, use o admin da Shopify.
- Para atualizações de listagem nos mecanismos de busca, forneça o título e a descrição. Ao enviar apenas um desses campos, o outro é apagado.
- Para metacampos, identifique o campo existente e o valor pretendido. Os metacampos armazenam informações adicionais do produto, como instruções de cuidados, e os valores deles devem corresponder ao tipo definido do campo.
- Alterar o status de um produto para rascunho ou arquivado remove o produto da vitrine. Solicite uma mudança de status somente quando esse for o resultado que você pretende.
Crie um código de desconto
O Composer pode criar um código de desconto aplicado ao pedido para todos os clientes, usando uma porcentagem ou um valor fixo na moeda da sua loja. Especifique o código, o valor, os horários de início e término, o fuso horário e qualquer subtotal mínimo ou limite de uso.
Crie um código de desconto para o pedido inteiro GIFT15 para 15% de desconto em pedidos com subtotal mínimo de US$ 75 na moeda da nossa loja. Inicie em 20 de novembro de 2026, às 9h. no horário do leste (Eastern Time) e encerre em 23 de novembro de 2026, às 23:59 no horário do leste (Eastern Time). Limite a 500 usos no total e 1 uso por cliente.
Revise o desconto na Shopify antes de compartilhar o código. Verifique o valor, as datas com atividade, o subtotal mínimo e as restrições de uso. Essa ação cria um código disponível para todos os clientes; solicitar uma campanha para um segmento específico não restringe esse código do Shopify ao segmento.
Verifique o resultado e resolva os problemas
Depois de uma solicitação que altera o Shopify, leia a resposta do Composer sobre a ação concluída e quaisquer erros e, em seguida, verifique o registro afetado no Shopify. Uma recomendação na conversa não significa que uma alteração foi aplicada. Algumas alterações na associação à coleção continuam sendo processadas após a solicitação inicial. Por isso, verifique a coleção resultante antes de usá-la em uma promoção.
O Composer pode ler produtos, mas não pode fazer alterações
Pode ser que esteja faltando na loja a permissão necessária para essa ação. Atualize a integração com a Shopify, conclua a autorização e peça ao Composer para tentar novamente. Se ainda falhar, verifique as ferramentas disponíveis do conector e o erro na conversa. Conclua as ações não compatíveis no Admin da Shopify.
O Composer não consegue encontrar um produto
Informe o nome exato do produto ou SKU e confira se você está usando a conta da Klaviyo conectada à loja correta. A pesquisa no catálogo retorna produtos com atividade por padrão. Se você estiver investigando um produto descontinuado, peça ao Composer para incluir produtos arquivados. Produtos em rascunho e não listados não são retornados por esta pesquisa no catálogo.
Uma nova coleção não aparece na vitrine
As coleções criadas pelo conector começam como não publicadas. Abra a coleção na Shopify, revise os produtos e publique-a nos canais de vendas relevantes antes de vinculá-la a uma campanha.