Send Softphone.Pro status to a third-party web app
To set up sending status change info to a Windows app, use the instruction via the link.
Set up the "Status change" event handler in Softphone.Pro. This sends status change info of the Agent to an external web app. It helps track employee work time. Or it changes 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. This lets you 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 the Add handler button:
3. Fill in the handler parameters:
- Event
Select Status change; - Action
Select Call a web service.
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. GET request with test parameter values will be sent to the specified URL:
5. Click Save.
6. Change the app status in the main Softphone.Pro window (including any added custom statuses). The configured handler will send a GET request to the set URL 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 Call a web service.
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. GET request with test parameter values will be sent to the specified URL:
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 send a GET request to the configured URL with current parameters.