Atualizar tarefa por ID
O robô «Atualizar tarefa por ID» modifica uma tarefa existente do Bitrix24 pelo seu ID a partir de qualquer contexto de processo de negócios. Os campos são passados como JSON com códigos em MAIÚSCULAS (TITLE, RESPONSIBLE_ID, DEADLINE, PRIORITY etc.) e aplicados pelo método tasks.task.update. Retorna um indicador «Sucesso (Y/N)» conforme o resultado da chamada à API.
O robô atualiza uma tarefa existente pelo seu ID chamando o método tasks.task.update. A entrada é um ID numérico da tarefa e um conjunto de campos como JSON; os códigos dos campos são informados em MAIÚSCULAS, conforme exige a API de tarefas — por exemplo, {"TITLE":"Novo título","RESPONSIBLE_ID":5,"DEADLINE":"2024-12-31T23:59:59+03:00","PRIORITY":"2"}. Quando usar: reatribuir o responsável ou alterar o prazo da tarefa quando um negócio passa para uma nova etapa; acrescentar um marcador de etapa ao título; elevar a prioridade conforme uma condição do processo. O robô retorna «Sucesso (Y/N)»: N se o ID estiver ausente, o JSON estiver vazio ou inválido, ou a API retornar um erro (o texto do erro vai para o log). Use o indicador «Sucesso» na condição da próxima etapa para separar os ramos de atualização bem-sucedida e malsucedida.
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| ID da tarefa | int | sim | |
| Campos a atualizar (UPPERCASE JSON): {"TITLE":"Novo título","RESPONSIBLE_ID":5,"DEADLINE":"2024-12-31T23:59:59+03:00","PRIORITY":"2"} | string | sim |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Sucesso (Y/N) | string |
Cenário: reatribuição de uma tarefa ao avançar um negócio
- Um negócio passa para a etapa «Em andamento»
- O robô chama a atualização da tarefa pelo seu ID com os campos {"RESPONSIBLE_ID":5}
- Com «Sucesso» = Y o processo continua, com N segue para o ramo de tratamento de erro