Ação na Plataforma · platform_action

Referência do nó

Kind:platform_actionCategoria:Ações

Para que serve

Pensa num painel de controle com 22 botões, cada um fazendo uma coisa diferente dentro do sistema: adicionar uma tag no contato, fechar a conversa, criar um negócio no CRM, pausar a automação. O nó Ação na Plataforma é esse painel: com um único bloco no canvas, você executa qualquer operação nativa do Atende Direito — sem precisar chamar APIs externas.

Quando usar

• Marcar o contato com tags ao longo do atendimento
• Fechar ou transferir conversas automaticamente
• Criar e mover negócios no pipeline do CRM
• Adicionar anotações ao contato após uma interação importante
• Controlar o fluxo da automação (pausar, retomar, habilitar entrada)

---

Passo a passo

1. ·
   Arraste o nó **Ação na Plataforma** para o canvas e conecte ao fluxo.
   

   

   CAPTURAR: nó platform_action no canvas conectado a um nó anterior

2. ·
   No painel, escolha a **Operação** na lista suspensa.
   

   

   CAPTURAR: seletor de operação do platform_action com todas as 22 operações listadas agrupadas por categoria

3. ·
   Preencha os **Parâmetros** específicos da operação escolhida (cada operação tem seus próprios campos).
4. ·
   Salve e conecte a saída ao próximo nó.

---

As 22 operações

Contato (9 operações)

Ações que afetam o registro do contato no sistema.

Operação	O que faz	Parâmetros principais
add_tag	Adiciona uma ou mais tags ao contato	Tags a adicionar
remove_tag	Remove tags do contato	Tags a remover
add_custom_field	Define o valor de um campo personalizado	Campo + Valor
remove_custom_field	Limpa o valor de um campo personalizado	Campo
add_note	Cria uma anotação no perfil do contato	Texto da nota
remove_note	Remove uma anotação específica	ID da nota
update	Atualiza dados do contato (nome, e-mail, telefone, etc.)	Campo + Novo valor
add_to_list	Adiciona o contato a uma lista de segmentação	Lista de destino
remove_from_list	Remove o contato de uma lista de segmentação	Lista de origem

CAPTURAR: painel do platform_action com a operação add_tag selecionada e o campo de tags preenchido

---

Conversa (9 operações)

Ações que afetam a conversa ativa no momento da execução.

Operação	O que faz	Parâmetros principais
close	Fecha a conversa atual	—
assign_agent	Atribui a conversa a um agente específico	Agente
transfer_agent	Transfere a conversa para outro agente	Agente de destino
assign_department	Atribui a conversa a um departamento	Departamento
transfer_department	Transfere a conversa para outro departamento	Departamento de destino
enable_input	Habilita a entrada do cliente (permite que ele responda)	—
disable_input	Desabilita a entrada do cliente	—
pause_automation	Pausa a automação do fluxo atual	—
resume_automation	Retoma a automação pausada	—

CAPTURAR: painel do platform_action com a operação assign_department selecionada e um departamento escolhido

---

CRM (4 operações)

Ações que criam e movem negócios no pipeline do CRM.

Operação	O que faz	Parâmetros principais
create_business	Cria um novo negócio/oportunidade no CRM	Nome, pipeline, estágio, valor
win_business	Marca um negócio como ganho	ID do negócio
lose_business	Marca um negócio como perdido	ID do negócio + motivo
move_business	Move um negócio para outro estágio do pipeline	ID do negócio + Estágio de destino

CAPTURAR: painel do platform_action com a operação create_business selecionada e os campos de nome, pipeline e valor preenchidos

---

Exemplo

Ao final de um atendimento bem-sucedido:

1. add_tag — adiciona a tag atendido ao contato
2. add_note — cria uma nota com o resumo do que foi tratado
3. create_business — cria um negócio no CRM com o serviço solicitado
4. close — fecha a conversa

Cada uma dessas ações pode ser um nó separado em sequência, ou você pode usar múltiplos nós em paralelo para executar ações independentes ao mesmo tempo.

Painel de configuração do nó Ação na Plataforma com as operações disponíveis

Dica

Você pode encadear quantos nós Ação na Plataforma precisar. Cada nó executa uma única operação — isso deixa o fluxo mais legível e fácil de depurar.

Atenção

A operação disable_input impede que o cliente envie mensagens enquanto estiver ativa. Sempre use enable_input em algum ponto posterior do fluxo ou ao fechar a conversa, para não deixar o cliente sem conseguir responder.