Visão geral
Além de conversar com o contato, um fluxo do Flow Builder pode executar ações na plataforma no meio do caminho: etiquetar o contato, registrar uma nota, gravar um atributo, criar um contato, abrir uma nova conversa ou deixar uma nota privada. Isso é feito por nós de ação.
O destaque é o nó Ação de contato (categoria Contatos): um nó dedicado que expõe exatamente as ações que atuam sobre o cadastro do contato, com os campos certos já prontos. Para as demais ações da plataforma, o nó genérico Ação da Conversa Labs (ação do sistema) também consegue executá-las.
Pré-requisitos
- O módulo Flow Builder habilitado para a conta (recurso opcional por plano/flag).
- Permissão de administrador para criar e publicar fluxos.
- Para a ação criar conversa, uma caixa de entrada de destino.
- Para condições/valores por atributo personalizado do contato, os atributos definidos na conta (eles são carregados automaticamente nos seletores do nó).
Passo a passo
Como adicionar um nó de Ação de contato a um fluxo:
- Abra o fluxo no Flow Builder.
- No painel de nós, localize a categoria Contatos e arraste o nó Ação de contato para o canvas.
- Conecte-o ao ponto do fluxo em que a ação deve acontecer.
- No painel lateral, escolha a ação (por exemplo, Adicionar etiqueta ao contato) e preencha os campos. Nos campos de atributo e valor, as opções são carregadas automaticamente — sem digitar texto solto.
- Para criar conversa, selecione a caixa de entrada e, se quiser, o status inicial e a mensagem inicial.
- Teste o fluxo e publique.
Configurações & opções
Nós/ações nativos disponíveis nos fluxos:
| Nó / ação | O que faz |
|---|---|
| Nó Ação de contato | Executa as ações de contato: adicionar/remover etiqueta, adicionar nota e definir atributo personalizado. |
| Ação Criar contato | Cria um contato (nome, e-mail, telefone; caixa de entrada opcional), com deduplicação nativa. |
| Ação Criar conversa | Abre uma conversa em uma caixa de entrada, com status e mensagem inicial opcionais. |
| Ação Adicionar nota privada | Deixa uma nota privada na conversa (agora disponível também nos fluxos). |
| Ação Enviar/criar contrato | Envia ou cria um contrato a partir de um modelo (requer o módulo de Contratos). |
| Ação Enviar um e-mail para o time | Notifica o time por e-mail durante o fluxo. |
| Nó Ação da Conversa Labs | Nó genérico de ação do sistema; consegue executar as mesmas ações de contato/criação. |
- Seletor com autocarregamento: ao configurar a ação, os atributos personalizados do contato e seus valores aparecem automaticamente — você seleciona, não digita.
- Nota privada nos fluxos: adicionar nota privada, antes disponível apenas em Automações e Macros, agora também roda dentro de um fluxo.
- Ações de contrato e e-mail para o time: enviar ou criar um contrato a partir de um modelo (requer o módulo de Contratos) e enviar um e-mail para o time agora publicam e executam corretamente dentro do nó de ação. A ação Adicionar SLA não está disponível nos fluxos — use-a em Automações ou Macros.
Casos de uso
- Etiquetar no meio do fluxo: quando o contato escolhe uma opção do menu, adicionar a etiqueta correspondente ao contato.
- Escalar para outra caixa de entrada: criar uma nova conversa em uma caixa de entrada de suporte avançado quando o fluxo detecta um caso complexo.
- Registrar contexto: gravar um atributo personalizado (por exemplo,
interesse = plano-anual) durante a qualificação. - Alertar a equipe: deixar uma nota privada com o resumo coletado no fluxo, sem enviar nada ao contato.
Dicas, limites e boas práticas
- Segurança contra loops: as ações de contato honram proteções contra laços — desenhe o fluxo para não disparar atualizações em cadeia.
- Criar contato deduplica: a mesma pessoa (e-mail/telefone/identificador) é reaproveitada, sem gerar duplicados.
- Criar conversa exige caixa de entrada: sem uma caixa de entrada selecionada, a ação não roda.
- Só admin configura: as ações nativas exigem permissão de administrador para serem montadas no fluxo.
- Prefira o nó Ação de contato quando só precisar mexer no cadastro — ele já traz os campos certos.
Solução de problemas
- Não encontro o nó de Ação de contato: confirme se o Flow Builder está habilitado e se você tem perfil de administrador.
- A ação não executou no fluxo: revise se o nó está conectado ao caminho correto e se os campos obrigatórios estão preenchidos.
- Criar conversa falhou: confirme que uma caixa de entrada foi selecionada no nó.
- O valor da condição/atributo não aparece: os valores são carregados dos dados da conta — confirme se o atributo existe e tem valores registrados.