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 |
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 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