Lead per ID aktualisieren
Der Roboter „Lead per ID aktualisieren“ ändert jeden Lead anhand seiner Kennung aus jedem Geschäftsprozess-Kontext in Bitrix24. Die zu ändernden Felder werden als JSON im camelCase-Format übergeben (title, stageId, assignedById 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 Lead anhand seiner ID, auch wenn der Geschäftsprozess auf einer anderen CRM-Entität läuft — einem Deal, einem Kontakt oder einer Aufgabe. Die Lead-ID und die Feldmenge werden explizit angegeben: Felder werden als JSON-Zeichenkette im camelCase-Format übergeben (zum Beispiel {"title":"Neuer Lead","stageId":"NEW","assignedById":5,"ufCrm_123":"Wert"}). Die Aktualisierung verwendet die universelle Methode crm.item.update, sodass alle Lead-Felder verfügbar sind, einschließlich benutzerdefinierter. Typische Fälle: beim Auslösen des Prozesses den Lead in die richtige Phase bringen; den Verantwortlichen aus einem externen System setzen; Lead-Phasen 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 |
|---|---|---|---|
| Lead-ID | int | ja | |
| Zu aktualisierende Felder (camelCase-JSON): {"title":"New lead","stageId":"NEW","assignedById":5,"ufCrm_123":"value"} | string | ja |
Was gibt der Roboter zurück?
| Parameter | Typ |
|---|---|
| Erfolg (Y/N) | string |
Szenario: Aktualisierung eines Leads aus einem Prozess
- Der Lead-Prozess erreicht den Qualifizierungsschritt
- Der Roboter aktualisiert den Lead: stageId und assignedById werden als JSON übergeben
- Ein Y-Ergebnis bestätigt die Aktualisierung für den nächsten Schritt