Nó DeepSeek

O nó DeepSeek (deepseek_chat) chama a API Chat Completions da DeepSeek diretamente (não pelo proxy de IA da WhatsWave). Use-o para modelos de chat e raciocínio com bom custo-benefício, incluindo DeepSeek Reasoner, nas Automações.

Figura 1: Nó DeepSeek — model e messages

O que faz

A cada execução, o engine do workflow:

1. Resolve variáveis em Messages (JSON)
2. Envia POST https://api.deepseek.com/v1/chat/completions (compatível com OpenAI)
3. Autentica com Authorization: Bearer {{deepseek_api_key}}
4. Retorna choices e usage padrão dentro de data

Diferente dos nós OpenAI, Gemini, Anthropic e Groq, o DeepSeek não usa POST /workflows/ai/chat. Você deve configurar a integration key manualmente.

Pré-requisitos

1. Conta DeepSeek e API key
2. Integration key deepseek_api_key em Settings → API Keys → Integration keys
3. Confirme que a chave está disponível ao workflow (painel Variables do workflow se escopar secrets por workflow)

Guia de configuração

Passo 1 — Armazenar a API key

1. Abra Settings → API Keys
2. Em Integration keys, adicione:
   • Name: deepseek_api_key (nome exato — corresponde ao header do template do nó)
   • Value: sua DeepSeek API key
3. Salve

O nó envia Authorization: Bearer {{deepseek_api_key}} automaticamente.

Passo 2 — Adicionar o nó

1. Abra Automações
2. Paleta → AI → DeepSeek
3. Conecte após o trigger ou preparação de dados

Passo 3 — Escolher model

Não há campo temperature neste template do nó — a DeepSeek usa defaults da API.

Passo 4 — Configurar messages

Campo: Messages (JSON) — suporta variáveis.

Padrão ao usar a UI de prompt:

[{ "role": "user", "content": "..." }]

Exemplo:

[
  {
    "role": "system",
    "content": "Return JSON only: {\"category\":\"...\",\"confidence\":0-1}"
  },
  {
    "role": "user",
    "content": "Text: {{trigger.body.message}}"
  }
]

O textarea Prompt (quando exibido) edita o mesmo array JSON dos outros nós de IA.

Passo 5 — Testar

Execute o modo de teste e inspecione Output → data.choices[0].message.content. Confira input_resolved se a autenticação falhar (chave mascarada nos logs).

Campos de saída

A DeepSeek retorna um body compatível com OpenAI aninhado em data:

Exemplos (node ID deepseek_1):

{{deepseek_1.data.choices[0].message.content}}
{{input.data.choices[0].message.content}}

Respostas DeepSeek não passam por /workflows/ai/chat, então não há flag is_own_key — o uso é sempre na sua conta DeepSeek.

Dicas e boas práticas

• Reasoner para tarefas difíceis — use deepseek-reasoner quando modelos Chat falharem em lógica estruturada; espere maior latência
• Chat para volume — deepseek-chat para classificação de webhooks em escala
• JSON no prompt — peça JSON explicitamente; faça parse em JavaScript se necessário
• Nome da chave deve coincidir — apenas deepseek_api_key é substituída no header Authorization
• Sem rastreamento de tokens do plano — uso DeepSeek não conta na cota de IA WhatsWave (cobrança direta)
• Timeout de 30s — divida cadeias de raciocínio muito longas entre nós ou use padrões assíncronos

FAQ

Por que HTTP 401 Unauthorized?

deepseek_api_key está ausente, incorreta ou invisível ao workflow. Adicione em Settings → API Keys e verifique variáveis do workflow.

Por que este nó é diferente de OpenAI/Gemini?

A DeepSeek chama a API do vendor diretamente com integration key. Outros nós da paleta IA passam pelo proxy WhatsWave para gerenciar chaves de provider e cobrança do plano.

Posso definir temperature ou max tokens?

Esses campos não estão no template atual do nó. Use o nó HTTP para controle completo da API DeepSeek se precisar de parâmetros extras.

O Reasoner retorna chain-of-thought?

A DeepSeek pode incluir conteúdo de raciocínio conforme a versão da API. Use o JSON bruto de Output nos logs para ver o objeto message completo.

A DeepSeek é suportada por POST /workflows/ai/chat?

O DTO lista deepseek como nome de provider, mas o serviço de IA de workflow aceita atualmente apenas openai, google, anthropic e groq. Use este nó dedicado para DeepSeek.

Exemplos de uso

Exemplo 1 — Tag de lead barata

DeepSeek Chat:

[{ "role": "user", "content": "Tag as B2B or B2C: {{trigger.body.company_description}}" }]

CRM upsert com tag de {{input.data.choices[0].message.content}}

Exemplo 2 — Raciocinar elegibilidade de reembolso

Model: deepseek-reasoner

Given order date {{trigger.body.order_date}} and policy 7-day returns, reply JSON {"eligible":true|false,"reason":"..."}

Condition na elegibilidade parseada

Exemplo 3 — Extrair linha de tabela da mensagem

Messages:

[
  {
    "role": "user",
    "content": "Extract fields name, email, phone as JSON from:\n{{trigger.body.text}}"
  }
]

Nó Variable armazena os campos parseados

Referências de API