Os nós de gatilho da VTEX permitem iniciar automações no Flow Builder Avançado com base nas atividades de pedidos da sua loja VTEX — ou executar backfills agendados para processar pedidos existentes em lote. Isso ajuda as equipes de vendas, suporte e operações a sincronizar dados de pedidos, notificar clientes e automatizar o roteamento de tarefas.

Neste artigo, mostraremos como adicionar e configurar três tipos de gatilhos da VTEX no Flow Builder Avançado.
 

Gatilhos da VTEX compatíveis

• Percorrer pedidos da VTEX
  Ideal para sincronizações agendadas ou importação de pedidos existentes. Esse gatilho percorre em lote todos os pedidos correspondentes aos filtros definidos.
• Pedidos criados na VTEX
  Use este gatilho quando quiser que o fluxo seja executado assim que um novo pedido for criado na VTEX — por exemplo, quando um cliente faz uma compra ou cria um novo perfil.
• Pedidos atualizados na VTEX
  Escolha este gatilho se quiser que o fluxo seja acionado quando um pedido existente for atualizado — como quando o status muda de “processando” para “entregue”.

Percorrer pedidos da VTEX

O gatilho “Percorrer pedidos da VTEX” permite processar vários pedidos em lote com base nas condições que você definir. Em vez de inscrever um pedido de cada vez, esse gatilho recupera um conjunto de pedidos (por exemplo, todos os pedidos pagos dentro de um período específico) e executa as ações do fluxo para cada um deles.

Um caso de uso importante é a sincronização inicial de dados, garantindo que todos os registros relevantes de pedidos da VTEX sejam importados para a SleekFlow. Isso permite automatizações baseadas em pedidos, como

Aqui estão algumas maneiras de aproveitar esse gatilho:

• Executar sincronizações de pedidos agendadas
  Mantenha os dados de pedidos atualizados na SleekFlow ou em sistemas externos executando o loop por todos os pedidos correspondentes da VTEX em uma programação regular.
• Atualizar status de pedidos em massa
  Inscreva grupos de pedidos de uma só vez — por exemplo, todos os pedidos com status “pronto para retirada” — para enviar lembretes ou notificações automaticamente.
• Reprocessar pedidos históricos
  Inscreva grupos de pedidos de uma só vez — por exemplo, todos os pedidos com status “pronto para retirada” — para enviar lembretes ou notificações automaticamente.

Siga as etapas abaixo para configurar o nó de gatilho “Percorrer pedidos da VTEX”:

1. Clique no nó para abrir o formulário de configuração, que aparecerá no lado direito da tela.
2. O formulário do nó contém os seguintes campos para configurar o gatilho:
   1. Aba Configuração
      1. Loja: Selecione a loja VTEX conectada que deseja usar para configurar este gatilho. Caso ainda não tenha conectado uma loja VTEX, siga as etapas descritas neste artigo da Central de Ajuda para realizar a conexão..
      2. Pedidos criados dentro de: Essa opção permite definir um intervalo de tempo no qual os pedidos da VTEX devem ter sido criados para serem inscritos no fluxo. Ela funciona como um filtro com base na data de criação do pedido. Isso é especialmente útil quando você deseja limitar execuções em massa ou agendadas apenas aos pedidos mais recentes, em vez de processar todo o histórico. Por exemplo:
         1. If you set Range = 7 and Unit = Days, only orders created in the last 7 days will be enrolled.
         2. If you set Range = 24 and Unit = Hours, the flow will include only orders placed in the past day.
            
3. Aba Filtro
   1. Condições de inscrição: Quando ativadas, você pode definir condições específicas na aba “Filtro” que o cliente deve atender para ser inscrito no fluxo. Por exemplo:
      1. Status do pedido = “pronto para retirada”
      2. Data de criação está dentro dos últimos 7 dias
      3. Valor total do pedido ≥ USD 200

Pedidos criados na VTEX

O gatilho “Pedidos atualizados na VTEX” executa o fluxo sempre que um pedido existente na sua loja VTEX conectada é atualizado. Isso é útil para automatizar notificações e processos internos com base em alterações no status do pedido, estado de pagamento ou detalhes de entrega.

Aqui estão algumas maneiras de aproveitar esse gatilho:

• Enviar atualizações de envio ou entrega
  Notifique os clientes automaticamente quando o status do pedido mudar para “enviado” ou “entregue”.
• Gerenciar cancelamentos ou falhas de pagamento
  Alerta automaticamente a equipe de suporte ou o cliente quando um pedido é cancelado ou quando um pagamento é recusado.
• Atualizar o CRM ou sistemas internos
  Sincronize os status atualizados dos pedidos, códigos de rastreamento ou detalhes de entrega com os Objetos Personalizados da SleekFlow ou ferramentas externas.

Siga as etapas abaixo para configurar o nó de gatilho “Pedidos atualizados na VTEX”:

1. Clique no nó para abrir o formulário de configuração, que aparecerá no lado direito da tela.
2. O formulário do nó contém os seguintes campos para configurar o gatilho:
   1. Aba Configuração
      Autenticação: Selecione a loja VTEX conectada que deseja usar para configurar este gatilho. Caso ainda não tenha conectado uma loja VTEX, siga as etapas descritas neste artigo da Central de Ajuda para realizar a conexão..
      
      
      
   2. Aba “Filtro”
      1. Condições de inscrição: Quando ativadas, você pode definir condições específicas na aba “Filtro” que o pedido deve atender para ser inscrito no fluxo. Por exemplo:
         1. Valor total do pedido ≥ USD 200
         2. Status do pedido = “confirmado”
         3. Método de pagamento = “cartão de crédito”

Pedidos atualizados na VTEX

O gatilho “Pedidos atualizados na VTEX” executa o fluxo sempre que um pedido existente na sua loja VTEX conectada é atualizado. Isso é útil para automatizar notificações e processos internos com base em alterações no status do pedido, estado de pagamento ou detalhes de entrega.

Aqui estão algumas maneiras de aproveitar esse gatilho:

• Enviar atualizações de envio ou entrega
  • Notifique os clientes automaticamente quando o status do pedido mudar para “enviado” ou “entregue”.
• Gerenciar cancelamentos ou falhas de pagamento
  • Alerta automaticamente a equipe de suporte ou o cliente quando um pedido é cancelado ou quando um pagamento é recusado.
• Atualizar o CRM ou sistemas internos
  • Sincronize os status atualizados dos pedidos, códigos de rastreamento ou detalhes de entrega com os Objetos Personalizados da SleekFlow ou ferramentas externas.

Siga as etapas abaixo para configurar o nó de gatilho “Pedidos atualizados na VTEX”:

1. Clique no nó para abrir o formulário de configuração, que aparecerá no lado direito da tela.
2. O formulário do nó contém os seguintes campos para configurar o gatilho:
   1. Aba Configuração
      Autenticação: Selecione a loja VTEX conectada que deseja usar para configurar este gatilho. Caso ainda não tenha conectado uma loja VTEX, siga as etapas descritas neste artigo da Central de Ajuda para realizar a conexão..
      
      
      
   2. ÍAba Filtro
      1. Condições de inscrição: Quando ativadas, você pode definir condições específicas na aba “Filtro” que o pedido atualizado deve atender para ser inscrito no fluxo. Por exemplo:
         1. O status do pedido muda de “em processamento” para “entregue”
         2. Status de pagamento = “aprovado”
         3. Atualizado nas últimas 24 horas