📞 Payphone

The Payphone widget enables live phone calls between viewers and streamers, creating unique interactive moments on stream.

---

Overview

Viewers can initiate WebRTC phone calls directly to you during your stream. They pay Juice per second of call time, and you can see and accept incoming calls from your dashboard.

Default Cost: 5 Juice per second

---

How It Works

1. Viewer types: !call in chat
2. A call request appears in your dashboard
3. You accept or decline the call
4. If accepted, a WebRTC voice call begins
5. Juice is charged per second of active call time
6. Either party can end the call

---

Features

Live Calls

• Real-time WebRTC voice communication
• Low latency audio
• Call duration tracking
• Automatic Juice billing

Voicemail

When you're unavailable or decline calls:

• Viewers can leave a voicemail
• Voicemails are saved for later review
• Separate cost for voicemail

---

Settings

Basic Settings

Setting	Description	Default
Cost per Second	Juice charged per second	5
Max Call Length	Maximum call duration (seconds)	30
Enabled	Master toggle for Payphone	On
Broadcast to Chat	Announce calls in chat	Off

Voicemail Settings

Setting	Description	Default
Voicemail Enabled	Allow voicemail messages	On
Voicemail Cost	Flat Juice cost per voicemail	2

---

Setup Instructions

Step 1: Enable Payphone

1. Go to Widgets → Payphone in your dashboard
2. Toggle Enabled to ON
3. Set your cost per second
4. Set maximum call length

Step 2: Add Overlay to OBS

1. Copy the Payphone overlay URL
2. In OBS, add a Browser Source
3. Paste the URL
4. Set dimensions: 400 x 300 (recommended)
5. Important: Enable audio capture for the browser source

Step 3: Configure Audio

For the best experience:

1. Ensure your microphone is set up properly
2. Test audio levels before going live
3. Consider using headphones to prevent echo

Step 4: Test the Connection

1. Use the Test Call button in the dashboard
2. Verify audio is clear in both directions
3. Check that the overlay displays correctly

---

Commands

Command	Description
!call	Request a call with the streamer
!voicemail <message>	Leave a voicemail (if enabled)
!hangup	End the current call

---

Managing Calls

Incoming Call Requests

When a viewer requests a call:

1. A notification appears in your dashboard
2. You see their username and Juice balance
3. Click Accept or Decline

During the Call

• Call timer shows elapsed time
• Juice is deducted in real-time
• Either party can end the call
• Audio is transmitted via WebRTC

Ending Calls

Calls end when:

• You click End Call
• The viewer uses !hangup
• Maximum call length is reached
• The viewer runs out of Juice

---

Voicemail System

How Voicemail Works

1. Viewer types: !voicemail Hello streamer!
2. They record their message (up to 30 seconds)
3. Voicemail cost is charged
4. You can review voicemails in the dashboard

Reviewing Voicemails

1. Go to Widgets → Payphone
2. Find the Voicemails section
3. Play, download, or delete voicemails

---

Cost Calculation

Live Call Costs

Call Duration	Cost (at 5 Juice/sec)
10 seconds	50 Juice
30 seconds	150 Juice
60 seconds	300 Juice

Voicemail Cost

Voicemail uses a flat rate (default 2 Juice) regardless of message length.

---

Audio Quality Tips

For Streamers

1. Use a quality microphone: Ensure clear audio for callers
2. Wear headphones: Prevent echo and feedback
3. Reduce background noise: Close windows, turn off fans
4. Test before streaming: Do a test call with a friend

For Viewers

• Use a microphone or headset
• Find a quiet environment
• Allow browser microphone access when prompted

---

Troubleshooting

Calls Won't Connect

Issue	Solution
No audio	Check browser permissions for microphone
Call drops immediately	Check internet connection stability
Can't hear caller	Ensure browser source audio is enabled
Caller can't hear you	Check your microphone settings

Permission Issues

If calls aren't working:

1. Check that your browser allows microphone access
2. Ensure the overlay URL is loaded (not blocked)
3. Try refreshing the browser source

Echo/Feedback

• Always use headphones while accepting calls
• Enable noise suppression if available
• Reduce microphone sensitivity

---

Best Practices

1. Set Reasonable Limits: 30-60 second max prevents marathon calls
2. Price Appropriately: Higher costs for more exclusive interactions
3. Use Voicemail: For when you can't take live calls
4. Brief Viewers: Let them know call etiquette
5. Stay Safe: Don't share personal information during calls

---

FAQ

Q: Can I screen calls before accepting? A: You see the caller's username but can't preview what they'll say.

Q: What happens if a call disconnects? A: Billing stops when the call ends, even if unexpected.

Q: Can multiple people call at once? A: Only one call at a time. Others must wait or leave voicemail.

Q: Is there a minimum call length? A: Minimum charge is 1 second (your cost-per-second amount).

Q: Are calls recorded? A: Live calls are not recorded. Voicemails are stored until deleted.

Q: Can I call viewers back? A: No, calls are viewer-initiated only.