Integrációk

API kulcsok és a nyilvános API

Hogyan küldj be hívásokat egy saját rendszerből (pl. dialer) API-kulccsal, kódszinten.

Két, egymástól független API-kulcs-rendszer létezik - ne keverd össze őket, más a céljuk és más végpontokhoz férnek hozzá.

Szervezeti kulcsok (Beállítások → API kulcsok)

A Beállítások → API kulcsok oldalt admin és menedzser szerepkör érheti el.
Az itt létrehozott kulcs mindig szervezeti hatókörű - ez az oldal nem kínál választást "személyes" és "szervezeti" hatókör között, kizárólag szervezeti kulcsot tud generálni.
Ez a kulcs az `/api/v1/ingest` végponthoz való, ami az `x-api-key` fejlécben átadott kulccsal hitelesítve fogad be új hívásokat kívülről (pl. egy dialer rendszerből).
Minden kulcs saját sebességkorlátozás (rate limit) alatt fut - percenként 30 kérés kulcsonként -, hogy egy hibás integráció ne tudja túlterhelni a feldolgozási pipeline-t.

Példa: hívás beküldése kódból

curl -X POST https://<a-te-sales-coach-domained>/api/v1/ingest \
  -H "x-api-key: sk_live_<32 hex karakter>" \
  -H "Content-Type: application/json" \
  -d '{"transcript": "...", "repEmail": "rep@ceged.hu", "callTitle": "Demo hívás"}'

A személyes kulcs elsősorban az asztali alkalmazáshoz készült, ami jelenleg még "Hamarosan" státuszban van (lásd az Integrációk fejezet "Asztali alkalmazás" oldalát) - a lenti mechanizmus már működik, de a legtöbb ügyfélnek egyelőre nincs mihez párosítania.

Személyes kulcs (Beállítások → Asztali alkalmazás)

Ez egy teljesen külön, önkiszolgáló rendszer: bármelyik csapattag létrehozhatja a saját, egyetlen személyes kulcsát a Beállítások → Asztali alkalmazás oldalon, admin-jogosultság nélkül.
Felhasználónként egyszerre csak egy aktív személyes kulcs létezhet - a kulcs neve mindig fixen "Asztali alkalmazás", ez párosítja az asztali appot a felhasználó saját fiókjához.
Kizárólag ez a kulcstípus tudja használni a resumable feltöltési végpontokat (`upload-url` és `complete-upload`) - egy szervezeti kulcsnak nincs egyetlen tulajdonosa, akihez a felvételt hozzá lehetne rendelni, ezért ezek a végpontok minden nem "personal" hatókörű kulcsot elutasítanak.

Egy API-kulcsot csak egyszer, létrehozáskor mutat meg a rendszer - csak a kulcs hash-elt formája marad tárolva. Ha elveszik, csak új kulcsot generálhatsz, a régit vissza nem kaphatod.

Asztali alkalmazás Webhookok