If

A atividade If habilita ramificações condicionais dentro dos fluxos de trabalho de API para criar caminhos de execução dinâmicos com base em condições orientadas por dados. Use a atividade If para fluxos de trabalho que exigem diferentes ações dependendo das respostas da API em tempo real, entradas do usuário ou estados do sistema.

Como usar a atividade If

Para adicionar uma atividade If ao seu fluxo de trabalho:

1. Em sua tela de designer de fluxo de trabalho de API, selecione o ícone de mais (+). O menu Adicionar atividade aparece.
2. Selecione If.
3. No painel Propriedades , escreva a expressão no campo Condição .
4. Adicione atividades às ramificações Then e Else conforme a necessidade.
5. Depure o fluxo de trabalho para executar a atividade e gerar campos de saída para uso posterior.

Exemplo de atividade If

O exemplo a seguir garante que um fluxo de trabalho de sincronização de transações processe apenas clientes ativos que fizeram pelo menos uma transação nas últimas 24 horas. Se as condições não forem atendidas, o fluxo de trabalho sairá com uma resposta de falha.

Abra a janela Configuração de depuração , cole e salve a seguinte sintaxe JSON:

{
  "id": 12345,
  "name": "John Doe",
  "isActive": true,
  "balance": 2500.75,
  "createdAt": "2025-03-25T12:00:00Z",
  "tags": [
    "premium",
    "verified",
    "active"
  ],
  "address": {
    "street": "123 Main St",
    "city": "New York",
    "state": "NY",
    "zipCode": "10001",
    "coordinates": {
      "latitude": 40.7128,
      "longitude": -74.006
    }
  },
  "transactions": [
    {
      "transactionId": "txn_001",
      "amount": 150.5,
      "currency": "USD",
      "timestamp": "2025-03-25T10:30:00Z"
    },
    {
      "transactionId": "txn_002",
      "amount": -75.25,
      "currency": "USD",
      "timestamp": "2025-03-23T08:15:00Z"
    }
  ]
}

1. Na tela do designer do fluxo de trabalho da API, adicione uma atividade If .
2. Selecione o campo Condição no painel de propriedades para abrir o editor de Expressão.
3. Use o gerador de expressão do Autopilot para criar sua condição e solicite o seguinte:

"Escreva uma instrução condicional que verifique se a solicitação de entrada é para um cliente ativo e se há pelo menos um objeto de transação criado nas últimas 24 horas."

A resposta deve ser assim:

const now = new Date();
const twentyFourHoursAgo = new Date(now.getTime() - 24 * 60 * 60 * 1000);

if ($workflow.input.isActive) {
  const recentTransactions = $workflow.input.transactions.filter(transaction => {
    const transactionTimestamp = new Date(transaction.timestamp);
    return transactionTimestamp > twentyFourHoursAgo;
  });

  const hasRecentTransactions = recentTransactions.length > 0;

  hasRecentTransactions;
} else {
  false;
}

4. Consulte os painéis Entrada do teste de atividade e Saída de expressão para verificar se a expressão gera os resultados esperados.
5. Salve a configuração de Condição .
6. Para a ramificação Then , adicione uma atividade Response .
7. Configure a resposta da seguinte forma:

   • Tipo— Falha

   • Detalhes—Abra o Editor de expressão e escreva o seguinte:

     {
         message: "Customer is not active or no transaction to process"
     }
     

   Essa etapa adiciona uma validação no início do fluxo de trabalho para confirmar que existe uma transação válida antes do processamento.