Nós de contato: atualizar contato e definir variável
Veja como usar os nós Atualizar contato e Definir variável dentro de um workflow para salvar dados na ficha do contato e lidar com valores temporários durante a execução.
Veja este passo no vídeo · Contatos e variáveis
Os nós Atualizar contato e Definir variável são duas peças-chave para que suas automações não apenas respondam, mas também lembrem e guardem informação. O primeiro grava dados permanentes na ficha do contato; o segundo guarda valores temporários que existem apenas enquanto a execução do workflow dura.
Ambos ficam na seção Ações da paleta do editor de workflows (menu lateral Automações).
Quando usar cada um
- Atualizar contato: quando você quer guardar algo de forma permanente no contato (nome, e-mail, idioma ou um campo personalizado como "Origem do lead"). O que você gravar aparece em Contatos e se mantém entre conversas.
- Definir variável: quando você precisa de um valor temporário para usar mais adiante no mesmo fluxo (um contador de tentativas, ou um texto montado a partir da resposta do cliente). A variável some quando a execução termina.
O nó Atualizar contato
- Abra seu workflow em Automações e arraste o nó Atualizar contato para a tela.
- Conecte-o à saída do nó anterior.
- No inspetor à direita, adicione uma ou mais atribuições. Cada uma tem um Campo e um Valor.
- Em Campo, escolha um campo padrão (Nome, Sobrenome, Nome de exibição, E-mail, Telefone, Empresa, Notas, Idioma, Fuso horário) ou um campo personalizado criado em Contatos.
- Em Valor, digite um texto fixo ou insira dados do fluxo com a sintaxe
{{$nome_variavel}}(por exemplo{{$ai.response}}). - Salve e publique o workflow.
O nó atualiza o contato ativo da conversa que disparou o workflow. Se o fluxo não tiver um contato no contexto, o nó não terá em quem gravar.
O nó Definir variável
- Arraste Definir variável para a tela e conecte-o.
- Adicione uma atribuição com um Nome (sem espaços, ex.:
tentativas), um Valor e uma Operação. - Escolha a operação:
- Definir (set): sobrescreve o valor.
- Anexar (append): concatena texto ao valor atual.
- Incrementar (increment): trata como número e soma; ideal para contadores. Deixe o valor vazio para somar 1.
- Mais adiante, referencie a variável em qualquer outro nó com
{{$tentativas}}.
As variáveis persistem durante toda a execução, mesmo depois de um nó de espera, então você pode defini-las no início e usá-las no fim.
Verificação
Use o botão Testar do editor para rodar o fluxo com um contato de teste. Depois abra a ficha do contato em Contatos e confirme que o campo mudou. Para as variáveis, veja a linha do tempo de execução do workflow: cada nó mostra os valores que calculou.
Se não funcionar
- "No contact_id in context": o workflow disparou a partir de um evento sem contato associado. Use um gatilho ligado a uma conversa ou contato.
- O campo personalizado não salva: confirme que o campo existe em Contatos e que o tipo (número, data, booleano) corresponde ao valor enviado.
- A variável sai vazia: garanta que o nome esteja escrito exatamente igual ao defini-la e ao usá-la;
{{$Tentativas}}e{{$tentativas}}são diferentes.
Dicas
- Combine os dois: defina uma variável temporária, monte-a com várias respostas e, no fim, jogue-a no contato com Atualizar contato.
- Use Atualizar contato para gravar o idioma detectado e personalizar mensagens futuras.
Artigos relacionados
Artigos relacionados
-
Crie sua primeira automacao (workflow)
Os workflows do Omnifox automatizam sua operacao: um gatilho inicia a automacao e os nos de acao fazem o trabalho. Crie uma mensagem de boas-vindas em minutos.
-
Catálogo de disparadores (triggers) dos workflows
Conheça os eventos que podem iniciar um workflow automaticamente no Omnifox.
-
Guia completo dos fluxos de trabalho (Workflows)
Os Workflows a fundo, em 54 capítulos: gatilhos, nós, variáveis, testes, histórico, modelos, importar e exportar, com cada opção explicada e um fluxo real de ponta a ponta.
-
Nós de ação disponíveis nos workflows
Descubra as ações que um workflow pode executar de forma automática.
-
Condições e ramificações (se/então) em um workflow
Faça seus fluxos tomarem decisões e seguirem caminhos diferentes conforme os dados de cada contato.