Skip to content

v2026.7.1

Release date: July 1, 2026


✨ New Features

Flow Test Chat in FlowBuilder

The FlowBuilder now includes a full environment for testing flows directly in the interface, without needing to create real conversations or send messages through another channel. The test simulates the exact behavior of a production flow — including AI nodes, conditions, inputs, debounce, and timeouts.

What is it for?

  • Validate flow behavior before publishing
  • Simulate customer responses and observe node progression in real time
  • Identify bottlenecks, loops, or unexpected behavior with immediate visual feedback
  • Test with real registered customers using an isolated channel ("Test Channel")

How to access?

  1. Go to Flows in the sidebar
  2. Open a flow in the FlowBuilder
  3. Click the Test Flow button (chat icon) in the top right corner
  4. Select a customer and click Start Test

Test panel features

Side panel (default):

  • Opens as a sliding panel on the right without blocking the rest of the screen
  • Shows the chat from the customer's perspective (simulation)
  • Reload button to refresh messages if the subscription is lost

Split mode (dual view):

  • Click the columns icon in the header to expand to full mode
  • Shows side by side: customer simulation (left) + agent view with the real chat (right)
  • The agent view uses the same ChatMessages component as a real conversation

Node progress indicator:

  • Bar above the input field shows the active node in real time via Realtime
  • Distinct visual states:
    • 🔵 Blue — Processing (node in execution)
    • 🟠 Amber — Waiting to execute (debounce active, with tooltip showing exact time)
    • 🟢 Green — Waiting for response (input or interactive node type)

Debounce override:

  • Selector in the modal header to override the flow's default debounce during testing
  • Options: Flow default / 1s / 3s / 5s / 10s / No debounce
  • Allows testing flows with long debounce (e.g., 20s) quickly

Active test chats:

  • On the initial screen, shows existing test chats for resumption without creating a new one
  • Displays customer name, time since last message, and option to resume

Session controls:

  • Restart — confirmation dialog before clearing and restarting the flow
  • Close — option to keep the chat (for review) or delete the chat from the database
  • Reload — button to manually reload messages

Test Channel Badge in Chat

The chat header now shows a pulsing amber "Test Channel" badge when the conversation is linked to a channel of type test. This prevents confusion between test conversations and real support chats.

Floating Active Node Indicator

In the chat header (agent view), a floating indicator below the flow button shows in real time:

  • Node name (resolved from the flow definition, fetched once per session)
  • "Waiting…" when debounce is active (amber with pulsing clock icon)
  • Tooltip with details (next step time on hover)

🐛 Bug Fixes

Foreign Key Error When Deleting Test Chat

When closing the test modal and choosing "Delete chat", a constraint error occurred (flow_sessions_chat_id_fkey) because the flow still had an active session referencing the chat. Deletion now follows the correct order: clearing flow_session_id first, then deleting flow_sessions, messages, customer_message_inputs, and finally the chat.

Debounce Override Not Propagated to Flow Engine

The debounce override configured in the test panel was not correctly passed to the flow engine. The debounceOverrideMs option is now accepted in createFlowEngine options and applied before any flow fallback.


🎯 Benefits

  • ✅ Test complete flows without creating real conversations or using production channels
  • ✅ Real-time visual feedback of active node, debounce, and input waiting states
  • ✅ Debounce override speeds up testing flows with long delays
  • ✅ Test session history avoids unnecessary chat recreation

Documentation constantly being updated