Everything you need to know
Can't find what you're looking for? Email purplecallio@gmail.com and an engineer will get back to you.
Products & Integration
Create a call from your backend with the REST API or @purplecallio/sdk, then join from the browser with @purplecallio/react components, the headless JavaScript SDK, or hosted UI. See the quickstart and video docs at purplecallio.com/docs/quickstart and purplecallio.com/docs/video.
Create a call from your backend with the REST API or @purplecallio/sdk, then join from the browser with @purplecallio/react, the headless SDK, or hosted UI. See purplecallio.com/docs/audio for a full walkthrough.
Hosted UI is the fastest path (5 minutes — just create a call and redirect your users). React Components let you build a branded custom interface without implementing WebRTC. Headless SDK gives you complete control over the UI while PurpleCallio handles signaling, authentication, and media infrastructure.
Yes. All three products are powered by the same backend, the same POST /calls response, and the same per-participant session tokens. You can change your frontend integration without changing your server-side code.
@purplecallio/sdk is the headless communication engine (join, leave, camera, microphone, screen share, events). @purplecallio/react is a component library built on top of the core SDK — it provides ready-made React components (MeetingProvider, ParticipantGrid, ControlBar, etc.) that call into the engine for you.
Currently PurpleCallio supports 1:1 audio and video calls. Group calls are on the roadmap.
Authentication & Security
Server-side only. Your API key (starts with bj_live_) is used by your backend to create calls. Never send it to the browser. The hosted page uses per-participant session tokens (starts with bj_session_) which are cryptographically tied to one participant and one call.
PurpleCallio supports two server-side authentication methods: API Keys (x-api-key header, ideal for backend integration) and JWT (for the dashboard and playground). Call participants authenticate with short-lived session tokens over WebSocket.
Yes. Each session token is tied to one participant and one call, and expires after 24 hours. If someone needs a new invite, create a new call.
Yes. Every webhook POST includes an X-PurpleCallio-Signature header (HMAC-SHA256 with your project secret). Always verify it before processing the payload.
Media & Network
PurpleCallio provides TURN relay with time-limited HMAC credentials. The hosted UI and SDK fetch ICE servers automatically — no configuration needed on your side.
PurpleCallio uses standard WebRTC, so any modern browser works — Chrome, Firefox, Safari, Edge. Mobile browsers are fully supported with responsive layouts.
Yes. The hosted UI includes a DeviceSelector, and the React SDK exposes useDevices() plus a DeviceSelector component. Developers on the Headless SDK can manage devices programmatically.
Yes — screen sharing works in all three products. The hosted UI has a built-in Share Screen control, React has a ScreenShareButton, and the SDK exposes screenShare.start() / screenShare.stop().
Live Translate (early access)
There is a short delay of a second or more between someone speaking and the other person hearing the translation, depending on the language pair and route. We publish measured numbers at launch, and Translation Observability shows your own live numbers.
Translation is AI-generated and can be wrong, especially with names, numbers, accents and noisy audio. DualView shows the original words next to the translation, PurpleLex keeps your terms consistent, and MeaningGuard flags phrases that may be misunderstood. A phrase that isn't flagged can still be wrong, so important details should be confirmed.
60 languages across Europe, Asia, the Middle East and Africa, each with both captions and voice translation, from English, Spanish, French and Arabic to Hindi, Chinese, Japanese and Swahili. Speech in any of them can be translated into any other, and the speaker's language can be detected automatically.
Not by default. Audio is streamed to the translation providers and not stored by PurpleCallio. Replay of the original audio is off by default; if a project turns it on, recent audio is kept in memory only for about 30 seconds and cleared when the call ends. Transcripts are stored only if you opt in to the Post-Call Suite, with the retention period you choose.
CostGuard warns both people first. Then, depending on your settings, voice translation steps down to captions or translation pauses. The call itself never drops, and you get a translation.limit_reached webhook.
Yes. The original voice is turned down (ducked) rather than muted while the translation plays, so tone and emotion still come through. Each person can adjust the level.
It's in early access. Join the early-access list and we'll enable it for your account. Pricing, languages and features may change before general availability.
Development & Support
Check the WebSocket connection state, verify the session token matches the correct participant, ensure camera/microphone permissions are granted, and confirm TURN credentials are returned from /turn/credentials. The docs FAQ covers common failure modes.
Try the Live Playground — create a call, open two browser tabs, and start a video call with no code and no API key required.
PurpleCallio support is run by the engineers who built the platform. Email purplecallio@gmail.com and you will get a technical answer.
Plans, Credits & Billing
Prepaid credit pricing
PurpleCallio uses prepaid credits with no recurring subscription plan. Usage is measured in participant-minutes and each media type — audio, video and screen sharing — consumes credits at its own rate. Screen sharing is its own category, not a surcharge on video.
Loading current credit rates…
Add a monetary amount to your PurpleCallio wallet and receive the estimated whole credits at the currently published price. Before payment, checkout shows the estimate, applicable taxes and final payable amount. Credits are added only after payment is confirmed.
Your purchase amount, before taxes, is divided by the published price per credit and rounded down to whole credits. The checkout quote is authoritative and records the price and policy that apply to that purchase.
One connected participant for one minute. Two participants in a ten-minute video call use twenty video participant-minutes. Audio, video, and screen sharing each have their own credit rate; screen sharing is its own category, not a surcharge on video.
Eligible calls and AI features deduct credits according to their configured consumption rates. The monetary price you pay for a credit is separate from those feature usage rates.
Each credit purchase is a separate lot with the validity shown in its checkout quote. Your wallet shows the balance, transactions and applicable expiry dates; eligible credits are used earliest-expiring first.
Open Dashboard → Billing → Credits to review your available balance, purchase history, usage transactions and expiry information.
Applicable taxes are calculated in the checkout quote and included in the final payable amount before you pay. The current tax rate is shown alongside the purchase summary where applicable.
Credits are not added until the payment provider confirms a successful payment. A pending or failed payment does not create spendable wallet credits.
Yes. Return to your wallet whenever you need additional credits. New calls may require an available balance, while calls already in progress are not cut off.
Yes. Eligible accounts can set a credit threshold, top-up amount and monthly maximum in Dashboard → Billing → Credits, then authorize a Razorpay eMandate. A charge is made only after the mandate is confirmed and your balance reaches the threshold. You can disable Auto Top-Up at any time.
Credit purchases are not refunded automatically. Refunds are issued where required by law, for duplicate or erroneous charges, or at PurpleCallio's discretion. See the Refund & Cancellation Policy for details.
Usage invoices issued before PurpleCallio moved to prepaid plans remain valid historical records. You can still view and download them as legacy usage invoices from the Billing page.
Still have questions?
Try the playground or read the docs — or talk to the engineers who built it.