Statisztikák — stats

Művelet	Mit tesz	Jog
GET /stats/project_summary_by_user	a projekt operátori bontása egy időszakra	stats:read
GET /stats/project_current_terminations	a projekt interjúinak mai állása lezárásonként	stats:read
GET /stats/project_terminations	a projekt lezárásai egy időszakban, lezárásonként	stats:read
GET /stats/project_service_level	az ügyfélszolgálati projekt szolgáltatási szintje egy időszakra	stats:read
GET /stats/project_traffic	a projekt forgalma a hét napjai és az órák szerint	stats:read
GET /stats/user_presence	a felhasználók napi jelenléte egy időszakra	stats:read
GET /stats/user_work_time	a felhasználók munkaideje és az idők bontása egy időszakra	stats:read
GET /stats/user_summary	a felhasználók összesítője egy időszakra, projektenként is	stats:read

GET /stats/project_summary_by_user Projekt operátori bontás

Ki mennyit dolgozott a projekten egy időszakban, és mit hozott: a projekt összege és operátoronként egy sor. Sort az az operátor kap, aki az időszakban a projekten dolgozott.

Paraméter	Régi	Típus		Leírás
projectId · projectCode	prid · prcode		kötelező	a projekt
startDate	start_date	string	kötelező	az időszak első napja
endDate	end_date	string	kötelező	az időszak utolsó napja — ez a nap is benne van; az időszak legfeljebb 31 nap
listId · listCode	lsid · lscode			csak a lista tételein végzett munka
excludeFlaggedUsers	—	boolean		true: kimaradnak azok a felhasználók, akiknek a szerepkörén be van állítva, hogy a szerepkör felhasználói nem jelennek meg a statisztikában

A válasz:

Mező	Régi	Típus	Leírás
projectId	prid	integer	a projekt belső azonosítója
projectCode	prcode	string	a projekt külső azonosítója
projectName	prname	string	a projekt neve
total	data	object	a projekt összege: a mutatók az összes operátorra
users		array	operátoronként egy sor, mappa, azon belül név szerint

Az operátor sora a felhasználó és a mutatói:

Mező	Régi	Típus	Leírás
userId	userid	integer	a felhasználó belső azonosítója
userCode	user_code	string	a felhasználó külső azonosítója
userName	user_name	string	a felhasználó neve
userExtCode	—	string	a felhasználó egyéb kódja
folderId	—	integer	a felhasználó mappája; üres, ha nincs
folderName	—	string	a mappa neve

A mutatók — a total-ban és az operátor sorában ugyanezek. Az idő egész másodperc, az óránkénti mutató a projekt-munkaidőhöz mér, a százalék és az óránkénti érték két tizedesre kerekített:

Mutató	Régi	Típus	Leírás
workSeconds	prj_time · work_time	integer	a projekten töltött munkaidő
predictiveWaitSeconds	predwait_time · ready_time	integer	a prediktív tárcsázóra várakozással töltött idő
terminationCount	total_num · num_all	integer	a lezárások száma: a projekten lezárt hívás-kísérletek
reachedCount	reached_num · num_reached	integer	az elért lezárások
reachedPerHour	reached_per_hour	number	elért lezárás óránként
successfulCount	successful_num · num_successful	integer	a sikeres lezárások
successfulPerHour	successful_per_hour	number	sikeres lezárás óránként
successfulPerReachedPercent	successful_per_reached_pct	number	a sikeres az elért százalékában
finalCount	closed_num · num_terminated	integer	a véglegesen lezárt kontaktok
callCount	cdr_num · num_all_dial	integer	az összes hívás: a kimenő indított és a bejövő
outboundCallCount	cdrout_num · num_out_dial	integer	a kimenő indított hívások, a prediktív és a manuális együtt
manualCallCount	mancdrout_num · cdroutman_num	integer	ebből az operátor által kézzel indított
outboundAnsweredCount	cdroutreached_num	integer	a kimenő hívások, amelyeket a hívott fél felvett
inboundCallCount	cdrin_dial · cdrin_num · num_in_dial	integer	a bejövő hívások
missedCallbackCount	—	integer	a nem fogadott bejövő hívás visszahívásai, amelyeket az operátor indított
rejectedOfferCount	num_denied_dial	integer	a nem fogadott hívás-ajánlatok: időtúllépés vagy elutasítás
callsPerHour	dial_per_hour · call_per_hour	number	hívás óránként
callOver30sCount	cdrplus30s_num	integer	a harminc másodpercnél hosszabb beszélgetések
avgTalkSeconds	cdrtime_avg	integer	az átlagos beszélgetés-hossz
avgInterviewSeconds	interviewtime_avg	integer	az átlagos interjú-idő
avgAfterCallSeconds	afterworktime_avg	integer	az átlagos utómunka-idő lezárásonként
interviewSeconds	interview_time	integer	az interjúban töltött idő: a kicsöngés, a beszélgetés és az utómunka együtt
ringSeconds	ring_time	integer	a kicsöngéssel töltött idő, manuális hívásnál
talkSeconds	cdr_time	integer	a beszélgetéssel töltött idő
afterCallSeconds	afterwork_time · post_prod_time	integer	az utómunkával töltött idő
afterCallOverrunSeconds	—	integer	az utómunka a megengedett utómunka-időn felül
shortBreakSeconds	shortbreak_time · short_break_time	integer	rövid szünet
lunchBreakSeconds	longbreak_time · long_break_time	integer	ebédszünet
trainingSeconds	training_time	integer	oktatással töltött idő
otherWorkSeconds	otherwork_time · other_work_time	integer	egyéb munkával töltött idő
externalWorkSeconds	extwork_time · ext_work_time	integer	külső munkával töltött idő
availableSeconds	reachable_time	integer	elérhető állapotban töltött idő
unavailableSeconds	notavailable_time · not_reachable_time	integer	a projekt-munkaidő maradéka: se elérhető, se interjú, se szünet, se belső hívás
internalCallSeconds	internalcall_time	integer	belső hívással töltött idő

A projekt-munkaidő és az óránkénti mutatók kimenő kampányon és ügyfélszolgálati projekten számolnak, máshol 0. A predictiveWaitSeconds csak kimenő kampányon, a missedCallbackCount és a rejectedOfferCount csak ügyfélszolgálati projekten számol.

Válasz 200application/json

{
  "projectId": 12,
  "projectCode": "SALES",
  "projectName": "Őszi kampány",
  "total": {
    "workSeconds": 25200,
    "predictiveWaitSeconds": 3600,
    "terminationCount": 120,
    "reachedCount": 60,
    "reachedPerHour": 8.57,
    "successfulCount": 12,
    "successfulPerHour": 1.71,
    "successfulPerReachedPercent": 20.0,
    "finalCount": 45,
    "callCount": 130,
    "outboundCallCount": 130,
    "manualCallCount": 10,
    "outboundAnsweredCount": 70,
    "inboundCallCount": 0,
    "missedCallbackCount": 0,
    "rejectedOfferCount": 0,
    "callsPerHour": 18.57,
    "callOver30sCount": 48,
    "avgTalkSeconds": 180,
    "avgInterviewSeconds": 135,
    "avgAfterCallSeconds": 20,
    "interviewSeconds": 16200,
    "ringSeconds": 1200,
    "talkSeconds": 12600,
    "afterCallSeconds": 2400,
    "afterCallOverrunSeconds": 300,
    "shortBreakSeconds": 1800,
    "lunchBreakSeconds": 1800,
    "trainingSeconds": 0,
    "otherWorkSeconds": 600,
    "externalWorkSeconds": 0,
    "availableSeconds": 1500,
    "unavailableSeconds": 300,
    "internalCallSeconds": 0
  },
  "users": [
    {
      "userId": 57,
      "userCode": "HR-1042",
      "userName": "Kovács Anna",
      "userExtCode": null,
      "folderId": 3,
      "folderName": "Kimenő csapat",
      "workSeconds": 25200,
      "predictiveWaitSeconds": 3600,
      "terminationCount": 120,
      "reachedCount": 60,
      "reachedPerHour": 8.57,
      "successfulCount": 12,
      "successfulPerHour": 1.71,
      "successfulPerReachedPercent": 20.0,
      "finalCount": 45,
      "callCount": 130,
      "outboundCallCount": 130,
      "manualCallCount": 10,
      "outboundAnsweredCount": 70,
      "inboundCallCount": 0,
      "missedCallbackCount": 0,
      "rejectedOfferCount": 0,
      "callsPerHour": 18.57,
      "callOver30sCount": 48,
      "avgTalkSeconds": 180,
      "avgInterviewSeconds": 135,
      "avgAfterCallSeconds": 20,
      "interviewSeconds": 16200,
      "ringSeconds": 1200,
      "talkSeconds": 12600,
      "afterCallSeconds": 2400,
      "afterCallOverrunSeconds": 300,
      "shortBreakSeconds": 1800,
      "lunchBreakSeconds": 1800,
      "trainingSeconds": 0,
      "otherWorkSeconds": 600,
      "externalWorkSeconds": 0,
      "availableSeconds": 1500,
      "unavailableSeconds": 300,
      "internalCallSeconds": 0
    }
  ]
}

HTTP	code	Mikor
400	INVALID_ARGUMENT	se projectId, se projectCode · ismeretlen projekt · ismeretlen listCode · hiányzó vagy hibás startDate, endDate · az endDate korábbi a startDate-nél · az időszak 31 napnál hosszabb

curl "$BASE/stats/project_summary_by_user?projectCode=SALES&startDate=2026-10-01&endDate=2026-10-31" -H "X-API-Key: $API_KEY"

GET /stats/project_current_terminations Aktuális lezárások

Hol tart ma a projekt: hány interjú áll az egyes lezárásokon. Pillanatkép, időszaka nincs.

Paraméter	Régi	Típus		Leírás
projectId · projectCode	prid · prcode		kötelező	a projekt
listId · listCode	lsid · lscode			csak a lista tételeinek interjúi

A válasz:

Mező	Régi	Típus	Leírás
projectId	—	integer	a projekt belső azonosítója
projectCode	—	string	a projekt külső azonosítója
projectName	—	string	a projekt neve
total		object	az összeg: count, az összes interjú
terminations		array	lezárásonként egy sor, a projekt lezárásainak sorrendjében

A lezárás sora:

Mező	Régi	Típus	Leírás
terminationId	termination_id	integer	a lezárás száma a projekten; 0 a még nem hívott rekordok sora
terminationCode	termination_code	string	a lezárás külső kódja
terminationName	termination_name	string	a lezárás neve
terminationReached	—	boolean	a lezárás elértnek számít
terminationSuccessful	—	boolean	a lezárás sikeresnek számít
terminationFinal	—	boolean	a lezárás véglegesen lezárja a kontaktot
terminationCallback	—	boolean	a lezárás visszahívást kér
count	interview_num	integer	az ezen a lezáráson álló interjúk száma
details	subterminations	array	a részlezárások: terminationDetail (a régi subtermination_name) és count

Válasz 200application/json

{
  "projectId": 12,
  "projectCode": "SALES",
  "projectName": "Őszi kampány",
  "total": {
    "count": 1500
  },
  "terminations": [
    {
      "terminationId": 0,
      "terminationCode": null,
      "terminationName": "Nem hívott",
      "terminationReached": false,
      "terminationSuccessful": false,
      "terminationFinal": false,
      "terminationCallback": false,
      "count": 600,
      "details": []
    },
    {
      "terminationId": 1,
      "terminationCode": "OK",
      "terminationName": "Sikeres",
      "terminationReached": true,
      "terminationSuccessful": true,
      "terminationFinal": true,
      "terminationCallback": false,
      "count": 240,
      "details": [
        {
          "terminationDetail": "Csomag A",
          "count": 150
        },
        {
          "terminationDetail": "Csomag B",
          "count": 90
        }
      ]
    },
    {
      "terminationId": 5,
      "terminationCode": "VH",
      "terminationName": "Visszahívás",
      "terminationReached": true,
      "terminationSuccessful": false,
      "terminationFinal": false,
      "terminationCallback": true,
      "count": 660,
      "details": []
    }
  ]
}

HTTP	code	Mikor
400	INVALID_ARGUMENT	se projectId, se projectCode · ismeretlen projekt · ismeretlen listCode

curl "$BASE/stats/project_current_terminations?projectCode=SALES" -H "X-API-Key: $API_KEY"

GET /stats/project_terminations Időszaki lezárások

Mi történt a projekten egy időszakban: hány lezárás született az egyes lezárás-kódokon. Egy interjú annyiszor számít, ahányszor az időszakban lezárták.

Paraméter	Régi	Típus		Leírás
projectId · projectCode	prid · prcode		kötelező	a projekt
startDate	start_date	string	kötelező	az időszak első napja
endDate	end_date	string	kötelező	az időszak utolsó napja — ez a nap is benne van; az időszak legfeljebb 31 nap
listId · listCode	lsid · lscode			csak a lista tételein született lezárások
excludeFlaggedUsers	—	boolean		true: kimaradnak azok a felhasználók, akiknek a szerepkörén be van állítva, hogy a szerepkör felhasználói nem jelennek meg a statisztikában

A válasz alakja az aktuális lezárásoké: a projekt, a total és a terminations sorai, ugyanazokkal a mezőkkel. A count itt a lezárások száma, és a még nem hívott rekordok sora nincs benne.

HTTP	code	Mikor
400	INVALID_ARGUMENT	se projectId, se projectCode · ismeretlen projekt · ismeretlen listCode · hiányzó vagy hibás startDate, endDate · az endDate korábbi a startDate-nél · az időszak 31 napnál hosszabb

curl "$BASE/stats/project_terminations?projectCode=SALES&startDate=2026-10-01&endDate=2026-10-31" -H "X-API-Key: $API_KEY"

GET /stats/project_service_level Szolgáltatási szint

Hogyan fogadta az ügyfélszolgálat a hívásokat egy időszakban: a bejövő, a fogadott és az elveszett hívások és a várakozás, a választott bontás soraiban. Ügyfélszolgálati projekten számol; más projekten a sorok üresek.

Paraméter	Régi	Típus		Leírás
projectId · projectCode	prid · prcode		kötelező	a projekt
startDate	start_date	string	kötelező	az időszak első napja
endDate	end_date	string	kötelező	az időszak utolsó napja — ez a nap is benne van; az időszak legfeljebb 31 nap
groupBy	type	string		a sorok bontása: day (alap) · hour · half_hour · month · queue (várakozási soronként)
includeCallbacks	—	boolean		true: az elveszett, de az időkorláton belül visszahívott hívás a fogadottak közé számít

A válasz:

Mező	Régi	Típus	Leírás
projectId	prid	integer	a projekt belső azonosítója
projectCode	prcode	string	a projekt külső azonosítója
projectName	prname	string	a projekt neve
callbackLimitMinutes	—	integer	a visszahívás időkorlátja percben, a rendszer beállítása
rows	rows	array	a bontás sorai

A sor kulcsa a bontás szerint egy mező:

Mező	Régi	Típus	Leírás
date	group_name	string	a nap — day
hour	group_name	integer	az óra, 0–23 — hour
time	group_name	string	a félóra kezdete, 08:30 alakban — half_hour
month	group_name	string	a hónap, 2026-10 alakban — month
queueName	group_name	string	a várakozási sor neve — queue

A sor mutatói. A százalék alapja a bejövő hívások, az IVR-ben véget ért és a zárva tartás alatt érkezett hívások nélkül — a queue bontásban mind; két tizedesre kerekített, és 0, ha nincs alapja:

Mutató	Régi	Típus	Leírás
inboundCallCount	total_num	integer	a bejövő hívások
answeredCount	reached_num	integer	a fogadott hívások
answeredPercent	reached_pct	number	a fogadott hívások aránya
lostCount	missedcalls_num	integer	a sorban vagy az ügyeleten várva elveszett hívások
lostPercent	missedcalls_pct	number	az elveszett hívások aránya
answeredIn30sCount · answeredIn60sCount · answeredIn120sCount	answer30_num · answer60_num · answer120_num	integer	a 30, 60 és 120 másodpercen belül fogadott hívások
answeredIn30sPercent · answeredIn60sPercent · answeredIn120sPercent	answer30_pct · answer60_pct · answer120_pct	number	ugyanezek aránya
serviceLevelPercent	totalsla_pct	number	a szolgáltatási szint: a fogadott hívások aránya
avgWaitSeconds	waitingtime_avg	integer	az átlagos várakozás a sorban
maxWaitSeconds	waitingtime_max	integer	a leghosszabb várakozás a sorban
waitOver5mCount	waitingtime_plus5m_num	integer	az öt percnél tovább várakozó hívások
calledBackCount	callbackin15m_num	integer	a sorban elveszett hívások közül az időkorláton belül visszahívottak
notCalledBackCount	—	integer	az elveszett hívások közül az időkorláton belül vissza nem hívottak
avgCallbackSeconds	callbacktime_avg	integer	az elveszett hívás és a visszahívás közti átlagos idő
ivrEndedCount	ivrdrop_num	integer	az IVR-ben véget ért hívások — a queue bontásban nincs
closedHoursCount	closed_num	integer	a zárva tartás alatt érkezett hívások — a queue bontásban nincs
redirectedCount	redirect_num	integer	az átirányított hívások — a queue bontásban nincs
onDutyCount	duty_num	integer	az ügyeletre ment hívások — a queue bontásban nincs
outboundCallCount	cdrout_num	integer	a projekten indított hívások — a queue bontásban nincs

Válasz 200application/json

{
  "projectId": 21,
  "projectCode": "HELPDESK",
  "projectName": "Ügyfélszolgálat",
  "callbackLimitMinutes": 15,
  "rows": [
    {
      "date": "2026-10-01",
      "inboundCallCount": 420,
      "answeredCount": 380,
      "answeredPercent": 92.68,
      "lostCount": 30,
      "lostPercent": 7.32,
      "answeredIn30sCount": 310,
      "answeredIn60sCount": 350,
      "answeredIn120sCount": 372,
      "answeredIn30sPercent": 75.61,
      "answeredIn60sPercent": 85.37,
      "answeredIn120sPercent": 90.73,
      "serviceLevelPercent": 92.68,
      "avgWaitSeconds": 24,
      "maxWaitSeconds": 410,
      "waitOver5mCount": 3,
      "calledBackCount": 18,
      "notCalledBackCount": 12,
      "avgCallbackSeconds": 540,
      "ivrEndedCount": 10,
      "closedHoursCount": 0,
      "redirectedCount": 4,
      "onDutyCount": 0,
      "outboundCallCount": 95
    }
  ]
}

HTTP	code	Mikor
400	INVALID_ARGUMENT	se projectId, se projectCode · ismeretlen projekt · hiányzó vagy hibás startDate, endDate · az endDate korábbi a startDate-nél · az időszak 31 napnál hosszabb · ismeretlen groupBy

curl "$BASE/stats/project_service_level?projectCode=HELPDESK&startDate=2026-10-01&endDate=2026-10-31&groupBy=hour" -H "X-API-Key: $API_KEY"

GET /stats/project_traffic Forgalom

Mikor van forgalom a projekten: az időszak a hét napjai és az órák celláiban — kimenő kampányon a lezárásokkal, ügyfélszolgálati projekten a hívásokkal. Cellát az az óra kap, amelyben volt forgalom.

Paraméter	Régi	Típus		Leírás
projectId · projectCode	prid · prcode		kötelező	a projekt: kimenő kampány vagy ügyfélszolgálati projekt
startDate	start_date	string	kötelező	az időszak első napja
endDate	end_date	string	kötelező	az időszak utolsó napja — ez a nap is benne van; az időszak legfeljebb 31 nap
excludeFlaggedUsers	—	boolean		true: kimaradnak azok a felhasználók, akiknek a szerepkörén be van állítva, hogy a szerepkör felhasználói nem jelennek meg a statisztikában

A válasz:

Mező	Régi	Típus	Leírás
projectId	—	integer	a projekt belső azonosítója
projectCode	—	string	a projekt külső azonosítója
projectName	—	string	a projekt neve
cells	hours	array	a cellák hétfőtől vasárnapig, azon belül óra szerint

A cella:

Mező	Régi	Típus	Leírás
weekday	dayname	string	a hét napja: monday · tuesday · wednesday · thursday · friday · saturday · sunday
hour	hour	integer	az óra, 0–23

Kimenő kampányon a cella mutatói — a százalék két tizedesre kerekített:

Mutató	Régi	Típus	Leírás
terminationCount	total_num	integer	a lezárások
reachedCount	reached_num	integer	az elért lezárások
successfulCount	successful_num	integer	a sikeres lezárások
userCount	operator_num	integer	a cellában lezáró operátorok száma
reachedPercent	—	number	az elért a lezárások százalékában
successfulPercent	—	number	a sikeres a lezárások százalékában
successfulPerReachedPercent	—	number	a sikeres az elért százalékában

Ügyfélszolgálati projekten:

Mutató	Régi	Típus	Leírás
inboundCallCount	total_num	integer	a bejövő hívások
outboundCallCount	—	integer	az indított hívások
answeredCount	reached_num	integer	a fogadott hívások
lostCount	missedcalls_num	integer	a sorban várva elveszett hívások
avgWaitSeconds	waitingtime_avg	integer	az átlagos várakozás a sorban

Válasz 200application/json

{
  "projectId": 12,
  "projectCode": "SALES",
  "projectName": "Őszi kampány",
  "cells": [
    {
      "weekday": "monday",
      "hour": 9,
      "terminationCount": 140,
      "reachedCount": 70,
      "successfulCount": 14,
      "userCount": 6,
      "reachedPercent": 50.0,
      "successfulPercent": 10.0,
      "successfulPerReachedPercent": 20.0
    },
    {
      "weekday": "monday",
      "hour": 10,
      "terminationCount": 160,
      "reachedCount": 72,
      "successfulCount": 18,
      "userCount": 7,
      "reachedPercent": 45.0,
      "successfulPercent": 11.25,
      "successfulPerReachedPercent": 25.0
    }
  ]
}

HTTP	code	Mikor
400	INVALID_ARGUMENT	se projectId, se projectCode · ismeretlen projekt · a projekt se nem kimenő kampány, se nem ügyfélszolgálati · hiányzó vagy hibás startDate, endDate · az endDate korábbi a startDate-nél · az időszak 31 napnál hosszabb

curl "$BASE/stats/project_traffic?projectCode=SALES&startDate=2026-10-01&endDate=2026-10-31" -H "X-API-Key: $API_KEY"

GET /stats/user_presence Jelenlét

Ki mikor dolgozott: felhasználónként a napjai, az első belépéssel, az utolsó kilépéssel és a napi munkaidővel. Sort az a felhasználó kap, aki az időszakban belépett.

Paraméter	Régi	Típus		Leírás
startDate	start_date	string	kötelező	az időszak első napja
endDate	end_date	string	kötelező	az időszak utolsó napja — ez a nap is benne van; az időszak legfeljebb 31 nap
userId · userCode	userid · user_code			csak ennek a felhasználónak a napjai
excludeFlaggedUsers	—	boolean		true: kimaradnak azok a felhasználók, akiknek a szerepkörén be van állítva, hogy a szerepkör felhasználói nem jelennek meg a statisztikában

A válasz:

Mező	Régi	Típus	Leírás
users		array	felhasználónként egy sor, mappa, azon belül név szerint

A felhasználó sora:

Mező	Régi	Típus	Leírás
userId	userid	integer	a felhasználó belső azonosítója
userCode	user_code	string	a felhasználó külső azonosítója
userName	user_name	string	a felhasználó neve
userExtCode	user_extcode	string	a felhasználó egyéb kódja
folderId	folderid	integer	a felhasználó mappája; üres, ha nincs
folderName	foldername	string	a mappa neve
days		array	naponként egy sor, időrendben — csak azok a napok, amelyeken belépett

A nap sora:

Mező	Régi	Típus	Leírás
date		string	a nap
startedAt	start	string	a nap első belépése
endedAt	end	string	a nap utolsó kilépése; aki még be van lépve, annál percenként frissül
workSeconds	work_time_sec	integer	a napi munkaidő másodpercben: a napon kezdett belépések hossza együtt

Válasz 200application/json

{
  "users": [
    {
      "userId": 57,
      "userCode": "HR-1042",
      "userName": "Kovács Anna",
      "userExtCode": null,
      "folderId": 3,
      "folderName": "Kimenő csapat",
      "days": [
        {
          "date": "2026-10-01",
          "startedAt": "2026-10-01T08:01:12+02:00",
          "endedAt": "2026-10-01T16:32:40+02:00",
          "workSeconds": 28800
        },
        {
          "date": "2026-10-02",
          "startedAt": "2026-10-02T07:58:03+02:00",
          "endedAt": "2026-10-02T16:05:19+02:00",
          "workSeconds": 27900
        }
      ]
    }
  ]
}

HTTP	code	Mikor
400	INVALID_ARGUMENT	hiányzó vagy hibás startDate, endDate · az endDate korábbi a startDate-nél · az időszak 31 napnál hosszabb · ismeretlen userCode

curl "$BASE/stats/user_presence?startDate=2026-10-01&endDate=2026-10-31" -H "X-API-Key: $API_KEY"

GET /stats/user_work_time Munkaidő

Ki mennyit dolgozott egy időszakban, és mivel telt az ideje: az összeg és felhasználónként egy sor. Sort az a felhasználó kap, aki az időszakban belépett.

Paraméter	Régi	Típus		Leírás
startDate	start_date	string	kötelező	az időszak első napja
endDate	end_date	string	kötelező	az időszak utolsó napja — ez a nap is benne van; az időszak legfeljebb 31 nap
userId · userCode	—			csak ennek a felhasználónak a sora
excludeFlaggedUsers	—	boolean		true: kimaradnak azok a felhasználók, akiknek a szerepkörén be van állítva, hogy a szerepkör felhasználói nem jelennek meg a statisztikában

A válasz:

Mező	Régi	Típus	Leírás
total		object	az összeg: a mutatók az összes felhasználóra
users		array	felhasználónként egy sor, mappa, azon belül név szerint

A felhasználó sora a felhasználó — userId, userCode, userName, userExtCode, folderId, folderName, mint a jelenlétnél — és a mutatói. A mutatók a total-ban és a felhasználó sorában ugyanezek; az idő egész másodperc:

Mutató	Régi	Típus	Leírás
workSeconds	work_time	integer	a belépve töltött munkaidő
workDayCount	workdays_num	integer	a munkanapok száma
correctedWorkSeconds	correctedwork_time	integer	a munkaidő a szünetek nélkül
availableSeconds	available_time	integer	elérhető állapotban töltött idő
unavailableSeconds	notavailable_time	integer	a munkaidő maradéka: se elérhető, se interjú, se szünet, se belső hívás
outboundProjectSeconds	ccoutprj_time	integer	kimenő kampányon töltött idő
predictiveWaitSeconds	predwait_time	integer	a prediktív tárcsázóra várakozással töltött idő
interviewSeconds	interview_time	integer	az interjúban töltött idő: a kicsöngés, a beszélgetés és az utómunka együtt
ringSeconds	ring_time	integer	a kicsöngéssel töltött idő, manuális hívásnál
talkSeconds	cdr_time	integer	a beszélgetéssel töltött idő
afterCallSeconds	afterwork_time	integer	az utómunkával töltött idő
afterCallOverrunSeconds	—	integer	az utómunka a megengedett utómunka-időn felül
shortBreakSeconds	shortbreak_time	integer	rövid szünet
lunchBreakSeconds	launchbreak_time	integer	ebédszünet
trainingSeconds	training_time	integer	oktatással töltött idő
otherWorkSeconds	otherwork_time	integer	egyéb munkával töltött idő
externalWorkSeconds	extwork_time	integer	külső munkával töltött idő
internalCallSeconds	internalcall_time	integer	belső hívással töltött idő

Válasz 200application/json

{
  "total": {
    "workSeconds": 540000,
    "workDayCount": 21,
    "correctedWorkSeconds": 486000,
    "availableSeconds": 90000,
    "unavailableSeconds": 30600,
    "outboundProjectSeconds": 410400,
    "predictiveWaitSeconds": 72000,
    "interviewSeconds": 345600,
    "ringSeconds": 21600,
    "talkSeconds": 259200,
    "afterCallSeconds": 64800,
    "afterCallOverrunSeconds": 3600,
    "shortBreakSeconds": 27000,
    "lunchBreakSeconds": 27000,
    "trainingSeconds": 7200,
    "otherWorkSeconds": 10800,
    "externalWorkSeconds": 0,
    "internalCallSeconds": 1800
  },
  "users": [
    {
      "userId": 57,
      "userCode": "HR-1042",
      "userName": "Kovács Anna",
      "userExtCode": null,
      "folderId": 3,
      "folderName": "Kimenő csapat",
      "workSeconds": 540000,
      "workDayCount": 21,
      "correctedWorkSeconds": 486000,
      "availableSeconds": 90000,
      "unavailableSeconds": 30600,
      "outboundProjectSeconds": 410400,
      "predictiveWaitSeconds": 72000,
      "interviewSeconds": 345600,
      "ringSeconds": 21600,
      "talkSeconds": 259200,
      "afterCallSeconds": 64800,
      "afterCallOverrunSeconds": 3600,
      "shortBreakSeconds": 27000,
      "lunchBreakSeconds": 27000,
      "trainingSeconds": 7200,
      "otherWorkSeconds": 10800,
      "externalWorkSeconds": 0,
      "internalCallSeconds": 1800
    }
  ]
}

HTTP	code	Mikor
400	INVALID_ARGUMENT	hiányzó vagy hibás startDate, endDate · az endDate korábbi a startDate-nél · az időszak 31 napnál hosszabb · ismeretlen userCode

curl "$BASE/stats/user_work_time?startDate=2026-10-01&endDate=2026-10-31" -H "X-API-Key: $API_KEY"

GET /stats/user_summary Operátori összesítő

Ki mennyit dolgozott és mit hozott egy időszakban, projektenként is: az összeg, felhasználónként egy sor, és alatta a projektjei. A paraméterei és a hibái a munkaidő paraméterei és hibái.

A válasz:

Mező	Régi	Típus	Leírás
total		object	az összeg: az idők és a darabok az összes felhasználóra
users		array	felhasználónként egy sor, mappa, azon belül név szerint

A felhasználó sora a felhasználó, a munkaidő mutatói, és:

Mező	Régi	Típus	Leírás
terminationCount · reachedCount · successfulCount · finalCount	total_num · reached_num · successful_num · closed_num	integer	a lezárások a felhasználó összes projektjén: mind, az elért, a sikeres és a véglegesen lezárt
callCount · outboundCallCount · manualCallCount · outboundAnsweredCount · inboundCallCount · missedCallbackCount · rejectedOfferCount · callOver30sCount	cdr_num · cdrout_num · cdroutman_num · cdroutanswered_num · cdrin_num · cdrmissedcallback_num · — · cdrplus30s_num	integer	a hívások, mint a projekt operátori bontásában
reachedPerHour · successfulPerHour · callsPerHour	reached_per_hour · successful_per_hour · call_per_hour	number	óránként, a felhasználó munkaidejéhez mérve
successfulPerReachedPercent	successful_per_reached_pct	number	a sikeres az elért százalékában
avgTalkSeconds · avgInterviewSeconds · avgAfterCallSeconds	cdrtime_avg · interviewtime_avg · afterworktime_avg	integer	az átlagos beszélgetés-hossz, interjú-idő és utómunka-idő
projects		array	projektenként egy sor: a projekt (projectId, projectCode, projectName) és a mutatói — ugyanazok, ugyanazon a néven, mint a projekt operátori bontásának sorában

A total az időket és a darabokat adja, projects nélkül.

Válasz 200application/json

{
  "total": {
    "workSeconds": 540000,
    "workDayCount": 21,
    "correctedWorkSeconds": 486000,
    "availableSeconds": 90000,
    "unavailableSeconds": 30600,
    "outboundProjectSeconds": 410400,
    "predictiveWaitSeconds": 72000,
    "interviewSeconds": 345600,
    "ringSeconds": 21600,
    "talkSeconds": 259200,
    "afterCallSeconds": 64800,
    "afterCallOverrunSeconds": 3600,
    "shortBreakSeconds": 27000,
    "lunchBreakSeconds": 27000,
    "trainingSeconds": 7200,
    "otherWorkSeconds": 10800,
    "externalWorkSeconds": 0,
    "internalCallSeconds": 1800,
    "terminationCount": 2400,
    "reachedCount": 1200,
    "reachedPerHour": 8.0,
    "successfulCount": 240,
    "successfulPerHour": 1.6,
    "successfulPerReachedPercent": 20.0,
    "finalCount": 900,
    "callCount": 2600,
    "outboundCallCount": 2600,
    "manualCallCount": 200,
    "outboundAnsweredCount": 1400,
    "inboundCallCount": 0,
    "missedCallbackCount": 0,
    "rejectedOfferCount": 0,
    "callsPerHour": 17.33,
    "callOver30sCount": 960,
    "avgTalkSeconds": 185,
    "avgInterviewSeconds": 144,
    "avgAfterCallSeconds": 27
  },
  "users": [
    {
      "userId": 57,
      "userCode": "HR-1042",
      "userName": "Kovács Anna",
      "userExtCode": null,
      "folderId": 3,
      "folderName": "Kimenő csapat",
      "workSeconds": 540000,
      "workDayCount": 21,
      "correctedWorkSeconds": 486000,
      "availableSeconds": 90000,
      "unavailableSeconds": 30600,
      "outboundProjectSeconds": 410400,
      "predictiveWaitSeconds": 72000,
      "interviewSeconds": 345600,
      "ringSeconds": 21600,
      "talkSeconds": 259200,
      "afterCallSeconds": 64800,
      "afterCallOverrunSeconds": 3600,
      "shortBreakSeconds": 27000,
      "lunchBreakSeconds": 27000,
      "trainingSeconds": 7200,
      "otherWorkSeconds": 10800,
      "externalWorkSeconds": 0,
      "internalCallSeconds": 1800,
      "terminationCount": 2400,
      "reachedCount": 1200,
      "reachedPerHour": 8.0,
      "successfulCount": 240,
      "successfulPerHour": 1.6,
      "successfulPerReachedPercent": 20.0,
      "finalCount": 900,
      "callCount": 2600,
      "outboundCallCount": 2600,
      "manualCallCount": 200,
      "outboundAnsweredCount": 1400,
      "inboundCallCount": 0,
      "missedCallbackCount": 0,
      "rejectedOfferCount": 0,
      "callsPerHour": 17.33,
      "callOver30sCount": 960,
      "avgTalkSeconds": 185,
      "avgInterviewSeconds": 144,
      "avgAfterCallSeconds": 27,
      "projects": [
        {
          "projectId": 12,
          "projectCode": "SALES",
          "projectName": "Őszi kampány",
          "workSeconds": 410400,
          "predictiveWaitSeconds": 72000,
          "terminationCount": 2400,
          "reachedCount": 1200,
          "reachedPerHour": 10.53,
          "successfulCount": 240,
          "successfulPerHour": 2.11,
          "successfulPerReachedPercent": 20.0,
          "finalCount": 900,
          "callCount": 2600,
          "outboundCallCount": 2600,
          "manualCallCount": 200,
          "outboundAnsweredCount": 1400,
          "inboundCallCount": 0,
          "missedCallbackCount": 0,
          "rejectedOfferCount": 0,
          "callsPerHour": 22.81,
          "callOver30sCount": 960,
          "avgTalkSeconds": 185,
          "avgInterviewSeconds": 144,
          "avgAfterCallSeconds": 27,
          "interviewSeconds": 345600,
          "ringSeconds": 21600,
          "talkSeconds": 259200,
          "afterCallSeconds": 64800,
          "afterCallOverrunSeconds": 3600,
          "shortBreakSeconds": 0,
          "lunchBreakSeconds": 0,
          "trainingSeconds": 0,
          "otherWorkSeconds": 0,
          "externalWorkSeconds": 0,
          "availableSeconds": 3600,
          "unavailableSeconds": 0,
          "internalCallSeconds": 0
        }
      ]
    }
  ]
}

curl "$BASE/stats/user_summary?startDate=2026-10-01&endDate=2026-10-31" -H "X-API-Key: $API_KEY"

A régi API-ból

Cím	Kérés	Válasz	Működés
stats/prj_sla → GET /stats/project_service_level	a type száma helyett a groupBy szava · a projekt, a startDate és az endDate kötelező · az időszak legfeljebb 31 nap	a projekt mezői a gyökérben · a sor mutatói a sorában, nem a data alatt · a sor kulcsa a bontás szerinti mező, nem a group_name · a queue bontás sorai a rows alatt, nem a projekt queues-ában	a projekt nélküli, várakozási sor szerinti kérés nincs · a visszahívás beszámítása kérhető (includeCallbacks)
stats/sla → GET /stats/project_service_level	a grouping helyett a groupBy · az időszak legfeljebb 31 nap	a sorok a rows alatt (days, hours, months volt), a prj_sla utódjának mezőivel · az idő egész másodperc, nem szöveg
stats/prj_traffic → GET /stats/project_traffic	a startDate és az endDate kötelező · az időszak legfeljebb 31 nap	a cellák a cells alatt (hours volt), hétfőtől, óra szerint · a nap a weekday szava · a cella mutatói a sorában, nem a data alatt · az arányok és ügyfélszolgálati projekten az indított hívások is kijönnek
stats/prj_actualterms → GET /stats/project_current_terminations		a projekt mezői a gyökérben · a darab a lezárás sorában (count), nem a data alatt · a lezárás jelzői is kijönnek
stats/prj_intervalterms → GET /stats/project_terminations	a startDate és az endDate kötelező · az időszak legfeljebb 31 nap	mint az aktuális lezárásoknál
stats/termstat → GET /stats/project_current_terminations · GET /stats/project_terminations	a history nincs: a mai állás az egyik, az időszak lezárásai a másik művelet · az időszakin a startDate és az endDate kötelező	a sorok a terminations alatt, a részlezárásokkal és a lezárás jelzőivel	a mai állás időszakkal nem szűkíthető
stats/worktime → GET /stats/user_presence	az időszak legfeljebb 31 nap	felhasználónként a napok (users → days), nem naponként a felhasználók (workdays → users) · a work_time szöveg nincs: a másodperc a workSeconds
stats/op_presence → GET /stats/user_presence	a type nincs · a startDate és az endDate kötelező · az időszak legfeljebb 31 nap	a nap sorai a days alatt (intervals volt) · a munkaidő a nap sorában, nem a data alatt · a startedAt és az endedAt teljes időpont	mindig a munkaidőt adja: az első és utolsó hívás módja nincs
stats/prj_by_op → GET /stats/project_summary_by_user	a startDate és az endDate kötelező	a project burok nincs: a projekt mezői a gyökérben · az operátor mutatói a sorában, nem a data alatt · a userName csak a név, a kód a userCode-ban	az összeg és az operátor sora ugyanazokat a mutatókat adja, ugyanazon a néven
stats/opsum → GET /stats/project_summary_by_user	a startDate és az endDate kötelező · az időszak legfeljebb 31 nap	a sorok a users alatt (rows volt), mellettük a projekt és az összeg (total) · a felhasználó az id, name, folderid, foldername helyett userId, userName, folderId, folderName · az idő egész másodperc, nem óra:perc:másodperc szöveg	sort az kap, aki az időszakban a projekten dolgozott — nem a projekt minden tagja
stats/op_worktime → GET /stats/user_work_time	a startDate és az endDate kötelező · az időszak legfeljebb 31 nap	a felhasználó mutatói a sorában, nem a data alatt · a userName csak a név, a kód a userCode-ban
stats/op_sum → GET /stats/user_summary	a startDate és az endDate kötelező · az időszak legfeljebb 31 nap	a felhasználó és a projekt mutatói a sorukban, nem a data alatt · a userName csak a név, a kód a userCode-ban · a projekt a projectId, projectCode, projectName mezőkkel
stats/prjopsum → GET /stats/user_summary	a prdata nincs: a projektek nélküli kérés a GET /stats/user_work_time · a mappa-szűrő nincs · az időszak legfeljebb 31 nap	mint az op_sum-nál · az idő egész másodperc, nem óra:perc:másodperc szöveg