Kontakt per ID aktualisieren
Der Roboter „Kontakt per ID aktualisieren“ ändert jeden Kontakt anhand seiner Kennung aus jedem Geschäftsprozess-Kontext in Bitrix24 (Alaio). Die zu ändernden Felder werden als JSON im camelCase-Format übergeben (name, lastName, assignedById, companyId und weitere). Er gibt ein Erfolgskennzeichen Y/N für die bedingte Verzweigung im Prozess zurück und arbeitet über die universelle CRM-Methode crm.item.update.
Der Roboter aktualisiert einen beliebigen Kontakt anhand seiner ID, auch wenn der Geschäftsprozess auf einer anderen CRM-Entität läuft — einem Deal, einem Lead oder einer Aufgabe. Die Kontakt-ID und die Feldmenge werden explizit angegeben: Felder werden als JSON-Zeichenkette im camelCase-Format übergeben (zum Beispiel {"name":"John","lastName":"Smith","assignedById":5,"companyId":12}). Die Aktualisierung verwendet die universelle Methode crm.item.update, sodass alle Kontaktfelder verfügbar sind, einschließlich benutzerdefinierter. Typische Fälle: bei einer Phasenänderung des Deals den verknüpften Kontakt aktualisieren; den Verantwortlichen und das Unternehmen aus einem externen System setzen; Kontaktfelder aus einem übergeordneten Prozess massenhaft ändern. Er gibt ein Kennzeichen Erfolgreich (Y/N) zurück: Y bei erfolgreicher Aktualisierung, N bei leerer ID, leerem oder ungültigem JSON oder einem API-Fehler — vergleichen Sie es in der Bedingung des nächsten Schritts.
Welche Eingabeparameter akzeptiert der Roboter?
| Parameter | Typ | Pflichtfeld? | Standard |
|---|---|---|---|
| Kontakt-ID | int | ja | |
| Zu aktualisierende Felder (camelCase-JSON): {"name":"John","lastName":"Smith","assignedById":5,"companyId":12} | string | ja |
Was gibt der Roboter zurück?
| Parameter | Typ |
|---|---|
| Erfolg (Y/N) | string |
Szenario: Aktualisierung eines Kontakts aus einem Deal-Prozess
- Der Deal wechselt in eine neue Pipeline-Phase
- Der Roboter aktualisiert den verknüpften Kontakt: assignedById und companyId werden als JSON übergeben
- Ein Y-Ergebnis bestätigt die Aktualisierung für den nächsten Schritt