Send Softphone.Pro status to a third-party Windows application
To set up sending status change info to a web app, use the instruction via the link.
Set up the "Status change" event handler in Softphone.Pro. This sends Agent status change info to an external Windows app. It helps track employee work time and allows to change the Agent's status in other systems immediately after they change it in Softphone.Pro.
Two handler scenarios are possible:
- Send info after status change: the handler triggers at the moment the Agent changes status. Useful if you need to start an action right after the status change;
- Send info periodically: the softphone sends its status info at a set interval. Useful for monitoring the Agent's current status.
Set up both handlers to see current status info and react to changes quickly.
The article below describes how to set up handlers for both scenarios.
Set up the "Status change" event handler
1. Click the icon in the top left corner of the main Softphone.Pro window. In the dropdown menu select Settings (or use the keyboard shortcut CTRL-S):
2. Go to Integration - Third-party systems. Click Add Handler:
3. Fill in the handler parameters:
- Event
Select Status change; - Action
Select Launch a program.
4. In the URL field enter the full path to the application with required parameters. Use placeholders from the hint in the handler settings window to pass data from Softphone.Pro. To test the request, click Test. The specified application will launch with test parameter values:
5. Click Save.
6. Change the app status in the main Softphone.Pro window (including any added custom statuses). The configured handler will launch the specified application with current parameters.
Set up periodic status info sending
1. Click the icon in the top left corner of the main Softphone.Pro window. In the dropdown menu select Settings (or use the keyboard shortcut CTRL-S):
2. Go to Integration - Third-party systems. Click the Add handler button:
3. Fill in the handler parameters:
- Event
Select Status change; - Action
Select Launch a program.
4. In the URL field enter the web service URL with required parameters. Use placeholders from the hint in the handler settings window to pass data from Softphone.Pro. To test the request, click Test. The specified application will launch with test parameter values:
5. Check the box Call periodically every N sec. Enter the value in seconds. The handler will trigger at the set interval:
6. Click Save.
7. The handler will trigger at the interval set in step 5. It will launch the configured application with current parameters.