Wyczyść duplikaty spraw w encji według ID
Robot „Wyczyść duplikaty spraw w encji według ID" znajduje w osi czasu wskazanego leada, deala, kontaktu lub firmy w Bitrix24 (Alaio) sprawy o tych samych nazwach, zostawia jedną według wybranej reguły, a pozostałe kończy lub usuwa. Encję wskazuje się typem i ID. Zwraca liczbę znalezionych duplikatów oraz ID przetworzonych spraw.
Robot usuwa powtarzające się sprawy z osi czasu encji wskazanej typem i ID — leada, deala, kontaktu lub firmy. Za duplikaty uznaje sprawy o tej samej nazwie: przed porównaniem nazwa jest normalizowana, powtórzone spacje są zwijane, wielkość liter nie ma znaczenia. Odpowiedzialny domyślnie nie wchodzi do porównania, ponieważ po scaleniu rekordów takie same sprawy mają zwykle różnych odpowiedzialnych; osobny przełącznik wymaga zgodności także po odpowiedzialnym. W każdej grupie jedna sprawa zostaje, pozostałe są przetwarzane. Która zostaje, określa parametr: „zakończoną, w przeciwnym razie najstarszą" (domyślnie), „zakończoną, w przeciwnym razie najnowszą", „„niezakończoną, w przeciwnym razie najstarszą", „niezakończoną, w przeciwnym razie najnowszą", najstarszą" lub „najnowszą" — cztery pierwsze oznaczają, że status waży więcej niż data, dwa ostatnie patrzą tylko na datę. Działanie na duplikacie wybiera się osobno: zakończyć (domyślnie, odwracalne) lub usunąć. Robot obsługuje zarówno sprawy uniwersalne, jak i zadania: zadanie powiązane z rekordem CRM widać w osi czasu, a przy usuwaniu duplikatu robot usuwa samo zadanie, a nie tylko wpis w karcie. Typy spraw włącza się polami wyboru — domyślnie tylko sprawy uniwersalne i zadania, natomiast połączenia, e-maile, czaty otwartych kanałów i formularze CRM pozostają wyłączone, ponieważ rejestrują rzeczywistą interakcję z klientem. Czego nie włączono wprost, robot nigdy nie rusza. Limity przeglądanych i przetwarzanych spraw na uruchomienie chronią portal przed ograniczeniem REST, a tryb raportu pozwala najpierw obejrzeć listę bez zmian. Aby wyczyścić encję, w której procesie biznesowym stoi sam robot, użyj „Wyczyść duplikaty spraw w bieżącej encji".
Jakie parametry wejściowe przyjmuje robot?
| Parametr | Typ | Wymagany? | Domyślnie |
|---|---|---|---|
| Typ encji | select | tak | deal |
| ID encji | int | tak | |
| Uniwersalne sprawy | bool | — | Y |
| Zadania | bool | — | Y |
| Połączenia | bool | — | N |
| E-maile | bool | — | N |
| Czaty otwartych kanałów | bool | — | N |
| Formularze CRM | bool | — | N |
| Którą sprawę zostawić | select | tak | completed_oldest |
| Co zrobić z duplikatem | select | tak | complete |
| Uznawać za duplikat tylko przy tym samym odpowiedzialnym | bool | — | N |
| Ile spraw przejrzeć (maks.) | int | — | 1000 |
| Ile spraw przetworzyć w jednym uruchomieniu (maks.) | int | — | 100 |
| Tylko raport, nic nie zmieniać | bool | — | N |
Co zwraca robot?
| Parametr | Typ |
|---|---|
| Wykonano (Y/N) | string |
| Ile duplikatów znaleziono | int |
| Ile spraw przetworzono | int |
| ID przetworzonych spraw | string |
| ID zostawionych spraw | string |
| Osiągnięto limit (Y/N) | string |
| Błędy | string |
Jakie błędy może zwrócić robot?
Te komunikaty robot zapisuje w dzienniku procesu biznesowego, gdy nie może wykonać kroku. Z treści widać, co poprawić w ustawieniach lub danych.
- Błąd API
- Błąd: nie wybrano żadnego typu spraw
- Błąd: nie podano ID encji
- Błąd: wybierz typ encji — lead, deal, kontakt lub firma
- Błąd: robot „bieżącej encji" musi działać w procesie biznesowym leada, deala, kontaktu lub firmy
Scenariusz: usunąć duplikaty spraw po scaleniu deali
- Dodaj robota „Wyczyść duplikaty spraw w encji według ID" do procesu biznesowego
- Wskaż typ encji Deal oraz ID deala, do którego wszystko scalono
- Zostaw włączone sprawy uniwersalne i zadania, wybierz działanie „Usunąć"
- Pierwsze uruchomienie zrób w trybie raportu i sprawdź listę w affected_ids