Integracja przez API (IVR API)
IVR API pozwala połączyć wirtualną centralę otoTelefon z Twoimi systemami – CRM, ERP, systemem ticketowym czy aplikacją www. Twoje oprogramowanie może w czasie rzeczywistym sterować obsługą połączenia: decydować, jaki komunikat odtworzyć, jakie pytanie zadać klientowi i dokąd przekierować rozmowę.
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?
Poniżej przykłady „branża → co robi IVR API”: centrala przekazuje dane o połączeniu, a Twoja aplikacja decyduje o komunikacie, pytaniu (DTMF) i przekierowaniu do właściwej kolejki lub osoby. Każdy przykład ma link do pełnego scenariusza branżowego.
E-commerce / sklepy internetowe
- rozpoznanie klienta po numerze i otwarcie karty zamówienia w CRM/panelu,
- dynamiczny komunikat zależny od statusu (np. wysyłka / zwrot / reklamacja),
- routing po temacie: zamówienia / zwroty / reklamacje → odpowiednia kolejka,
- numery trackingowe: automatyczne przypisanie połączenia do kampanii i źródła w CRM.
Przychodnie i placówki medyczne
- podgląd karty pacjenta po numerze telefonu (rejestracja widzi historię),
- komunikat zależny od danych z systemu (np. „masz dziś wizytę o…”),
- kierowanie do właściwej ścieżki: rejestracja / wyniki / teleporady → kolejka lub gabinet,
- po rozmowie: automatyczna notatka / zadanie do oddzwonienia w systemie.
Sprzedaż B2B / call center
- API dopina rozmowę do leada i pokazuje konsultantowi historię kontaktu,
- routing po priorytecie (VIP / kluczowi klienci / kampania) do właściwej kolejki lub opiekuna,
- automatyczne zapisy: wynik rozmowy, notatka, kolejny krok (follow-up) po zakończeniu połączenia.
IT / helpdesk / serwisy B2B
- automatyczne tworzenie ticketu lub dopisanie komentarza do istniejącego zgłoszenia,
- routing po SLA (np. złoty/srebrny) do właściwej kolejki i komunikatu,
- powiązanie nagrania rozmowy z ticketem jako historia kontaktu (opcjonalnie).
Hosting i domeny (wsparcie, awarie, billing)
- API sprawdza w systemie: status usług, zaległości, priorytet klienta,
- awarie → inna ścieżka (np. dyżur / kolejka krytyczna) niż billing czy sprzedaż,
- po rozmowie: automatyczne uzupełnienie ticketu o notatkę i wynik kontaktu.
Finanse, ubezpieczenia, windykacja
- identyfikacja klienta i podpowiedź: polisa/szkoda/zaległość w panelu konsultanta,
- komunikat i routing po typie sprawy (sprzedaż / szkody / odnowienia / rozliczenia),
- raportowanie kampanii i wyników rozmów do systemu analitycznego przez API.
Praca zdalna / hybrydowa
- API wybiera konsultanta po dostępności/grafiku i kieruje rozmowę bez „ręcznego przełączania”,
- spójne raportowanie i historia kontaktu w CRM niezależnie od lokalizacji pracownika,
- jedna logika obsługi dla biura, home office i terenu.
Branże, w których IVR API często robi największą różnicę
- Serwisy awaryjne – priorytety zgłoszeń i routing do dyżuru po typie awarii.
- Fotowoltaika – leady do CRM + routing po etapie (wycena/audyt/serwis).
- Pompy ciepła – sezonowość, szybkie przypisanie do instalatora/koordynatora/serwisu.
- Kompensacja mocy biernej – kwalifikacja leadów (audyt/analiza rachunków) i przypisanie opiekuna.
- Produkcja kosmetyków – routing po temacie (R&D/produkcja/logistyka) i notatki w CRM.
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.