Integrações LBHM

Quando a sua operação usa outros sistemas da LBHM, o fluxo fala com eles por nós prontos: abrir e acompanhar tarefas no LBHM Tasks, consultar endereços por CEP no LBHM Utils e mandar um aviso pelo LIP.

Na paleta do editor eles aparecem em LBHM Tasks, LBHM Utils e, no caso do aviso, em Núcleo.

O que vale para todos

• Cada nó usa uma credencial do sistema com que fala — LBHM Tasks (API), LBHM Utils (API) ou LBHM LIP (API). Cadastre-a uma vez e escolha pelo nome no nó.
• Os campos de texto aceitam {{ … }} com dados do item, então o mesmo nó atende um lote inteiro.
• Na aba Config ficam Timeout (segundos) (padrão 60), Saída do nó (Mesclar item, o padrão, ou Substituir item) e Processamento paralelo, que dispara vários itens ao mesmo tempo mantendo a ordem da saída — veja Ajustes do nó.
• Cada nó tem uma saída (main) e acrescenta ao item um campo com a resposta do sistema — indicado em cada seção abaixo.
• Com o Processamento paralelo ligado, uma falha de comunicação vira _erro no item e o lote segue. Com ele desligado, vale o Em caso de erro da aba Config.

Tasks — Criar/atualizar

Abre uma tarefa no LBHM Tasks para alguém tratar.

Preencha Processo e Tipo — sem os dois a tarefa não é criada. O Tasks exige a classificação na criação, porque é o tipo que define quais ações a pessoa vai ter na tarefa. Escolha primeiro o Processo: a lista de Tipos é a daquele processo, e trocar o processo limpa o tipo escolhido. Se a lista de tipos vier vazia, cadastre o tipo no Tasks antes de ligar o fluxo. A recusa também acontece quando o tipo escolhido pertence a outro processo.

Uma tarefa que já existe — mesma Origem e mesma Referência externa — é atualizada e passa mesmo sem Processo e Tipo: o Tasks preserva a classificação que ela já tem.

Sai o item enriquecido com _tarefa: o número da tarefa, o status, se ela foi criada agora ou apenas atualizada, o processo, o tipo e os tópicos.

Sobre repetir a execução: com Referência externa preenchida, rodar de novo sobre o mesmo registro atualiza a tarefa existente em vez de abrir outra. Sem ela, cada execução abre uma tarefa nova — e um fluxo agendado enche a fila de duplicatas.

Tasks — Atualizar/Finalizar

Mexe numa tarefa que já existe, encontrada por Origem + Referência externa (os dois obrigatórios). Só o que você preencher é alterado; o resto fica como está.

É este o nó que fecha o ciclo: quando a automação termina o trabalho, ela mesma conclui a tarefa que abriu.

Sai o item com _tarefa, no mesmo formato do nó anterior.

Tasks — Listar

Busca tarefas e emite uma saída por tarefa — bom para varrer o que está em aberto e agir em cada uma.

Sem nenhuma tarefa no resultado, o item não segue adiante — o ramo simplesmente não roda. Se quiser tratar o "não achei nada", ligue Porta para saída vazia na aba Config.

Tasks — Tópico (upsert)

Garante que um tópico exista antes de você usá-lo numa tarefa.

Sai o item com _topico.

Tasks — Consultar

Lê informações de apoio do Tasks. Escolha o Recurso:

Use Tópicos e Equipes para montar decisões no fluxo (para qual tópico mandar a tarefa, por exemplo) e Indicadores para um resumo periódico.

Utils — Consultar CEP

Consulta um CEP na base dos Correios do LBHM Utils e completa o endereço no item.

Sai o item com _cep: logradouro, bairro, cidade, UF e os códigos do município e do tipo de rua. Se o CEP não constar na base, o item segue mesmo assim, com _cep.encontrado igual a falso — decida o que fazer com um IF logo depois.

Utils — Buscar CEPs

Procura endereços por critérios, em vez de por um CEP específico. Serve para perguntas do tipo "todas as ruas deste bairro" ou "os CEPs desta cidade".

Campos pesquisáveis: CEP, Logradouro/Rua, Bairro, UF/Estado, Cidade/Município, Cód. Município, Cód. tipo de rua e Tipo. Operadores: Igual, Diferente, Contém, Começa com, Termina com e Em lista. O valor aceita {{ … }}; campo e operador são fixos.

Sai um item por endereço encontrado, cada um com _cep e o total encontrado em _cep_total. Quando a busca não acha nada, o item segue com _cep_total igual a zero — assim o fluxo sabe que procurou.

LIP — Notificar

Manda um aviso pelo LBHM LIP para quem assina aquele canal.

Quem recebe é quem assinou o canal no LIP — o nó não escolhe destinatário por nome. Sai o item com _lip, incluindo quantas pessoas receberam. Se o número vier zero, ninguém assinou aquele canal ainda: confira a assinatura no LIP.

Veja também: Tarefas, Ações e Credenciais.