[Intum](https://intum.pl/pomoc.md) / [VoIP](https://intum.pl/pomoc/voip.md)

# [Konfiguracja Linphone z SuperVoIP](https://intum.pl/pomoc/voip/konfiguracja-linphone-z-supervoip.md) | [API](#api)

Linphone to darmowy, open source'owy program do obsługi połączeń VoIP (softphone). Dostępny na Windows, Mac, Linux, iOS i Android. Poniżej instrukcja konfiguracji Linphone z SuperVoIP do użytku z Intum.

## 1. Pobranie i instalacja

Pobierz Linphone ze strony: [linphone.org/download](https://www.linphone.org/en/download/#linphoneapp)

Zainstaluj i uruchom program.

## 2. Dane potrzebne do konfiguracji

Przed konfiguracją przygotuj dane z panelu SuperVoIP:

1. Zaloguj się do [panelu SuperVoIP](https://panel2.supervoip.pl)
2. Przejdź do: **Wirtualna Centrala -> Stanowiska**
3. Odczytaj dane swojego stanowiska (SIP):
   - **Numer konta SIP** - 7-cyfrowy numer (np. 1290245)
   - **Hasło SIP** - hasło do konta SIP (**inne niż hasło logowania do panelu!**)

Jeśli nie znasz hasła SIP, możesz je zmienić w panelu SuperVoIP klikając na numer swojego konta SIP.

## 3. Konfiguracja konta SIP

### Desktop (Windows / Mac / Linux)

1. Uruchom Linphone. Pojawi się ekran **Connection**
2. Kliknij przycisk **Third-party SIP account**
3. Pojawi się komunikat informujący, że niektóre funkcje (grupowe czaty, wideokonferencje) wymagają konta Linphone i będą ukryte przy koncie SIP. Kliknij **I understand**
4. Wypełnij formularz konta SIP:

| Pole | Wartość |
|------|---------|
| Username | numer konta SIP (np. 1290245) |
| Password | hasło SIP z panelu SuperVoIP |
| Domain | `sip.supervoip.pl` |
| Display name | Twoje imię (opcjonalne) |
| Transport | TCP (zalecany) |

Pozostałe pola (Authentication ID, Registrar URI, Outbound SIP Proxy URI) zostaw puste.

5. Kliknij **Connection**

### Mobile (iOS / Android)

1. Pobierz **Linphone** z App Store lub Google Play
2. Uruchom aplikację i wybierz **Third-party SIP account**
3. Potwierdź komunikat klikając **I understand**
4. Uzupełnij te same dane:
   - **Username**: numer konta SIP
   - **Password**: hasło SIP
   - **Domain**: `sip.supervoip.pl`
   - **Transport**: TCP
5. Kliknij **Connection** / **Login**

Na iOS push notifications działają automatycznie - połączenia przychodzące budzą aplikację nawet gdy jest w tle.

## 4. Weryfikacja połączenia

Po skonfigurowaniu:

1. Sprawdź czy Linphone pokazuje status **Connected** / **Registered** (zielona kropka przy koncie)
2. Wykonaj połączenie testowe - zadzwoń na inny numer
3. Poproś kogoś o połączenie do Ciebie - sprawdź czy dzwonek działa

### Rozwiązywanie problemów

Jeśli status to **Registration failed** lub **Not registered**:

- Sprawdź hasło - hasło SIP jest inne niż hasło do panelu SuperVoIP
- Sprawdź numer konta - to 7-cyfrowy numer ze stanowiska, nie numer telefonu
- Zmień transport - spróbuj UDP zamiast TCP (lub odwrotnie)
- Firewall - upewnij się że porty 5060-5061 nie są blokowane
- Hasło wygasło - zmień hasło SIP w panelu SuperVoIP i wpisz nowe

## 5. Jak to działa z Intum?

Po skonfigurowaniu Linphone:

1. Otwórz kartę klienta w Intum
2. Kliknij ikonę telefonu przy numerze klienta
3. Intum inicjuje połączenie - Linphone zadzwoni
4. Odbierz w Linphone - system połączy Cię z klientem

Wszystkie połączenia są automatycznie rejestrowane w historii połączeń (**VoIP -> Historia połączeń**) i na karcie klienta.

## 6. Parametry techniczne SuperVoIP

Dla zaawansowanych użytkowników:

| Parametr | Wartość |
|----------|---------|
| Serwer SIP | `sip.supervoip.pl` |
| Port UDP | 5060, 5090 |
| Port TCP/TLS | 5061 |
| Kodeki audio | G.722 HD, G.711u, G.711a, iLBC, GSM |
| Kodeki wideo | H.261, H.263, H.263+, H.264 (SIP-to-SIP) |
| RTP (głos) | porty 10000-20000 |
| SRTP (szyfrowany) | porty 20001-30000 |

## 7. Inne programy softphone

Linphone to jeden z wielu programów obsługujących SIP. Alternatywy:

- **Zoiper** - darmowy, wszystkie platformy
- **MicroSIP** - darmowy, tylko Windows
- **Bria** - płatny, więcej funkcji
- **SuperSIP** - aplikacja od SuperVoIP na Android

Konfiguracja każdego z tych programów wymaga tych samych danych: numer konta SIP, hasło SIP, serwer `sip.supervoip.pl`.

---

## API

### Ogólne API

# Intum API

Dokumentacja API platformy [Intum](https://intum.pl) - system operacyjny firmy.

## Host

Host jest zawsze taki sam jak adres konta: `xxxx.intum.com` lub `xxx.intum.pl` (w zależności od ustawień konta)

## Autoryzacja

Wszystkie requesty API wymagają `api_token`:
- header: `Authorization: Bearer TOKEN`

Token możesz wygenerować w **Ustawienia Konta** → **Tokeny API**