VON@Link
ScreenPop
v1.2 for Windows
VON@Link
ScreenPop
v1.2 for Windows
Last updated: Sep. 10, 2011
1 Introduction
1.1 System requirements2 Setup
2.1 Analog Telephone Adapter
2.1.1 Analog Telephone Adapter with built-in router
2.2 Soft phone
2.3 Hard phone3 Using ScreenPop
3.1 Starting
3.2 General tab
3.3 Phone tab
3.3.1 Discover phone
3.3.2 Add phone ID manually
3.3.3 Edit phone
3.3.4 Phone options
3.3.5 Reject callers
3.3.6 Restrict outbound numbers
3.4 Launch tab
3.4.1 Pop tray balloon
3.4.2 Overlay screen
3.4.3 Play audio
3.4.4 Show Outlook Contact
3.4.5 Virtual modem
3.4.6 Custom applications
3.5 Contacts
3.6 Calls tab
3.6.1 Preferences
3.6.2 Click to call for Vonage
3.6.3 Click to call for standard SIP phone
3.7 Voice mail waiting
3.8 Licensing
3.8.1 Hardware ID
3.8.2 Transfer license to USB driveAppendix A Restarting Packet Monitor service
Appendix B Interfacing to custom applications
B.1 File extensions
B.2 Examples
B.3 Adding an applicationAppendix C Disabling sleep mode on Vista
Appendix D Capturing a network trace
VONaLink is a suite of software products to enhance the functionality of your VoIP phone by integrating it with your computer.
*A hub is not needed if ScreenPop is running on the same computer as the soft phone. For hard phones or analog telephone adapters, a hub is needed.
To install ScreenPop:
ScreenPop can work in one of two modes - stand-alone or as a
TeamServer client. TeamServer refers to VONaLink
TeamRecord or
TeamOnCall. The mode is selected from the
General tab.
If ScreenPop is in stand-alone mode, continue reading this section. If ScreenPop is a TeamServer client, skip this section and jump to Using ScreenPop.
When in stand-alone mode, ScreenPop works by unobtrusively monitoring network packets as they travel between your phone and VoIP provider. The network setup depends on the type of VoIP phone that you have. If your computer has 2 network adapters, ScreenPop will monitor both of them.
|
If you are using Vista, power saving sleep mode must be disabled. |
Analog Telephone Adapters (ATA) are usually used to provide VoIP service to residential or small business customers by companies such as Vonage.
VONaLink works by monitoring network packets. A network hub is a "dumb" device that allows computers connected to the same hub to read all packets that flow through the hub. Because of this, VONaLink running on one computer can read the network packets destined for a phone plugged into the same hub. In contrast, a network switch is a "smart" device that improves performance by allowing packets between the specified sender and receiver only, so network monitoring is not possible.
The price of a hub is less than that of a switch. Because the cost difference between a hub and switch is small, and most people prefer the performance of a switch, most computer stores stock switches. You will need to shop at a store that carry a wide range of network devices to find a hub. Some models are listed on the Support page.
|
|
If your Analog Telephone Adapter has a built-in router, then you need a new
broadband router, in addition to a hub, and configure as follows:
A soft phone is a software program that runs on your computer and uses the connected microphone and headset. It is possible to use a soft phone with VONaLink on a wireless network.
If VONaLink and the soft phone run on the same computer, VONaLink can read the network packets flowing to and from the soft phone.
If VONaLink and the soft phone are running on separate computers, the use of a network hub is needed. A network hub is a "dumb" device that allows computers connected to the same hub to read all packets that flow through the hub. Because of this, VONaLink running on one computer can read the network packets destined for a phone plugged into the same hub. In contrast, a network switch is a "smart" device that improves performance by allowing packets between the specified sender and receiver only, so network monitoring is not possible.
The price of a hub is less than that of a switch. Because the cost difference between a hub and switch is small, and most people prefer the performance of a switch, most computer stores stock switches. You will need to shop at a store that carry a wide range of network devices to find a hub.
|
|
A hard phone resembles the typical home phone, but connects to a network.
VONaLink works by monitoring network packets. A network hub is a "dumb" device that allows computers connected to the same hub to read all packets that flow through the hub. Because of this, VONaLink running on one computer can read the network packets destined for a phone plugged into the same hub. In contrast, a network switch is a "smart" device that improves performance by allowing packets between the specified sender and receiver only.
The price of a hub is less than that of a switch. Because the cost difference between a hub and switch is small, and most people prefer the performance of a switch, most computer stores stock switches. You will need to shop at a store that carry a wide range of network devices to find a hub, so network monitoring is not possible.
Some phones, such as the Grandstream BudgeTone 102, have a built-in hub, so a separate hub is not necessary. Some high-end phones have built-in network switches. Again, the switch cannot be used, so a separate hub is needed.
|
|
To start ScreenPop, click on the desktop icon:
or the menu item: Start menu > All programs >
VONaLink ScreenPop
If ScreenPop is already running, the icon
is found in the System Tray. Click on the icon
to open the window.
Windows Vista
1. Right click on the Windows Taskbar
2. Click on Properties and switch to the Notification Area tab
3. Verify that Hide inactive icons checkbox is not checked
4. Click OK
Windows XP/2003/2000
1. Right click on the Windows Taskbar
2. Click on Properties and switch to the Taskbar tab
3. Verify that Hide inactive icons checkbox is not checked
4. Click OK
When ScreenPop is started for the first time, it will prompt you for your evaluation serial number. Enter the serial number and click on Activate.
| Run automatically upon Windows login | Select this checkbox to automatically start ScreenPop when you login to Windows. |
| Minimize on start | Select this checkbox to start ScreenPop as a minimized window. |
| Confirm exit | Select this checkbox and ScreenPop will ask before exiting. |
| Mode | Choose between Stand-alone and Connect to TeamServer. When used as a TeamServer client, click on Settings to specify the address and port of the TeamRecord or TeamOnCall Subscription service. |
To monitor up to 10 phone numbers, specify the phone numbers from the Phone tab.
If you are using a soft phone or a Vonage V-Phone on a wireless network,
select the My phone is a soft phone on this computer checkbox and restart
ScreenPop.
The exact phone identifier format used by your VoIP provider varies between providers. To assist you in determining your phone ID, click on Discover phone button from the Phone tab. Make an outgoing call and receive an incoming call to see your phone ID appear. Select the phone ID and click on Add. Up to 10 phones may be added.
In most cases, it should
be sufficient to make an outgoing call or receive an incoming call to
detect the phone ID, but VoIP provider Packet8 uses one phone ID for outgoing
and another ID for incoming.
The easiest way to add phones is through discovery. To manually add a phone ID, click on Add. Up to10 phones may be added.
Enter an optional nickname to help you identify the phone. If your VoIP provider is not listed, choose Other (numbers Only).
Your VoIP provider may include the country code before the phone number. For example:
| AT&T CallVantage | Do not include a 1 before the 10 digit phone number |
| Packet8 | Packet8 does not use your phone number as the phone ID in the network packets for outgoing calls. Use Discover phone to determine the ID used. |
| Voip.com | Voip.com does not use your phone number as the phone ID in the network packets. Use Discover phone to determine the ID used. |
| Vonage | In North America include a 1 before the 10 digit phone number |
To change the nickname or the provider for a phone, select the phone and click on Edit.
| Ignore calls with numbers shorter than ... digits | If ScreenPop is used in an office with internal extension numbers, select this checkbox and specify the phone number length so that only external calls are monitored. |
| Hide local area code | Select this checkbox to hide the area code of a phone number if it is the same area code as your phone. |
| Phone number display format | Format mask for display phone numbers. Each # represent a digit.
Other valid characters are space, period, hyphen, and brackets. For
example: # (###) ###-#### |
| Retain call logs for ... days | A file is created each day to log the calls for that day. ScreenPop can automatically delete old logs by specifying the number of days that logs should be kept. Leave the field blank for indefinite period. |
The Reject callers list contains the phone numbers and names from whom you do not wish to accept. When one of these calls arrive, you will hear your phone start to ring, but VONaLink will then send a network message to cancel the call, and your phone will stop ringing. The caller may encounter one the following call treatments:
ScreenPop has no control of which call treatment will be used.
From the Reject callers section, click on Add to show the Add Reject dialog. You may enter a phone number or a name. To reject based on starting digits, specify an asterisk after the starting digits. For example: 1800*. This will reject all numbers that start with 1800.
You can also add callers to the reject list from the Calls tab.
The Restrict outbound numbers list contains the phone numbers that should not be dialed, such as long distance or toll calls.
From the Restrict outbound numbers section, click on Add to show the Add Restrict dialog. Enter a phone number. To restrict based on starting digits, specify an asterisk after the starting digits. For example: 1800*. This will restrict all numbers that start with 1800.
The Launch tab allows you to specify the actions to take when an incoming call rings.
If a caller
dials *67 before your phone number, the caller ID does not display on your
analog phone. However, at the network level, the originating phone number may be present.
If the phone number is not there, the IP address of the calling network will be
used.
Select the Pop tray balloon checkbox to have a popup balloon appear in the system tray when a call rings. Click on Test to see how the tray balloon looks.
Select the Overlay screen checkbox to have the incoming phone number displayed as a screen overlay. To choose text color, size, position, and display duration, click on the Settings button.
Click on the Test button to see how the screen overlay looks.
Select the Play audio checkbox to have a voice read out the phone number when a call rings, or play an audio file if it has been specified in Contacts. To choose a female or male voice for announcing a phone number, click on the Settings button.
Click on Test to hear how the voices sound.
Select the Show Outlook Contact checkbox to display the Microsoft Outlook Contact when a call rings. To choose which Outlook fields to search, click on the Settings button. Outlook 2000 or later is required.
The typical search is done using the Calling number. If you are answering multiple local phone numbers, it is possible to search using the Called number.
Select the Create contact checkbox to create a contact if the phone number is not found in Outlook.
To test, enter a phone number and click on Test to search Outlook.
This feature has been deprecated.
One of the unique and powerful features of ScreenPop is the ability to launch up to 3 custom applications. For example, the applications could do a reverse lookup of the caller and connect to your customer database.
For more information on how to add your custom applications to the list, see Appendix A.
Typically, you would want to launch the application only when the phone rings. To launch your application for all the changes in call status, select the When status changes option.
For an incoming call, the status sequence is: ring > in >
end
For an outgoing call, the status sequence is: out > end
To test, enter a phone number, an optional name, status, and click on Test to run the specified application.
The Contacts tab is where you can associate an alias and audio file with a contact.
In the following screenshot, when a call from 19057372391 arrives, the name "Tony Leung" will be used as the caller's name instead of "LEUNG T." Also, if the Play audio checkbox from the Launch tab is enabled, the file TonyLeung.wav will be played.
Click on the Refresh button if the phone number display format has been changed.
To add a new contact, click on Add.
The Phone field is mandatory. Either the Alias or Audio field may be left blank, but not both.
WAV files are accepted for audio. Windows built-in Sound Recorder, or an application such as Audacity, may be used to record a WAV file.
The Add Contact window may also be invoked from the Calls tab.
The Calls tab shows a list of calls for each day.
 |
Go to previous folder |
 |
Go to next folder |
 |
Find remote party in Outlook |
 |
Add contact |
|
|
Add caller to the reject list |
 |
Delete the daily log |
 |
Refresh the list of folders and calls |
 |
Show the Preferences window |
You can also click on the right mouse button to show a popup menu. The menu item Click to call is enabled only if the provider of the local number is Vonage or a standard SIP phone.
The Preferences window allows you to choose what is displayed in the Calls table.
From the Calls tab, right click on a call and select the menu item Click to call. If the Click to call menu item is disabled, wait 1-2 minutes so the VONaLink can detect the IP address of your phone. If you make an outgoing call, VONaLink will detect the IP address right away. Once the IP address is detected, the Click to call menu item will be enabled.
Enter the username and password for your account at the Vonage web site.
Click on OK. When your Vonage phone rings, pick up the handset, and Vonage will connect you to the target phone number.
For Click to call to work on a standard SIP phone, your phone must accept calls using direct IP addressing. Phones or phone adapters that are locked to a specific provider may not work using direct IP addressing.
From the Calls tab, right click on a call and select the menu item Click to call. If the Click to call menu item is disabled, wait 1-2 minutes so the VONaLink can detect the IP address of your phone. If you make an outgoing call, VONaLink will detect the IP address right away. Once the IP address is detected, the Click to call menu item will be enabled.
Click on OK. When your phone rings, pick up the handset, and your phone will transfer to the target phone number.
If there are messages in your voice mailbox, an envelope icon will appear on the bottom right corner of ScreenPop.
The limitation of the voice mail indicator is that if ScreenPop is closed and opened again, the indicator is cleared.
Click on the menu: Help > License.
To see the number of days remaining in the evaluation, click on Help > About.
A license is in the form of a unique serial number. If you plan on using ScreenPop on more than 1 computer, buy a USB flash drive, plug it in and let ScreenPop reads its ID, then use the ID of the USB drive when buying ScreenPop. In other words, if your license is associated with the USB flash drive, you always need to have it plugged into the computer in order to use ScreenPop on that computer. Any size of USB flash drive will do.
To purchase a license, click on the menu: Help > License. Click on Buy Now. It will take you to the Buy page of www.vonalink.com
When purchasing a license, you will be asked for the Hardware ID generated by VONaLink. By default, the license will be associated with your computer.
It is also possible to associate the license with any removable USB drive, or Vonage V-Phone. This allows you to move the VONaLink license from computer to computer.
Choose the device which the license will be associated with, and copy the Hardware ID by clicking on Copy to clipboard. Paste the Hardware ID in the web order form.
After purchasing, you will be given a permanent serial number that is unique to your computer hardware. Replace the evaluation serial number with the permanent one.
If your license is associated with your computer and your find the need to use ScreenPop on another computer, you can request a transfer of your license to a USB flash drive. Insert a USB drive in your computer and click on the menu Help > Transfer license to USB drive. Select the USB device, and click on Copy to clipboard to save the Hardware ID. Paste the Hardware ID in a message along with your original order details to Technical Support. Once your receive the new serial number, paste it into the Serial # field and click on Activate.
ScreenPop works together with VONaLink Packet Monitor service. When your computer boots up, the service is automatically started. The service will look for a network adapter with an IP address. If none is found after a number of retries, the service will stop. ScreenPop will indicate the status area that the Packet Monitor service has stopped. To start it manually:
The list of allowed file extensions are saved in \vonalink\app\ext. The extension file specify how to launch the application and how the parameters are passed. VONaLink defines 5 variables:
| Variable | Description | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| %app% | Application file name | ||||||||||||||
| %local% | Phone number of local party | ||||||||||||||
| %remote% | Phone number of remote party | ||||||||||||||
| %name% | Name of remote party if present | ||||||||||||||
| %status% | Call status: The possible values of status are:
|
To specify how to launch a VB script, the \vonalink\app\vbs file contains:
cscript "%app%" local=%local% remote=%remote% "name=%name%" status=%status%
To specify how to launch a Perl application, the \vonalink\app\pl file contains:
perl "%app%" --local=%local% --remote=%remote% "--name=%name%" --status=%status%
Example applications are found in \vonalink\app\examples to do the following:
To add an application so that it appears in the Custom applications window, place the file in \vonalink\app. The file extension of the application must be in \vonalink\app\ext.
If your computer goes into sleep mode to save power, this interferes with network packet reading. To disable sleep mode, go to Windows Control Panel > Power Options. Select High performance.
Click on High performance Change plan settings to verify that Put the computer to sleep is set to Never.
The procedure is performed only if requested by VONaLink technical support.
1. Open up a Command Prompt window (Start menu > Accessories > Command
Prompt)
2. Type:
cd \vonalink\bin
3. Type:
vonapkt trace on
4. To get current trace state, type:
vonapkt trace
5. Wait 15 seconds. Talk on your VoIP phone. Hang up.
6. Type:
vonapkt trace off
7. A file with the pcap extension is saved in \vonalink\log\trace. If
the file is large, compress it using
7-zip or
Winzip.
8. Send the file to Technical Support
Windows is a registered trademark of Microsoft Corporation in the U.S. and other countries.
