Lavorare con contatti e audience
I nodi contatto e audience consentono a un workflow di leggere le informazioni del cliente e modificare record o appartenenze. Operano sulle risorse nello spazio di lavoro dell'automazione.
Automations is in Early access. Your workspace permissions determine which actions you can perform.
Trovare e utilizzare un contatto
- Aggiungi Get contact quando hai un ID contatto, oppure List contacts quando devi cercare tramite filtri supportati.
- Mappa l'identificatore o il valore di ricerca dal tuo trigger.
- Per una lista, aggiungi un Branch per distinguere un risultato vuoto da un contatto trovato.
- Mappa i campi del contatto selezionato nello step successivo.
Una ricerca riuscita ma vuota è un risultato da gestire. Non segue il percorso di errore dell'azione. Usa quel percorso per una lettura rifiutata o fallita.
I nodi di listing restituiscono una pagina. Un cursore di pagina successiva indica che possono esistere altri record. Né List contacts né List audience contacts visitano automaticamente le pagine successive o eseguono un'azione successiva per ogni contatto.
Creare o aggiornare record
Usa Create contact per un nuovo record e Update contact per un record noto. Una ricerca seguita dalla creazione non è un'operazione atomica: un altro processo può creare un contatto corrispondente tra questi step. Gestisci un conflitto di creazione anziché dare per scontato che il nuovo contatto esista.
Create or update contacts accetta un batch preparato. Ispeziona il risultato di ogni voce: una voce può fallire mentre le altre vengono create o aggiornate. Un nodo riuscito non significa che ogni voce del batch sia riuscita, e le modifiche riuscite non vengono annullate quando un'altra voce fallisce.
Input e risultati di grandi dimensioni possono superare i limiti dati dell'automazione anche quando il prodotto Contacts accetta un batch più grande. Usa un batch preparato più piccolo se la validazione o l'esecuzione segnala un valore sovradimensionato.
Gestire le appartenenze alle audience statiche
- Seleziona un'audience esistente, oppure aggiungi Create audience per crearne una come parte del workflow.
- Usa Add contacts to audience, Remove contact from audience o Remove contacts from audience con ID contatto espliciti.
- Ispeziona il risultato dell'azione e gestisci gli errori prima di procedere.
La rimozione dell'appartenenza mantiene il contatto. Aggiungere a un'audience e rimuovere da un'altra sono operazioni separate, quindi un errore tra le due può lasciare il contatto in entrambe le audience. Pianifica il percorso di errore per lo stato che richiede attenzione.
Usa Get audience e Update audience per leggere o modificare l'audience stessa. Questi nodi non creano uno snapshot dei suoi membri né trasformano il workflow in un broadcast.
Eliminare un contatto deliberatamente
Usa Delete contact per rimuovere permanentemente il contatto e le sue appartenenze alle audience.
I record di preferenza e soppressione associati all'indirizzo di canale della persona possono rimanere. Eliminare e ricreare un contatto non rimuove un opt-out o un blocco di consegna.
Prossimi passi
- Usare preferenze e lookup.
- Usare dati da step precedenti.
- Anteprima e controllo di un workflow.
- Sfogliare le guide Automations.
Risorse correlate
Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.