Kontakte mit einem Deal verknüpfen
Der Roboter „Kontakte mit einem Deal verknüpfen“ verknüpft einen oder mehrere Kontakte anhand ihrer IDs mit einem Deal in Bitrix24 (Alaio), direkt in einer Automatisierungsregel oder einem Geschäftsprozess. Der Modus „Hinzufügen“ ergänzt die bereits verknüpften Kontakte, der Modus „Ersetzen“ behält nur die angegebenen. Zurückgegeben werden ein Erfolgskennzeichen, die Anzahl der verknüpften Kontakte und die resultierende ID-Liste.
Ein Deal kann mehrere Kontakte haben, aber der Standardroboter „Dokument ändern“ ändert nur den einen Hauptkontakt, und die übrigen Verknüpfungen gehen dabei leicht verloren. Dieser Roboter verwaltet die gesamte Liste. Geben Sie eine Kontakt-ID oder mehrere an, durch Komma getrennt, aus einer Variablen oder aus der Ausgabe eines anderen Roboters wie „Kontakt per Telefon finden“. Standardmäßig arbeitet der Roboter mit dem Deal, auf dem der Prozess läuft, es kann aber jede Deal-ID angegeben werden. Der Modus „Hinzufügen“ ergänzt die bereits verknüpften Kontakte und überspringt vorhandene; der Modus „Ersetzen“ behält nur die angegebenen Kontakte, der erste wird zum Hauptkontakt. Zurückgegeben werden Erfolg (Y/N), die Anzahl der in diesem Lauf verknüpften Kontakte und die vollständige Liste der verknüpften Kontakt-IDs nach dem Lauf, bereit für Bedingungen und nächste Schritte.
Welche Eingabeparameter akzeptiert der Roboter?
| Parameter | Typ | Pflichtfeld? | Standard |
|---|---|---|---|
| Deal-ID (leer — der Deal, auf dem der Prozess läuft) | int | — | |
| Kontakt-IDs (eine oder mehrere) | string | ja | |
| Modus | select | — | add |
Was gibt der Roboter zurück?
| Parameter | Typ |
|---|---|
| Erfolg (Y/N) | string |
| In diesem Lauf verknüpfte Kontakte | int |
| IDs aller verknüpften Kontakte nach dem Lauf | string |
Welche Fehler kann der Roboter zurückgeben?
Diese Meldungen schreibt der Roboter ins Protokoll des Geschäftsprozesses, wenn er einen Schritt nicht ausführen kann. Der Text zeigt, was in den Einstellungen oder Daten zu korrigieren ist.
- Fehler: keine ID angegeben, und der Prozess läuft auf einem anderen Element
- Fehler: keine gültige Kontakt-ID angegeben
- Fehler: zu viele Kontakte, das Limit ist {max}
- API-Fehler: {message}
- Kontakte konnten nicht verknüpft werden: {ids}
- Kontakte nicht gefunden: {ids}
Szenario: Ein Deal mit einem Unternehmen, das mehrere Ansprechpartner hat
- Der Prozess sammelt die IDs aller Kontakte des Unternehmens
- Dieser Roboter verknüpft sie im Modus „Hinzufügen“ in einem Schritt mit dem Deal
- E-Mails und Anrufe zum Deal sind nun bei jedem Beteiligten sichtbar