Powiąż kontakty ze sprawą
Robot „Powiąż kontakty ze sprawą” wiąże jeden lub kilka kontaktów według ich ID ze sprawą w Bitrix24 (Alaio), bezpośrednio w regule automatyzacji lub procesie biznesowym. Tryb „dodaj” dopisuje do już powiązanych kontaktów, tryb „zastąp” zostawia tylko wskazane. Zwraca flagę sukcesu, liczbę powiązanych kontaktów i wynikową listę ID.
Sprawa może mieć kilka kontaktów, ale standardowy robot „Zmień dokument” zmienia tylko jeden główny, a pozostałe powiązania łatwo przy tym stracić. Ten robot zarządza całą listą. Podaj jedno ID kontaktu lub kilka, oddzielone przecinkami, ze zmiennej lub z wyniku innego robota, na przykład „Znajdź kontakt po telefonie”. Domyślnie robot działa na sprawie, na której uruchomiono proces, ale można podać ID dowolnej sprawy. Tryb „Dodaj” dopisuje kontakty do już powiązanych i pomija te, które już są; tryb „Zastąp” zostawia tylko wskazane kontakty, a pierwszy z nich staje się głównym. Zwraca Sukces (Y/N), liczbę kontaktów powiązanych w tym uruchomieniu oraz pełną listę ID powiązanych kontaktów po wykonaniu, gotową do użycia w warunkach i kolejnych krokach.
Jakie parametry wejściowe przyjmuje robot?
| Parametr | Typ | Wymagany? | Domyślnie |
|---|---|---|---|
| ID sprawy (puste — sprawa, na której działa proces) | int | — | |
| ID kontaktów (jeden lub kilka) | string | tak | |
| Tryb | select | — | add |
Co zwraca robot?
| Parametr | Typ |
|---|---|
| Sukces (Y/N) | string |
| Kontakty powiązane w tym uruchomieniu | int |
| ID wszystkich powiązanych kontaktów po wykonaniu | 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: nie podano ID, a proces działa na innym elemencie
- Błąd: nie podano żadnego poprawnego ID kontaktu
- Błąd: za dużo kontaktów, limit to {max}
- Błąd API: {message}
- Nie udało się powiązać kontaktów: {ids}
- Nie znaleziono kontaktów: {ids}
Scenariusz: sprawa z firmą, która ma kilku przedstawicieli
- Proces zbiera ID wszystkich kontaktów firmy
- Ten robot w trybie „Dodaj” wiąże je ze sprawą w jednym kroku
- E-maile i połączenia w sprawie są teraz widoczne przy każdym uczestniku