A gestão operacional de um e-commerce envolve inúmeras tarefas repetitivas, como marcação de pedidos VIP, notificações de reposição de estoque e bloqueio preventivo de remessas com risco de fraude. Embora o Shopify Flow ofereça um motor visual de automação sem código, configurar manualmente gatilhos (Triggers), condições (Conditions) e ações (Actions) pode se tornar desafiador devido à complexidade das variáveis da GraphQL Admin API, expressões booleanas aninhadas e incompatibilidades entre listas e itens individuais. O Shopify Sidekick surge como um copiloto de inteligência artificial integrado diretamente ao painel administrativo: os lojistas descrevem os objetivos operacionais em linguagem natural cotidiana, e o assistente projeta, corrige erros e simula testes nos fluxos de trabalho do Flow.
Como o Sidekick opera dentro do Shopify Flow
O Sidekick não substitui o Shopify Flow; ele funciona como uma camada de interface conversacional para o motor de automação do Flow. Ao abrir o aplicativo Shopify Flow no painel da Shopify e acionar o Sidekick, a IA carrega o contexto do ambiente de automações da loja e traduz comandos em texto diretamente em nós visuais no editor.
+-------------------------------------------------------------------+
| Painel Shopify (Desktop) -> Apps -> Shopify Flow |
+-------------------------------------------------------------------+
|
v
+-----------------------+ +------------------------+
| Comandos do lojista | -- Prompt --> | Shopify Sidekick AI |
| em linguagem natural | | Interpretação e lógica |
+-----------------------+ +------------------------+
|
v
+-------------------------------------------------------------------+
| Tela do Shopify Flow: Rascunho de fluxo autogerado |
| - Gatilho: Monitor de eventos (ex: Order created, Risk analyzed) |
| - Condições: Filtros de negócio (ex: Total >= $200 e > 3 pedidos) |
| - Ações: Tarefas e conectores (ex: Tag de pedido, Reter remessa) |
| - Status: Inativo (etiquetado automaticamente como "sidekick") |
+-------------------------------------------------------------------+
|
+------------------+------------------+
| |
v v
+-------------------------------+ +-------------------------------+
| Resolução de erros com IA | | Execução de testes simulados |
| - Resolve erro "Data not found"| | - Sidekick gera dois eventos |
| - Insere loops "For each" | | de teste (atende/não atende)|
| - Corrige listas vs. itens | | - Validação visual sem risco |
+-------------------------------+ +-------------------------------+
|
v
+-------------------------------------------------------------------+
| Revisão manual do lojista -> Clique em "Ativar fluxo de trabalho" |
+-------------------------------------------------------------------+
Pré-requisitos essenciais e diretrizes de segurança
Antes de criar fluxos de trabalho com o Sidekick, os gerentes de loja devem observar os seguintes requisitos técnicos:
- Exigência de computador desktop: A geração e edição de fluxos de trabalho com o Sidekick exige o uso de um navegador em computador desktop.
- Contexto da aplicação ativo: É obrigatório acessar o aplicativo Shopify Flow (
Apps > Flow) antes de abrir o Sidekick. Caso o assistente seja acionado a partir de outras telas gerais do painel, ele não conseguirá renderizar os nós diretamente na tela do Flow. - Estado inativo por padrão: Todo fluxo estruturado pelo Sidekick é criado com o status Inativo (Inactive) e recebe a tag automática
sidekick. O assistente nunca ativa regras em produção sem a aprovação explícita do lojista. - Controle humano final: O Sidekick organiza as etapas e propõe melhorias, mas a ativação depende exclusivamente do clique em Turn on workflow (Ativar fluxo de trabalho).
Passo a passo: Criando fluxos com prompts em linguagem natural
Passo 1: Acessar o Flow e abrir o Sidekick
- No painel de controle da Shopify, acesse Apps (Aplicativos) no menu lateral e clique em Flow.
- Clique no ícone do Sidekick localizado na barra superior ou no widget flutuante.
- A janela lateral será aberta, já conectada ao contexto de edição do Flow.
Passo 2: Estruturar comandos com clareza
Para que o Sidekick projete a lógica correta na primeira tentativa, recomenda-se organizar a instrução em três elementos essenciais:
- Quando (When): O evento gatilho que inicia a automação.
- Se (If): As condições, valores ou critérios que devem ser validados.
- Então (Then): A ação executiva a ser realizada após a validação.
Passo 3: Exemplos práticos para cenários frequentes
| Cenário operacional | Exemplo de prompt em linguagem natural | Componentes gerados no Shopify Flow |
|---|---|---|
| Marcação de pedidos de clientes VIP e alto valor | "Quando um pedido for criado, se o valor total for maior que 200 dólares e o cliente já tiver mais de 3 pedidos anteriores, adicione a tag VIP-HighValue ao pedido e envie um e-mail interno para staff@store.com." | Gatilho: Order created; Condições: Total price >= 200 e Customer numberOfOrders > 3; Ações: Add order tags ("VIP-HighValue"), Send email |
| Alerta de estoque baixo e nota para reposição | "Quando o nível de estoque for alterado, verifique se a quantidade disponível de qualquer variante ficou abaixo de 10 unidades. Se sim, adicione a tag low-stock ao produto e inclua uma nota de reposição." | Gatilho: Inventory quantity changed; Condição: Available inventory <= 10; Ações: Add product tags ("low-stock"), Add product note |
| Retenção preventiva de pedidos com risco de fraude | "Quando a análise de risco do pedido for concluída, se o nível de risco for High ou a recomendação for de cancelamento, retenha o atendimento do pedido com o motivo Suspected fraud e adicione a tag Fraud-Review." | Gatilho: Order risk analyzed; Condição: Risk level == HIGH; Ações: Hold fulfillment order (Motivo: "Suspected fraud"), Add order tags ("Fraud-Review") |
| Roteamento de pedidos internacionais | "Quando um pedido for pago, se o código do país do endereço de entrega não for US, adicione a tag International-Fulfillment e envie uma mensagem no canal logistics do Slack." | Gatilho: Order paid; Condição: Shipping countryCode != "US"; Ações: Add order tags ("International-Fulfillment"), Send Slack message |
Passo 4: Avaliar e ajustar os nós na tela
Assim que a automação é gerada, o Sidekick exibe um resumo da lógica no chat e fornece um botão para abrir o fluxo recém-criado. Clique no link para verificar os nós visuais. Caso queira refinar as etapas, você pode editar os blocos manualmente ou enviar novos comandos no chat:
- "Adicione uma condição extra para ignorar pedidos pagos inteiramente com cartões de presente."
- Avalie a proposta apresentada pelo Sidekick e clique em Apply changes (Aplicar alterações) para consolidar ou em Discard changes (Descartar alterações) para manter a versão anterior.
Solução de problemas e correção de erros com o Sidekick
Um dos principais pontos de atrito para os gerentes de loja é lidar com erros que impedem o salvamento do fluxo de trabalho. O Sidekick consegue examinar os avisos de erro e reestruturar os blocos automaticamente por meio de comandos de texto.
Resolvendo o erro "Data not found" (Dados não encontrados)
O erro mais frequente no Shopify Flow é o Data not found. Ele ocorre quando uma ação exige um recurso individual (como um único produto ou uma única remessa de atendimento), mas o gatilho precedente ou a ação de consulta (Get data) entrega uma lista (array) de recursos.
Por exemplo, ao configurar um gatilho agendado Scheduled time seguido por Get product data, conectar essa saída diretamente em Add product tags gera a falha Data not found, pois a ação de etiquetas não aceita uma coleção de produtos de uma só vez.
Como corrigir usando o Sidekick:
- Abra o fluxo com erro no editor do Flow.
- No Sidekick, digite:
Fix the Data not found error on the Add product tags action.(Corrija o erro Data not found na ação Add product tags). - O Sidekick identifica a incompatibilidade de tipos e insere uma ação For each (Para cada item) entre a consulta de dados e a marcação de tags, reconectando as etapas.
- Revise a alteração na tela e clique em Apply changes.
Ajustando loops em pedidos com múltiplos pacotes
Quando um pedido é dividido em múltiplos locais de estoque, uma ação como Mark a fulfillment order as fulfilled falhará se conectada diretamente a Order created, pois o pedido traz uma lista de remessas de atendimento.
- Comando para o Sidekick: "A ação de marcar remessa informa que faltam dados. Crie um loop para processar individualmente cada remessa do pedido."
- O Sidekick ajustará automaticamente a iteração For each sobre a lista
fulfillmentOrders.
Superando o descompasso de dados assíncronos da API
É comum tentar avaliar o risco de fraude de um pedido usando o gatilho Order created. No entanto, na GraphQL Admin API da Shopify, a análise de risco e os dados detalhados de UTM de campanhas são preenchidos de forma assíncrona segundos ou minutos após a emissão do pedido. Consultar esses valores imediatamente em Order created resulta em variáveis vazias, fazendo com que a condição resulte incorretamente em False.
- Pergunta de diagnóstico ao Sidekick: "Por que meu fluxo de fraude não está marcando pedidos de alto risco? Verifique se há algum problema com o gatilho."
- O Sidekick explicará a natureza assíncrona do dado e recomendará substituir o gatilho inicial por Order risk analyzed (Risco do pedido analisado).
Validação segura antes de colocar o fluxo em produção
Testar regras de automação diretamente com pedidos reais pode gerar envios acidentais de e-mails para clientes ou alterações indevidas no inventário. O Shopify Flow conta com um ambiente de simulação no qual o Sidekick gera eventos de teste (Simulated events) baseados na estrutura real da sua loja.
+-------------------------------------------------------------------+
| 1. Abrir fluxo no editor do Flow -> Clicar em "Test your workflow"|
+-------------------------------------------------------------------+
|
v
+-------------------------------------------------------------------+
| 2. Selecionar "Generate events" (Gerar eventos com o Sidekick) |
| - O Sidekick avalia os dados da loja e gera dois cenários: |
| * Evento A: Atende aos critérios (Simula caminho True) |
| * Evento B: Não atende aos critérios (Simula caminho False) |
+-------------------------------------------------------------------+
|
v
+-------------------------------------------------------------------+
| 3. Inspeção visual do caminho e validação de variáveis |
| - O caminho percorrido é destacado em cor na tela |
| - Aba "Preview" nas ações permite checar valores Liquid |
| - Modo seguro: não envia e-mails reais nem altera dados |
+-------------------------------------------------------------------+
|
v
+-------------------------------------------------------------------+
| 4. Validação concluída -> Sair do teste -> Clicar em "Ativar fluxo"|
+-------------------------------------------------------------------+
Como executar a geração de testes com o Sidekick:
- Abra o rascunho do fluxo no editor do Flow.
- No nó do gatilho inicial, clique em Test your workflow (Testar fluxo de trabalho).
- Na janela de testes, selecione Generate events.
- O Sidekick analisa pedidos e produtos existentes e cria dois cenários simulados:
- Um que cumpre todas as condições (caminho True);
- Outro que não atinge os critérios (caminho False).
- Selecione qualquer um dos cenários na lista de eventos salvos.
- Acompanhe a linha destacada no editor. Clique em ações específicas e consulte a aba Preview (Visualização) para garantir que as variáveis dinâmicas em Liquid (como nomes e valores) estejam sendo preenchidas corretamente.
- Como o teste opera em modo simulado, nenhuma notificação real é enviada e nenhum pedido é alterado. Após validar o funcionamento, clique em Turn on workflow para ativar a automação com segurança.
Boas práticas e limites operacionais
Para manter a operação organizada e escalável, é recomendável adotar as seguintes práticas:
- Prompts específicos em vez de genéricos: Evite instruções vagas como "Crie uma regra para clientes VIP". Prefira: "Quando um pedido for criado, se o subtotal ultrapassar 150 dólares e o país for o Brasil, adicione a tag VIP-BR".
- Evitar dispersão excessiva em um mesmo gatilho (Fan-out): Criar dezenas de fluxos isolados dependendo todos de
Order createdsobrecarrega o processamento simultâneo. Use o Sidekick para agrupar múltiplos ramos condicionais em um único fluxo organizado. - Atenção ao limite de 1.000 fluxos: A Shopify permite no máximo 1.000 fluxos combinados (ativos e inativos) por loja. Peça ajuda ao Sidekick periodicamente para identificar rascunhos sem uso e limpá-los.
- Requisitos de plano para ações avançadas: Ações como
Send HTTP request(para envio de webhooks externos) exigem planos Shopify Grow, Advanced ou Plus. - Limites de ecossistema: O Sidekick estrutura integrações oficiais e apps compatíveis com conectores do Flow. Caso precise de integrações com plataformas proprietárias que não possuem conector, será necessário utilizar webhooks genéricos ou contratar um desenvolvedor parceiro da Shopify.
Ao unir a linguagem natural do Sidekick com o poder visual do Shopify Flow, os lojistas conseguem eliminar tarefas manuais de atendimento, estoque e triagem de pedidos em questão de minutos, sem escrever uma única linha de código.