Strona główna -> Integracje

Integracje IVR API — jak to działa

Integracja w otoContactCenter działa w czasie rzeczywistym: platforma wysyła do Twojej aplikacji zdarzenie (webhook), a Twoja aplikacja odsyła decyzję (Action) — co ma się wydarzyć dalej w rozmowie (komunikat, DTMF, routing, kolejka, połączenie, rozłączenie).

To podejście sprawdza się, gdy telefon ma działać zgodnie z procesem: priorytetem, SLA, opiekunem klienta, statusem sprawy albo godzinami pracy — a nie według jednego, sztywnego “drzewka IVR”.

Model rozmowy: zdarzenie → decyzja → akcja

Połączenie trafia na scenariusz IVR API.
Webhook (HTTP POST) wysyła do Twojej aplikacji JSON z kontekstem rozmowy.
Twoja aplikacja zwraca JSON: Action + opcjonalnie Session.
Platforma wykonuje akcję i jeśli trzeba — wyśle kolejne zdarzenie (pętla rozmowy).

Ten sam mechanizm pozwala budować zarówno proste IVR, jak i scenariusze “procesowe” (routing według danych z CRM/helpdesku).

Przykład: co przychodzi i co odsyłasz

Webhook (uproszczony): (w praktyce JSON jest przesyłany w POST w polu „request”)

{
  "request": {
    "FromNumber": "48123456789",
    "ToNumber": "48221234567",
    "ChannelStatus": "Connected",
    "UniqueCallId": "f95bccb5b1...",
    "Hash": "4fa0ff6d06...",
    "Event": { "EventName": "Connected", "EventData": "" },
    "Session": null
  }
}

Odpowiedź Twojej aplikacji (uproszczona):

{
  "Action": {
    "Type": "GetDTMF",
    "Prompt": "1",
    "Timeout": "1000",
    "MaxDigits": "10"
  },
  "Session": { "step": "ask_id" }
}

Potem dostajesz kolejne zdarzenie GetDTMF z wpisanymi cyframi (albo „timeout”), a Ty decydujesz co dalej: Play, Call..., kolejka, rozłączenie. :contentReference[oaicite:2]{index=2}

Przejdź do wybranego tematu

Start:

Przegląd integracji · Szybki start

Webhook:

Zdarzenia i pola · FAQ integracji

Sterowanie:

Akcje API · Samoobsługa (DTMF) · Kolejki i routing

Produkcja:

Stabilność · Bezpieczeństwo webhooka

Chcesz uruchomić pierwszy scenariusz?

Najkrótsza ścieżka to: prosty IVR → pierwszy routing → dopiero potem reguły według danych z systemów.