Sessions & Deployment

What is a Session?

A session is a single conversation between a user and an agent. When a user clicks “Start” or loads your agent, a session begins. The session includes:

Real-time video/audio - WebRTC connection via Daily.co
Conversation state - The ongoing dialogue between user and agent
Tool executions - Any tools the agent calls during the conversation

Sessions end when the user disconnects, closes the tab, or the connection times out.

Single-Use vs Permanent agents: Single-Use agents can only have one session—the agent expires after it ends. Permanent agents can have unlimited sessions using the same agent ID.

Deployment Options

There are three ways to deploy your agents:

Hosted Page

Instant deployment via meet.iwy.ai

Embeddable Widgets

Drop-in components for your website

Custom Integration

Full control with the Daily.co SDK

Option 1: Hosted Page

The fastest way to deploy—just share a URL.

https://meet.iwy.ai/YOUR_AGENT_ID

When someone visits this URL with a valid agent ID, a session starts automatically. No code required. Use cases:

Share a link via email, SMS, or QR code
Embed in calendar invites
Quick demos and testing

Example:

https://meet.iwy.ai/550e8400-e29b-41d4-a716-446655440000

Works with both Single-Use and Permanent agent IDs.

Option 2: Embeddable Widgets

Drop-in web components that you embed directly in your website. The widgets handle all session management automatically—users just click to start. Repository: github.com/iwy-ai/live-widgets npm: @iwy/live-widgets

Quick Start

Add the script tag and component to your HTML:

<!-- The widget component -->
<live-avatar agentid="YOUR_AGENT_ID"></live-avatar>

<!-- Load the widget script -->
<script src="https://unpkg.com/@iwy/live-widgets@latest/dist/live-avatar.min.js"></script>

That’s it. When a user clicks the widget, a session starts automatically.

Via npm

npm install @iwy/live-widgets

import '@iwy/live-widgets';

function App() {
  return <live-avatar agentid="YOUR_AGENT_ID"></live-avatar>;
}

Attribute	Required	Description
`agentid`	Yes	Your agent’s UUID (Single-Use or Permanent)

Use cases:

Customer support widget on your website
Sales agent embedded in product pages
Interactive demos in documentation

The widget calls the /start-agent-session endpoint automatically when clicked. You don’t need to make any API calls yourself.

Option 3: Custom Integration

For full control over the UI and experience, use the /start-agent-session endpoint directly with the Daily.co SDK.

How It Works

Call the API to get connection credentials
Use Daily.co SDK to join the room with your own UI
Handle events for custom behavior

Step 1: Get Session Credentials

curl -X POST https://api.iwy.ai/v1/start-agent-session \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "YOUR_AGENT_ID"
  }'

Response:

{
  "roomUrl": "https://iwy.daily.co/room-abc123",
  "dailyToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "webLink": "https://app.iwy.ai/call/room-abc123"
}

Field	Description
`roomUrl`	Daily.co room URL for SDK connection
`dailyToken`	Authentication token for the room
`webLink`	Browser-accessible link (no SDK required)

Step 2: Connect with Daily.co SDK

TypeScript/JavaScript:

import DailyIframe from '@daily-co/daily-js';

// Create the call frame
const callFrame = DailyIframe.createFrame({
  iframeStyle: {
    width: '100%',
    height: '100%',
  },
});

// Join the session
await callFrame.join({
  url: roomUrl,      // from API response
  token: dailyToken, // from API response
});

// Handle events
callFrame.on('left-meeting', () => {
  console.log('Session ended');
});

React:

import { DailyProvider, DailyVideo } from '@daily-co/daily-react';

function VideoSession({ roomUrl, token }) {
  return (
    <DailyProvider url={roomUrl} token={token}>
      <DailyVideo />
    </DailyProvider>
  );
}

Daily.co SDK Resources

Resource	Link
JavaScript SDK	docs.daily.co/reference/daily-js
React SDK	docs.daily.co/reference/daily-react
React Native SDK	docs.daily.co/reference/daily-react-native
iOS SDK	docs.daily.co/reference/ios
Android SDK	docs.daily.co/reference/android

Use cases:

Custom video UI matching your brand
Mobile apps (iOS, Android, React Native)
Advanced features (recording, transcription, custom controls)
Integration with existing video infrastructure

Comparison

Feature	Hosted Page	Widgets	Custom Integration
Setup time	None	5 minutes	Hours
Custom UI	No	Limited	Full control
Code required	No	Minimal	Yes
Mobile apps	Browser only	Browser only	Native SDKs
Branding	iwy branded	Customizable	Fully custom
Best for	Quick sharing	Website embed	Custom apps

Session Management Pipeline

What happens under the hood when a user starts a session?

iwy session management pipeline -- dark mode

Sequence diagram showing iwy’s session management pipeline: agent provisioning, model orchestration, real-time WebRTC streaming, and analytics data flow. © iwy.ai 2025

Pipeline Steps

Session Request - User clicks widget, visits URL, or your app calls the API
Agent Provisioning - iwy loads the agent configuration
Room Creation - Daily.co room is provisioned for WebRTC
Model Orchestration - LLM, STT, TTS, and video models are initialized
WebRTC Connection - Real-time audio/video stream established
Conversation Loop - Speech → Text → LLM → Text → Speech → Video
Analytics - Session data captured for insights
Session End - Resources released, data persisted

Quick Reference

Deployment	When to Use	Getting Started
`meet.iwy.ai/{id}`	Share a link, quick demos	Just share the URL
`<live-avatar>` widget	Embed on website	Add script + component
`/start-agent-session` API	Custom UI, mobile apps	Call API + use Daily.co SDK

Support

Need help? Contact us

API Reference

Single-Use Agents

Permanent Agents

Tools

Sessions

What is a Session?

Deployment Options

Hosted Page

Embeddable Widgets

Custom Integration

Option 1: Hosted Page

Option 2: Embeddable Widgets

Quick Start

Via npm

Widget Options

Option 3: Custom Integration

How It Works

Step 1: Get Session Credentials

Step 2: Connect with Daily.co SDK

Daily.co SDK Resources

Comparison

Session Management Pipeline

Pipeline Steps

Quick Reference

Support

​What is a Session?

​Deployment Options

Hosted Page

Embeddable Widgets

Custom Integration

​Option 1: Hosted Page

​Option 2: Embeddable Widgets

​Quick Start

​Via npm

​Widget Options

​Option 3: Custom Integration

​How It Works

​Step 1: Get Session Credentials

​Step 2: Connect with Daily.co SDK

​Daily.co SDK Resources

​Comparison

​Session Management Pipeline

​Pipeline Steps

​Quick Reference

​Support

What is a Session?

Deployment Options

Option 1: Hosted Page

Option 2: Embeddable Widgets

Quick Start

Via npm

Widget Options

Option 3: Custom Integration

How It Works

Step 1: Get Session Credentials

Step 2: Connect with Daily.co SDK

Daily.co SDK Resources

Comparison

Session Management Pipeline

Pipeline Steps

Quick Reference

Support