Komunikoni më lehtë me klientët tuaj
Aplikacione për telefon dhe kompjuterPër zhvilluesGjendja e rrjetit Qendra e ndihmës

Voice API

Aplikacioni juaj.
Thirrjet tuaja.
Ju i kontrolloni.

Shtoni thirrje në aplikacionin tuaj. Me API-në e IllyVoIP mund të nisni dhe të pranoni thirrje, të luani audio, të merrni përgjigje dhe të përcaktoni hapin e radhës.

Shikoni API-nëShikoni një kërkesë API

Funksionet që ju duhen
për thirrjet në aplikacion.

Përdorni veprime të veçanta për të kontrolluar thirrjen në kohë reale ose ekzekutoni një varg veprimesh me një kërkesë të vetme.

Nisni dhe pranoni thirrje

Nisni thirrje dalëse ose përgjigjuni thirrjeve hyrëse të drejtuara te Voice API Control.

Shikoni dokumentacionin

Luani audio dhe merrni përgjigje

Luani audio, shndërroni tekstin në të folur dhe merrni përgjigje zanore ose zgjedhje nga tastiera e telefonuesit.

Shikoni dokumentacionin

Përcaktoni si vazhdon thirrja

Transferojeni, vendoseni në pritje, vazhdojeni, dërgoni tone DTMF ose përfundojeni thirrjen sipas logjikës së aplikacionit tuaj.

Shikoni dokumentacionin

Shembull i një vargu veprimesh

Përshëndetni.
Dëgjoni.
Zgjidhni hapin tjetër.

Kjo kërkesë luan një përshëndetje dhe merr një përgjigje zanore gjatë një thirrjeje ekzistuese. Aplikacioni juaj përcakton si do ta përdorë përgjigjen.

Autentikimi
X-Api-Key
Formati i kërkesës
application/json
I detyrueshëm për këtë endpoint
Idempotency-Key

Zëvendësoni vlerat shembull me të dhënat e autentikimit që ruhen në server dhe me një sesion të vlefshëm kontrolli të thirrjes. Ripërdorni të njëjtin çelës idempotence vetëm për një kërkesë identike.

Lexoni dokumentacionin për vargun e veprimeve
Përmbajtja e kërkesës · JSON
POST/api/v1/voice/call-control/execute
{
  "call_control_id": "YOUR_CALL_CONTROL_ID",
  "actions": [
    {
      "type": "speak",
      "text": "Welcome to our support line."
    },
    {
      "type": "gather",
      "input": "speech",
      "prompt_text": "How can we help?",
      "speech_language": "en-US",
      "timeout_ms": 8000,
      "save_as": "request"
    }
  ]
}

Thirrjet hyrëse

Numri juaj.
Përgjigjja nga aplikacioni juaj.

Drejtojeni një numër IllyVoIP te Voice API Control. Abonohuni në ngjarjen e ziles, përgjigjuni thirrjes që i plotëson kushtet dhe përdorni identifikuesin e kontrollit që kthehet për veprimet e mëtejshme.

Lexoni udhëzimin për thirrjet hyrëse
Numri i telefonitDrejtim te Voice API Control
Ngjarja e zilescall_ringing
Aplikacioni juajPërgjigjuni → kontrolloni thirrjen

Webhooks

Reagoni ndaj
ngjarjeve të thirrjes.

Pranoni njoftimet për ecurinë e thirrjes në endpoint-in e aplikacionit tuaj. Përdorini për të përditësuar të dhënat, për të ndjekur thirrjen ose për të nisur hapin tjetër në sistem.

Shikoni webhooks
call_initiatedcall_ringingcall_answeredcall_completed

Verifikoni nënshkrimet, konfirmoni shpejt pranimin dhe shmangni përpunimin e përsëritur sipas ID-së së ngjarjes. Ridërgimi mund të sjellë të njëjtën ngjarje më shumë se një herë.

Zgjidhni mjetet
për aplikacionin tuaj.

Përdorni kontrollin e thirrjeve sipas logjikës së aplikacionit dhe lidhni mjetet e tjera që ju nevojiten.

Webphone SDK

Shtoni thirrje nga shfletuesi në ndërfaqen tuaj me SDK-në e dokumentuar dhe autentikimin përmes tokenëve afatshkurtër.

Lexoni dokumentacionin e SDK-së

Asistentë zanorë me AI

Konfiguroni në portal një asistent për thirrjet hyrëse, me bazë njohurish dhe hapa të përcaktuar në editorin vizual.

Shikoni asistentët zanorë me AI

Para
integrimit të parë.

Pyetni ekipin tonë
A është Voice API e njëjtë me një lidhje SIP?+

Jo. Lidhja SIP shërben për të lidhur një sistem ose platformë telefonike. Voice API i lejon aplikacionit tuaj të kërkojë veprime gjatë thirrjes, si leximi i tekstit me zë, marrja e përgjigjeve dhe transferimi i thirrjes.

A mund të përdoret për thirrje hyrëse dhe dalëse?+

Po. Dokumentacioni përfshin nisjen e thirrjeve dalëse dhe përgjigjen ndaj thirrjeve hyrëse. Për thirrjet hyrëse, drejtojeni numrin te Voice API Control dhe ndiqni hapat e dokumentuar për ngjarjen e ziles dhe përgjigjen.

A mund të marr përgjigje zanore dhe zgjedhje me tastierë?+

Po. Endpoint-i gather mbështet të folurën dhe tonet DTMF. Në dokumentacion gjeni mundësitë e hyrjes, gjuhën dhe kohën e pritjes që mund të konfiguroni.

A mund t’i përdor funksionet zanore edhe jashtë një thirrjeje?+

Po. Dokumentacioni përfshin endpoint-e të veçanta për shndërrimin e të folurës në tekst dhe të tekstit në të folur. Përdorini për përpunim audioje jashtë thirrjeve; gjatë thirrjes përdorni veprimet gather dhe speak të Voice API.

Si tarifohen funksionet zanore?+

Në portal publikohen tarifat aktuale për shndërrimin e të folurës në tekst dhe të tekstit në të folur. Voice API i përdor këto tarifa për veprimet gather dhe speak. Kontrolloni edhe tarifat e thirrjeve që zbatohen për konfigurimin tuaj.

Ku duhet ta ruaj çelësin API?+

Çelësat API të llogarisë mbajini në aplikacionin që ekzekutohet në server. Për thirrjet nga shfletuesi përdorni tokenët afatshkurtër sipas dokumentacionit të Webphone SDK, pa ekspozuar çelësin API të llogarisë.

A mund ta shqyrtoj API-në para se ta lidh aplikacionin?+

Portali përfshin dokumentacionin e endpoint-eve, shembuj kërkesash dhe përgjigjesh, specifikimin OpenAPI dhe API Playground. Kërkesat nga Playground mund të kryejnë veprime reale, prandaj kontrolloni kërkesën para ekzekutimit.

Ndërtoni thirrjet
që i duhen aplikacionit tuaj.

Filloni me dokumentacionin e endpoint-eve dhe shembujt aktualë të kërkesave.

Hapni dokumentacionin e Voice APIBisedoni me ne