Roboteka
Roboteka · Robôs · Limpar atividades duplicadas da entidade atual

Limpar atividades duplicadas da entidade atual

O robô «Limpar atividades duplicadas da entidade atual» encontra na linha do tempo do lead, negócio, contato ou empresa em cujo processo de negócios ele é executado, no Bitrix24 (Alaio), atividades com o mesmo título, mantém uma conforme a regra escolhida e conclui ou exclui as demais. Não é preciso o ID — a entidade vem do contexto do processo. Retorna a quantidade de duplicatas e os IDs processados.

O robô remove atividades repetidas da linha do tempo da entidade atual — o lead, negócio, contato ou empresa em cujo processo de negócios ele é executado; não é preciso determinar o ID, a entidade é obtida do contexto do processo. 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 uma entidade arbitrária pelo seu ID a partir do processo de outra entidade, use o robô «Limpar atividades duplicadas da entidade por ID».

Quais parâmetros de entrada o robô aceita?

Parâmetro Tipo Obrigatório? Padrão
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 A concluída, senão a mais antiga, 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, A mais recente sim completed_oldest
O que fazer com a duplicata select Concluir, Excluir 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

Quais erros o robô pode retornar?

O robô grava essas mensagens no histórico do processo de negócios quando não consegue concluir uma etapa. O texto mostra o que corrigir nas configurações ou nos dados.

  • Erro de API
  • Erro: nenhum tipo de atividade foi selecionado
  • Erro: ID da entidade não foi informado
  • Erro: escolha um tipo de entidade — lead, negócio, contato ou empresa
  • Erro: um robô de «entidade atual» deve ser executado a partir do processo de negócios de um lead, negócio, contato ou empresa

Cenário: organizar a linha do tempo de um negócio após uma mesclagem

  1. No processo de negócios do negócio adicione o robô «Limpar atividades duplicadas da entidade atual»
  2. Não é preciso o ID — o negócio vem do contexto do processo
  3. Mantenha a regra «A concluída, senão a mais antiga» e a ação «Excluir»
  4. O robô retorna found_duplicates e a lista processada em affected_ids

Robôs semelhantes