Actie: Object record zoeken/ bedrijf zoeken

De actie Object Record Zoeken doorzoekt je CRM naar een specifiek custom object record aan de hand van waarden uit een Inbound Webhook trigger. Je koppelt velden uit de webhook payload aan de velden van het object. Als je workflow al is gestart met hetzelfde object als de trigger, wordt deze stap overgeslagen.

Deze actie is ook beschikbaar in bedrijfsgebaseerde workflows als Bedrijf Zoeken, waarmee je een bedrijfsrecord kunt vinden aan de hand van webhook-waarden (bijv. companyName , domain ).

Actienaam

• Object Record Zoeken (voor custom object workflows)
• Bedrijf Zoeken (voor bedrijfsgebaseerde workflows)

Actiebeschrijving

Gebruik deze actie om:

• Een record (custom object of bedrijf) op te zoeken door webhook-parameters te koppelen aan object-/bedrijfsvelden in Filters.
• Meerdere matches op te lossen met een tie-breaker (Oudste Aangemaakt / Nieuwste Aangemaakt).
• Te splitsen op Record Gevonden vs Record Niet Gevonden voor duidelijke, deterministische flows.

Voorwaarde: Er moet een Inbound Webhook trigger in de workflow aanwezig zijn. De actie haalt waarden uit de payload van deze trigger (body, headers).

Actiedetails

I. Vereist Inbound Webhook

• Alleen beschikbaar wanneer de workflow een Inbound Webhook trigger bevat.
• Waarden worden uit de payload van die trigger gehaald (bijv. {{inboundWebhookRequest.body.petname}} , {{inboundWebhookRequest.body.domain}} ).

II. Filteren Op (tie-breaker)

Kies hoe je één record selecteert als er meerdere matches zijn:

• Oudste Aangemaakte Record
• Nieuwste Aangemaakte Record

III. Filters (EN-logica)

• Voeg een of meer rijen toe. Alle filters gebruiken EN-logica.
• Linkerkant: Object-/Bedrijfsveld om te matchen (bijv. Record ID, Externe ID, VIN, Naam Huisdier, Bedrijfsnaam, Domein).
• Rechterkant (waarde): Kies een veld uit de Inbound Webhook trigger (Body, Headers) of typ een vaste waarde.
• Tips:
  • Gebruik bij voorkeur unieke identificatoren (Record ID, Externe ID, Domein) voor deterministische resultaten.
  • Voeg extra filters toe (status, locatie, type) om onduidelijke matches te voorkomen.

IV. Uitkomsten

• Record Gevonden: Het gematchte object wordt het huidige record voor vervolgacties (Bijwerken, Koppelen, Wissen, etc.).
• Record Niet Gevonden: Gebruik deze tak om een nieuw record aan te maken, een gebruiker te waarschuwen of de flow te stoppen.

V. Overslaan-gedrag

• Als de workflow al start met hetzelfde object als de trigger (bijv. "Auto aangemaakt" of "Bedrijf aangemaakt"), wordt deze stap automatisch overgeslagen.

VI. Best Practices

• Zorg ervoor dat de webhook schone, getypeerde waarden stuurt (strings/nummers/booleans).
• Normaliseer hoofdlettergebruik/witruimte in het bronsysteem als je matcht op namen.
• Test met voorbeeldpayloads in een staging-workflow voordat je live gaat.

Voorbeelden

Voorbeeld 1: Een Huisdier Vinden op Naam (webhook → lookup)

Doel: Een webhook stuurt petname = "snowy" . Vind het Huisdier object met die naam.

Instelling

• Filteren Op: Oudste Aangemaakte Record
• Filters:
  • Naam Huisdier = {{inboundWebhookRequest.body.petname}}

Flow

1. Inbound Webhook triggert met { "petname": "snowy" } .
2. Actie vindt Huisdier waar Naam Huisdier gelijk is aan snowy.
3. Record Gevonden: Werk de status van Huisdier bij en stuur bericht naar eigenaar.
4. Record Niet Gevonden: Maak een Huisdier record aan met naam = "snowy" en markeer voor controle.

Voorbeeld 2: Een Abonnement Vinden op Externe Referentie

Doel: Je factuurwebhook stuurt subscription_ref . Vind het Abonnement object.

Instelling

• Filteren Op: Nieuwste Aangemaakte Record
• Filters:
  • Externe Referentie = {{inboundWebhookRequest.body.subscription_ref}}
  • Status = actief (optioneel veiligheidsfilter)

Flow

1. Webhook komt binnen met subscription_ref .
2. Actie selecteert het nieuwste actieve Abonnement met die referentie.
3. Record Gevonden: Werk planvelden bij; zet verlengingsmails in de wachtrij.
4. Record Niet Gevonden: Maak een tijdelijk Abonnement aan en waarschuw Finance.

Voorbeeld 3: Een Bedrijf Vinden op Domein

Doel: Een webhook van een leadgeneratieformulier stuurt companyDomain . Vind het Bedrijf record met dat domein.

Instelling

• Filteren Op: Nieuwste Aangemaakte Record
• Filters:
  • Domein = {{inboundWebhookRequest.body.companyDomain}}

Flow

1. Inbound Webhook triggert met { "companyDomain": "acme.com" } .
2. Actie vindt Bedrijf waar Domein gelijk is aan acme.com.
3. Record Gevonden: Schrijf Bedrijf in voor een "Onboarding" workflow.
4. Record Niet Gevonden: Maak een nieuw Bedrijf record aan met domein acme.com.