Integracja przez API - otoTelefon.pl

Czym jest IVR API i dla kogo?

IVR API to „inteligentna nakładka” na centralę telefoniczną. Połączenie trafia do specjalnego obiektu IVR, który kontaktuje się z Twoją aplikacją (przez HTTPS), przekazuje dane o połączeniu i czeka na odpowiedź – listę kroków do wykonania.

W praktyce to Twój system decyduje, co ma się dziać z dzwoniącym. Rozwiązanie jest idealne dla firm, które traktują telefonię jako część własnego ekosystemu IT:

software house’ów i integratorów budujących rozwiązania dla klientów,
firm korzystających intensywnie z CRM / systemów ticketowych,
call center i zespołów sprzedaży, które chcą „podpiąć” telefony pod swoje narzędzia,
serwisów SaaS, które chcą dodać klientom wbudowaną telefonię.

Co możesz zrobić przez IVR API?

Po stronie centrali masz zestaw gotowych „akcji” (np. odtwórz komunikat, poczekaj na cyfry, przełącz do kolejki). Twoja aplikacja zwraca listę takich akcji w odpowiedzi na zapytanie z centrali. Typowe scenariusze:

Decyzja, co zrobić z połączeniem – możesz przyjąć, rozłączyć lub przekierować połączenie (np. gdy numer jest na czarnej liście, dzwoni poza godzinami pracy VIP‑linii albo ma trafić od razu do opiekuna).
Dynamiczny wybór komunikatu – w zależności od danych z Twojej bazy (status zamówienia, termin wizyty, saldo, poziom SLA) odtwarzasz różny komunikat dla tego samego numeru.
Kierowanie do właściwej kolejki / konsultanta – po weryfikacji (np. ID klienta podanego tonowo, numeru telefonu) klient trafia od razu do dedykowanego opiekuna lub właściwej kolejki połączeń.
Automatyczne zakładanie / aktualizacja rekordów – przy każdym połączeniu możesz tworzyć zgłoszenia w helpdesku, aktualizować leady w CRM, dopisywać notatki do historii klienta.
Self‑service i ankiety telefoniczne – Twoja aplikacja decyduje, jakie pytanie zadać dalej, w zależności od odpowiedzi klienta (naciśniętych cyfr).
Obsługa kampanii i numerów trackingowych – każdy numer reklamowy może mieć swoją logikę, a dane o połączeniach wracają do Twojego systemu raportowego.

Jak firmy wykorzystują integrację przez API?

Wszystkie poniższe przykłady korzystają z tej samej mechaniki: centrala przekazuje dane o połączeniu, a Twoja aplikacja odsyła instrukcje, co zrobić dalej.

E‑commerce / sklepy internetowe

przy połączeniu klienta system rozpoznaje numer telefonu i otwiera konsultantowi kartę ostatniego zamówienia;
automatyczne komunikaty o statusie zamówienia („paczka jest w doręczeniu, przewidywany termin dostawy…”);
zliczanie skuteczności kampanii – połączenia z numerów trackingowych przypisywane do odpowiedniej kampanii w CRM.

Przychodnie i placówki medyczne

ekran rejestracji automatycznie pokazuje kartę pacjenta po numerze telefonu;
system sprawdza, czy pacjent ma dziś wizytę i odtwarza właściwy komunikat (godzina, gabinet, lekarz);
po zakończeniu rozmowy API dopisuje notatkę lub aktualizuje status wizyty w systemie medycznym.

IT / helpdesk / software house’y

każde połączenie automatycznie zakłada ticket w systemie zgłoszeń lub dopisuje komentarz do istniejącego;
priorytet i ścieżka obsługi zależą od poziomu SLA klienta (np. złoty / srebrny), odczytywanego z Twojej bazy;
po zakończeniu rozmowy konsultant jednym kliknięciem aktualizuje status zgłoszenia, a nagranie rozmowy jest podlinkowane jako historia kontaktu.

Finanse, windykacja, B2B call center

przy połączeniu agent widzi saldo klienta, listę faktur i historię przypomnień z systemu finansowego;
automatyczne komunikaty o zaległościach przed połączeniem z konsultantem;
statystyki kampanii (odebrane połączenia, wynik rozmowy) wracają przez API do Twojego systemu raportowego.

Jak wygląda integracja technicznie?

Z punktu widzenia programisty IVR API to wymiana zapytań HTTP(S) między centralą a Twoim serwerem. W dużym skrócie:

W panelu klienta włączasz dodatek Integracja przez API (IVR API) dla swojej centrali.
Tworzysz usługę IVR API i podajesz adres URL swojego skryptu, np. https://twoja-domena.pl/ivr-api.
Wskazujesz numer(y) stacjonarne lub obiekty IVR, które mają kierować połączenia do tego API (np. infolinia, numer działu serwisu, opcja w menu „wciśnij 4”).
Gdy klient dzwoni, centrala wysyła do Twojej aplikacji zapytanie z parametrami połączenia (numer dzwoniącego, numer docelowy, identyfikator sesji, wciśnięte cyfry DTMF itd.).
Twój skrypt analizuje dane, podejmuje decyzję – np. „odtwórz komunikat A, poczekaj na wybór, potem przekaż do kolejki B” – i odsyła odpowiedź w formacie JSON.
Centralka wykonuje te polecenia i, w razie potrzeby, ponownie odpyta Twój system na dalszych etapach rozmowy.

Szczegółowy opis formatu zapytań i odpowiedzi znajdziesz w dokumentacji IVR API. Po uruchomieniu usługi pomagamy dobrać najlepszy sposób integracji po stronie centrali, natomiast logika po stronie Twojej aplikacji pozostaje po Twojej stronie lub Twojego integratora.

Ile kosztuje integracja przez API?

IVR API jest dostępne jako dodatkowa opcja do każdego pakietu otoTelefon.

Integracja przez API: +250 zł netto / miesiąc – niezależnie od liczby użytkowników w Twoim pakiecie.
Opłata obejmuje utrzymanie i rozwój interfejsu API oraz wsparcie w zakresie konfiguracji po stronie centrali.

Aktualne ceny i ewentualne promocje zawsze znajdziesz w cenniku pakietów i dodatków.

Najczęstsze pytania o integrację przez API

Czy muszę być programistą, żeby skorzystać z IVR API?

Do codziennego korzystania z centrali nie potrzebujesz API – wszystkimi funkcjami zarządzasz z poziomu panelu klienta. IVR API jest przeznaczone dla firm, które dysponują własnym programistą lub współpracują z integratorem – to po jego stronie leży stworzenie skryptu obsługującego zapytania z centrali.

W jakiej technologii mogę pisać integrację?

W dowolnej – po stronie Twojej aplikacji może to być PHP, Python, .NET, Java, Node.js, Ruby lub inne środowisko, które potrafi przyjąć zapytanie HTTP(S) i odesłać odpowiedź w JSON. Po stronie centrali komunikacja odbywa się przez standardowe wywołania HTTP.

Czy IVR API jest potrzebne, żeby mieć IVR, kolejki i własne powitania?

Nie. powitania (IVR Player), kolejki połączeń i wirtualna centrala działają niezależnie od API. Integracja przez API jest potrzebna tylko wtedy, gdy chcesz, aby Twoje systemy (CRM, ERP, helpdesk) aktywnie sterowały scenariuszami połączeń.

Czy pomagacie w napisaniu kodu po stronie mojego systemu?

Zapewniamy dokumentację IVR API oraz wsparcie w zakresie konfiguracji po stronie centrali (tworzenie usług, przypisanie numerów itd.). Kod integracji po stronie Twojej aplikacji możesz zlecić swojemu zespołowi IT, zewnętrznemu software house’owi lub partnerowi‑integratorowi.

Czym różni się IVR API od Web Services API do faksu?

IVR API dotyczy połączeń głosowych – steruje tym, co dzieje się z telefonem klienta (komunikaty, kolejki, przekierowania). Web Services API do faksu służy do integracji faksu internetowego z aplikacjami (wysyłka i odbiór faksów z własnego systemu). To dwie osobne usługi – jeśli interesuje Cię integracja faksów, szczegóły znajdziesz na stronie o faksie internetowym.

Czy mogę testować API przed wdrożeniem na produkcję?

Tak. Możesz uruchomić IVR API na testowym numerze lub w osobnej konfiguracji, aby najpierw sprawdzić zachowanie integracji na kilku połączeniach wewnętrznych, a dopiero później podpiąć pod numer publiczny widoczny dla klientów.

Zobacz także

Integracja przez API najlepiej działa razem z innymi funkcjami systemu:

Centralka telefoniczna – baza całego systemu: numery, użytkownicy, IVR, kolejki.
Kolejka połączeń – obsługa większego ruchu telefonicznego w działach sprzedaży i serwisu.
Tryb call center – praca wielu konsultantów na jednym systemie, z pełną historią rozmów.
Nagrywanie rozmów – analiza jakości obsługi klienta i materiał szkoleniowy dla zespołu.
Faks internetowy – wysyłka i odbiór faksów przez e‑mail; dostępne jest też osobne Web Services API do integracji faksu z Twoimi systemami.

Chcesz, aby telefon „rozumiał” Twój CRM?

Załóż konto w usłudze otoTelefon, włącz integrację przez API i połącz swoją centralę telefoniczną z CRM, helpdeskiem lub własną aplikacją. Twoje systemy zaczną widzieć każde połączenie – i reagować na nie automatycznie.

Załóż konto Porozmawiaj z nami o integracji