INHALTSVERZEICHNIS
Überblick
Action Name
Action Description
Action Details
Beispiele
Überblick
Die Find Object Record Action durchsucht dein CRM nach einem bestimmten Custom-Object-Datensatz anhand von Werten aus einem Inbound Webhook Trigger. Dabei ordnest du Felder aus dem Webhook-Payload den Feldern des Objekts zu. Wenn dein Workflow bereits mit demselben Objekt als Trigger gestartet wurde, wird dieser Schritt übersprungen.
Diese Action ist auch in Company-basierten Workflows als Find Company verfügbar und ermöglicht es dir, einen Company-Datensatz anhand von Webhook-Werten zu finden (z. B. companyName, domain).
Action Name
Find Object Record (für Custom-Object-Workflows)
Find Company (für Company-basierte Workflows)
Action Description
Verwende diese Action, um:
Einen Datensatz (Custom Object oder Company) zu finden, indem du Webhook-Parameter in den Filtern den Objekt-/Company-Feldern zuordnest
Mehrere Treffer mithilfe eines Tie-Breakers aufzulösen (Earliest Created / Latest Created)
Den Workflow sauber zu verzweigen in Record Found vs Record Not Found
Voraussetzung: Ein Inbound Webhook Trigger muss im Workflow vorhanden sein. Die Action verwendet Werte aus dessen Payload (Body, Headers).
Action Details
I. Inbound Webhook erforderlich
Nur aktiv, wenn der Workflow einen Inbound Webhook Trigger enthält.
Werte werden aus dem Payload dieses Triggers entnommen (z. B. {{inboundWebhookRequest.body.petname}}, {{inboundWebhookRequest.body.domain}}).
II. Filter On (Tie-Breaker)
Wähle, welcher Datensatz verwendet wird, wenn mehrere übereinstimmen:
• Earliest Created Record
• Latest Created Record
III. Filters (UND-Logik)
Füge eine oder mehrere Bedingungen hinzu. Alle Filter verwenden UND-Logik.
Linke Seite: Objekt-/Company-Feld (z. B. Record ID, External ID, VIN, Pet Name, Company Name, Domain)
Rechte Seite (Wert): Wähle ein Feld aus dem Inbound Webhook Trigger (Body, Headers) oder gib einen festen Wert ein
Tipps:
• Verwende eindeutige Identifikatoren (Record ID, External ID, Domain) für eindeutige Ergebnisse
• Ergänze weitere Filter (Status, Standort, Typ), um Mehrdeutigkeiten zu vermeiden
IV. Ergebnisse
Record Found: Der gefundene Datensatz wird zur Referenz für nachfolgende Actions (Update, Associate, Clear usw.)
Record Not Found: Nutze diesen Pfad, um einen neuen Datensatz zu erstellen, einen User zu benachrichtigen oder den Workflow zu beenden
V. Überspringverhalten
Wenn der Workflow bereits mit demselben Objekt als Trigger startet (z. B. „Car created“ oder „Company created“), wird dieser Schritt automatisch übersprungen.
VI. Best Practices
Stelle sicher, dass der Webhook saubere, korrekt typisierte Werte sendet (Strings/Zahlen/Booleans).
Normalisiere Groß-/Kleinschreibung und Leerzeichen im Quellsystem, wenn du nach Namen filterst.
Teste mit Beispiel-Payloads in einem Test-Workflow, bevor du live gehst.
Beispiele
Beispiel 1: Haustier nach Name finden (Webhook → Suche)
Ziel: Ein Webhook sendet petname = „snowy“. Finde das Pet-Objekt mit diesem Namen.
Setup
Filter On: Earliest Created Record
Filters:
Pet Name = {{inboundWebhookRequest.body.petname}}
Ablauf
Inbound Webhook wird ausgelöst mit { "petname": "snowy" }.
Die Action findet das Pet, bei dem Pet Name „snowy“ entspricht.
Record Found: Aktualisiere den Status des Pets und benachrichtige den Owner.
Record Not Found: Erstelle einen neuen Pet-Datensatz mit Name = „snowy“ und markiere ihn zur Prüfung.
Beispiel 2: Subscription über External Reference finden
Ziel: Ein Billing-Webhook sendet subscription_ref. Finde das Subscription-Objekt.
Setup
Filter On: Latest Created Record
Filters:
External Reference = {{inboundWebhookRequest.body.subscription_ref}}
Status = active (optionaler Sicherheitsfilter)
Ablauf
Webhook trifft mit subscription_ref ein.
Die Action wählt die neueste aktive Subscription mit dieser Referenz aus.
Record Found: Aktualisiere Plan-Felder; starte Renewal-E-Mails.
Record Not Found: Erstelle eine Platzhalter-Subscription und benachrichtige Finance.
Beispiel 3: Company über Domain finden
Ziel: Ein Lead-Formular sendet companyDomain. Finde die passende Company.
Setup
Filter On: Latest Created Record
Filters:
Domain = {{inboundWebhookRequest.body.companyDomain}}
Ablauf
Inbound Webhook wird ausgelöst mit { "companyDomain": "acme.com" }.
Die Action findet die Company, bei der die Domain „acme.com“ entspricht.
Record Found: Starte einen „Onboarding“-Workflow für die Company.
Record Not Found: Erstelle eine neue Company mit der Domain acme.com.