Click on each component to explore its role in the Nuvion IQ system. Data flows through these components and back to deliver a seamless conversational experience.

Watch the complete lifecycle of an IQ session from user message to API execution. Use the controls to step through or auto-play the flow.

Experience a realistic IQ conversation flow. Click "Send Next Message" to step through a send-money conversation and see how the AI collects required information.

Explore the three main endpoints for interacting with Nuvion IQ sessions. All endpoints require JWT authentication.

{
  "session_reference": "01JEF8XYZ123456789ABCDEF_1733750400000",
  "message": "I want to send money to John",
  "context_code": "send-money"
}

{
  "status": 200,
  "message": "IQ session created successfully",
  "data": {
    "id": "01JEF8XYZ123456789ABCDEF",
    "session_reference": "01JEF8XYZ123456789ABCDEF_1733750400000",
    "messages": [
      {
        "sender": "user",
        "text": "I want to send money to John"
      },
      {
        "sender": "system",
        "text": "I'd be happy to help you send money!..."
      }
    ],
    "status": "active"
  }
}

Understanding session states is crucial for building a responsive UI. Each state requires different handling in your frontend implementation.

// Check session status and handle accordingly
if (session.status === 'processing') {
  showLoadingIndicator();
  disableInput();
} else if (session.status === 'ready' && session.context.data.ready) {
  const { endpoint, method, payload } = session.context.data;
  await executeAPICall(endpoint, method, payload);
} else if (session.status === 'active') {
  enableInput();
  hideLoadingIndicator();
}

Nuvion IQ currently supports two action contexts. Each context defines what information the AI will collect and which API endpoint to call when complete.