--- title: Ação na Plataforma description: Execute 22 operações nativas do Atende Direito diretamente no fluxo — sem chamar APIs externas. --- # Ação na Plataforma · `platform_action` 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) 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](/guia/flow-builder/acoes/ferramenta-mcp). --- Passo a passo Arraste o nó **Ação na Plataforma** para o canvas e conecte ao fluxo.
 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](/guia/atendimento/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) | 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: 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. 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. 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. 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. `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](/guia/atendimento/controle-da-ia-no-chat#bloqueio-de-entrada-durante-a-execucao-do-fluxo). --- ## Saiba mais - [Ferramenta MCP](/guia/flow-builder/acoes/ferramenta-mcp) — chame ferramentas de serviços externos conectados, em vez das operações nativas deste nó - [Controle da IA no chat](/guia/atendimento/controle-da-ia-no-chat) — os 8 motivos de pausa da automação e como o atendente vê isso no dia a dia