Tema
Ação na Plataforma · platform_action
Referência do nó
Kind
platform_actionCategoriaAçõesPara 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)
Dica
Na paleta, o app Atende Direito aparece marcado como "Interno" (sempre disponível, já vem pronto em todo agent do workspace, sem precisar instalar). É esse app que gera o nó platform_action ao ser arrastado para o canvas — diferente de um app externo (Asaas, Resend, ZapSign, etc.), que gera um nó Ferramenta MCP.
Passo a passo
- Arraste o nó **Ação na Plataforma** para o canvas e conecte ao fluxo.
Paleta de nós aberta no canvas do Flow Builder, com as categorias disponíveis para localizar e arrastar o nó desejado
- No painel, escolha a **Operação** na lista suspensa.
- Preencha os **Parâmetros** específicos da operação escolhida (cada operação tem seus próprios campos).
- 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 |
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 (a IA para de responder) | reason + until |
resume_automation | Retoma a automação pausada | — |
pause_automation em detalhe
Sempre que o seu fluxo (ou o agent) precisar tirar a IA de circulação para aquela conversa — porque qualificou o lead, porque o negócio fechou, porque bateu o número de falhas seguidas — é essa operação que você usa. Ela ativa o controle único de automação da conversa (veja Controle da IA no chat para o quadro completo dos 8 motivos e de como o atendente enxerga isso no dia a dia).
| Parâmetro | O que é | Valores |
|---|---|---|
reason | Por que a automação está pausando — fica registrado na conversa e aparece pro atendente | qualified, disqualified, business_closed, escalation, transferred, human_takeover, manual_pause, snooze |
until | Quando a automação volta sozinha | Uma duração (ex.: +7d, +90d) ou vazio (∅) para exigir retomada manual (resume_automation ou o botão "Devolver ao bot" no chat) |
Dica
A política de retomada é decisão sua, por fluxo — não existe um padrão fixo pra "qualificado" ou "perdido". Composições comuns:
agent qualifica o lead → pause_automation(reason=qualified, until=+7d)
agent desqualifica → pause_automation(reason=disqualified, until=+30d)
crm.win_business (ganhou) → pause_automation(reason=business_closed, until=∅) // manual
crm.lose_business (perdeu) → pause_automation(reason=business_closed, until=+90d)Encadeie o nó Ação na Plataforma logo depois de crm.win_business/crm.lose_business ou de uma saída do nó Agent que sinalize qualificação — é só mais um nó no canvas.
Dois motivos você não precisa disparar manualmente: transferred e escalation já são setados automaticamente pelas operações assign_agent/transfer_agent/ assign_department/transfer_department quando a conversa é entregue para um humano — o nó de transferência já pausa a IA por você. human_takeover e manual_pause também não passam pelo canvas: são disparados pelo atendente direto no chat.
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 |
create_business — contato
O campo "Contato" (contact_id) é obrigatório e deve ser preenchido explicitamente no editor. Por padrão, o editor pré-preenche com a variável contact.id (o contato da conversa em execução), mas você pode trocar por outra variável ou um ID literal. Ao publicar o fluxo, o editor valida se o campo está preenchido e rejeita o publish se estiver vazio.
Exemplo
Ao final de um atendimento bem-sucedido:
add_tag— adiciona a tagatendidoao contatoadd_note— cria uma nota com o resumo do que foi tratadocreate_business— cria um negócio no CRM com o serviço solicitadoclose— 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
Durante o teste, o fluxo roda como em produção: as Ações na Plataforma são executadas de verdade e alteram o CRM real (tags, notas, transferências, negócios), e as mensagens são entregues no WhatsApp. Teste sempre com um contato fictício para não impactar clientes reais.
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.
Dica
enable_input/disable_input são o controle manual — a plataforma também bloqueia a entrada automaticamente enquanto o fluxo está processando de forma síncrona (sem esperar o cliente), liberando assim que o fluxo hiberna aguardando resposta ou termina. Veja Controle da IA no chat.
Saiba mais
- Ferramenta MCP — chame ferramentas de serviços externos conectados, em vez das operações nativas deste nó
- Controle da IA no chat — os 8 motivos de pausa da automação e como o atendente vê isso no dia a dia