IA

Name: WhatsWave
Author: WhatsWave

Os nós da paleta IA chamam modelos de linguagem (LLMs) de dentro das Automações. Use-os para classificar leads, resumir conversas, extrair dados estruturados, redigir respostas ou executar etapas pontuais de raciocínio — sem montar um Agente de IA completo.

Workflows > editor > AI palette Figura 1: Nós de IA na paleta do editor de workflows

Nós disponíveis

Nó	Node ID	O que faz	Documentação
OpenAI	`openai_chat`	Chat completion GPT via proxy WhatsWave (`POST /workflows/ai/chat`)	Nó OpenAI
Gemini	`gemini_chat`	Chat Google Gemini via proxy WhatsWave	Nó Gemini
Anthropic	`anthropic_messages`	API Messages da Claude via proxy WhatsWave	Nó Anthropic
DeepSeek	`deepseek_chat`	API Chat Completions da DeepSeek direta	Nó DeepSeek
Groq	`groq_chat`	Inferência rápida Llama via proxy WhatsWave	Nó Groq

Nós de IA vs. Agente de IA (WhatsWave)

	Nós da paleta IA	Agente de IA (`workflow_ai_agent`, grupo WhatsWave)
Propósito	Uma chamada LLM com prompt definido por você	Agente completo com ferramentas, memória e configuração da empresa
Sessão	Sem histórico persistente de chat	Sessão por agente + telefone do contato
Melhor para	Classificação, extração, geração pontual	Atendimento conversacional, uso de ferramentas, ações no CRM

Para agentes multi-turno com ferramentas, veja nós WhatsWave e o nó AI Agent.

Quando usar nós de IA

Classificar ou pontuar dados recebidos (tier do lead, intenção, urgência) antes de rotear com um nó Condition
Resumir ou reescrever texto de mensagens antes de enviar via Send message
Extrair campos JSON de texto não estruturado (detalhes do pedido, nomes, datas) para nós de CRM ou ERP
Escolher o modelo certo para a tarefa — Groq para velocidade, GPT-4o ou Claude Sonnet para qualidade, DeepSeek Reasoner para raciocínio mais difícil

Visão geral de credenciais

A maioria dos nós de IA (OpenAI, Gemini, Anthropic, Groq) passa pelo endpoint POST /workflows/ai/chat da WhatsWave usando seu integration token ({{api_token}}, injetado automaticamente em runtime).

Provider	Auth no workflow	Onde configurar chaves
OpenAI, Gemini, Anthropic, Groq	Integration token + AI API key selecionada no nó	Settings → API Keys — adicione a chave do provider e selecione no seletor API key / Model do nó
DeepSeek	`Authorization: Bearer {{deepseek_api_key}}` (API direta)	Settings → API Keys → Integration keys — adicione `deepseek_api_key`

Se nenhuma chave for selecionada no nó, o engine usa a primeira chave ativa desse provider na sua empresa (ou uma chave compartilhada da plataforma, quando disponível).

Chaves próprias: quando a chave selecionada pertence à sua empresa, o uso de tokens é marcado com is_own_key: true e cobrado na sua conta do provider em vez da cota do plano WhatsWave.

Padrão de fluxo típico

Trigger — Webhook, Manual ou evento de mensagem recebida
Nó de IA — envie o prompt com {{trigger.body.message}} ou contexto de nós anteriores
Variable ou JavaScript — parse da saída da IA se precisar de um escalar (score, categoria)
Condition — ramifique com base no resultado da IA
Send message / CRM — aja sobre a classificação

Saída e variáveis

Os nós de IA retornam um envelope no estilo HTTP:

{
  "status": 200,
  "data": {
    "choices": [{ "message": { "role": "assistant", "content": "..." }, "index": 0 }],
    "usage": { "prompt_tokens": 120, "completion_tokens": 45, "total_tokens": 165 },
    "is_own_key": false
  },
  "headers": { }
}

Caminhos comuns (substitua openai_1 pelo ID do seu nó):

{{input.data.choices[0].message.content}}
{{openai_1.data.choices[0].message.content}}
{{openai_1.data.usage.total_tokens}}

Quando Response format é JSON (object) no OpenAI, ou quando o modelo retorna JSON válido, content pode ser um objeto parseado — use JavaScript para ler campos aninhados.

Os logs de execução também mostram Prompt sent (mensagens resolvidas) para depuração.

IA