Ugrás a tartalomra

Zircon CRM / AI és integrációk

Böngészőben fut · HU / EN / DE

REST API, integrációnként külön jogosultsággal

A Zircon CRM REST API-ján a weboldalad, a webshopod, a BI-eszközöd vagy egy automatizálás közvetlenül olvas és ír ügyfeleket, leadeket, projekteket, ticketeket és pénzügyi rekordokat. Minden integráció saját API-felhasználót kap, és csak azt teheti, amit a jogosultsági táblájában bejelölsz.

19 üzleti erőforrásJogosultság erőforrásonkéntLejáró, cserélhető tokenek

Röviden

Mire jó a Zircon CRM REST API-ja?

A REST API szabványos webes felület, amelyen más rendszerek JSON-ban kérnek és küldenek adatot. A Zircon CRM-ben 19 üzleti erőforrás érhető el így, az egyedi mezőkkel együtt, lekérésre, keresésre, létrehozásra, módosításra és törlésre. Minden integráció külön API-felhasználót, lejáratható tokent és erőforrásonkénti jogosultságot kap. Fejlesztőknek, integrációs partnereknek és BI-elemzőknek készült.

Ismerős?

Az adatok átjárnak, de senki nem tudja, ki mit visz.

Ha ezek közül valamelyik ismerős, az integrációitok még vakon futnak.

  1. 01

    A webshop mindent lát

    A rendelések szinkronjához kellett egy kulcs, és a legegyszerűbb az adminisztrátori fiók volt. Azóta a webshop a fizetésekhez és a munkatársak adataihoz is hozzáfér.

  2. 02

    Egy kiszivárgott kulcs, három leálló rendszer

    A token bekerült egy nyilvános kódtárba. Cserélni kell, de senki nem tudja, melyik integráció használja még.

  3. 03

    Az éjszakai szkript elszabadult

    Egy hibás ciklus megállás nélkül küldi a kéréseket, és a felület reggelre belassul. Hogy melyik integráció volt, csak a szervernaplóból derül ki.

Mit tud

Ezt adja a Zircon CRM REST API-ja.

Az API-t az adminisztrátor kezeli, és minden lépése bekerül a tevékenységnaplóba.

19 erőforrás, egyedi mezőkkel

Ügyfelek, kapcsolattartók, leadek, projektek, mérföldkövek, feladatok, időbejegyzések, ticketek, számlák, árajánlatok, üzleti ajánlatok, szerződések, jóváírások, költségek, fizetések, tételek, munkatársak, naptáresemények és előfizetések. A válaszokban benne vannak az egyedi mezők értékei is.

Jogosultsági tábla erőforrásonként

Minden API-felhasználónál erőforrásonként bejelölöd, mit tehet: lekérés, keresés, létrehozás, módosítás, törlés. Egy weboldali űrlap így csak leadet hozhat létre, egy BI-eszköz csak olvashatja a számlákat.

Lejárat, kvóta, csere

Az API-felhasználónak lejárati dátumot adsz, a túlterhelés ellen állítható kéréskorlát és percenkénti csúcskorlát véd. Egy pipával új tokent generálsz: a régi azonnal leáll, a használati statisztika megmarad.

Keresés egyedi mezőkben és címkékben

A kulcsszavas keresés a szokásos mezők mellett az egyedi mezők értékeiben is keres. Ticketeket, leadeket, számlákat és projekteket címkére (#) is megtalálsz, a bizonylatszámot előtaggal vagy anélkül.

Használati statisztika és riport

Minden kérés naplózva van végponttal, válaszkóddal, válaszidővel és IP-címmel. API-felhasználónként 7, 30 vagy 90 napos statisztikát látsz, a cégszintű riport pedig CSV-be exportálható.

Érzékeny adat nem megy ki

A jelszó-lenyomatokat, a jelszó-visszaállító kulcsokat és a kétlépcsős belépés titkait minden válaszból kiszűri a rendszer, bármelyik végpontról jön az adat.

Így működik

Így kerül be a weboldali űrlap a CRM-be.

  1. 01

    Létrehozod az API-felhasználót

    Nevet adsz neki (például „weboldal, lead-űrlap”), lejáratot, ha ideiglenes, és beállítod a kéréskorlátot.

  2. 02

    Csak a szükséges jogot adod meg

    A táblában a leadek létrehozását jelölöd be, és ha kell, az egyedi mezők lekérését.

  3. 03

    Kipróbálja a fejlesztő

    A tokent átadod a fejlesztőnek, aki a tokenellenőrző végponttal és az adminisztrátori kéréskészítővel teszteli a hívásokat, majd beköti az űrlapot.

  4. 04

    Figyeled a forgalmat

    Az új megkeresések leadként érkeznek. A statisztikában látod a hibákat, és ha a token kiszivárog, egy mentéssel cseréled.

Őszintén

Jó tudni, mielőtt elindulsz.

  • Az API kérésre válaszol, eseményt nem küld (webhook nincs), a listák pedig lapozás nélkül, egyben jönnek. A változásokat lekérdezéssel követed, a nagy BI-kivonatokat ehhez igazítva tervezd.

  • A tételes bizonylatok (számla, árajánlat, üzleti ajánlat, jóváírás) módosításához a teljes bizonylatot kell elküldeni, tételekkel és összegekkel. A módosítás fájllal együtt lecseréli a meglévő csatolmányokat.

  • Az API-felhasználóra a munkatársi láthatósági szabályok nem vonatkoznak. Pénzügyi és munkatársi adatokhoz csak megbízható integráció kapjon olvasási jogot.

  • A kéréskészítő az élő rendszert hívja, és valódi adatot módosít. Kísérletezéshez korlátozott jogú teszt API-felhasználót használj.

  • Az API-n létrehozott számla a Zircon CRM saját számlája. A hivatalos, NAV-nak jelentett számlát a Számlázz.hu-integráció állítja ki.

Mielőtt írnál

Jogos kérdések. Őszinte válaszok.

  1. 01

    Csatlakoztathatok AI-asszisztenst a REST API-hoz?

    Technikailag igen, de a Zircon CRM-ben erre az MCP-szerver való. Az MCP a munkatárs nevében fut, az ő jogosultságaival, minden hívás naplózva van, és a Claude vagy a Cursor néhány lépésben csatlakozik. Az API-felhasználóra a munkatársi láthatósági szabályok nem vonatkoznak.

  2. 02

    Szól-e a Zircon CRM egy másik rendszernek, ha megváltozik egy adat?

    Nem, az API csak válaszol a kérésekre, eseményt nem küld. Ha egy integrációnak reagálnia kell a változásokra, időnként lekérdezi a megfelelő végpontot. A kéréskorlátot ehhez igazítva állítsd be.

  3. 03

    Működik-e a Zircon CRM API-ja n8n-nel, Make-kel vagy Zapierrel?

    Igen, bármelyik eszközzel, amely általános HTTP-kérést tud küldeni. Kész, előre gyártott connector nincs: az automatizálás közvetlenül hívja a végpontokat a tokennel.

  4. 04

    Mi a teendő, ha kiszivárgott egy API-token?

    A Zircon CRM-ben az API-felhasználó szerkesztésekor új tokent kérsz, és mented. A régi token azonnal leáll, az integrációt át kell állítani az újra, a használati statisztika pedig átkerül az új tokenhez.

Beszéljünk.

Az első beszélgetés ingyenes
Valódi ember válaszol, nem robot

Hozd el a listát: melyik rendszer mit olvasna vagy írna a CRM-ben. A demón együtt állítunk össze egy API-felhasználót a szükséges jogokkal, és megnézzük, mit mutat róla a statisztika.

Ügyelet
H–P 9–17
Support
support@zircon.hu (meglévő ügyfeleknek)