Zoho CRM - Kontakt-Rollen

Mit dem Zoho CRM-Konnektor steht das Schemaobjekt Contact_Roles zur Verfügung. Dabei handelt es sich nicht um ein klassisches Modul, sondern um ein Funktionsobjekt zur Verwaltung der Rollen, die Kontakte bei einem Abschluss (Deal) einnehmen.

Kontakt-Rollen sind 1:n-Verknüpfungen zwischen Deal und Kontakt, ergänzt um eine Rollenbezeichnung (z. B. Decision Maker, Evaluator). Das Objekt dient ausschließlich der Verwaltung dieser Beziehung.

Eigenschaften und Besonderheiten

• Keine eigene Primär-ID
  Das Objekt besitzt keine autarke ID. Stattdessen wird eine zusammengesetzte ID aus
  deal_id + contact_id verwendet (Composite Key).

• Keine Änderungsinformation
  Das Objekt stellt keine Feldwerte für Änderungszeitpunkt/Version bereit. Ein „Delta-Abruf“ ist daher nicht möglich; nutzen Sie vollständige Abrufe oder eigene Änderungslogik.

• Rollen-ID vs. Rollenname
  Die Zoho-API liefert beim Lesen die Rollen-ID zurück, akzeptiert beim Anlegen/Aktualisieren jedoch den Rollennamen.
  Das Schemaobjekt enthält deshalb beide Felder:

  • contact_role_id (read-only, aus API-Antwort)
  • contact_role_name (zum Schreiben; Pflicht für Create/Update, sofern eine Rolle gesetzt werden soll)

• Kontaktfelder (read-only)
  Das Schemaobjekt bringt alle relevanten Kontaktfelder mit (schreibgeschützt), plus die ID-Felder deal_id und contact_id sowie die Rollenangaben.

Unterstützte Operationen

1. Lesen (Liste nach Deal)
   Ruft alle Kontakt-Rollen eines Deals ab.

2. Lesen (Einzelsatz)
   Ruft die Kontakt-Rolle für ein konkretes Paar aus deal_id und contact_id ab.

3. Anlegen/Aktualisieren
   Legt eine Rolle für (deal_id, contact_id) an oder ändert die Rolle (via contact_role_name).

4. Löschen
   Entfernt die Rolle für (deal_id, contact_id).

Hinweis: Da es keine Änderungsinformation gibt, sollten Abrufe gezielt (Deal-bezogen) erfolgen oder zeitlich/kontextuell über Sync-Strategien begrenzt werden.

Aufrufparameter (Feldnotation)

Der Konnektor erwartet Parameter in Feldnotation. Diese kann in Filtern, Übereinstimmungsregeln, Ad-hoc-Ausführungen oder in Abläufen verwendet werden.

Beispiele

• Alle Rollen eines Deals lesen

deal_id|:|1234|;|

• Rolle für bestimmtes Deal/Contact-Paar lesen

deal_id|:|1234|;|contact_id|:|5678|;|

Trennzeichen: |:| zwischen Feld und Wert, |;| zwischen Parametern.

Einsatz in Syncs

Lesen

• Sync-Typ: Universal-Sync (schema-basiert) mit Quelle Zoho CRM, Objekt Contact_Roles.
• Filter:
• Per Deal (deal_id) – empfohlen (performant, zielgerichtet).
• In Abläufen: Übergabe der deal_id aus dem Auslöser (z. B. „Deal aktualisiert“).
• Ziel:
• Interne Datenbank/Support-DB (zur Anzeige/Reporting),
• CRM/ERP (zur Spiegelung der Deal-Kontaktbeziehungen).

Schreiben (Create/Update)

• Pflichtzuordnungen:
• deal_id (Ziel-Deal in Zoho)
• contact_id (Kontakt in Zoho)
• Optionale Zuordnung:
• contact_role_name (Rollenname; wird beim Schreiben benötigt, wenn eine Rolle gesetzt/aktualisiert werden soll)
• Hinweise:
• Datensatz-Abbildungen zwischen externen Kontakten/Deals und Zoho-IDs stark empfohlen (robuste ID-Ermittlung).
• Bei Schreibkonflikten (z. B. abweichende Rollenbelegung) Konfliktstrategie pro Sync festlegen.

Löschen

• Varianten:
• Universal-Lösch-Sync mit Datensatz-Abbildung oder eindeutiger Übereinstimmung (Composite Key).
• Abfrage-Sync (direkter Aufruf zum Entfernen der Beziehung).
• Voraussetzung: Eindeutige Identifikation des Paares (deal_id, contact_id).