Security update: RingQ is patched against the critical PHP vulnerabilities. Update your servers today.

Read now
RingQ Customer Centric Communications

How to Set Up the WebRTC Web Call Gateway in RingQ


WebRTC web calls let anyone call your business straight from a web browser, with no app, phone number or plug-in. The RingQ WebRTC gateway gives you a call link and a website call button. When a visitor clicks it, enters their name and starts the call, it rings the extension, call queue or IVR you choose, like any other call in your cloud phone system. Your team answers on the web app, the RingQ mobile app or a desk phone.

What you need

  • Administrator access to your RingQ web app.
  • An extension, call queue or IVR that should answer web calls.
  • Your RingQ server reachable on its domain name over HTTPS, with the RingQ media ports open.
  • Visitors need a current browser (Chrome, Edge, Safari or Firefox) and must allow the microphone when the browser asks.

Set up web calls step by step

Step 1. Find the WebRTC gateway

Open Call Flow and, in the Trunks panel, click the Gateways tab. Every RingQ server has a gateway named WebRTC, created automatically on new servers and added once by an update on existing ones. It is a system gateway: you can edit it, but Delete is greyed out (tooltip: System gateway). The row WebRTC (Extensions & Queues) is also built in and fully locked; it carries the personal RingQ Talk links of your extensions and queues. Other gateways work as before.

RingQ Call Flow, Trunks panel, Gateways tab with the system WebRTC gateway and the locked WebRTC (Extensions & Queues) row

Step 2. Open the gateway settings

Click Edit on the WebRTC row. The username and password are created for you; you don't need to change them. Tip: the gateway name is shown to visitors as "Call <name>", so you can rename it to your company or team name. Capital letters are kept.

RingQ Edit Gateway dialog for the WebRTC gateway with gateway name, authentication ID and the Web call (WebRTC) switch

Step 3. Choose where web calls ring

Make sure Web call (WebRTC) is switched on. Under Web calls go to, pick an extension, a call queue or an IVR. The list highlights the row under your mouse and marks the current choice with a tick. Calls from the link go straight to this destination. On a new server it starts with your admin extension.

RingQ WebRTC gateway Web calls go to picker listing extensions, with the selected destination ticked

Step 4. Share the call link or add the call button to your website

  • Call link: click Copy and share the link in emails, chat, social media or a QR code. Anyone who opens it can call you.
  • Embed code: click Copy and paste the code into your website, just before the closing body tag. It adds a RingQ call button that opens the same call page.
  • Click Save to keep any changes.
RingQ WebRTC gateway settings: Web call switch, Web calls go to destination, Call link and Embed code with Copy buttons

Step 5. Set how many web calls can run at once

Click Advance Setting. Calls Allowed sets how many web calls can be up at the same time (5 by default). Keep OPUS at the top of Codec Priority for the best browser audio. Click Back, then Save.

RingQ Advance Gateway Settings with Calls Allowed set to 5 and OPUS first in Codec Priority

What your visitor sees

The call page shows Call followed by your gateway name. The visitor enters their name and email and clicks Start call, then allows the microphone. The destination rings showing the visitor's name. During the call the page shows the call timer, a Keypad button and End call.

RingQ web call page where a visitor enters name and email and clicks Start call, powered by RingQ

Using IVR menus from a web call

If web calls go to an IVR, the visitor taps Keypad once the call is connected and presses the menu option (0-9, * or #). The digits are sent as standard telephone key tones, so IVR menus, queue options and PIN prompts work as they do from a phone.

Test your web call

  1. Open the call link in a private browser window on a computer or phone with a microphone.
  2. Enter a name and email, click Start call and allow the microphone.
  3. The destination rings with the name you entered. Answer and talk both ways for a few seconds; if it is an IVR, try an option with Keypad.
  4. Hang up and check Call Status and the call log.

Troubleshooting

  • Start call does nothing or the visitor can't be heard: the microphone is blocked. Allow it in the browser's site settings and reload the page.
  • The call connects but there is no audio in one direction: check the firewall and media ports (see the port forwarding guide).
  • Nobody rings: check Web calls go to, and that the WebRTC gateway shows a green dot in the Gateways list.
  • Extra visitors can't get through at busy times: raise Calls Allowed in Advance Setting.
  • Keypad presses do nothing: make sure the destination is an IVR and press after the greeting starts. If the Keypad button is missing, reload the page.
  • You can't delete the WebRTC gateway: that is by design, it is a system gateway. Switch Web call off instead if you don't want web calls.

Related guides