Skip to content
Sugester V2 EN

Call handling software (softphone)

Updated at: • 2 min read

Go to section

  1. Softphone Program
  2. Zoiper Configuration
  3. Other Softphone Programs
  4. SuperVOIP REST API
  5. Making Calls
  6. Standard Call
  7. Autocall (automatic call)
  8. Call History
  9. Troubleshooting
  10. Calls are not recorded in Sugester
  11. “Invalid URL” error when saving the webhook
  12. Softphone not registering (no “Registered”)
  13. API authorization error

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
    1. 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:

Endpoint Description
GET /api/incoming_calls Incoming call history
GET /api/outgoing_calls Outgoing call history
GET /api/sips List of SIP numbers
POST /api/asterisk/do_call Initiate a call
GET /api/records List of recordings
POST /api/sms Send SMS

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:

  5. The system first calls you (the agent)
  6. After you answer, it automatically connects to the client
  7. 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

  8. Check webhook - URL must be https://voip.sugester.pl/voip/voips/supervoip
  9. Check VoIP number - must be added in Sugester with the provider “SuperVOIP”
  10. Check number uniqueness - the number cannot be on multiple accounts simultaneously
  11. 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
Previous
Next

Was this entry helpful?

Share

Comments