SALESELITDocs

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.

A Beállítások → API kulcsok oldalon (admin) hozhatsz létre programozott hozzáférést a saját szervezetedhez - minden kulcs vagy "személyes" (egy konkrét felhasználóhoz kötve), vagy "szervezeti" hatókörű.

A beviteli (ingest) API

  • Az `/api/v1/ingest` végpont fogad be új hívásokat kívülről, az `x-api-key` fejlécben átadott kulccsal hitelesítve.
  • Az API-kulcsokhoz külön feltöltési (`upload-url`) és feltöltés-lezáró (`complete-upload`) végpont is tartozik, ugyanazzal a resumable-upload logikával, mint a webes/asztali feltöltésnél.
  • Minden kulcs saját sebességkorlátozás (rate limit) alatt fut, 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_..." \
  -H "Content-Type: application/json" \
  -d '{"callTypeId": "...", "audioUrl": "https://..."}'

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.