Webphone usage

Home

The Mizutech webphone is a SIP client for browsers, implementing multiple engines to take advantage of the best available client-side VoIP technology across the majority of OS and browsers, including Java Applet, HTML5/WebRTC, Native Plugin service, Flash and others covered by a simple to use universal API and customizable user interface templates.

This is a simple index page with direct links to the examples shipped with the webphone package. You are free to use any of the included solutions, modify/customize each of the supplied HTML/CSS code or implement your VoIP client from scratch by providing your own user interface (or no user interface at all) using the webphone's Java Script API.
Try out the solutions/examples from the left side to quickly check the webphone functionalities. This page is part of the downloadable webphone package. Check the source codes for more details (softphone.html and the html files in the samples folder).

If you don't have a SIP server or VoIP account yet, you can use our VoIP service:

- Server address: voip.mizu-voip.com
- Account: create free VoIP account from here or use the following username/passwords: webphonetest1/webphonetest1, webphonetest2/webphonetest2 (others might also use these public accounts so calls might be misrouted)
- Call: You can call the "testivr3" access number to hear a music or register with both accounts and call each others (you can also use one account for webphone and the other one for a regular SIP client)
- We recommend using the softphone skin (the softphone.html) for a quick test as this is a full implementation (rather than the other simpler examples)

Note: It is also possible to configure (outbound) proxy address and different sip username / auth username. These settings can be also requested on the softphone user interface login page.

Basic: simplest usage example (not for production) [basic_example.html]
Tech Demo: try out the webphone by using this simple demo. You can also use this as a starting template for your custom development [techdemo_example.html / techdemo_example.js]
Softphone: implements a full featured VoIP softphone in browser which can be used as is [softphone_launch.html/softphone.html/softphone folder]
Mobile: the webphone works also on mobile. This is just a show-case [mobile_example.html]
Click to call: click to call button [click2call.html / click2call.js]
Linkify: convert all phone number like strings on your website to click to call links [linkify_example.html / linkify.js]
API: use the "webphone_api.js" file. Check the examples and the documentation for the usage.
HTML URL: the webphone can load its settings also from the webpage URL and perform various actions such as initiate a call.
There are many other ways to use the webphone.

For more details download or check the documentation.

JavaScript API

The public JavaScript API can be found in "webphone_api.js" file, under global javascript namespace "webphone_api". To be able to use the webphone as a javascript VoIP library, just copy the webphone folder to your web project and add the webphone_api.js to your page. Simple example:

<head>
      
      <script src="webphone_api.js"></script>
</head>
<body>
      <script>
      // IMPORTANT: Wait until the webphone is loaded, before calling any API functions
      webphone_api.onAppStateChange(function (state) {
      if (state === 'loaded') {

            //set parameters (alternatively these can be also preset in your html)
            webphone_api.setparameter('serveraddress', SERVERADDRESS); // Replace the word in uppercase with your SIP server IP or domain name (add also the :port number if not using the standard UDP 5060)
            webphone_api.setparameter('username', USERNAME); // Replace the word in uppercase with a valid SIP extension username
            webphone_api.setparameter('password', PASSWORD); // Replace the word in uppercase with the password for the above user
            //see the "Parameters" section in the documentation for more options

            //start the webphone (optional but recommended)
            webphone_api.start();
            //make a call (usually initiated by user action, such as click on a click to call button)
            webphone_api.call(number);
            //hangup
            webphone_api.hangup();
            //send instant message
            webphone_api.sendchat(number, message);
      }
      });
      </script>
</body>

For more details consult the Javascript API section in the documentation.