FAQ integracji IVR API
Najczęstsze pytania o wdrożenie webhooka, akcje, timeouty, bezpieczeństwo i dobre praktyki produkcyjne.
Najczęstsze pytania
Czy potrzebuję programisty?
Jeśli chcesz tylko IVR i kolejki — nie. Jeśli routing ma zależeć od danych z CRM/helpdesku (opiekun, SLA, status, priorytet), potrzebujesz prostego endpointu webhook (czyli logiki po stronie Twojej aplikacji).
Ile trwa wdrożenie?
Najkrótszy wariant (MVP) to: jedno zdarzenie → jedna decyzja → prosty routing. Zwykle da się to uruchomić szybko, a potem iteracyjnie dokładać reguły, DTMF i kolejne kolejki.
Jeśli celujesz w produkcję (fallback, monitoring, role, procedury), zaplanuj dodatkowy czas na stabilność i bezpieczeństwo.
Punkt startu: Szybki start.
Jak testować integrację bez ryzyka dla obsługi?
Najbezpieczniej zacząć od numeru testowego albo osobnej ścieżki IVR, tak żeby ruch klientów nie trafiał “na eksperyment”. Potem stopniowo przekierowujesz kolejne tematy na integrację.
Dobra praktyka: najpierw routing i kolejka, dopiero potem samoobsługa DTMF.
Co jeśli aplikacja nie odpowie?
Ustawiasz maksymalny czas oczekiwania na odpowiedź oraz działanie awaryjne (fallback). To jest element “production-ready”, który decyduje o przewidywalności obsługi: klient ma trafić do sensownej ścieżki nawet wtedy, gdy Twoja aplikacja ma chwilowy problem.
Zobacz: Stabilność integracji.
Czy webhook musi być po HTTPS?
Rekomendujemy HTTPS. Problemy z certyfikatem mogą skutkować błędem (np. 1003). Dodatkowo możesz weryfikować wywołania poprzez Hash i ograniczać dostęp (np. allowlista / reguły po IP), zależnie od Twojego środowiska.
Zobacz: Bezpieczeństwo webhooka.
Jakie błędy zdarzają się najczęściej?
Najczęściej spotykane to: 1002 (timeout), 1003 (SSL), 1004/1005 (domena/połączenie), 1006 (niepoprawna odpowiedź). Opis błędu dostajesz jako ErrorNo i ErrorMsg.
Szczegóły: Webhook (zdarzenia).
Czy mogę dzwonić na numery zewnętrzne?
Tak, ale musisz mieć włączone uprawnienie oraz skonfigurowane konto SIP dla połączeń wychodzących (w przeciwnym razie integracja zwróci błąd, np. 3001).
Zobacz: Akcje API.
Jak debugować integrację?
Loguj: UniqueCallId, EventName/EventData, czas odpowiedzi aplikacji i zwracaną Action. To pozwala szybko zobaczyć, gdzie rozmowa zmieniła ścieżkę i dlaczego.
W praktyce te 4 pola skracają diagnostykę z godzin do minut.
Co jest po mojej stronie, a co po stronie platformy?
Platforma dostarcza zdarzenia (webhook), wykonuje akcje (IVR/DTMF/routing/połączenia) i pilnuje przepływu rozmowy. Po Twojej stronie jest logika decyzyjna: reguły routingu, integracja z CRM/helpdeskiem i stan (Session).
Dlatego najlepsze wdrożenia zaczynają od prostego procesu i dopiero potem dokładają automatyzacje.
Chcesz ruszyć bez zgadywania?
Najpierw Quickstart, potem Webhook i Akcje, a na końcu pierwszy scenariusz routingu.