Documentação completa do "Smart Action Agent" (m26), um agente n8n…

INEMA

notes

Trello [Move Card]

idList = nova lista pelo new_stage

Slack [Send Message]

Canal: o mesmo da entrada
Texto de confirmação do que foi feito

Error Trigger (workflow separado) ou caminhos de erro

Enviar mensagem no Slack com detalhes da falha
Registrar contexto mínimo (sem dados sensíveis)

Expressões úteis

Pegar transcript final: {{ \$json.transcript || \$node["HTTP Request Transcrição OpenAI"].json.text }}
Montar horário de término 60 min após o início: {{ \$json.event_start_rfc3339_end_mais_60 || \$jmespath(\$json, "event.start") }} (alternativa: usar Date & Time para adicionar 60 minutos)

Convenções de listas no Trello

New Lead
Discovery Call
Proposal Review
Won
Lost Mantenha esses nomes idênticos ao que o agente usa.

Mensagens de teste no Slack

Voz/texto 1: Agende reunião com Mark, amanhã às 10h EST. Me lembre de levar a apresentação. Resultado: Evento criado 10:00 EST com descrição incluindo lembrete.
Voz/texto 2: Contato com o lead Steve Johnson. Discovery call marcada para 2 de agosto de 2025. Ele é Head of Operations em empresa média. Resultado: Card criado/movido para Discovery Call + notas no card + opcionalmente evento no calendário.
Voz/texto 3: Tive reunião com Steve Johnson; ele recebeu a proposta e vai revisar. Atualize para Proposal Review. Resultado: Card movido para Proposal Review com nota.

Boas práticas e erros comuns

Timezone: sempre normalize tudo para America/New_York antes de criar o evento.
Deduplicação de leads: se houver mais de um card com o mesmo nome, adicionar um sufixo único ou verificar email/telefone no texto.
Falhas de download de áudio Slack: use header Authorization: Bearer xoxb-... na url_private_download.
LLM sempre em JSON: se o modelo sair do JSON, envolva em um Code node que aplique regex para extrair o primeiro bloco JSON válido e, se falhar, notifique no Slack.

Segurança e conformidade

Guardar tokens nas credenciais do n8n.
Limitar o canal de entrada a um canal específico.
Sanitizar PII em logs.
Definir limites: tamanho máximo de áudio e duração.

Expansões rápidas

WhatsApp via Evolution API ou Telegram: substituir o Slack Trigger por esses conectores.
CRM real (HubSpot/Pipedrive): trocar nós do Trello por nós do CRM.
Confirmar com o usuário no Slack antes de ações críticas: adicionar um passo opcional de aprovação.

Perguntas e exemplos prontos

Como envio um comando? Fale ou digite no canal do Slack configurado, por exemplo: Agende call com Ana amanhã às 15h, inclua link do Zoom e lembrete de 30 min.
O que acontece se eu não informar horário? O agente aplica defaults (ex.: 10:00 no fuso America/New_York) e marca defaults_applied=true.
Como mover um lead de etapa? Exemplo: Mova o Steve Johnson para Proposal Review e adicione nota que a proposta foi enviada hoje.
Posso usar Telegram em vez de Slack? Sim. Troque o nó de entrada e mantenha o restante do fluxo.
E se o LLM não devolver JSON válido? O fluxo envia aviso no Slack, registra a transcrição e tenta novamente com um prompt de fallback que força o formato.

Resumo rápido Agente de Ação Inteligente no n8n que capta voz/texto pelo Slack, transcreve (OpenAI), interpreta a intenção com LLM e executa automaticamente: criar eventos no Google Calendar e criar/atualizar/mover leads no Trello. Tudo sem sair do Slack.

Passo a passo prático no n8n

Preparar credenciais e permissões

Slack
Crie um app no Slack e instale no workspace.
Escopos sugeridos: channels\:history, channels\:read, chat\:write, files\:read, users\:read, im\:history.
Obtenha o Bot User OAuth Token (xoxb-...).
OpenAI
Gere a API key.
Google Calendar
OAuth com escopo https://www.googleapis.com/auth/calendar.
Trello
Obtenha key e token da sua conta.
Defina o fuso padrão do agente: America/New_York.

Estrutura do workflow

Entrada: Slack Trigger (mensagem com texto ou áudio).
Se houver áudio: baixar o arquivo e transcrever com OpenAI.
Se houver só texto: usar diretamente como transcrição.
Agente LLM: transformar a transcrição em um JSON de ação.
Roteamento por intenção:
create_event → Google Calendar: Create Event.
add_lead → Trello: Create Card na lista apropriada.
update_lead/move_lead → Trello: localizar card e atualizar/mover.
Retorno: mensagem de confirmação no Slack.
Log/erros: enviar aviso no Slack em caso de falha.

Nós sugeridos (em ordem)

1) Slack Trigger

Eventos: mensagem em canal específico. 2) IF (tem áudio?)
Condição: existe url privada de download ou anexo de áudio. 3) HTTP Request [Slack download] (só quando tem áudio)
GET na url_private_download do arquivo.
Header Authorization: Bearer xoxb-...
Output binário (ex.: audio). 4) HTTP Request [Transcrição OpenAI] (só quando tem áudio)
POST https://api.openai.com/v1/audio/transcriptions
Form-data: file = binário do passo anterior; model = whisper-1
Retorna texto transcrito. 5) Set [Texto de entrada]
Campo transcript = texto do Slack OU da transcrição.
Campo channel_id, user_id, timezone_default = America/New_York. 6) Chat OpenAI [Agente de Ação]
System prompt: exigir JSON único e válido.
Input: {{ \$json.transcript }}.
Saída: JSON com intenção e campos normalizados.
Exemplo de system prompt: Você é um parser de ações. Responda somente com um JSON válido, sem explicações. Schema: { "intent": "create_event" | "add_lead" | "update_lead" | "move_lead", "event": { "title": string, "date": "YYYY-MM-DD" | null, "time": "HH\:MM" | null, "timezone": string | null, "description": string | null, "defaults_applied": boolean }, "lead": { "name": string | null, "stage": "New Lead" | "Discovery Call" | "Proposal Review" | "Won" | "Lost" | null, "action": "create" | "update" | "move" | null, "notes": string | null, "new_stage": string | null }, "confidence": 0.0-1.0 } Regras:
- Se for agendamento sem data/hora, inferir do contexto; caso ausente, sinalizar defaults_applied=true e usar timezone "America/New_York".
- Se mencionar “discovery call” em data X, defina stage="Discovery Call".
- Nunca faça perguntas de acompanhamento. Sempre preencha o melhor possível. 7) IF [intent == create_event] 8) Date & Time [normalizar data/hora]
Converter para RFC3339 no tz America/New_York. 9) Google Calendar [Create Event]
Summary = event.title
Description = event.description
Start/End com horário convertido (ex.: 30–60 min). 10) IF [intent == add_lead] 11) Trello [Get Boards] ou Set (id do board fixo) 12) Trello [Get Lists]
Localizar lista pelo nome de stage (ex.: New Lead).

Trello [Create Card]

Name = lead.name
Desc = lead.notes
idList = lista encontrada

IF [intent == update_lead ou move_lead]
Trello [Search Cards] ou [Get Cards in Lists]

Filtrar por nome do card = lead.name

Trello [Update Card]

Atualizar descrição com

Smart Action Agent, um agente de IA que executa tarefas a partir de comandos de voz enviados pelo Slack (ou outros canais como WhatsApp ou Telegram). Ele está integrado ao Google Calendar e ao Trello para automatizar agendamentos e gestão de leads.

O agente interpreta mensagens de voz e realiza ações como:

Criar reuniões no Google Calendar com título, horário e lembretes personalizados.
Adicionar ou atualizar leads no Trello, movendo-os entre etapas do funil de vendas com base no contexto da conversa.
Inserir anotações relevantes para que outros membros da equipe tenham contexto sobre o cliente ou lead.

O sistema reconhece estágios automaticamente (ex.: “discovery call” → etapa correta no Trello) e pode, ao mesmo tempo, criar compromissos no calendário relacionados ao lead.

Propósito: Permitir que qualquer profissional gerencie agenda e pipeline de vendas de forma totalmente prática e rápida, usando apenas comandos de voz, sem precisar acessar manualmente múltiplas plataformas.

Agente de Ação Inteligente

Workflow acionado pelo Slack: Escuta qualquer nova mensagem (incluindo arquivos de áudio) em um canal específico do Slack.

Manipulação de áudio: Faz o download do arquivo de áudio anexado via API do Slack.

Transcrição: Envia o áudio para o endpoint de reconhecimento de fala da OpenAI para gerar uma transcrição em texto.

Interpretação inteligente de ações: Envia a transcrição para um “Agente de Ação Inteligente” baseado em GPT, que interpreta a intenção do usuário e mapeia para as ferramentas disponíveis — sem perguntas de acompanhamento.

Automação de calendário: Se o usuário solicitar uma reunião ou evento, o agente extrai data, hora, resumo e descrição (preenchendo parâmetros ausentes automaticamente) e aciona a ferramenta do Google Calendar para criar o evento.

Gerenciamento de leads no Trello:

Adicionar novos leads: Recupera os IDs das listas do pipeline de leads no Trello e cria um novo cartão na etapa “Novo Lead” (ou outra especificada) com o nome e os detalhes extraídos.

Atualizar leads existentes: Busca todas as listas e cartões do pipeline, localiza o cartão do lead especificado e atualiza sua descrição ou move para uma nova etapa conforme instruído.

Caso de Uso / Aplicação

Nome da solução: Agente de Ação Inteligente Oferta principal: Um assistente de IA conversacional integrado ao Slack que executa agendamentos e atualizações no CRM em nome dos usuários, transformando mensagens de voz ou texto em eventos de calendário ou ações no pipeline do Trello.

Principais benefícios

Fluxo de trabalho contínuo: Usuários não precisam sair do Slack para agendar reuniões ou atualizar leads, reduzindo trocas de contexto.

Produtividade mãos-livres: Comandos de áudio permitem que profissionais ocupados façam múltiplas tarefas — por exemplo, agendar um retorno de chamada enquanto dirigem ou atualizar o status de um prospecto em movimento.

Consistência e conformidade: Parâmetros padrão e prompts estruturados garantem que cada evento e cartão de lead sigam os padrões organizacionais.

Indústrias e compradores ideais

Vendas e Desenvolvimento de Negócios (B2B SaaS, Serviços Profissionais): Captura e qualifica leads rapidamente durante chamadas ou reuniões, agendando automaticamente apresentações ou acompanhamentos.

Recrutamento e Seleção: Recrutadores podem transcrever entrevistas de triagem de candidatos e atualizar instantaneamente o pipeline de candidatos sem entrada manual de dados.

Consultoria e Agências: Consultores podem registrar reuniões de início de projeto e cadastrar novos leads de clientes usando notas de voz simples no Slack.

Imobiliário: Corretores podem gravar notas de visitas a imóveis no Slack e fazer com que o sistema atualize o CRM ou agende ligações com clientes.

Assistentes Executivos / Equipes Administrativas: Assistentes podem usar breves mensagens de áudio para construir agendas executivas e manter pipelines de contatos com esforço mínimo.

Ao empacotar isso como uma integração low-code no n8n ou um aplicativo gerenciado no Slack, você pode oferecer aos clientes um assistente “voz-para-ação” plug-and-play que aumenta a produtividade, acelera o tempo de resposta e reforça a consistência dos processos em qualquer equipe que utilize Slack, Google Calendar e Trello.

Recursos Smart Action Agent.json

O Smart Action Agent é um assistente de IA integrado ao Slack que transforma mensagens de voz ou texto em ações automáticas, como criar eventos no Google Calendar ou atualizar pipelines de leads no Trello, sem sair do Slack.

Propósito: Facilitar agendamentos e gestão de leads de forma rápida, prática e padronizada, aumentando a produtividade e reduzindo o esforço manual.

m26 - Agente de Ação Inteligente