Configure your call settings (device, microphone and SIP)
Get your browser, microphone and SIP connection ready to place and receive calls right from the Omnifox Inbox.
What you're setting up
Omnifox ships a built-in phone inside the Inbox: when you open a conversation on a voice channel (for example WhatsApp with calling enabled), the Call button in the chat header dials over SIP straight from your browser. There's no separate softphone to install, but three things are worth setting up correctly: your browser, your microphone and the SIP registration. This is an advanced guide for agents and administrators.
Prerequisites
- A modern desktop browser (up-to-date Chrome, Edge or Firefox). The phone uses WebRTC.
- The site served over HTTPS (omnifox.io already is): without HTTPS the browser blocks the microphone.
- A headset with a microphone is recommended to avoid echo and feedback.
- The channel must have voice enabled: WhatsApp calling for WhatsApp (see related articles).
Steps
- Go to the Inbox and open any conversation on the voice-enabled channel.
- Click the Call button in the chat header. The first time, your browser prompts for microphone access — choose Allow.
- If you have more than one microphone, open the lock/permission icon in the browser address bar and pick the right input device (for example your USB headset). Omnifox uses the operating system's default microphone, so switching it there also switches it for the call.
- Check the SIP status. Omnifox keeps a single SIP registration per agent, held by the active tab (the one you're looking at). If you have several Omnifox tabs open, only the foreground tab keeps the registration; switching tabs makes that tab the one that rings.
- During a call use Mute (microphone icon) to mute and Hang up to end it. The duration is shown live.
Verify
- Place a test call to your own number, or ask a teammate to call you.
- You should hear ringing and, once answered, two-way audio.
- The call indicator in the header shows In call with… and a running timer.
If it doesn't work
- The Call button is greyed out or missing: the channel has no voice enabled, or your role lacks the calling permission. Ask an administrator.
- No audio / they can't hear you: make sure the browser microphone isn't blocked and the correct device is selected. Close other apps using the mic (Zoom, Meet).
- "SIP not registered": usually caused by many tabs; keep a single Omnifox tab in the foreground and reload. The call server rejects a second registration from the same agent.
- Echo: use a headset and lower your speaker volume.
Tips
- Keep a single Omnifox tab as your "phone" to avoid SIP registration bouncing between tabs.
- Before a call-heavy shift, run a test call to confirm mic permissions after any browser update.
Related articles
Related articles
-
WhatsApp calls in Omnifox
Receive and make WhatsApp voice calls directly from the Omnifox inbox.
-
IVR, call queues and routing
Design voice menus (IVR), organize call queues, and connect your own PBX to Omnifox.
-
View call history and play recordings in the inbox
Find every call in the inbox Calls tab and listen back to recordings without leaving Omnifox.
-
Start a call from a conversation
Voice-call a contact without leaving the chat: the Call via WhatsApp button dials the call and logs it in the inbox.
-
What calling in Omnifox is: channels, architecture and key concepts
An overview of how voice calling works in Omnifox: channels, the web softphone, IVR menus and AI voice agents.