INDICE DEI CONTENUTI

Panoramica

L'azione Find Object Record cerca nel tuo CRM uno specifico record di oggetto personalizzato usando i valori provenienti da un Trigger Inbound Webhook. Mappi i campi del payload webhook sui campi dell'oggetto. Se il tuo Workflow è già partito con lo stesso oggetto come Trigger, questo passaggio viene saltato automaticamente.

Questa azione è disponibile anche nei Workflow basati su aziende come Find Company, permettendoti di individuare un record azienda usando i valori del webhook (es. companyName, domain).

Nome dell'azione

  • Find Object Record (per Workflow con oggetti personalizzati)

  • Find Company (per Workflow basati su aziende)

Descrizione dell'azione

Usa questa azione per:

  • Cercare un record (oggetto personalizzato o azienda) mappando i parametri webhook sui campi dell'oggetto/azienda nei Filters.

  • Risolvere corrispondenze multiple usando un criterio di selezione (Earliest Created / Latest Created).

  • Ramificare su Record Found vs Record Not Found per flussi precisi e deterministici.

Prerequisito: Nel Workflow deve essere presente un Trigger Inbound Webhook. L'azione legge i valori dal payload di questo Trigger (body, headers).

Dettagli dell'azione

Schermata 1 — Azione Workflow – Find Object Record / Find Company

Schermata 2 — Azione Workflow – Find Object Record / Find Company

I. Richiede Inbound Webhook

  • Abilitata solo quando il Workflow contiene un Trigger Inbound Webhook.

  • I valori vengono presi dal payload di quel Trigger (es. {{inboundWebhookRequest.body.petname}}, {{inboundWebhookRequest.body.domain}}).

II. Filter On (criterio di selezione)

Scegli come selezionare un record in caso di corrispondenze multiple:

  • Earliest Created Record

  • Latest Created Record

III. Filters (logica AND)

  • Aggiungi una o più righe. Tutti i filtri usano la logica AND.

  • Lato sinistro: Campo dell'oggetto/azienda da confrontare (es. Record ID, External ID, VIN, Pet Name, Company Name, Domain).

  • Lato destro (valore): Scegli un campo dal Trigger Inbound Webhook (Body, Headers) oppure digita un valore fisso.

  • Suggerimenti:

    • Preferisci identificatori univoci (Record ID, External ID, Domain) per risultati deterministici.

    • Aggiungi filtri aggiuntivi (status, location, type) per evitare corrispondenze ambigue.

IV. Esiti

  • Record Found: L'oggetto trovato diventa il record corrente per le azioni successive (Update, Associate, Clear, ecc.).

  • Record Not Found: Usa questo ramo per creare un nuovo record, notificare un utente o interrompere il flusso.

V. Comportamento di salto

  • Se il Workflow parte già con lo stesso oggetto come Trigger (es. "Car created" o "Company created"), questo passaggio viene saltato automaticamente.

VI. Best Practice

  • Assicurati che il webhook invii valori puliti e tipizzati (stringhe/numeri/booleani).

  • Normalizza maiuscole/minuscole e spazi nel sistema sorgente se esegui il match per nome.

  • Testa con payload di esempio in un Workflow di staging prima di andare in produzione.

Esempi

Esempio 1: Trova un animale domestico per nome (webhook → ricerca)

Obiettivo: Un webhook invia petname = "snowy". Trova l'oggetto Pet con quel nome.

Configurazione

  • Filter On: Earliest Created Record

  • Filters:

    • Pet Name = {{inboundWebhookRequest.body.petname}}

Flusso

  1. L'Inbound Webhook si attiva con { "petname": "snowy" }.

  2. L'azione trova il Pet dove Pet Name è uguale a snowy.

  3. Record Found: Aggiorna lo status del Pet e notifica il proprietario.

  4. Record Not Found: Crea un record Pet con nome = "snowy" e aggiunge un Tag per la revisione.

Esempio 2: Trova una Subscription per riferimento esterno

Obiettivo: Il tuo webhook di fatturazione invia subscription_ref. Trova l'oggetto Subscription.

Configurazione

  • Filter On: Latest Created Record

  • Filters:

    • External Reference = {{inboundWebhookRequest.body.subscription_ref}}

    • Status = active (filtro di sicurezza opzionale)

Flusso

  1. Il webhook arriva con subscription_ref.

  2. L'azione seleziona la Subscription attiva più recente con quel riferimento.

  3. Record Found: Aggiorna i campi del piano; metti in coda le email di rinnovo.

  4. Record Not Found: Crea una Subscription segnaposto e avvisa il team Finance.

Esempio 3: Trova un'azienda per dominio

Obiettivo: Un webhook da un Form di lead generation trasmette companyDomain. Trova il record Company con quel dominio.

Configurazione

  • Filter On: Latest Created Record

  • Filters:

    • Domain = {{inboundWebhookRequest.body.companyDomain}}

Flusso

  1. L'Inbound Webhook si attiva con { "companyDomain": "acme.com" }.

  2. L'azione trova la Company dove Domain è uguale a acme.com.

  3. Record Found: Iscrivi la Company in un Workflow "Onboarding".

  4. Record Not Found: Crea un nuovo record Company con dominio acme.com.