Limpar atividades duplicadas da entidade por ID
O robô «Limpar atividades duplicadas da entidade por ID» encontra na linha do tempo de um lead, negócio, contato ou empresa indicado no Bitrix24 (Alaio) atividades com o mesmo título, mantém uma conforme a regra escolhida e conclui ou exclui as demais. A entidade é informada por tipo e ID. Retorna a quantidade de duplicatas encontradas e os IDs processados.
O robô remove atividades repetidas da linha do tempo de uma entidade informada por tipo e ID — lead, negócio, contato ou empresa. São consideradas duplicatas as atividades com o mesmo título: antes da comparação o título é normalizado, espaços repetidos são reduzidos e maiúsculas não são diferenciadas. O responsável não entra na comparação por padrão, porque após a mesclagem de registros as mesmas atividades costumam ter responsáveis diferentes; um interruptor à parte exige que o responsável também coincida. Em cada grupo uma atividade é mantida e as demais são processadas. Qual delas é mantida é definido por um parâmetro: «a concluída, senão a mais antiga» (padrão), «a concluída, senão a mais recente», «a aberta, senão a mais antiga», «a aberta, senão a mais recente», «a mais antiga» ou «a mais recente» — os quatro primeiros significam que o status pesa mais que a data, os dois últimos olham apenas a data. A ação sobre a duplicata é escolhida separadamente: concluir (padrão, reversível) ou excluir. O robô trabalha tanto com atividades universais quanto com tarefas: uma tarefa vinculada a um registro CRM aparece na linha do tempo e, ao excluir uma duplicata, o robô remove a própria tarefa e não apenas a linha do cartão. Os tipos de atividade são ativados por caixas de seleção — por padrão apenas atividades universais e tarefas, enquanto chamadas, e-mails, chats de canais abertos e formulários CRM ficam desativados porque registram interação real com o cliente. O que não for ativado explicitamente nunca é tocado. Os limites de verificação e de processamento por execução protegem o portal da limitação do REST, e o modo somente relatório permite revisar a lista antes de qualquer alteração. Para limpar a entidade em cujo processo de negócios o próprio robô é executado, use «Limpar atividades duplicadas da entidade atual».
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| Tipo de entidade | select | sim | deal |
| ID da entidade | int | sim | |
| Atividades universais | bool | — | Y |
| Tarefas | bool | — | Y |
| Chamadas | bool | — | N |
| E-mails | bool | — | N |
| Chats de canais abertos | bool | — | N |
| Formulários CRM | bool | — | N |
| Qual atividade manter | select | sim | completed_oldest |
| O que fazer com a duplicata | select | sim | complete |
| Considerar duplicatas apenas com o mesmo responsável | bool | — | N |
| Quantas atividades verificar (máx.) | int | — | 1000 |
| Quantas atividades processar por execução (máx.) | int | — | 100 |
| Apenas relatório, não alterar nada | bool | — | N |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Concluído (Y/N) | string |
| Quantas duplicatas foram encontradas | int |
| Quantas atividades foram processadas | int |
| IDs das atividades processadas | string |
| IDs das atividades mantidas | string |
| Limite atingido (Y/N) | string |
| Erros | string |
Cenário: remover atividades duplicadas após mesclar negócios
- Adicione o robô «Limpar atividades duplicadas da entidade por ID» a um processo de negócios
- Informe o tipo de entidade Negócio e o ID do negócio no qual tudo foi mesclado
- Deixe ativadas as atividades universais e as tarefas, escolha a ação «Excluir»
- Faça a primeira execução no modo somente relatório e revise a lista em affected_ids