← All Docs
🔑

API Keys — Programmatic Access to Shopbell

Create and manage API keys to trigger agents, fetch recordings, or integrate with your backend. What the dgr_ and oss_sk_ prefixes mean.

🗝️

Service Keys — LLM, TTS, STT Inference Access

Service keys authenticate your workflows to Shopbell's managed inference layer. What they cost, how to generate more, and the app.shopbell.ai signup link.

🤖

Model Configurations — BYOK vs Shopbell-Managed

Two ways to power the LLM, TTS, and STT in your agents: bring your own API keys (OpenAI, Anthropic, Deepgram) or use Shopbell's managed inference. When to use each.

🧬

LLM Configuration — Choosing the Right Language Model

GPT-4o, GPT-4o-mini, Claude 3.5 Sonnet, Llama 70B. Cost, latency, and quality tradeoffs. Recommendations by use case.

🎤

Voice (TTS) Configuration — Kokoro Voices

Shopbell ships with Kokoro TTS — free, open-source, human-sounding. Four voices available: Bella, Adam, Sky. Nicole was retired for sounding sleepy. Setup, sample audio, picking the right voice.

👂

Transcriber (STT) — Speech-to-Text Configuration

Deepgram is the default STT engine. Latency, accuracy, and language support. When to use Deepgram vs. BYOK with Whisper.

🌍

Inbound Calls — Telephony Providers (Twilio, Vonage, Plivo, Telnyx)

Configure inbound calls for each telephony provider Shopbell supports. Twilio, Vonage, Plivo, Telnyx, Cloudonix, Vobiz, and Asterisk ARI.

🛠️

Troubleshooting — Common Issues and Fixes

Real problems we've seen and how to fix them: API not reachable, Twilio error 22105, browser mic blocked, no audio, silent WebSocket calls.