## 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:

1. Abra o fluxo no **Flow Builder**.
2. No painel de nós, localize a categoria **Contatos** e arraste o nó **Ação de contato** para o canvas.
3. Conecte-o ao ponto do fluxo em que a ação deve acontecer.
4. 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.
5. Para **criar conversa**, selecione a **caixa de entrada** e, se quiser, o status inicial e a
   mensagem inicial.
6. **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.

## Veja também

- [Flow Builder: fluxos conversacionais visuais](/hc/ajuda/articles/automation-flows-flow-builder-pt-br)
- [Automações de contato: gatilhos e ações no cadastro](/hc/ajuda/articles/automation-flows-automacoes-de-contato-pt-br)
- [Macros: ações reutilizáveis em um clique](/hc/ajuda/articles/automation-flows-macros-pt-br)