Csta Browser

From Vodia PBX Wiki
Jump to: navigation, search

The snom ONE CSTA Browser tool opens a URL in a web page when you receive a call. The browser can be opened automatically depending on the call type or manually by clicking on the balloon icon when the calls comes in.

This feature can be used by many CRM tools to automatically look up records from customers with known phone numbers.

Installation

The CSTA browser comes in the form of a ZIP file. After opening, you will see some files and a program with the name "setup.exe".

CstaBrowser1.png

After double-clicking on the setup program, your computer will probably pop-up a warning that the publisher is unknown. In this version we did not include any publishing information. Please click on the "Install" button.

CstaBrowser2.png

The installation should just take a few seconds. In your taskbar you should then find a small telephone icon. If you right-click on it, you will find three items:

  • The item "test" will in this item open the URL with a hardcoded telephone number. This is to test if the program is able to open the web browser as it should.
  • The item "settings" will open the dialog as described below.
  • The item "exit" will terminate the application.

If you want that the application automatically starts when you log in to your computer, you need to do the following steps:

  • Open your Startup folder. You can do this for example in Windows 7 by clicking on the Start button on your keyboard, then right-click on "All Programs" and select the "Open" option there. Then double-click on the "Programs" folder, and then double-click on the "Startup" folder icon.

CstaBrowser3.png

  • After you have the Startup folder open in Windows Explorer, press the Windows Start button again, then enter "CstaBrowser" in the field "Search programs and files".
  • You can then just drag & drop the CstaBrowser application into your Startup folder.
  • If you don’t want to start the application automatically any more, just remove the link from the startup folder.

Settings

In order to connect the application with the telephone system, you need to enter your account information.

CstaBrowser4.png

  • The username is the name of your extension. Typically, this is a 2, 3 or 4-digit number that colleagues dial when they want to reach you from another phone. Please note that for some versions of the PBX, you must use the primary name of the user. Using alias names you may be able to register, but would not receive any incoming call notification (this bug is fixed on newer versions of the PBX).
  • The password is the web password for your extension. This is the password that you use to log into the web interface of the telephone system. Please note that this is usually different from the password that you use to register your phone using the SIP protocol. You have to enter the password twice to make sure that there is no typo in the password.
  • The domain name is typically the name if your organization or unit. You have received this name with your username and password. The domain correspondents to the second part of an email address, for example, 6179@company.com. If your telephone system has only one domain and your system administrator has included the name "localhost", you may put here as well the name "localhost". Please note that for some versions of the PBX, you must use the primary name of the domain. Using alias names you may be able to register, but would not receive any incoming call notification (this bug is fixed on newer versions of the PBX).
  • The address of the PBX is the IP address or DNS address of your phone system. This might be the same as the domain name, but typically it is just an IP address like 192.168.1.2 or a name that can be resolved to an IP address using the DNS protocol. The TSP uses that address to locate the server in the Internet or LAN.
  • The port number is needed to connect to the right port on the server. The TSP uses the HTTP ports for the message exchange with the telephone system. For unencrypted traffic, the default port number is 80; for encrypted traffic it is 443. Your system administrator might have chosen different ports for you.
  • Currently, the application will not encrypt the traffic between the PC and the server. This feature might be added later.
  • The URL setting determines what web page will be opened when you receive a call. This can be any valid URL. It has to start with either http:// or with https://. In addition to the static text that you can provide here, the application will replace the following texts:
    • The text "{open}" and "{close}" will be replaced with the text "{" and "}". This makes it possible to use those characters in the URL, if you have to.
    • The text "{number}" will be replaced with the telephone number of the remote party.
    • The text "{domain}" will be replaced with the domain name of the remote party.
    • The text "{username}", "{password}", "{address}", "{port}", "{encryption}" and "{url}" will be replaced with the respective setting.
    • The text "{parm1}", "{parm2}" and "{parm3}" will be replaced with the generic parameter 1, 2 or 3.

After you have successfully registered your application to the PBX, the icon in the task bar will include a little green check mark. In case the registration goes wrong, you will see a little red button with a white cross in it.

Uninstalling the Application

If you decide to uninstall the application, just open the windows control panel, select programs and features and then right click on the application to uninstall it.