Trabalhe com contatos e audiências
Os nós de contato e audiência permitem que um workflow leia informações de clientes e altere registros ou associações. Eles operam sobre recursos no espaço de trabalho da automação.
Automations is in Early access. Your workspace permissions determine which actions you can perform.
Encontre e use um contato
- Adicione Get contact quando você tiver um ID de contato, ou List contacts quando precisar buscar por filtros compatíveis.
- Mapeie o identificador ou valor de busca a partir do seu gatilho.
- Para uma lista, adicione um Branch para distinguir um resultado vazio de um contato encontrado.
- Mapeie os campos do contato selecionado para a próxima etapa.
Uma busca bem-sucedida que retorna vazio é um resultado a ser tratado. Ela não segue o caminho de falha da ação. Use esse caminho para uma leitura rejeitada ou com erro.
Nós de listagem retornam uma página. Um cursor de próxima página indica que mais registros podem existir. Nem List contacts nem List audience contacts visitam automaticamente páginas seguintes ou executam uma ação posterior para cada contato.
Crie ou atualize registros
Use Create contact para um novo registro e Update contact para um registro conhecido. Uma consulta seguida de criação não é uma operação atômica: outro processo pode criar um contato correspondente entre essas etapas. Trate um conflito de criação em vez de assumir que o novo contato existe.
Create or update contacts aceita um lote preparado. Inspecione o resultado de cada entrada: uma entrada pode falhar enquanto outras são criadas ou atualizadas. Um nó bem-sucedido não significa que cada entrada do lote foi bem-sucedida, e alterações bem-sucedidas não são revertidas quando outra entrada falha.
Entradas e resultados grandes podem exceder os limites de dados da automação mesmo quando o produto Contacts aceita um lote maior. Use um lote preparado menor se a validação ou a execução reportar um valor acima do limite.
Gerencie associações a audiências estáticas
- Selecione uma audiência existente ou adicione Create audience para criar uma como parte do workflow.
- Use Add contacts to audience, Remove contact from audience ou Remove contacts from audience com IDs de contato explícitos.
- Inspecione o resultado da ação e trate falhas antes de prosseguir.
A remoção de associação mantém o contato. Adicionar a uma audiência e remover de outra são operações separadas, então uma falha entre elas pode deixar o contato em ambas as audiências. Planeje o caminho de falha para o estado que precisa de atenção.
Use Get audience e Update audience para ler ou alterar a própria audiência. Esses nós não criam um snapshot dos seus membros nem transformam o workflow em um broadcast.
Exclua um contato deliberadamente
Use Delete contact para remover permanentemente o contato e suas associações a audiências.
Registros de preferência e supressão associados ao endereço de canal da pessoa podem permanecer. Excluir e recriar um contato não remove um opt-out ou bloqueio de entrega.
Próximos passos
- Use preferências e consultas.
- Use dados de etapas anteriores.
- Visualize e verifique um workflow.
- Navegue pelos guias de Automações.
Recursos relacionados
Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.