Panoramica
L'azione Trova Record Oggetto ricerca nel tuo CRM uno specifico record di oggetto personalizzato utilizzando i valori provenienti da un trigger Inbound Webhook. Mappi i campi del payload del webhook sui campi dell'oggetto. Se il workflow è già avviato con lo stesso oggetto del trigger, questo passaggio viene saltato automaticamente.
Questa azione è disponibile anche nei workflow basati su aziende come Trova Azienda (Find Company), consentendoti di individuare il record di un'azienda utilizzando i valori del webhook (ad es., companyName, domain).
Nome dell'azione
Trova Record Oggetto (per workflow con oggetti personalizzati)
Trova Azienda (per workflow basati su aziende)
Descrizione dell'azione
Usa questa azione per:
Cercare un record (oggetto personalizzato o azienda) mappando i parametri del webhook sui campi dell'oggetto/azienda nei Filtri.
Risolvere corrispondenze multiple tramite un criterio di spareggio (Record creato prima / Record creato dopo).
Ramificare il flusso su Record Trovato vs Record Non Trovato per flussi puliti e deterministici.
Prerequisito: Nel workflow deve essere presente un trigger Inbound Webhook. L'azione legge i valori dal payload di quel trigger (body, headers).
Dettagli dell'azione
I. Richiede Inbound Webhook
Abilitata solo quando il workflow contiene un trigger Inbound Webhook.
I valori vengono prelevati dal payload di quel trigger (ad es.,
{{inboundWebhookRequest.body.petname}},{{inboundWebhookRequest.body.domain}}).
II. Filtra per (criterio di spareggio)
Scegli come selezionare un record quando ne corrispondono più di uno:
• Record creato prima (Earliest Created Record)
• Record creato dopo (Latest Created Record)
III. Filtri (logica AND)
Aggiungi una o più righe. Tutti i filtri usano la logica AND.
Lato sinistro: Campo dell'oggetto/azienda su cui fare la corrispondenza (ad es., ID Record, ID Esterno, VIN, Nome Animale, Nome Azienda, Dominio).
Lato destro (valore): Seleziona un campo dal trigger Inbound Webhook (Body, Headers) oppure digita un valore fisso.
Suggerimenti:
• Preferisci identificatori univoci (ID Record, ID Esterno, Dominio) per risultati deterministici.
• Aggiungi filtri extra (stato, posizione, tipo) per evitare corrispondenze ambigue.
IV. Risultati
Record Trovato: L'oggetto trovato diventa il record corrente per le azioni successive (Aggiorna, Associa, Cancella, ecc.).
Record Non Trovato: Usa questo ramo per creare un nuovo record, avvisare un utente o interrompere il flusso.
V. Comportamento di salto
Se il workflow parte già con lo stesso oggetto del trigger (ad es., "Auto creata" o "Azienda creata"), 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 fai corrispondenze sui nomi.
Testa con payload di esempio in un workflow di staging prima di andare live.
Esempi
Esempio 1: Trova un Animale per Nome (webhook → ricerca)
Obiettivo: Un webhook invia petname = "snowy". Trova l'oggetto Animale con quel nome.
Configurazione
Filtra per: Record creato prima
Filtri:
Nome Animale =
{{inboundWebhookRequest.body.petname}}
Flusso
L'Inbound Webhook si attiva con
{ "petname": "snowy" }.L'azione trova l'Animale dove Nome Animale è uguale a snowy.
Record Trovato: Aggiorna lo stato dell'Animale e notifica il proprietario.
Record Non Trovato: Crea un record Animale con nome = "snowy" e aggiunge un Tag per la revisione.
Esempio 2: Trova un Abbonamento tramite Riferimento Esterno
Obiettivo: Il tuo webhook di fatturazione invia subscription_ref. Trova l'oggetto Abbonamento.
Configurazione
Filtra per: Record creato dopo
Filtri:
Riferimento Esterno =
{{inboundWebhookRequest.body.subscription_ref}}Stato = attivo (filtro di sicurezza opzionale)
Flusso
Arriva il webhook con
subscription_ref.L'azione seleziona l'Abbonamento attivo più recente con quel riferimento.
Record Trovato: Aggiorna i campi del piano; mette in coda le email di rinnovo.
Record Non Trovato: Crea un record Abbonamento segnaposto e avvisa la Finanza.
Esempio 3: Trova un'Azienda tramite Dominio
Obiettivo: Un webhook proveniente da un form di lead generation passa companyDomain. Trova il record Azienda con quel dominio.
Configurazione
Filtra per: Record creato dopo
Filtri:
Dominio =
{{inboundWebhookRequest.body.companyDomain}}
Flusso
L'Inbound Webhook si attiva con
{ "companyDomain": "acme.com" }.L'azione trova l'Azienda dove Dominio è uguale a acme.com.
Record Trovato: Iscrive l'Azienda in un workflow "Onboarding".
Record Non Trovato: Crea un nuovo record Azienda con dominio acme.com.