[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)

# [Integration of VoIP with SuperVoip Company](https://sugester.intum.pl/kb/sugester-v2-en/integration-of-voip-with-supervoip-company.md)

SuperVoIP is a Polish provider of internet telephony (VoIP), offering modern communication solutions for businesses. Integration with SuperVoIP allows for a direct connection of the system with telephony, streamlining call handling and automating customer contact processes.

## **1. Activating the SuperVoIP API Service**

Before you proceed with configuration, ensure that you have an active **SuperVoIP API** service in the SuperVoIP panel.

1. Log in to the **SuperVoIP panel**.
2. Go to: **Virtual PBX (Wirtualna centrala) -> Services (Usługi)** (direct link: `https://panel2.supervoip.pl/services`)
3. Check if the **SuperVoIP API** is visible in the list of services.

![List of services in the SuperVoIP panel — API service not available](https://s3.eu-west-1.amazonaws.com/attachments.intum.net/public-files/31076/dce2f899d0524f6cfb72d2c9eabeaef5ebbdb34d)

If the **SuperVoIP API** service is not on the list:

1. Click **Add service** (or the appropriate add button).

![Adding SuperVoIP API service](https://s3.eu-west-1.amazonaws.com/attachments.intum.net/public-files/31076/fe5351c77c38a2a4fd4dd1723233e8d0607c9436)

2. Find and select the **SuperVoIP API** service.
3. After adding, the service will appear on the list with the status **Pending activation**.

![SuperVoIP API service with Pending activation status](https://s3.eu-west-1.amazonaws.com/attachments.intum.net/public-files/31076/01c914f9abee96b2a378e10a76aac6c1a858b677)

4. Wait for the service to be activated by SuperVoIP. Until activation, you will see a waiting message in the API settings.

![API settings — service inactive, waiting for activation](https://s3.eu-west-1.amazonaws.com/attachments.intum.net/public-files/31076/0757124922f07f2a0caa0a88d31c0e9529511e4c)

After the service is activated, you can proceed to configuration.

## **2. Configuration on the SuperVoIP Side**

### 2.1. Setting up the Webhook

1. Log in to the **SuperVoIP panel**.
2. Go to:
**Virtual PBX (Wirtualna centrala) -> Services (Usługi) -> SuperVoIP API -> SuperVoIP API REST Settings**
(direct link: `https://panel2.supervoip.pl/api?page=rest`)
3. In the **Webhook** section, fill in the form:
- **Name** - anything you like, for example Sugester
- **URL** - `https://voip.sugester.pl/voip/voips/supervoip`
- tick the **call** checkbox
4. Click **Add webhook**.

The webhook is required for proper communication between SuperVoIP and the Sugester system.

**Running the system on your own domain?** The address `voip.sugester.pl` applies to accounts hosted in Sugester. If you use an installation under your own address, enter your own system with the same path, that is `https://your-domain.com/voip/voips/supervoip`.

**No call checkbox?** A SuperVoIP account can hold only one webhook with **call** events. If such a webhook already exists, only **sms** will be offered when you add another one. Delete the old webhook or contact SuperVoIP.

![Webhook configuration in SuperVoIP API REST settings](https://s3.eu-west-1.amazonaws.com/attachments.intum.net/public-files/31076/0d52ba9a8595a641e3e05ffd011f950cab37b7f1)

### 2.2. Generating the API Key

1. In the SuperVoIP panel, go to:
**Virtual PBX (Wirtualna centrala) -> Services (Usługi) -> SuperVoIP API -> SuperVoIP API REST Settings**
2. Locate the **Token auth3** field.
3. If the token does not exist - generate it.
4. Copy the generated API key - it will be needed in the next step.

## **3. Configuration on the Sugester Side**

### 3.1. Adding the SuperVoIP API Key

- In the Sugester panel, go to **4 dots** -> **VoIP section** -> **VoIP Settings** -> **Edit**
- In the **API Key** field in the SuperVoIP section, paste the previously generated **API Key**
- Save the settings

### 3.2. Adding VoIP Numbers

- In the Sugester panel, go to the **VoIP** section -> **VoIP Numbers**
- Select the **+** option
- Fill in the following fields:
  - **Name** - any name identifying the number
  - **Number** - phone number (matching the number from SuperVoIP). Add the number as a continuous string without spaces and special characters.
  - **Provider** - SuperVoIP
  - **Description** - optional field if you need to insert a description for the number
- If the number is to be linked to the autocall widget, check the **Use as autocall** checkbox
- Save the number.

![VoIP number addition form in Sugester](https://s3.eu-west-1.amazonaws.com/attachments.intum.net/public-files/31076/3c7e89f0cd9710e68e68cb905d2ce60894dffe6f)

### 3.3. Adding SIPs

SIP data is retrieved directly from the SuperVoIP panel.

1. Log in to the client panel in SuperVoIP.
2. Go to:
**Virtual PBX -> Workstations**
3. Read the workstation data (SIP).

![List of SIP workstations in the SuperVoIP panel — Virtual PBX](https://s3.eu-west-1.amazonaws.com/attachments.intum.net/public-files/31076/a554a8da553ad18ef9f1cc60666a0855e967d237)

### 3.4. Configuring SIP in Sugester

Go to **4 dots -> VoIP -> SIPs**
When adding a SIP in Sugester, fill in:

- **Name** - any name identifying the workstation
- **SIP** - SIP account number (from the workstation in SuperVoIP, e.g., 1290245)
- **Provider** - select SuperVoIP
- **VoIP** - select the VoIP number to which the SIP is assigned
- **Responsible person** - Sugester user handling the given SIP

![SIP addition form in Sugester](https://s3.eu-west-1.amazonaws.com/attachments.intum.net/public-files/31076/16c975ac32eb26ff4244c89f584b8221db8a0fb0)

## **4. What Next?**

After configuring SuperVoIP in Sugester, the next step is to install and configure a call handling program (softphone). This will allow you to make and receive calls directly from your computer.

You can find detailed instructions in the article: [Call handling program (softphone)](program-do-obsugi-poaczen-softphone-JSMA1VHQ)