Remover tags da tarefa por ID
O robô «Remover tags da tarefa» retira as tags indicadas de uma tarefa do Bitrix24 pelo seu ID sem tocar nas demais. As tags são fornecidas como uma lista (uma por linha) e comparadas sem distinção de maiúsculas e minúsculas. Retorna um indicador «Sucesso» (Y/N), o número de tags removidas e a lista das tags restantes para a próxima etapa do processo.
O robô remove de uma tarefa do Bitrix24 apenas as tags listadas, mantendo todas as demais. A entrada é um ID numérico da tarefa e uma lista de tags (campo múltiplo, uma tag por linha); a comparação é feita sem distinção de maiúsculas e minúsculas e os espaços em branco excedentes são descartados. Internamente o robô lê as tags atuais da tarefa, exclui as que coincidem e grava o restante via tasks.task.update (a API não tem uma operação de «remover uma tag», por isso a lista de tags é sempre reescrita por completo). Se nenhuma das tags indicadas estiver na tarefa, nenhuma gravação é realizada e o robô informa que não havia nada a remover. Um cenário típico é retirar a marcação «nova» ou «aguardando resposta» quando uma tarefa passa para uma determinada etapa: a própria condição da etapa é configurada nas regras de automação ou no processo de negócios, e o robô apenas remove a tag da tarefa cujo ID você passa. Retorna «Sucesso» (Y/N), o número de tags removidas e a lista das restantes — use-os nas condições e notificações das etapas seguintes.
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| ID da tarefa | int | sim | |
| Tags a remover (uma por linha) | string | sim |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Sucesso (Y/N) | string |
| Quantidade de tags removidas | int |
| Tags restantes | string |
Cenário: retirar a tag "nova" quando uma tarefa passa para a etapa "Em andamento"
- Na regra de automação da etapa adicione o robô «Remover tags da tarefa»
- Defina o ID da tarefa como a tarefa atual e informe "nova" na lista de tags
- O robô retorna Sucesso = Y e removed_count = 1 se a tag estava na tarefa