Apeluri

Istoricul apelurilor primite și date: cine, cu cine, cât, și ce s-a întâmplat.

Un „apel” aici e o convorbire cu cineva din afară: un pacient care a sunat la cabinet, o comandă confirmată prin telefon, un apel pierdut la ora prânzului. Apelurile interne, dintre două interioare, nu apar. Fiecare apel are un id care nu se schimbă, aceleași câmpuri oriunde l-ai vedea, și rămâne în istoric cât ține retenția contului tău.

Lista apelurilor

Apelurile, cele mai noi întâi, pe pagini. Fără niciun parametru primești ultimele 30 de zile, câte 50 pe pagină.

Un parametru scris greșit nu e ignorat: primești 400 cu invalid_parameter și explicația. Așa, un filtru greșit nu îți umple sistemul cu apeluri pe care nu le-ai cerut.

Exemplu

Apelurile primite și nepreluate din 17 octombrie:

curl "https://api.criox.ro/v1/calls?direction=inbound&result=missed&from=2026-10-17T00:00:00%2B03:00&to=2026-10-18T00:00:00%2B03:00" \
  -H "Authorization: Bearer cxk_…"

Răspunsul, cu un singur apel ca să încapă aici:

{
  "data": [
    {
      "id": "c0ffee00-1b2c-4d3e-8f4a-5b6c7d8e9f01",
      "direction": "inbound",
      "started_at": "2026-10-17T08:12:41.000Z",
      "ended_at": "2026-10-17T08:15:27.000Z",
      "contact_number": "+40743755549",
      "contact_number_national": "0743755549",
      "contact_name": "Ion Popescu",
      "line_number": "+40215708509",
      "line_number_national": "0215708509",
      "agent_extension": "101",
      "agent_name": "Maria Ionescu",
      "queue_number": null,
      "queue_name": null,
      "result": "answered",
      "missed_reason": null,
      "after_hours": false,
      "wait_seconds": 12,
      "talk_seconds": 154,
      "duration_seconds": 166,
      "recorded": true,
      "crm_provider": "kommo",
      "crm_contact_id": "991",
      "crm_contact_url": "https://exemplu.kommo.com/contacts/detail/991",
      "destination_type": "extension",
      "destination_number": "101",
      "destination_name": "Maria Ionescu",
      "path": [
        { "type": "extension", "number": "101", "name": "Maria Ionescu", "key": null, "at": "2026-10-17T08:12:41.000Z", "seconds": 12, "result": "answered" }
      ]
    }
  ],
  "has_more": true,
  "next_cursor": "MTc2MDY4Mjc2MS5jMGZmZWUwMC0xYjJjLTRkM2UtOGY0YS01YjZjN2Q4ZTlmMDE"
}

Paginarea

Cât timp has_more e true, ceri pagina următoare cu cursor=next_cursor, cu aceleași filtre. Cursorul ține minte unde ai rămas, deci un apel care intră în istoric între două pagini nu te face să sari peste altul. Când nu mai e nimic, has_more e false și next_cursor e null.

O pagină poate avea mai puține rânduri decât limit și totuși has_more: true: apelurile interne se scot după ce pagina a fost tăiată. Oprește-te după has_more, nu după numărul de rânduri.

// Node.js: toate apelurile din octombrie, pagină cu pagină
let cursor = null;
do {
  const url = new URL("https://api.criox.ro/v1/calls");
  url.searchParams.set("from", "2026-10-01T00:00:00+03:00");
  if (cursor) url.searchParams.set("cursor", cursor);

  const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.CRIOX_KEY}` } });
  if (!res.ok) throw new Error(`CrioX a răspuns ${res.status}`);
  const page = await res.json();

  for (const call of page.data) await save(call);
  cursor = page.has_more ? page.next_cursor : null;
} while (cursor);

Un apel

Un singur apel, după id. Cazul obișnuit: ai primit evenimentul call.completed, ai păstrat call_id, și vrei să-l recitești mai târziu, de exemplu după ce colegul a adăugat numele în agendă. Îl găsești cât timp îl ține retenția contului, nu doar 30 de zile.

curl https://api.criox.ro/v1/calls/c0ffee00-1b2c-4d3e-8f4a-5b6c7d8e9f01 \
  -H "Authorization: Bearer cxk_…"

Răspunsul e obiectul „apel” de mai jos, fără înveliș. Un id care nu există în contul tău primește 404 cu call_not_found; un id care nu e UUID primește 400.

Obiectul „apel”

Aceleași chei, în aceeași ordine, pe orice apel; null acolo unde nu se aplică sau nu se știe. E același obiect ca în evenimente, unde id se numește call_id. Modelul e simetric: contact_* e mereu cel din afară, agent_* e mereu colegul tău, line_* e mereu numărul tău, oricare ar fi sensul apelului.

Valorile lui result

Valorile lui missed_reason

Destinația și traseul

Un apel primit intră pe un număr, iar numărul îl trimite undeva: la un interior, la un grup de sonerie, într-o coadă, într-un meniu vocal, la asistentul AI, în mesageria vocală sau la un număr din afară. Acel „undeva” e destinația, cu tipul, numărul și numele ei. Rămâne destinația chiar dacă apelul l-a preluat până la urmă un coleg: pentru „cine a vorbit” sunt câmpurile agent_*. Pe un apel dat, destinația e numărul sunat.

Traseul (path)

Tot ce s-a întâmplat cu apelul, în ordine: a intrat în meniu, a apăsat o tastă, a intrat în coadă, au sunat două interioare, a răspuns unul, a fost trecut la asistent. Fiecare pas are aceleași șapte chei, null unde nu se aplică:

Valorile lui result, pe tip de pas:

Un apel care a intrat într-un meniu, a ales „Programări”, a așteptat în coadă și l-a preluat al doilea coleg sunat:

{
  "destination_type": "ivr",
  "destination_number": null,
  "destination_name": "Meniu principal",
  "path": [
    { "type": "ivr",       "number": null,   "name": "Meniu principal", "key": null, "at": "2026-10-17T08:12:42.000Z", "seconds": null, "result": "enter" },
    { "type": "ivr",       "number": null,   "name": "Programări",      "key": "1",  "at": "2026-10-17T08:12:46.000Z", "seconds": null, "result": "key" },
    { "type": "queue",     "number": "7001", "name": "Programări",      "key": null, "at": "2026-10-17T08:12:46.000Z", "seconds": 7,    "result": "answered" },
    { "type": "extension", "number": "102",  "name": "Ion Popa",        "key": null, "at": "2026-10-17T08:12:47.000Z", "seconds": 4,    "result": "no_answer" },
    { "type": "extension", "number": "101",  "name": "Maria Ionescu",   "key": null, "at": "2026-10-17T08:12:51.000Z", "seconds": 2,    "result": "answered" }
  ]
}

Întrebări frecvente

De ce lipsește un apel pe care îl văd în CrioX?

Trei cauze obișnuite: e un apel intern, între două interioare, și acelea nu intră în API; e mai vechi de 30 de zile și nu ai trimis from; sau pagina ta de istoric are un filtru pe care cererea nu îl are. Dacă nu e niciuna, scrie-ne cu id-ul apelului.

Cum iau toate apelurile de ieri?

Cu from și to pe ziua de ieri, în fusul tău orar, și paginare până la has_more: false. Exemplul de la paginare face exact asta pentru o lună.

Cum sincronizez continuu, fără să ratez nimic?

Primești evenimentele: ele vin în câteva secunde după fiecare apel, cu același obiect. Dacă totuși preferi să întrebi tu, întreabă o dată la câteva minute, cu from = momentul ultimului apel pe care îl ai, minus o oră, ca să prinzi și apelurile lungi care s-au închis mai târziu. Apelurile pe care le ai deja le recunoști după id.

Pot lua înregistrarea convorbirii?

Încă nu prin API. recorded îți spune dacă există; o asculți din CrioX. Accesul la înregistrări prin API e pe listă, cu reguli proprii, pentru că e altceva decât a ști că apelul a avut loc.

CrioX · suport@criox.ro · live.criox.ro