Verificar a lista de verificação por etapa
O robô «Verificar a lista de verificação da etapa» lê um campo personalizado Lista de verificação por etapa de uma entidade CRM do Bitrix24 (Alaio) — um negócio, lead, empresa ou processo inteligente — e informa se todos os itens obrigatórios da etapa atual estão marcados. As entradas são o tipo de entidade, seu ID e o código do campo. Retorna all_done com o valor Y se todos os itens obrigatórios estiverem marcados, caso contrário N, além dos contadores done/total e a lista dos itens que faltam.
O robô abre a entidade CRM por tipo e ID, determina sua etapa atual (STAGE_ID no negócio, STATUS_ID no lead, stageId no processo inteligente) e lê o valor do campo Lista de verificação por etapa indicado. Ele pega os itens configurados para essa etapa, compara com os marcados e conta o progresso apenas pelos itens obrigatórios — os opcionais não afetam o resultado. As saídas são: all_done — Y se todos os itens obrigatórios da etapa estiverem marcados, caso contrário N; done e total — quantos itens obrigatórios estão marcados e quantos existem no total; pending_list — os nomes dos itens obrigatórios ainda não marcados, um por linha. Se os parâmetros forem inválidos, a entidade não for encontrada ou o campo indicado não for uma lista de verificação por etapa, o robô retorna all_done N, contadores zerados e uma lista vazia — as mesmas chaves do sucesso, para que a condição da próxima etapa nunca encontre uma chave ausente. Notificar o responsável, voltar a etapa ou criar uma tarefa para os itens pendentes fica a critério do próprio cenário do processo de negócios — o robô apenas informa o fato.
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| Tipo de entidade: deal / contact / company / lead | string | sim | |
| ID da entidade | int | sim | |
| Código do campo | string | sim |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Todos os itens obrigatórios da etapa concluídos (Y/N) | string |
| Número de itens obrigatórios marcados | int |
| Número total de itens obrigatórios da etapa | int |
| Lista dos itens obrigatórios ainda não marcados (um por linha) | string |
Cenário: não deixar um negócio avançar sem os itens obrigatórios
- Um negócio muda de etapa do funil
- O robô verifica a lista de verificação da etapa atual pelo campo Lista de verificação por etapa
- Com all_done = N o processo cria uma tarefa para o responsável com a pending_list e devolve o negócio para a etapa anterior