[Sugester V2 EN](https://sugester.intum.pl/kb/sugester-v2-en.md) / [VoIP Telephony](https://sugester.intum.pl/kb/sugester-v2-en/voip-telephony.md)

# [Call handling software (softphone)](https://sugester.intum.pl/kb/sugester-v2-en/call-handling-software-softphone.md)

## Softphone Program
To make and receive VoIP calls, you need a softphone program. We recommend **Zoiper** - available on:
- Windows, Mac, Linux
- iOS, Android
### Zoiper Configuration
1. Download Zoiper from: https://www.zoiper.com/
2. Install and run the program
3. Add a new SIP account:
- **Username**: SIP number (e.g., 1289481)
- **Password**: SIP password from the SuperVOIP panel
- **Domain/Server**: `sip.supervoip.pl`
4. Save and enable the account
After successful configuration, Zoiper will show the status "Registered" - this means it is ready for calls.
### Other Softphone Programs
In addition to Zoiper, you can use other programs that support the SIP protocol:
- **Linphone** (free, open source)
- **Bria** (paid, more features)
- **MicroSIP** (free, Windows only)
- **Twinkle** (free, Linux)
## SuperVOIP REST API
SuperVOIP provides a REST API for managing calls. Authorization via Bearer token.
**Useful endpoints:**
<table>
<tr><th>Endpoint</th><th>Description</th></tr>
<tr><td><code>GET /api/incoming_calls</code></td><td>Incoming call history</td></tr>
<tr><td><code>GET /api/outgoing_calls</code></td><td>Outgoing call history</td></tr>
<tr><td><code>GET /api/sips</code></td><td>List of SIP numbers</td></tr>
<tr><td><code>POST /api/asterisk/do_call</code></td><td>Initiate a call</td></tr>
<tr><td><code>GET /api/records</code></td><td>List of recordings</td></tr>
<tr><td><code>POST /api/sms</code></td><td>Send SMS</td></tr>
</table>Documentation: https://restapi.supervoip.pl/
## Making Calls
### Standard Call
1. Open the client card in Sugester
2. Click the phone icon next to the number
3. The call will be initiated - your softphone (Zoiper) will ring
4. After you answer, the system will connect you to the client
### Autocall (automatic call)
The feature is available when enabled in the VoIP number settings:
1. The system first calls you (the agent)
2. After you answer, it automatically connects to the client
3. Both numbers see your presentation number
## Call History
All calls are recorded:
- **VoIP** → **Call History** (`/voip/calls`) - full list
- **Client Card** → **Calls** tab - calls with a specific client
Recorded data:
- Date and time
- Calling/receiving number
- Duration
- Status (answered, missed, busy)
- Assigned agent
## Troubleshooting
### Calls are not recorded in Sugester
1. **Check webhook** - URL must be `https://voip.sugester.pl/voip/voips/supervoip`
2. **Check VoIP number** - must be added in Sugester with the provider "SuperVOIP"
3. **Check number uniqueness** - the number cannot be on multiple accounts simultaneously
4. **Check SIP** - without an added SIP, calls are not assigned to the user
### "Invalid URL" error when saving the webhook
SuperVOIP validates the webhook URL. Use exactly: `https://voip.sugester.pl/voip/voips/supervoip`
### Softphone not registering (no "Registered")
- Check SIP login details in the SuperVOIP panel
- Ensure the firewall is not blocking SIP ports (5060 UDP)
- Try disabling and re-enabling the account in Zoiper
### API authorization error
- Check if the auth Token is correctly pasted (the entire JWT string)
- The token should not contain spaces at the beginning/end