Lead per ID aktualisieren
Der Roboter „Lead per ID aktualisieren“ ändert jeden Lead anhand seiner Kennung aus jedem Geschäftsprozess-Kontext in Bitrix24 (Alaio). 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 |
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: {id} ist nicht angegeben
- Fehler: fields_json ist leer
- Fehler: fields_json enthält ungültiges JSON
- API-Fehler
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