Tovább a tartalomhoz
ADERTISADERTISConnect

Interjúk — interviews

Művelet Mit tesz Jog
GET /interviews/list interjúk, szűrőkkel interviews:read
GET /interviews/get egy interjú interviews:read
GET /interviews/history a lezárások, a rögzítés sorrendjében interviews:read
GET /interviews/export egy projekt interjúi a listatétel adataival és a kérdőív válaszaival interviews:export
GET /interviews/schema a mezők leírása interviews:read
POST /interviews/add_termination új lezárás egy interjún interviews:write
POST /interviews/add_callback visszahívás felvétele bejövő projektben interviews:write

Az interjú egy ügyfél feldolgozása egy projektben, a mostani lezárásával; minden lezárás a lezárások sorába is bekerül. Az interjú hívásai a Hívásnaplóban állnak.

A mezők

Szekció neve “A mezők”
Mező Régi Típus Listában Leírás
id interviewid integer csak olvasható ✓ belső azonosító
code interview_code string(80) csak olvasható ✓ az interjú külső azonosítója
projectId prid integer csak olvasható ✓ a projekt belső azonosítója
projectCode prcode string csak olvasható ✓ a projekt külső azonosítója
projectName — string csak olvasható ✓ a projekt neve
listId lsid integer csak olvasható ✓ az ügyfél listája
listCode lscode string csak olvasható ✓ a lista külső azonosítója
listName list_name string csak olvasható ✓ a lista neve
listItemId listitem_num integer csak olvasható ✓ az ügyfél listatétele; üres, ha nincs
listItemCode — string csak olvasható ✓ a listatétel külső azonosítója
listItemName — 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 contact_name string csak olvasható ✓ a kontakt neve
phoneNumber phone_num string csak olvasható ✓ az ügyfél száma: a lezárás hívásáé, hívás nélkül a kontakté
startedAt start_date string csak olvasható ✓ a mostani lezárás kezdete
endedAt end_date string csak olvasható ✓ a mostani lezárás vége
userId userid integer csak olvasható ✓ aki a mostani lezárást rögzítette; üres, ha nem felhasználó (a tárcsázó vagy egy API-kulcs)
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
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
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
status — string csak olvasható ✓ az interjú állapota — lent
dialStatus sys_termination string csak olvasható ✓ a rendszer zárja: hívhatja-e a tárcsázó — lent
note notes string csak olvasható ✓ a lezárás megjegyzése
callbackAt callback_time string csak olvasható ✓ a visszahívás ideje — csak visszahívást ütemező lezárásnál
callbackUserId callback_userid integer csak olvasható ✓ a visszahívás felelőse; üres: közös — csak visszahívást ütemező lezárásnál
callbackUserCode callback_usercode string csak olvasható ✓ a felelős külső azonosítója
callbackUserName — string csak olvasható ✓ a felelős neve
callbackUserExtCode callback_userextcode string csak olvasható ✓ a felelős egyéb kódja
callbackPhoneNumber — string csak olvasható ✓ a visszahívandó szám — csak visszahívást ütemező lezárásnál
callId cdrid integer csak olvasható ✓ a mostani lezárás hívása; üres, ha nincs
qmRatedAt qm_date string csak olvasható ✓ a minőségellenőrzés ideje
qmRatingId qm_class integer csak olvasható ✓ a minősítés kódja, ha van
qmRatingName qm_class_name string csak olvasható ✓ a minősítés neve
qmUserName qm_user_name string csak olvasható ✓ az értékelő neve
qmNote qm_notes string csak olvasható ✓ az értékelés megjegyzése

Az állapot: open (nyitott: még hívásra vár) · in_progress (folyamatban) · callback (visszahívásra vár) · successful (sikeres) · closed (lezárt: véglegesen, a rendszer által, tiltott vagy lejárt listán).

A rendszer zárja (dialStatus): callable (nincs zár — a lezárása szerint hívható) · locked (éppen dolgoznak rajta) · dialing (a tárcsázó hívja) · importing (a listája importálás alatt) · no_number (nincs több hívható száma) · max_terminations (elérte a lezárások felső számát) · max_not_reached (elérte a nem elért hívások felső számát) · expired (a listája lejárt) · disabled (a listája, a listája a projektben, vagy a tétele tiltott).

GET /interviews/list Interjúk

Szekció neve “GET /interviews/list Interjúk”

Az interjúk mostani állapota, lapozva (A lapozás). A szűrők mind elhagyhatók:

Paraméter Régi Típus Leírás
startedSince · startedUntil start_date · end_date string a mostani lezárás kezdete ettől, eddig
projectId · projectCode prid · prcode a projekt interjúi
listId · listCode — a lista ügyfeleinek interjúi
listItemId — integer egy ügyfél interjúi
userId · userCode — a felhasználó lezárásai
terminationId termination integer · array egy lezárás, vagy a JSON-törzsben több
code — string az interjú külső azonosítója pontosan ez

Az interjú minden lezárással változik; a változásokat a history sorolja.

Válasz 200application/json
{
  "interviews": [
    {
      "id": 553201,
      "code": null,
      "projectId": 12,
      "projectCode": "SALES",
      "projectName": "Őszi kampány",
      "listId": 3,
      "listCode": "OKT-2026",
      "listName": "Októberi lista",
      "listItemId": 884512,
      "listItemCode": "C-20931",
      "listItemName": "Szabó Péter",
      "contactNo": 1,
      "contactName": "Szabó Péter",
      "phoneNumber": "3610000001",
      "startedAt": "2026-10-19T09:12:04+02:00",
      "endedAt": "2026-10-19T09:15:03+02:00",
      "userId": 57,
      "userCode": "HR-1042",
      "userName": "Kovács Anna",
      "userExtCode": null,
      "terminationId": 4,
      "terminationCode": "SIKER",
      "terminationName": "Sikeres értékesítés",
      "terminationDetail": null,
      "terminationReached": true,
      "terminationSuccessful": true,
      "terminationFinal": true,
      "terminationCallback": false,
      "status": "successful",
      "dialStatus": "callable",
      "note": null,
      "callbackAt": null,
      "callbackUserId": null,
      "callbackUserCode": null,
      "callbackUserName": null,
      "callbackUserExtCode": null,
      "callbackPhoneNumber": null,
      "callId": 8812345,
      "qmRatedAt": "2026-10-20T10:02:00+02:00",
      "qmRatingId": null,
      "qmRatingName": "Megfelelt",
      "qmUserName": "Tóth Eszter",
      "qmNote": null
    }
  ],
  "hasMore": false
}
Terminál
curl "$BASE/interviews/list?projectCode=SALES&startedSince=2026-10-19T00:00:00" -H "X-API-Key: $API_KEY"

GET /interviews/get Egy interjú

Szekció neve “GET /interviews/get Egy interjú”

Az interjú a lista mezőivel.

Terminál
curl "$BASE/interviews/get?id=553201" -H "X-API-Key: $API_KEY"

GET /interviews/history A lezárások

Szekció neve “GET /interviews/history A lezárások”

Az interjúk lezárásai, a rögzítés sorrendjében, lapozva: az after az utoljára látott sor — így szűrő nélkül is az új lezárásokat adja. A sor az interjú mezőit adja a status, a dialStatus és a QM nélkül; a saját azonosítója az id, az interjúé az interviewId, a kódja az interviewCode. A lezárás utólagos javítása a meglévő sort írja át, újat nem ad.

Paraméter Régi Típus Leírás
startedSince · startedUntil start_time · end_time string a lezárás kezdete ettől, eddig
projectId · projectCode prid · prcode a projekt lezárásai
interviewId interviewid integer egy interjú lezárásai
listId · listCode — a lista ügyfeleinek lezárásai
listItemId — integer egy ügyfél lezárásai
userId · userCode — a felhasználó lezárásai
terminationId termination integer · array egy lezárás, vagy a JSON-törzsben több
Válasz 200application/json
{
  "history": [
    {
      "id": 7790112,
      "interviewId": 553201,
      "interviewCode": null,
      "projectId": 12,
      "projectCode": "SALES",
      "projectName": "Őszi kampány",
      "listId": 3,
      "listCode": "OKT-2026",
      "listName": "Októberi lista",
      "listItemId": 884512,
      "listItemCode": "C-20931",
      "listItemName": "Szabó Péter",
      "contactNo": 1,
      "contactName": "Szabó Péter",
      "phoneNumber": "3610000001",
      "startedAt": "2026-10-19T09:12:04+02:00",
      "endedAt": "2026-10-19T09:15:03+02:00",
      "userId": 57,
      "userCode": "HR-1042",
      "userName": "Kovács Anna",
      "userExtCode": null,
      "terminationId": 4,
      "terminationCode": "SIKER",
      "terminationName": "Sikeres értékesítés",
      "terminationDetail": null,
      "terminationReached": true,
      "terminationSuccessful": true,
      "terminationFinal": true,
      "terminationCallback": false,
      "note": null,
      "callbackAt": null,
      "callbackUserId": null,
      "callbackUserCode": null,
      "callbackUserName": null,
      "callbackUserExtCode": null,
      "callbackPhoneNumber": null,
      "callId": 8812345
    }
  ],
  "hasMore": false
}
Terminál
curl "$BASE/interviews/history?after=7790111" -H "X-API-Key: $API_KEY"

GET /interviews/export Interjúk exportja

Szekció neve “GET /interviews/export Interjúk exportja”

Egy projekt interjúi az Adatexport változóival: az interjú adatai mellett a listatétel oszlopai, a kontaktok és a kérdőív válaszai. A válasz a változók leírása (variables) és a sorok (rows); a sorban a kulcs a változó kódja. A művelet saját jogot kér (interviews:export), az interviews:read mellé.

Paraméter Régi Típus Leírás
projectId · projectCode prid · prcode kötelező a projekt
type historic string current (alapértelmezett): soronként egy interjú, a mostani lezárásával · history: soronként egy lezárás, a kérdőív válaszai nélkül
startDate · endDate start_date · end_date string az interjú kezdete, naptári nappal; a záró nap is beleszámít
terminationId termination integer egy lezárás, vagy a JSON-törzsben a tömbjük
listId · listCode — csak a projekt egy listájának interjúi
templateId · templateName template_id · template_code a projekt export-sablonja: csak a sablon változói jönnek. Elhagyva minden változó
valueMode script_data_format string a választós kérdés válasza: code (alapértelmezett) a kódja · label a felirata · code_label a kettő együtt
listState include_inactive_lists string active (alapértelmezett): az érvényes listák interjúi · with_disabled: a tiltott listáké is · all: minden listáé, a tesztlistáé is
includeUncalled teljes boolean a még nem hívott rekordok is; alapból false
includeSkipped include_inactive_questions boolean az átugrott kérdések válasza is; alapból true
limit limit integer egy lap interjúinak (a history-nál lezárásainak) száma: 1–100, alapból 100
after offset string a folytatás: az előző válasz next értéke
Válasz 200application/json
{
  "variables": [
    { "code": "sys_interjuid", "title": "Interjú azonosító", "type": "integer" },
    { "code": "lst_col01", "title": "Név", "type": "string" },
    {
      "code": "K1",
      "title": "Elégedettség",
      "type": "integer",
      "valueLabels": { "1": "Elégedett", "2": "Nem elégedett" }
    }
  ],
  "rows": [
    { "sys_interjuid": 5512, "lst_col01": "Szabó Péter", "K1": "1" }
  ],
  "hasMore": true,
  "next": "5512"
}
Mező Típus Leírás
variables[].code string a változó kódja — a sorok kulcsa; ugyanaz, mint az Adatexport fájljának oszlopneve
variables[].title string a változó felirata
variables[].type string integer · number · boolean · date · time · string
variables[].valueLabels object a választós kérdés értékei: kód → felirat; csak ahol van
rows array soronként egy interjú (a history-nál egy lezárás): változókód → érték. Az interjú, a listatétel és a kontakt adata a típusa szerint jön (szám, true / false, időpont), a kérdőív válasza mindig szöveg; az üres érték null
hasMore boolean van-e még sor
next string csak ha hasMore true: ezt küldd a következő kérés after paraméterében

A lapozás itt a next értékével megy, nem a sor azonosítójával: a sablonból az azonosító ki is maradhat.

HTTP code Mikor
400 INVALID_ARGUMENT se projectId, se projectCode · ismeretlen type, valueMode vagy listState · ismeretlen sablon · a lista nem a projekté · az after nem egy előző válasz next-je · a limit 1–100-on kívül
422 VALIDATION_FAILED mezőhiba (fields): ismeretlen projectId vagy projectCode (INVALID_VALUE) · a projectCode több projekten áll (AMBIGUOUS)
Terminál
curl "$BASE/interviews/export?projectCode=SALES&templateName=CRM&startDate=2026-10-01&endDate=2026-10-31" -H "X-API-Key: $API_KEY"

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

Szekció neve “GET /interviews/schema A mezők leírása”

Az interjú mezői. A válasz alakja: A mezők leírása.

Terminál
curl "$BASE/interviews/schema" -H "X-API-Key: $API_KEY"

POST /interviews/add_termination Új lezárás

Szekció neve “POST /interviews/add_termination Új lezárás”

Új lezárás egy meglévő interjún: az interjú mostani lezárása lesz, és a lezárások sorába is bekerül. Az interjút az interviewId, a callId, vagy a projekt és a listatétel adja — ebből az első, ami a kérésben áll; a listatételnél az ügyfél legutóbbi interjúja a projektben. Az előző lezárás részletezése nem öröklődik.

Mező Régi Típus Leírás
interviewId interviewid integer az interjú
callId cdrid integer az interjú a hívása szerint
projectId · projectCode és listItemId, vagy listId / listCode és listItemCode prid · prcode · lsid · lscode · listitem_num · extcode az ügyfél interjúja a projektben
terminationId termination integer kötelező a lezárás, a projekt választható lezárásai közül
startedAt · endedAt start_time · end_time string a lezárás kezdete és vége — ha csak az egyik jön, a másik is az; elhagyva most
userId · userCode dgid a lezárás felhasználója, a projekt felhasználói közül; elhagyva az API-kulcs
callbackAt callback_time string a visszahívás ideje; visszahívást ütemező lezárásnál kötelező, másnál nem adható
callbackUserId · callbackUserCode callback_dgid a visszahívás felelőse: 0 a közös, különben a projekt felhasználói közül; visszahívást ütemező lezárásnál kötelező, másnál nem adható
note notes string(500) megjegyzés; a hosszabb levágva
Kérésapplication/json
{
  "interviewId": 553201,
  "terminationId": 8,
  "callbackAt": "2026-10-22T14:00:00+02:00",
  "callbackUserId": 57,
  "note": "Csütörtökön délután hívható."
}
Válasz 200application/json
{ "id": 7790140, "interviewId": 553201 }

Az id a lezárások új sora.

HTTP code Mikor
404 NOT_FOUND nincs ilyen interjú, a hívásnak nincs interjúja, vagy az ügyfélnek nincs interjúja a projektben
422 VALIDATION_FAILED a lezárás nem választható a projektben (TERMINATION_NOT_ALLOWED) · visszahívást ütemező lezárás idő nélkül (CALLBACK_TIME_REQUIRED) · visszahívás ideje vagy felelőse nem visszahívást ütemező lezárásnál (TERMINATION_NOT_CALLBACK) · a felhasználó vagy a felelős nem a projekt tagja (USER_NOT_IN_PROJECT, CALLBACK_USER_NOT_IN_PROJECT) · a vég a kezdet előtt (INVALID_PERIOD) · jövőbeli idő (TIME_IN_FUTURE)
422 VALIDATION_FAILED az interjún éppen dolgoznak (INTERVIEW_IN_PROGRESS), vagy a tárcsázó hívja (INTERVIEW_DIALING) — később újra kell próbálni
Terminál
curl "$BASE/interviews/add_termination" -H "X-API-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"interviewId": 553201, "terminationId": 8, "callbackAt": "2026-10-22T14:00:00+02:00", "callbackUserId": 0}'

POST /interviews/add_callback Visszahívás felvétele

Szekció neve “POST /interviews/add_callback Visszahívás felvétele”

Visszahívás egy bejövő projektben, hívás nélkül — például a weboldal visszahívás-kérő űrlapjáról. Ha a szám a projekt telefonkönyvében van, a visszahívás az ott álló ügyfélhez kötődik. A válasz 201, az új interjú azonosítójával; a Location fejléc a get-jére mutat.

Mező Régi Típus Leírás
projectId · projectCode prid · prcode kötelező a projekt: aktív, bejövő
phoneNumber phone string kötelező a visszahívandó szám
terminationId termination integer a lezárás, a projekt visszahívást ütemező lezárásai közül; elhagyva a Visszahívás
callbackAt callback_time string a visszahívás ideje; elhagyva most
callbackUserId · callbackUserCode callback_dgid kötelező a felelős: 0 a közös, különben a projekt felhasználói közül
note notes string(500) megjegyzés; a hosszabb levágva
Kérésapplication/json
{
  "projectCode": "SUPPORT",
  "phoneNumber": "3610000001",
  "callbackAt": "2026-10-21T10:00:00+02:00",
  "callbackUserId": 0,
  "note": "Visszahívást kért a weboldalon."
}
Válasz 201application/json
{ "id": 553260 }
HTTP code Mikor
422 VALIDATION_FAILED a projekt nem bejövő (PROJECT_NOT_INBOUND), vagy nem aktív (PROJECT_NOT_ACTIVE) · hibás szám (INVALID_PHONE) · tiltólistás szám (BLOCKED_NUMBER)
422 VALIDATION_FAILED a lezárás nem választható (TERMINATION_NOT_ALLOWED), vagy nem ütemez visszahívást (TERMINATION_NOT_CALLBACK) · a felelős nem a projekt tagja (CALLBACK_USER_NOT_IN_PROJECT)
Terminál
curl "$BASE/interviews/add_callback" -H "X-API-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"projectCode": "SUPPORT", "phoneNumber": "3610000001", "callbackUserId": 0}'

A régi API-ból

Szekció neve “A régi API-ból”
Cím Kérés Válasz Működés
interview/list → GET /interviews/list a projekt nem kötelező · a historic helyett a history · a qm_start_date, qm_end_date, include_test, include_script_data, script_data_format és nodata nincs a vars és a kérdőív válaszai, a listatétel oszlopai (listitem_col…), a kontakt adatai (contact_wstat, contact_email, contact_notes, contact_phone), az IVR-gombok (cdr_dtmf, cdr_ratingdtmf), az első hívás (first_call, first_reach), a munkahely és a tétel lejárata nincs — a tétel adatai a Listatételek get-jéből a dialStatus szóval, a régi sys_termination szövege helyett; az interjú állapota (status) új
interview/history → GET /interviews/history a projekt vagy az időszak nem kötelező a sor azonosítója id · a contact_code nincs lapozás az after-rel: az új lezárások követése
interview/add_termination → POST /interviews/add_termination a dgid elhagyható: alapból az API-kulcs · a napra szóló start_date, end_date nincs { "id", "interviewId" } a lezárás a projekt választható lezárásai közül; visszahívást ütemezőhöz idő és felelős kell (0: közös); a felhasználó és a felelős a projekt tagja; az előző lezárás részletezése nem öröklődik; élő interjún 422
interview/add_callback → POST /interviews/add_callback a termination csak visszahívást ütemező lezárás · a felelős kötelező (0: közös) 201 · interviewid → id a projekt aktív is; tiltólistás számra nem vesz fel
interview/export → GET /interviews/export a projekt kötelező · az offset helyett az after az előző válasz next-jével · a historic helyett a type · a noheader, a nodata, az include_script_data és az interviewid nincs · a limit legfeljebb 100 a vars helyett a variables (desc → title, datatype → type), az interviews helyett a rows; a változók kódja az Adatexport fájljáé (interviewid helyett sys_interjuid) saját jog (interviews:export); a kérdőív válaszai alapból kóddal jönnek
— — — csak az újban: interviews/get · interviews/schema
© 2026 Adertis Kft.