Skip to main content

​
Sharing Agents

After deploying your agent to LiveKit Cloud, you can generate share links that let anyone talk to it — no setup required on their end. Links open on voiceblox.ai with a voice conversation interface.
  1. Open the Deploy dialog from the toolbar.
  2. Switch to the Share tab.
  3. Choose a link type: Private Link or Public Link.
  4. Click Generate Link and copy the URL.
Best for sharing with a specific person — a colleague, a client, or a tester.
  • Generates a one-time use link with a configurable expiration (1 hour, 24 hours, or 7 days).
  • The link contains a LiveKit JWT token that auto-creates a room and dispatches your deployed agent when opened.
  • After the TTL expires, the link stops working.

​
Security

The JWT token embedded in the URL is signed with your LiveKit API secret but does not contain the secret itself. If someone decodes the URL, they can only see the room name, participant identity, permissions, and agent name — no credentials are exposed.

​
How it works

1. Builder generates JWT with RoomAgentDispatch (agent name embedded in token)
2. Token + LiveKit server URL encoded as base64 in the share URL
3. End-user opens voiceblox.ai/talk/{encoded-config}
4. Browser connects to LiveKit using the JWT
5. LiveKit Cloud auto-creates the room and dispatches the agent
6. Voice conversation starts
Best for embedding on a website or sharing publicly. Each visitor gets their own independent session.
Public links require the LiveKit Sandbox Token Server, which is designed for development and testing. It is not recommended for high-volume production use.

​
Setup

  1. Open your project’s Settings page in LiveKit Cloud.
  2. Find the Token server toggle and switch it on.
  3. Copy the sandboxId displayed below the toggle.
  4. Add it to .env.local:
LIVEKIT_SANDBOX_ID=your-sandbox-id
  1. Restart the dev server.

​
How it works

  • Each time someone opens the link, the LiveKit Sandbox Token Server generates a fresh token and creates a new room.
  • The deployed agent is automatically dispatched to the new room.
  • Multiple people can use the same link simultaneously — each gets a separate conversation.

​
Embed code

Public links also generate an embed code (iframe) you can paste into any website: 
<iframe
  src="https://voiceblox.ai/embed/{config}"
  allow="microphone"
  style="width:400px;height:600px;border:none;border-radius:12px;"
></iframe>
Embed code is only available for Public Links, since Private Links are single-use.

​
Troubleshooting

IssueFix
”Share” tab says “Deploy your agent first”Deploy the agent before generating links
Public Link shows setup warningAdd LIVEKIT_SANDBOX_ID to .env.local (see Setup above)
Private Link expiredGenerate a new link with a longer TTL
Agent doesn’t connect after opening linkEnsure the agent is still deployed in LiveKit Cloud