Nó Session

O nó Session (session) cria, recupera ou atualiza uma sessão de agente de IA — histórico de conversa isolado e metadados vinculados a um agente e contexto de contato. Escolha o operation template no diálogo do nó.

Encontre-o na paleta WhatsWave em Automações.

Figura 1: Nó Session — campos da operação create

O que faz

Sessões armazenam estado da conversa do agente. O nó AI Agent costuma gerenciar sessões automaticamente; use este nó para controle explícito do ciclo de vida ou metadados.

Operação: Create session (session_op_create)

Endpoint: POST /agents/sessions/create

Operação: Get session (session_op_get)

Endpoint: POST /agents/sessions/get

Use para encontrar sessão existente antes de update ou ler metadados do histórico.

Operação: Update session (session_op_update)

Endpoint: PUT /agents/sessions/update

Dicas e boas práticas

• Prefira nó AI Agent para turnos normais de chat — cria/atualiza sessões implicitamente via agente + telefone.
• Use metadata para marcar origem do workflow, ID de campanha ou idioma: { "campaign": "black_friday", "workflow_run": "{{execution.id}}" }.
• Get com metadata_filter quando várias sessões puderem existir — estreite antes do update.
• Armazene {{session_1.session.id}} após create para etapas de update seguintes.
• Resete contexto criando sessão nova ou limpando metadata ao mudar de assunto na conversa.

Exemplos de uso

Exemplo 1 — Marcar sessão com ID de campanha

Trigger: Webhook — inscrição em campanha.

Fluxo:

1. Session — Create
   • agent_id: UUID do agente de suporte
   • metadata: { "campaign_id": "{{trigger.body.campaign}}" }
2. AI Agent — primeira mensagem com mesmo agente e telefone

Exemplo 2 — Buscar sessão antes de handoff

Trigger: Webhook — escalar para humano.

Fluxo:

1. Session — Get
   • agent_id: {{trigger.body.agent_id}}
   • metadata_filter: { "phone": "{{trigger.body.phone}}" }
2. Conversations — Transfer usando contexto de {{session_1.session}}

Exemplo 3 — Atualizar metadata após compra

Trigger: Webhook — pedido pago.

Fluxo:

1. Session — Get (localizar sessão)
2. Session — Update
   • id: {{session_1.session.id}}
   • metadata: { "last_order": "{{trigger.body.order_id}}" }

FAQ

Quando preciso deste nó vs AI Agent?

AI Agent executa o modelo e gerencia sessões automaticamente. Use Session para CRUD em registros de sessão e metadata sem enviar nova instruction.

IDs legados session_create, session_get, session_update?

Mapeiam para o template unificado session com seletor de operação.

O que há na saída session?

Objeto de sessão incluindo id, referência do agente, metadata e ponteiros do histórico de mensagens — inspecione no log de execução.

Artigos relacionados

• Nó AI Agent
• Nó Contact
• Visão geral WhatsWave