Knowledgebase

Portal Home > Knowledgebase > VoIP > How can a website user connect to an extension

How can a website user connect to an extension

How Can a Website User Connect to an Extension?

How to activate Call API at the server level

CallAPI is enabled server wide from the Server >> Unified Communications >> System preferences >> Call API tab. The following options are available:

  1. Allow Call API on this server - Enable to use of Call API on the VoipNow Professional server.

  2. Total access Call API username - The login of the administrator user on the server level.

  3. Old Total Call API password ******** - This is the previously administrator password. Unless you set a password here, you will not be able to use the Call API administrator account.

  4. Total access Call API password - The password used for Call API access as administrator user.

  5. Confirm Call API password - Password confirmation.

  6. Accept at most {x} requests from a user in {y} seconds - Limits for how many times a user may access the API during {y} seconds.

  7. Preferred Call API agent - Referred Call API agent (i.e.: the program that connects to Call API):

    • NONE (default)

    • iSymphony 1.9.0 rev 140

    • iSymphony 2.0

  8. Subnet or IP address {IP} limit {x} request/60 seconds - This option is used to limit for how many times a host connecting from a specified IP/network address may issue requests over 60 seconds. You can add multiple IP/network addresses with different settings.

How to create an extension for this purpose

Call API works with phone terminal extensions only and has to be enabled both on the reseller and client levels that own the respective extension.

In order to activate Call API at reseller and client levels, follow these steps:

  1. Enable Call API server wide.

  2. Select the reseller that owns the extension.

  3. Go to the reseller's Permissions and Phone Numbers page and enable the Call API Management option by selecting the corresponding check box.

  4. Select the client that owns the extension.

  5. Go to the client's Permissions and Phone Numbers page and enable the Call API Management option by selecting the corresponding check box.

To allow Call API usage on a phone terminal extension, follow the steps below.

  1. Select the extension.

  2. Go to the extension's Permissions and Phone Numbers page and enable the Call API Management option by selecting the corresponding check box.

  3. Go to Phone Terminal Setup section and enable Call API access.

How to add a button for "Call Now" (building the Call API to originate requests for the VoipNow Professional server)

After Call API has been enabled for the extension, you can configure the CallNow URL by clicking the CallNow button in the extension management screen.

In the CallNow Preferences page you have the following options:

  1. Allow people to call me - Enable calls to be originated from the web interface using Call API and CallNow.

  2. CallNow ID - The identification string to be added to the server's URL; by default, it is automatically generated, but you can set it to something else as long as it is unique on the server.

  3. I am available only in time interval - Choose the time interval you allow calls trough the web interface.

  4. Do not allow people to contact me while I am on the phone - Do not allow calls trough the web interface when another call is in progress.

  5. Confirmation required before connecting me to caller - When the call is connected to the extension, the system asks for the confirmation of the call by pressing digit 0.

  6. Show my name on the public CallNow interface - Show the extension owner's name in the web page.

  7. Ask for the name of the caller - Ask the caller to enter his name in the web interface.

  8. Use image validation on the public interface - Ask the caller to validate his entry by typing the numbers/characters shown in a generated image.

  9. Language - Select the language for the web interface.

  10. Message on the public interface - The message that the caller will see in the interface.

When done, press Ok and the server will generate an URL in the form:

http://server_ip_or_doamain_name/callnow/the_id

Using this URL, anybody with Internet access is able to contact you on your extension. The user only has to enter his name and phone number on the public CallNow interface. When the request is made, your extension will ring and after you pickup it will connect you to the user that trying to contact you.


Also Read