Follow

OnSIP InstaCall Overview

InstaCall allows your website visitors to call your organization with the click of a button— no dialing necessary. Calls are web-based, do not route over the public switched telephone network (PSTN), and are completely free for both sides. Your organization can receive voice InstaCall calls on any registered OnSIP phone. If your company uses the OnSIP app, you’ll be able to receive voice or video InstaCall calls.

Note that InstaCall uses the latest WebRTC technologies, currently only available in the latest versions of Chrome and Firefox. Visitors to your site not using either of these browsers will see a disabled grey button with mouse-over text that suggests the download and use of Chome / Firefox. Visitors to your site must also have JavaScript enabled. For other known requirements and limitations, please see Ensuring InstaCall Success.

 

OnSIP InstaCall - Getting Started Video

This is a quick video on how to create your InstaCall button in OnSIP and then adding the script to your own website.  For more details and images, continue to scroll down this page

Getting Started with OnSIP InstaCall

 

Creating your InstaCall Button

On the Apps page, click "Create New Apps", then "InstaCall", then "Create a new InstaCall".

Fill out the following fields:

Create a new InstaCall

  1. InstaCall Name - Give this InstaCall name a meaningful name for your record keeping.
  2. Call Destination - Choose where you want the call to be sent.
  3. Enable Video - Give your website visitors the option to start a video call. Note: At the moment, video calls must be answered in the OnSIP app to work. In addition, please note if your business hour rules will direct the call to an ACD queue, the video stream will not be passed through to an ACD queue (the call will be received as audio only).
  4. Enable Dialpad - Gives your site visitors a dial pad to enter in DTMF tones during a call. This will be needed if you send the call to an auto attendant.
  5. Alt. Contact Method - Please enter alternate methods of contact to your InstaCall destination. These will be shown to your site visitors in the event that the InstaCall call disconnects or fails.
  6. Caller ID - Please choose how you would like your caller ID displayed. You can choose from:
    • The site visitor’s name (this will require your site visitors to input their names before they are able to make a call) e.g. Jane Doe
    • The InstaCall Name, e.g. "InstaCall on HomePage" or
    • A combination of the visitor’s name plus a 3 letter tag you designate for the InstaCall button (this will also require your site visitors to input their names before they are able to make a call) e.g. Jane Doe HOM
  7. Time Zone - Choose your time zone.
  8. Business Hours - Choose the time frames that the InstaCall button appears active. During times when the button is inactive, it will appear grey and not clickable to website visitors. Upon mouseover, the website visitor will see a message: "Web calling will be available HH:MM - HH:MM, Tomorrow" where HH:MM - HH:MM is your business hour interval.
  9. Google Analytics - Providing your Google Analytics Web Property ID and Domain Name will allow you to track InstaCall button clicks and calls as events.
  10. Click "Next".

    InstaCall setup

  11. Theme - Choose your preferred InstaCall style.
  12. Button Text - Please choose the text that will display on the InstaCall button on your site.
  13. Instructions - Provide brief instructions for your visitors. When they click the InstaCall button, this message will display in the pop-up that contains the call.
  14. Post Call Message - Up to 100 characters can be displayed to website visitors after a call.

Click "Save".

 

Adding InstaCall to your site

Find the "InstaCall" Button in your application list, and select it. Copy and paste the code snippet under the label “Button Code” into the HTML of your website or give the code snippet to your site administrator / web developer to handle.

Copy and paste button code

Please note:

  • Copying and pasting the InstaCall JavaScript code into your webpage “at HTML level” comes with the responsibility of knowing that you can break elements in the page if done incorrectly. We recommend a website administrator with general HTML/CSS/JavaScript experience/know-how complete these steps in case the button position and styling needs editing.
  • If your site is having issues calling the script, add "https" to the link.  Change from: 
    • js.src="//app.onsip.com/app/instacall/js/popup.js"  to
    • js.src="https://app.onsip.com/app/instacall/js/popup.js"
  • If you would like to customize the look of your InstaCall button (or other call to action), see Customize InstaCall Button in Related Links at the bottom of this page
  • If you would like to send custom data (e.g. account information, visitor's link) along with the call, this is possible if you are using the end-to-end InstaCall solution: InstaCall App + the OnSIP app. To learn more about custom data, visit our page on Providing Custom Data/Caller Information.

 

Modifying your InstaCall settings

You can modify all the settings of your InstaCall Button at any time. Find the "InstaCall" button you wish to modify in your application list, and select it. Under the InstaCall details box, select "modify" in the bottom right-hand corner. All the settings you configured during setup can be edited here.

Be sure to hit the save button when done. This will update the code snippet under “Button Code”. You will need to copy and paste the updated code into your site’s HTML for the changes to take effect.

To edit the button color modify the button class:

<button class="ic-button ic-button-custom"

Remove the line:

data-theme="skeu-light"

And then create a section in your .css for ic-button.ic-button-custom:

.ic-button.ic-button-custom {

  border-bottom-color: #969;

  border-right-color: #969;

  background-color: #969;

  color: #000;

}

 

.ic-button.ic-button-custom:hover, .ic-li:hover > .ic-button {

  border-bottom-color: #f0f;

  border-right-color: #f0f;

  background-color: #f0f;

  color: #000;

}

 

Connection Time

At the moment, InstaCall requires about 2-4 seconds to connect. This means that if your InstaCall Call Destination is an auto-attendant or another destination that answers incoming calls immediately, the first few seconds of your automated message may be clipped. To deal with this, we recommend setting up an announcement that transfers to your intended call destination after it has finished playing and selecting it as your InstaCall Call Destination instead.

Simply follow these 3 easy steps:

  1. Upload a recording, a ~4 second sound clip to fill the time while InstaCall connects. You can upload any .wav file you like but we've attached a standard ringback tone for you to use here (Right Click, Save As) .
  2. Create an OnSIP announcement using the recording you uploaded that transfers to your intended Call Destination after it has finished playing.
  3. Point the InstaCall Call Destination to the announcement.
 
Was this article helpful?
0 out of 0 found this helpful

Comments