Hívásnapló — calls

Művelet	Mit tesz	Jog
GET `/calls/list`	hívások, szűrőkkel	`calls:read`
GET `/calls/get`	egy hívás	`calls:read`
GET `/calls/last`	egy felhasználó utolsó hívása	`calls:read`
GET `/calls/recording`	a hívás felvétele	`calls:recording`
GET `/calls/schema`	a mezők leírása	`calls:read`

Hívást a Hívásindítás indít.

A mezők

Mező	Régi	Típus		Listában	Leírás
`id`	`cdrid`	`integer`	csak olvasható	✓	belső azonosító
`direction`		`string`	csak olvasható	✓	`in` — bejövő, `out` — kimenő
`mode`		`string`	csak olvasható	✓	a hívás típusa — lent
`phoneNumber`	`phone_num`	`string`	csak olvasható	✓	az ügyfél száma
`extension`		`string`	csak olvasható	✓	a mellék
`queue`		`string`	csak olvasható	✓	a várakozási sor kódja
`ccNumber`	—	`string`	csak olvasható	✓	a saját szám: bejövőn a hívott, kimenőn a kijelzett szám; titkos számkijelzésnél `(-)` utótaggal
`projectId`	`prid`	`integer`	csak olvasható	✓	a projekt belső azonosítója
`projectCode`	`prcode`	`string`	csak olvasható	✓	a projekt külső azonosítója
`projectName`	`prname`	`string`	csak olvasható	✓	a projekt neve
`userId`	—	`integer`	csak olvasható	✓	a hívás felhasználója: kézi hívásnál a hívó, kiosztott hívásnál az operátor; üres, ha nincs
`userCode`	`user_code`	`string`	csak olvasható	✓	a felhasználó külső azonosítója
`userName`	`user_name`	`string`	csak olvasható	✓	a felhasználó neve
`userExtCode`	`user_extcode`	`string`	csak olvasható	✓	a felhasználó egyéb kódja
`interviewId`	`interviewid` · `recnum`	`integer`	csak olvasható	✓	az interjú, amelyikhez a hívás tartozik; üres, ha nincs
`interviewCode`	`interview_code`	`string`	csak olvasható	✓	az interjú kódja
`historyId`	`historyid`	`integer`	csak olvasható	✓	az interjú előzményének sora, amelyikhez a hívás tartozik
`listId`	`lsid`	`integer`	csak olvasható	✓	az ügyfél listája
`listCode`	`lscode`	`string`	csak olvasható	✓	a lista külső azonosítója
`listName`	—	`string`	csak olvasható	✓	a lista neve
`listItemId`	`listitem_num`	`integer`	csak olvasható	✓	az ügyfél listatétele
`listItemCode`	`extcode`	`string`	csak olvasható	✓	a listatétel külső azonosítója
`listItemName`	`client`	`string`	csak olvasható	✓	az ügyfél a lista első fejléc-oszlopából — listánként más adat
`contactNo`	`contact_num`	`integer`	csak olvasható	✓	a listatétel kontaktjának sorszáma
`contactName`	—	`string`	csak olvasható	✓	a kontakt neve
`startedAt`	`start_time`	`string`	csak olvasható	✓	a hívás kezdete
`queuedAt`	`dial_time`	`string`	csak olvasható	✓	a várakozási sorba kerülés
`connectedAt`	`connect_time`	`string`	csak olvasható	✓	a hívás kapcsolása
`agentStartedAt`	`op_connect_time`	`string`	csak olvasható	✓	az első operátor belépése a hívásba
`agentEndedAt`	`op_end_time`	`string`	csak olvasható	✓	az utolsó operátor beszélgetésének vége
`endedAt`	`end_time`	`string`	csak olvasható	✓	a hívás vége; a még tartó hívásnál üres
`waitSeconds`	—	`integer`	csak olvasható	✓	a várakozás másodpercben: kimenőn a kezdettől a kapcsolásig, bejövőn az első sorba kerüléstől az első operátorig
`lineSeconds`	`call_length`	`integer`	csak olvasható	✓	a kapcsolástól a hívás végéig, másodpercben
`talkSeconds`	—	`integer`	csak olvasható	✓	az operátorok beszélgetése a hívásban összesen, másodpercben
`afterAgentSeconds`	—	`integer`	csak olvasható	✓	az utolsó operátor kilépésétől a hívás végéig, másodpercben — például az utána következő értékelés
`durationSeconds`	—	`integer`	csak olvasható	✓	a hívás teljes hossza, másodpercben
`recording`	`has_mp3`	`string`	csak olvasható	✓	a felvétel: `available` — letölthető, `none` — nincs (nem készült, nincs felvétel-megőrzés, vagy a hívás még tart), `deleted` — törölték, `expired` — a megőrzési idő után törölték
`terminationId`	`termination`	`integer`	csak olvasható	✓	a lezárás belső azonosítója a projektben
`terminationCode`	`termination_code`	`string`	csak olvasható	✓	a lezárás kódja
`terminationName`	`termination_name`	`string`	csak olvasható	✓	a lezárás neve
`terminationDetail`	`termination_details`	`string`	csak olvasható	✓	a részletes lezárás
`note`	`termination_notes`	`string`	csak olvasható	✓	az operátor megjegyzése
`terminationReached`	`termination_reached`	`boolean`	csak olvasható	✓	a lezárás elért hívás
`terminationSuccessful`	`termination_successful`	`boolean`	csak olvasható	✓	a lezárás sikeres
`terminationFinal`	`termination_final`	`boolean`	csak olvasható	✓	a lezárás a listatételt véglegesen lezárja
`terminationCallback`	`termination_recall`	`boolean`	csak olvasható	✓	a lezárás visszahívást ütemez

A típus: manual (manuális) · predictive (prediktív) · inbound (bejövő) · office (irodai) · ivr (IVR kampány) · external (külső szám) · internal (belső) · ring (csörgetés).

GET `/calls/list` Hívások

A hívások, lapozva (A lapozás). A szűrők mind elhagyhatók:

Paraméter	Régi	Típus	Leírás
`startedSince` · `startedUntil`	`start_time` · `end_time`	`string`	a hívás kezdete ettől, eddig
`projectId` · `projectCode`	`prid` · `prcode`		a projekt hívásai
`userId` · `userCode`	—		a felhasználó hívásai
`direction`	—	`string`	`in` vagy `out`
`mode`	—	`string`	egy típus
`interviewId`	—	`integer`	egy interjú hívásai
`listId` · `listCode`	—		a lista ügyfeleinek hívásai
`listItemId`	—	`integer`	egy ügyfél hívásai
`phoneNumber`	—	`string`	az ügyfél száma ezzel kezdődik; csak a számjegyek számítanak, a `00` előtag nélkül, a `06` helyén `36`

A hívás a végéig változik, a lezárása pedig a vége után, az interjú lezárásakor kerül rá; a lista módosítási időre nem szűrhető. A még tartó hívást (üres endedAt) kérd le újra a get-tel; a lezárásokat az interjúk lezárásainak sora adja, a hívás azonosítójával (callId).

{
  "calls": [
    {
      "id": 8812345,
      "direction": "out",
      "mode": "predictive",
      "phoneNumber": "3610000001",
      "extension": "201",
      "queue": null,
      "ccNumber": "3610000099",
      "projectId": 12,
      "projectCode": "SALES",
      "projectName": "Őszi kampány",
      "userId": 57,
      "userCode": "HR-1042",
      "userName": "Kovács Anna",
      "userExtCode": null,
      "interviewId": 553201,
      "interviewCode": null,
      "historyId": 7790112,
      "listId": 3,
      "listCode": "OKT-2026",
      "listName": "Októberi lista",
      "listItemId": 884512,
      "listItemCode": "C-20931",
      "listItemName": "Szabó Péter",
      "contactNo": 1,
      "contactName": "Szabó Péter",
      "startedAt": "2026-10-19T09:12:04+02:00",
      "queuedAt": null,
      "connectedAt": "2026-10-19T09:12:15+02:00",
      "agentStartedAt": "2026-10-19T09:12:16+02:00",
      "agentEndedAt": "2026-10-19T09:15:02+02:00",
      "endedAt": "2026-10-19T09:15:03+02:00",
      "waitSeconds": 11,
      "lineSeconds": 168,
      "talkSeconds": 166,
      "afterAgentSeconds": 1,
      "durationSeconds": 179,
      "recording": "available",
      "terminationId": 4,
      "terminationCode": "SIKER",
      "terminationName": "Sikeres értékesítés",
      "terminationDetail": null,
      "note": null,
      "terminationReached": true,
      "terminationSuccessful": true,
      "terminationFinal": true,
      "terminationCallback": false
    }
  ],
  "hasMore": false
}

curl "$BASE/calls/list?projectCode=SALES&startedSince=2026-10-19T00:00:00" -H "X-API-Key: $API_KEY"

GET `/calls/get` Egy hívás

A hívás a lista mezőivel.

curl "$BASE/calls/get?id=8812345" -H "X-API-Key: $API_KEY"

GET `/calls/last` Egy felhasználó utolsó hívása

A felhasználó utolsó hívása, a kezdete szerint, a get alakjában. Ha az endedAt üres, a hívás még tart; ha a connectedAt sem üres, a felhasználó vonalban van.

Paraméter	Régi	Típus		Leírás
`userId` · `userCode`	`userid` · `user_code`		kötelező	a felhasználó

HTTP	`code`	Mikor
`400`	`INVALID_ARGUMENT`	se `userId`, se `userCode` · ismeretlen `userCode`
`404`	`NOT_FOUND`	a felhasználónak nincs hívása

curl "$BASE/calls/last?userCode=HR-1042" -H "X-API-Key: $API_KEY"

GET `/calls/recording` A hívás felvétele

A hívás felvétele MP3-ban (audio/mpeg): a válasz maga a fájl, Content-Disposition fejléccel. Felvétele a recording: available hívásnak van. A letöltés a rendszer hozzáférés-naplójába kerül, az API-kulcs nevén.

Paraméter	Régi	Típus		Leírás
`id`	`cdrid`	`integer`	kötelező	a hívás belső azonosítója

HTTP	`code`	Mikor
`404`	`NOT_FOUND`	a hívásnak nincs felvétele
`422`	`VALIDATION_FAILED`	a felvétel átmenetileg nem érhető el — később újra (`RECORDING_UNAVAILABLE`)
`429`	`RATE_LIMITED`	a kulccsal túl sok letöltés fut egyszerre — a `Retry-After` megmondja, mennyit várj

curl "$BASE/calls/recording?id=8812345" -H "X-API-Key: $API_KEY" -o call-8812345.mp3

GET `/calls/schema` A mezők leírása

A válasz alakja: A mezők leírása.

curl "$BASE/calls/schema" -H "X-API-Key: $API_KEY"

A régi API-ból

Cím	Kérés	Válasz	Működés
`cdr/list` → GET `/calls/list`	az `order_by` nincs: a lista azonosító szerint jön	a `cdrhash` és a `cdrcode` nincs; az irány, a típus és a felvétel szóval; az `other_data` helyett a `listItemName` és a `contactName`	a felvétel a `recording`-gal tölthető le
`cdr/get` → GET `/calls/get`	`cdrid` → `id`	mint a listában	—
`cdr/userstatus` → GET `/calls/last`	—	a `get` alakja; a `status` helyett az `endedAt` és a `connectedAt`	hívás nélkül `404`
`sound/getfile` · `sound/getfilebyhash` → GET `/calls/recording`	a hívás azonosítójával	—	API-kulccsal, `calls:recording` joggal
—	—	—	csak az újban: `calls/schema`

Hívásnapló — calls

A mezők

GET /calls/list Hívások

GET /calls/get Egy hívás

GET /calls/last Egy felhasználó utolsó hívása