Guides

Shareable Links

Enable shareable links on any agent to generate a public URL that lets anyone test-call your AI agent directly from their browser — no phone needed, no signup required.

Enable Shareable

$curl -X PATCH "https://api.voicebip.com/v1/agents/{agent_id}/shareable" \
>  -H "Authorization: Bearer pk_live_your_key" \
>  -H "Content-Type: application/json" \
>  -d '{"shareable": true}'

Once enabled, the shareable link follows this format:

https://app.voicebip.com/try/{agent_id}

Share this link with potential customers, investors, or teammates. They can call your agent from any modern browser with a microphone.

Disable Shareable

$curl -X PATCH "https://api.voicebip.com/v1/agents/{agent_id}/shareable" \
>  -H "Authorization: Bearer pk_live_your_key" \
>  -H "Content-Type: application/json" \
>  -d '{"shareable": false}'

Existing calls in progress are not interrupted, but no new calls can be started.

Rate Limits

Shareable links have their own rate limits (separate from API key rate limits):

LimitValue
Concurrent calls per agent10
Calls per day per agent50

When limits are exceeded, the endpoint returns HTTP 503 with error code AGENT_BUSY.

How It Works

The shareable link page uses WebRTC for browser-to-server audio:

  1. User opens the shareable link in their browser
  2. Browser requests microphone permission
  3. Browser creates a WebRTC SDP offer
  4. POST /v1/public/try/{agent_id}/offer sends the offer to the server (no auth required)
  5. Server verifies the agent exists and shareable == true
  6. Server returns an SDP answer
  7. WebRTC peer connection is established
  8. Audio flows through the normal voice pipeline (STT, AI, TTS)

Setting Up the Agent

For the best shareable experience:

  1. Set a greeting - The greeting text plays automatically when the call connects:
$curl -X PATCH "https://api.voicebip.com/v1/agents/{agent_id}" \
>  -H "Authorization: Bearer pk_live_your_key" \
>  -H "Content-Type: application/json" \
>  -d '{"greeting_text": "Hi! I am the Acme Finance assistant. How can I help you today?"}'
  1. Use a template - Templates come with pre-written greetings and system prompts
  2. Test first - Use the dashboard’s built-in browser call to test before sharing

Security

  • No authentication is required for the public endpoint
  • The agent must have shareable: true (returns 404 otherwise)
  • IP-based rate limiting prevents abuse
  • No PII from the agent’s workspace is exposed to the caller
  • Demo workspace type (demo) enables real SIP calls at zero billing cost for landing page demos