[Intum Pomoc](https://intum.pl/pomoc.md) / [Integracje z dostawcami](https://intum.pl/pomoc/telefonia-voip/integracje-z-dostawcami.md)

# [Integracja z Ringostat](https://intum.pl/pomoc/telefonia-voip/voip-integracja-ringostat.md)

Ringostat to dostawca telefonii i call trackingu. Po podłączeniu rozmowy z Ringostata wpadają do
historii połączeń w Intum i przypinają się do klientów, a numer na karcie klienta da się wybrać
kliknięciem. Konfiguracja to kilka kroków: dane z panelu Ringostata wpisujesz w Intum, a adres
webhooka z Intum wklejasz z powrotem w panelu Ringostata.

W odróżnieniu od Datery nagranie rozmowy przychodzi razem ze zdarzeniem połączenia, więc Intum nie
musi go osobno pobierać. Z połączeniami przychodzącymi dostajemy też dane kampanii (źródło, medium,
nazwa kampanii, identyfikator Google Analytics) - na karcie rozmowy widać dzięki temu, z której
reklamy przyszedł telefon.

## 1. Klucz API i ID projektu po stronie Ringostata {#klucz}

W panelu Ringostata: **Ustawienia → Integracja → Ringostat API**. Skopiuj klucz (**Auth-key**)
i **ID projektu** - są na tej samej stronie.

> [!NOTE]
> Jedno konto w Intum łączy się z jednym projektem Ringostata. Jeśli firma ma w Ringostacie kilka
> projektów, każdy ma własny klucz i własne ID - w Intum podłączysz jeden z nich.

## 2. Klucz API i ID projektu w ustawieniach modułu {#klucz-w-intum}

> [!PATH]
> [Ustawienia Voip](app:/voip/settings/edit) → **Ringostat** → **Zapisz**

Wpisz **Klucz API** i **ID projektu Ringostat**. Klucz jest potrzebny do dzwonienia z karty
klienta, a ID projektu do [autocalla](telefonia-voip/voip-autocall).

Po zapisie klucz widać w polu jako gwiazdki, a pod nim pojawia się **Usuń klucz API**. Pole
z gwiazdkami zostawione bez zmian nie zmienia zapisanego klucza, więc możesz spokojnie edytować
inne ustawienia. Nowy klucz wpisujesz w to samo pole.

## 3. Numer VoIP {#numer-voip}

> [!PATH]
> [Numery Voip](app:/voip/voips) → **Nowy**

Wybierz dostawcę **Ringostat** i wpisz numer telefonu projektu tak, jak widnieje w panelu
Ringostata. Po tym numerze Intum rozpoznaje, do którego numeru należy rozmowa.

## 4. SIP-y operatorów {#sipy}

Każdy pracownik, który ma dzwonić z karty klienta, potrzebuje w Intum [SIP-a](telefonia-voip/voip-sipy)
z dostawcą **Ringostat** i numerem VoIP z kroku 3. W polu SIP wpisz login SIP (numer wewnętrzny)
tego pracownika z panelu Ringostata.

Po tym samym loginie Intum przypisuje operatora do rozmów, które przychodzą z Ringostata.

## 5. Adres webhooka {#adres-webhooka}

> [!PATH]
> [Ustawienia Voip](app:/voip/settings) → **Dane do integracji** → **Ringostat** → **Wygeneruj adres webhooka**

Adres zawiera token przypisany do konta, dzięki czemu Ringostat trafia dokładnie na Twoje konto
w Intum, niezależnie od tego, pod jakim adresem się logujesz. Skopiuj go przyciskiem obok pola.

> [!WARNING]
> Traktuj ten adres jak hasło: kto go zna, może wysyłać zdarzenia połączeń na Twoje konto. Token
> da się w każdej chwili wyłączyć w [tokenach API](app:/account/api_tokens) - wtedy Ringostat
> dostanie błąd, a w ustawieniach pojawi się przycisk ponownego włączenia (dla administratora).

## 6. Webhook po stronie Ringostata {#webhook}

W panelu Ringostata: **Ustawienia → Integracja → Webhooks 2.0**. Dodaj dwa zdarzenia, oba na
skopiowany adres, metodą POST w formacie JSON:

- **Incoming call event** - połączenia przychodzące,
- **Outbound call event** - połączenia wychodzące.

Zalecany moment wysyłki to zakończenie rozmowy („after call”) - wtedy w zdarzeniu jest już czas
rozmowy i link do nagrania.

Zostaw w zdarzeniu domyślny zestaw pól. Intum potrzebuje z niego co najmniej numerów dzwoniącego
i odbierającego (**caller**, **callee**), typu i statusu połączenia, daty i czasów rozmowy. Bez
**callee** w zdarzeniu wychodzącym Intum nie połączy rozmowy z autocallem, który ją zlecił.

> [!WARNING]
> Ten krok wykonuje się w panelu Ringostata, nie w Intum. Jeśli nazwy ustawień się nie zgadzają,
> sprawdź aktualną dokumentację Ringostata albo skontaktuj się z ich supportem.

## Co trafia do Intum {#zakres}

- historia połączeń przychodzących i wychodzących z czasem rozmowy i statusem,
- dopasowanie rozmowy do klienta i kontaktu po numerze telefonu,
- link do nagrania rozmowy - na karcie rozmowy jako **Odsłuchaj nagranie**,
- dane kampanii przy połączeniach przychodzących - na karcie rozmowy w wierszu **Dane kampanii**,
- dzwonienie kliknięciem w numer na karcie klienta (centrala dzwoni najpierw do operatora, po
  odebraniu łączy z klientem),
- [autocall](telefonia-voip/voip-autocall) - oddzwanianie z widgetu „zamów rozmowę"; wynik rozmowy
  (odebrana, do ponowienia, nieudana) wraca do pozycji autocalla po zakończeniu połączenia.

Czego nie ma: podglądu stanu linii na żywo (Ringostat nie udostępnia CTI - do dzwonienia z
komputera służy ich własna aplikacja Ringostat Smart Phone) oraz analiz AI, które zostają w panelu
Ringostata.

## Statusy połączeń {#statusy}

Intum rozpoznaje statusy z [dziennika połączeń
Ringostata](https://help.ringostat.com/pl/articles/6413217-dziennik-polaczen-opis-statusow-rozmow):

- **odebrane** - `ANSWERED` i `PROPER`; różni je tylko to, czy rozmowa przekroczyła próg
  „połączenia docelowego” ustawiony w projekcie,
- **nieodebrane** - `NO ANSWER`, `FAILED`, `NO-FORWARD`, `VOICEMAIL`, `WRONG EXTENSION`,
  `NO EXTENSION`, `CLIENT NO ANSWER`, `FAILED FORBIDDEN DESTINATION` i `DECLINE`,
- **zajęte** - `BUSY` (wszyscy w schemacie przekierowań byli zajęci); w filtrze listy rozmów ma
  osobną pozycję, a w zakładce nieodebranych liczy się jak nieodebrane.

Status `REPEATED` mówi o miejscu rozmowy w cyklu sprzedażowym, a nie o tym, czy ktoś odebrał,
więc przy nim o odebraniu decyduje to, czy była rozmowa. Tak samo przy każdej wartości spoza listy -
status zapisujemy wtedy tak, jak przyszedł.

Czas trwania na liście rozmów to czas samej rozmowy, bez dzwonienia, tak jak u innych dostawców.
Nieodebrane połączenie ma więc czas pusty, nawet jeśli długo dzwoniło.