Processos (BPM)

Processos (BPM) organiza o trabalho em fluxos (pipes): cada pedido é um card que anda por fases, com campos próprios do fluxo, aprovações, SLA e automações. É também onde ficam os fluxos automatizados e, em Processos › Central de Automações, os webhooks e o painel de tudo o que roda sozinho. As integrações típicas abrem cards a partir de outro sistema, avisam o ERP quando um pedido é aprovado, devolvem o resultado ao card e levam os dados para o BI.

Abrir card de outro sistema Criar o card com valores de campos pelo identificador, anexar arquivos e mover de fase.

Aprovações Fase de aprovação, aprovadores, o gatilho Aprovação Pendente e aprovar ou reprovar pela API.

Avisar o ERP quando o pedido é aprovado Jornada ponta a ponta: fase Aprovado → webhook com os campos → o ERP responde e atualiza o card.

Levar os dados para o BI Paginar cards, valores de campos e movimentações; métricas prontas do fluxo.

Formulários públicos Abrir cards por formulário sem login, embutido no seu site ou app.

O que a TAI avisa

Assine estes eventos num webhook ou use-os num fluxo automatizado — o caminho de cada um está em Da TAI para o seu sistema. Os campos listados chegam em dados (e em {{gatilho.<campo>}} nos fluxos automatizados). Os eventos de card valem para todos os fluxos da empresa: use pipeId para separar o fluxo que interessa.

Evento	Dados (dados)
Um sistema externo envia dados WEBHOOK_RECEBIDO Outro sistema chamou um endereço de entrada da empresa (aba Webhooks). O que ele mandou pode ser usado nas ações.	entradaIdentradaNomecorpo
Um card é aberto num fluxo CARD_CRIADO Uma solicitação nova foi aberta num processo. Aceita o registro completo.	cardIdnumeropipeIdpipeNomefaseIdfaseNomefaseOrigemNomeresponsavelIdcriadorId
Um card muda de fase CARD_MOVIDO_FASE Um card passou para outra fase do processo. Aceita o registro completo.	cardIdnumeropipeIdpipeNomefaseIdfaseNomefaseOrigemNomeresponsavelIdcriadorId
Um card é concluído CARD_CONCLUIDO Um card chegou à fase de conclusão do processo. Aceita o registro completo.	cardIdnumeropipeIdpipeNomefaseIdfaseNomefaseOrigemNomeresponsavelIdcriadorId
Um card é cancelado CARD_CANCELADO Um card foi cancelado. Aceita o registro completo.	cardIdnumeropipeIdpipeNomefaseIdfaseNomefaseOrigemNomeresponsavelIdcriadorId
Um card é aprovado CARD_APROVADO Uma aprovação de fase deu "aprovado". Aceita o registro completo.	cardIdnumeropipeIdpipeNomefaseIdfaseNomefaseOrigemNomeresponsavelIdcriadorId
Um card é reprovado CARD_REPROVADO Uma aprovação de fase deu "reprovado". Aceita o registro completo.	cardIdnumeropipeIdpipeNomefaseIdfaseNomefaseOrigemNomeresponsavelIdcriadorId
Uma fase do card é pulada CARD_FASE_DISPENSADA Uma fase foi pulada (fase opcional) ou dispensada por quem gerencia o fluxo, com motivo. Aceita o registro completo.	cardIdnumeropipeIdpipeNomefaseIdfaseNomefaseOrigemNomeresponsavelIdcriadorId
Um fluxo automatizado é publicado FLUXO_PUBLICADO Alguém publicou (ou republicou) um fluxo automatizado — a versão nova passa a rodar. Aceita o registro completo.	fluxoIdfluxoNomeexecucaoIdversaomensagem
Uma execução de fluxo automatizado termina FLUXO_EXECUCAO_CONCLUIDA Uma execução de um fluxo automatizado chegou ao fim com sucesso. Aceita o registro completo.	fluxoIdfluxoNomeexecucaoIdversaomensagem
Uma execução de fluxo automatizado falha FLUXO_EXECUCAO_FALHOU Uma execução de um fluxo automatizado parou num passo que falhou (ou num Fim marcado como falha). Aceita o registro completo.	fluxoIdfluxoNomeexecucaoIdversaomensagem
Uma conexão com sistema externo é cadastrada CONEXAO_CRIADA Alguém cadastrou uma conexão (URL e credencial de um sistema externo) para os fluxos usarem.	conexaoIdconexaoNomehostchaveacaotipoquantidade
Uma conexão com sistema externo é alterada CONEXAO_ALTERADA Alguém mudou a URL, a credencial, o estado ou excluiu uma conexão com sistema externo.	conexaoIdconexaoNomehostchaveacaotipoquantidade
Uma conexão passa a aceitar http sem criptografia CONEXAO_HTTP_ACEITO O dono da conta aceitou que uma conexão use http (sem TLS): credencial e dados trafegam legíveis.	conexaoIdconexaoNomehostchaveacaotipoquantidade
Uma integração feita é liberada para refazer MARCA_LIBERADA Alguém liberou uma marca de "uma vez só" (ex.: pessoa já enviada ao ERP) — o próximo envio refaz a ação.	conexaoIdconexaoNomehostchaveacaotipoquantidade
Um vínculo com sistema externo é conferido VINCULO_CONFERIDO Alguém confirmou, trocou, ignorou ou reabriu vínculos entre registros da TAI e de um sistema externo (ex.: o cargo Analista I é a função 01.003 do TOTVS RM).	conexaoIdconexaoNomehostchaveacaotipoquantidade
A conferência de vínculos termina VINCULOS_CONFERENCIA_CONCLUIDA Não sobrou nada para conferir num tipo de vínculo (sugestões e "sem par" resolvidos) ou alguém concluiu a conferência — libera o fluxo que esperava em "Aguardar conferência".	conexaoIdconexaoNomehostchaveacaotipoquantidade
Alguém ativa a verificação em duas etapas MFA_ATIVADO Uma pessoa ativou a verificação em duas etapas da própria conta (app autenticador ou e-mail).	usuarioIdcolaboradorIdmetodo
Alguém desativa a verificação em duas etapas MFA_DESATIVADO Uma pessoa desativou a verificação em duas etapas da própria conta.	usuarioIdcolaboradorIdmetodo
A verificação em duas etapas de alguém é redefinida MFA_REDEFINIDO Um administrador redefiniu a verificação em duas etapas de uma pessoa (perda do celular, por exemplo).	usuarioIdcolaboradorIdredefinidoPorUsuarioId
A empresa passa a exigir (ou deixa de exigir) a verificação em duas etapas MFA_POLITICA_ALTERADA A política da empresa para verificação em duas etapas foi alterada.	exigealteradoPorUsuarioId
Uma decisão é aprovada DECISAO_APROVADA Alguém aprovou uma decisão pendente na Caixa de decisões (o ato aprovado foi executado). Aceita o registro completo.	decisaoIdtipoDecisaotituloautomacaoIdmensagem
Uma decisão é recusada DECISAO_RECUSADA Alguém recusou uma decisão pendente na Caixa de decisões, com o motivo. Aceita o registro completo.	decisaoIdtipoDecisaotituloautomacaoIdmensagem

Gatilhos das automações do fluxo

Dentro de um fluxo, quem reage aos cards são as automações do fluxo, configuradas na aba Automações da configuração do fluxo. Elas têm gatilhos próprios, mais finos que os eventos — uma fase escolhida, um campo, o SLA — e a ação Webhook chama uma URL sua, com as variáveis do card — veja Automações de processos.

Gatilho (na tela)	Código	Quando dispara
Solicitação Criada	CARD_CRIADO	Um card é criado — na tela, pela API, por formulário ou por automação
Solicitação Movida	CARD_MOVIDO	Um card muda de fase
Entrada na Fase / Saída da Fase	FASE_ENTRADA / FASE_SAIDA	Um card entra numa fase escolhida, ou sai dela
Campo Alterado	CAMPO_ALTERADO	Um campo escolhido (ou qualquer campo) muda de valor
SLA Vencido	SLA_VENCIDO	O prazo do card vence
Aprovação Pendente	APROVACAO_PENDENTE	Um card entra numa fase que pede aprovação
Agendado	AGENDADO	Num horário (cron), sobre os cards em aberto do fluxo ou de uma fase
Quando acontecer algo na plataforma	EVENTO_PLATAFORMA	Um evento de qualquer módulo (admissão concluída, férias aprovadas, conta vencida…) abre um card neste fluxo, ou age nos cards do mesmo assunto

O último é o fluxo que ouve um evento: use-o quando cada fato de outro módulo precisa de acompanhamento, com fases, responsável e prazo — veja Fluxo que ouve o evento.

O que a TAI faz sozinha

Rotina	O que faz	Começa ligada?
Prazos dos cards (bpm-sla-vencidos)	A cada hora, avisa os responsáveis por cards com prazo vencido	Sim

A rotina aparece em Processos › Central de Automações › Rotinas dos módulos, com interruptor. Além dela, cada fluxo tem Avisos automáticos (aprovador, responsável, prazo, conclusão), que começam desligados e se ligam na aba Geral da configuração do fluxo.

Recursos da API

Todas as rotas estão na referência de Processos.

Rota-base	Para que serve
/pipe	Fluxos: listar, detalhar, métricas, visualização do board
/phase	Fases de um fluxo (/phase/by-pipe/{pipeId}), aprovadores
/field-schema	Campos do fluxo, com o identificador de cada um
/card	Cards: criar, detalhar, mover, avançar, aprovar, cancelar
/card-field-value	Valores dos campos de um card, por id ou por identificador
/card-comment	Comentários do card
/card-movimentacao	Histórico de fases: quem moveu, quando, por quê
/bpm/ged	Arquivos dos campos do tipo Arquivo, com versões
/automation	Automações do fluxo e o histórico de execuções

Nota

Para criar e mover cards pela API, o usuário de integração precisa estar vinculado a um colaborador com acesso ao fluxo (aba Visibilidade) — ou ser administrador da conta, o que não se recomenda para integração. Veja Abrir card de outro sistema.