Perguntas frequentes

Por onde começo?

Crie um fluxo, adicione um gatilho (comece pelo Disparo manual), ligue alguns passos e use Executar fluxo para ver o resultado. Quando estiver pronto, ligue o interruptor Ativo na barra do editor. Veja Fluxos.

Qual a diferença entre executar no editor e executar pela lista?

Executar fluxo, no editor, salva o que você montou e roda na hora, mostrando em cada nó o que ele recebeu e o que produziu — é assim que você acompanha enquanto monta. Executar agora, no card do fluxo, roda o fluxo uma vez e leva você direto ao Monitor. As duas ficam registradas em Execuções.

Meu fluxo agendado não roda. Por quê?

Confira duas coisas. Primeiro, se o fluxo está ativo: gatilhos automáticos só valem com o fluxo ativo — veja Fluxos. Segundo, se a execução anterior já terminou: um disparo que chega com o fluxo ainda rodando é pulado, e o próximo vem no horário seguinte — a regra está em Execuções.

Outro sistema chama o meu webhook e o fluxo não roda. Por quê?

Confira, nesta ordem: se o fluxo está ativo; se quem chama está usando o endereço que aparece no nó de webhook; e se esse sistema está autorizado. Cada gatilho de webhook decide quem pode chamá-lo — os fechados só aceitam a chamada de um app cadastrado, apresentando a chave dele, e os abertos aceitam qualquer um dentro de um limite de chamadas por minuto. Em Apps você vê o histórico das chamadas, inclusive as recusadas e o motivo de cada recusa. Veja Apps.

O que é um "item"?

É a unidade de informação que percorre o fluxo — pense numa linha ou registro. Um fluxo trabalha com vários itens ao mesmo tempo. Veja Conceitos.

Como uso, num campo, um dado que veio do passo anterior?

Escreva uma expressão entre chaves duplas — {{ $json.NOME }} traz o campo NOME do item que está passando — ou arraste a etiqueta do campo, que aparece na aba Parâmetros do nó, direto para o campo que você está preenchendo. Veja O editor.

Como mando cada registro por um caminho diferente?

Use o nó IF (condição), que separa os itens pelas saídas true e false, ou o Switch (rotear), para vários caminhos — ligando cada saída a um trecho diferente do fluxo. Veja Dados e lógica. Quando a regra é uma régua de negócio com muitas linhas, prefira a Tabela de decisão a encadear vários "se" pelo fluxo — veja Decisão.

Uma execução falhou. O que faço?

Abra a execução em Execuções para ver, passo a passo, onde e por que parou. Corrija a causa (um dado de origem, a configuração de um nó, uma credencial) e execute de novo. Lembre que a nova execução começa do zero: os passos que já tinham dado certo agem outra vez — se algum deles cria registro, envia e-mail ou lança no RM, isso se repete. Quando esse risco existir, ajuste o fluxo para processar só o que ficou pendente antes de reexecutar.

Posso ser avisado quando algo falha?

Sim, e o caminho mais curto é Configurações: ligue o aviso por e-mail, informe quem recebe e escolha o intervalo. Tudo o que falhou no intervalo chega num único e-mail, com link para a execução — veja Configurações.

Quando você quiser tratar a falha à sua maneira (abrir um atendimento, avisar por outro canal, registrar num sistema seu), monte um fluxo com o gatilho Erro, que dispara sempre que qualquer outro falhar. Veja Gatilhos.

Onde ficam os agentes de IA?

Em Agentes de IA, no menu, junto com Skills — as competências que você monta uma vez e reaproveita entre agentes. É lá que você escreve a instrução do agente, escolhe o modelo, dá as ferramentas que ele pode usar e conversa com ele. Veja Agentes de IA e Skills.

O que é o teto de gasto de um agente?

É quanto aquele agente pode gastar por mês, em reais, com o modelo de linguagem. Atingido o teto, ele para de responder até o mês virar — assim uma conversa que saiu do previsto não vira uma conta inesperada. Deixe em branco para não limitar. Veja Agentes de IA.

Onde ficam as senhas dos sistemas?

Em Credenciais, guardadas de forma cifrada e reaproveitadas pelos nós. Você nunca repete usuário e senha em cada fluxo.

Mexer num fluxo afeta as execuções já registradas?

Não. Editar a definição muda como o fluxo roda da próxima vez; o histórico de execuções permanece.

Não consigo salvar o fluxo. O que houve?

O caso mais comum é o fluxo ser mantido pela LBHM — ele aparece com borda azul e o símbolo NEXUS na lista, e com a marca Mantido pela LBHM no Monitor. Nesses fluxos, nem quem administra a instância salva alterações: dá para abrir e consultar o desenho, acompanhar e executar. Se um deles precisa mudar, fale com o seu ponto focal na LBHM.

Se o fluxo não tem essa marca, então falta perfil: montar, salvar e ativar fluxos é atribuição de quem administra a instância. Peça ao responsável na sua organização — veja Perfis e acessos.

Um fluxo sumiu da minha lista. O que houve?

Você vê apenas os fluxos liberados para você. Se um deles deixou de aparecer, o acesso foi removido ou alterado. Peça a quem mantém o fluxo que o libere de novo em Quem tem acesso — veja Perfis e acessos.