ForHosting KIT · Avisos e automações

Fluxo condicional

O flow.conditional deixa a automação decidir o rumo: conforme o resultado de um passo, o fluxo segue por um caminho ou por outro. Se o documento é uma nota fiscal, extraia os dados; se não, mande para revisão. É a regra “se isso, então aquilo”, sem você escrever a cola. Está em beta.

● Betapor etapaUS$ 0,000

Ver a API — US$ 0,000 Ver a API

Use pelo WebAPIE-mailApp em breveTelegram em breve

A decisão que ficava no seu código

Sem ramificação, todo fluxo é uma linha reta: faz A, faz B, faz C, sempre igual. Mas o trabalho real tem bifurcações — se o valor passou de mil reais, pede aprovação; se o arquivo veio em branco, avisa alguém. Normalmente essa decisão mora num pedaço de código que você mantém entre uma ferramenta e outra. O fluxo condicional traz a bifurcação para dentro da automação: a regra fica declarada, no lugar de escondida num script.

Como a bifurcação é declarada

Você define a condição sobre o resultado de um passo — igual a, maior que, contém, está vazio — e diz o que rodar em cada saída. O fluxo avalia e segue só o ramo que corresponde; o outro simplesmente não roda. Dá para aninhar decisões e cobrir mais de dois caminhos, mas o bom desenho é o mesmo de sempre: poucas bifurcações claras valem mais que uma teia que ninguém entende depois.

Em beta, dito na lata

O flow.conditional está em beta. As formas de condição mais comuns já funcionam e você pode montar bifurcações hoje, mas ainda estamos ampliando os tipos de regra aceitos e lapidando o comportamento em casos de borda. Tradução prática: ótimo para experimentar e para fluxos internos; para o que não pode falhar, teste bem antes e acompanhe. A página é atualizada conforme o beta amadurece, e o preço publicado é o que vale.

Quanto custa ramificar

A conta segue a mesma dos outros fluxos: você paga a soma dos passos que realmente rodaram mais 20% pela orquestração. Como só um ramo executa em cada bifurcação, você não paga pelo caminho que não foi tomado — o passo que não rodou não entra na conta. Cobrança por uso, preço publicado, sem taxa fixa de chamada e sem assinatura.

Casos de uso

Um caminho para cada tipo de arquivo

A TecnoSul Soluções Digitais recebe arquivos variados. O fluxo checa: se é nota fiscal, extrai os dados e arquiva; se é outro documento, manda para a fila de revisão de Carlos Eduardo Souza. Um caminho para cada tipo, sem triagem manual.

Aprovação por valor do pedido

Uma loja aprova pedidos por valor: se passa de R$ 1.000, o fluxo dispara um pedido de aprovação; se fica abaixo, segue direto para a expedição. A regra que vivia na cabeça do gerente virou parte da automação.

Campo vazio volta para correção

Rafael Almeida Costa processa formulários: se o campo de CPF vem vazio, o fluxo devolve para correção; se vem preenchido, segue para o cadastro. O erro é barrado na entrada, não três passos depois.

Comprovante legível ou reenvio

A Distribuidora Horizonte Verde trata comprovantes: se a imagem está legível, extrai os dados; se está borrada, encaminha para reenvio. Márcia Regina Oliveira só olha os casos que realmente precisam de gente.

Perguntas frequentes

Que tipos de condição posso usar?

As comparações comuns — igual a, maior ou menor que, contém, está vazio — sobre o resultado de um passo. Estamos ampliando os tipos aceitos ao longo do beta; a página reflete o que está disponível.

Pago pelo caminho que não foi tomado?

Não. Só o ramo que corresponde à condição roda, e você paga apenas os passos que executaram, mais 20% de orquestração. O caminho não tomado não entra na conta.

Dá para ter mais de dois caminhos?

Dá: é possível aninhar decisões e cobrir vários casos. Mas vale a mão leve — poucas bifurcações claras se mantêm melhor do que uma teia difícil de entender depois.

Está pronto para uso sério?

Está em beta. As condições mais comuns já funcionam; para fluxos que não podem falhar, teste bem e acompanhe. Ótimo para experimentar e para automações internas.

Quanto custa um fluxo com decisão?

A soma dos passos que rodaram mais 20% pela orquestração — sem taxa fixa de chamada. Como só um ramo executa, a conta acompanha o caminho realmente tomado. Cobrança por uso.

Os dados avaliados na condição ficam guardados?

O resultado é lido para decidir o caminho e serve só para isso. Nada da bifurcação é retido por nós — o que precisa durar mora no seu sistema, sob as regras da LGPD que você já segue.

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/flow/conditional

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/flow/conditional \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

const res = await fetch("https://api.kit.forhosting.com/flow/conditional", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "input": "…"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/flow/conditional",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/flow/conditional", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"input":"…"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/flow/conditional", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "input": "…"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "flow.conditional",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,000

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →