Minden, amire szükséged van a chatbotod elindításához
Közérthető útmutató Obdal AI chatbotod felépítéséhez, testreszabásához és beágyazásához — az első alkalmazástól egészen a weboldaladon való élesítésig.
Mi az Obdal, közérthetően
Az Obdal a saját tartalmadat alakítja 24/7 elérhető AI chatbottá, amelyet bármely weboldalra elhelyezhetsz. Ez az oldal végigvezet a teljes folyamaton. A lépések előtt érdemes ismerni öt szót, amelyekkel mindenhol találkozni fogsz: az alkalmazás egyetlen chatbot; a tudásbázisa azok a fájlok és GYIK-ek, amelyek alapján válaszol; a widget az a csevegőbuborék, amelyet a látogatók látnak; a Tervező az, ahol ezt a widgetet formázod; a beszélgetések pedig azok a csevegések, amelyeket kezel. Ha ezek a helyükre kerülnek, a dokumentáció többi része gyorsan olvasható.
Alkalmazás (chatbot)
Egy chatbot egy alkalmazás. Minden más — a tudása, a kinézete, a beszélgetései — ehhez az alkalmazáshoz tartozik.
Tudásbázis
A feltöltött fájlok és az általad megírt GYIK-ek. A chatbotod kizárólag ebből a tartalomból válaszol, így pontos marad a vállalkozásodra nézve.
Widget
Az a csevegőbuborék, amelyre a látogatóid kattintanak egy beszélgetés megnyitásához. A beágyazási kód beillesztése után jelenik meg a weboldaladon.
Tervező
A kódmentes stúdió, ahol a widgetet formázod — színeit, témáját, pozícióját és üdvözlő üzenetét — élő előnézettel.
Beszélgetések
Minden csevegés, amelyet a widgeted kezel. A beszélgetések alapján mérjük a használatot, és a csomagod határozza meg, hányat kapsz havonta.
Hogyan illeszkednek össze a részek
A tartalmad működteti az alkalmazást, az alkalmazás vezérli a widgetet, a widget pedig a weboldaladon él.
- Alkalmazás
- Tudás
- Widget
- A weboldalad
Egy fiók több alkalmazást is tartalmazhat, és mindegyik teljesen különálló — saját tudása, saját API-kulcsa, saját widgetdizájnja és saját beszélgetései vannak. Semmi sem szivárog át egyik chatbotból a másikba.
Az üres vezérlőpulttól az élő chatbotig
Négy lépésben élő chatbotot indíthatsz. Először hozz létre egy alkalmazást a vezérlőpultodon. Másodszor adj hozzá tudást fájlok feltöltésével vagy GYIK-ek megírásával, hogy a botnak legyen miből válaszolnia. Harmadszor nyisd meg a Tervezőt, és szabd testre, hogyan néz ki és hová kerül a widget. Negyedszer tedd közzé a beágyazási kód weboldalra másolásával. Az alábbi lépések mindegyike a saját, részletesebb szakaszára hivatkozik, de ez a teljes, ideális út az üres vezérlőpulttól az élő chatbotig.
- 1
Hozz létre egy alkalmazást
Az Alkalmazások vezérlőpultodon hozz létre egy új alkalmazást, és adj neki nevet. Az elnevezés automatikusan létrehozza az API-kulcsát, így a chatbot készen áll a beállításra.
- 2
Add hozzá a tudásodat
Tölts fel fájlokat, és írj GYIK-eket, hogy a botnak legyen miből válaszolnia. A feltöltött fájlok a háttérben dolgozódnak fel, és kis idő múlva válnak kereshetővé.
- 3
Szabd testre a widgetet
Nyisd meg a Tervezőt a botnév, az avatar, az üdvözlő üzenet, a téma és a színek beállításához. Az élő előnézet azonnal frissül, ahogy bármit megváltoztatsz.
- 4
Tedd közzé a weboldaladon
Másold ki a beágyazási kódot a Tervező Közzététel füléről, és illeszd be a weboldaladra. Az ingyenes csomag elegendő az élesítéshez.
Állítsd be az engedélyezett eredeteket, különben a widget rejtve marad
Nem angol válaszokhoz magad állítsd be a nyelvet
A widget elhelyezése a weboldaladon
A közzététel azt jelenti, hogy egyetlen kódrészletet illesztesz be a weboldaladra. Nyisd meg az alkalmazásodat, lépj a Tervező Közzététel füljére, és másold ki a beágyazási kódot. Illeszd be közvetlenül a záró címke elé minden olyan oldalon, ahol a widgetnek meg kell jelennie — a legtöbb weboldalszerkesztőben van hely az egyéni HTML-nek vagy a lábléc-szkripteknek. Ahhoz, hogy a widget betöltődjön, a weboldalad címét fel kell venni az engedélyezett eredetek közé, különben a csevegés rejtve marad. Ha a weboldalad egyoldalas alkalmazás, a kódrészlet akkor is működik, ha a fő elrendezésedben van. A közvetlen WordPress- és Shopify-integrációk úton vannak; egyelőre a beágyazási kód minden platformon működik.
A beágyazási kódrészlet
Ezt a Tervező Közzététel füléről másold ki — a valódi kódrészleted a saját API-kulcsodat tartalmazza.
<script> window.obdalConfig = { apiKey: "your-app-api-key", baseUrl: "https://obdal.com" };</script><script async src="https://obdal.com/widget-loader.js"></script>Hová illeszd be
Add a kódrészletet közvetlenül a záró </body> címke elé minden olyan oldalon, ahol a widgetnek meg kell jelennie. Magától inicializálódik — nincs más teendő. A legtöbb weboldalszerkesztő kínál egyéni HTML- vagy lábléc-szkriptek területet, amely tökéletes erre.
Add hozzá a weboldaladat az engedélyezett eredetekhez
Egyoldalas alkalmazások
Ha a weboldalad kliensoldali útválasztást használ, illeszd be a kódrészletet egyszer a fő elrendezésedbe. A betöltő az oldal betöltésekor inicializálódik, és a widget elérhető marad, ahogy a látogatók a nézetek között mozognak.
Platformbővítmények
A dedikált WordPress- és Shopify-bővítmények hamarosan érkeznek. Amíg meg nem jelennek, a fenti szkriptes beágyazás minden platformon működik, beleértve ezt a kettőt is.
Magát frissíti
A widgeted formázása, mezőről mezőre
A Tervező az, ahol a chatbotod megkapja a kinézetét, és egy élő előnézet frissül, ahogy bármit megváltoztatsz. Négy füle van. Az Általános a botnevet, az avatart és az üdvözlő üzenetet fedi le. A Megjelenés a legnagyobb fül: téma és színek, fejléc- és üzenetstílusok, betűtípusok, ablakméret, sarokrádiusz, animációk és a csevegés indítógomb. A Pozíció állítja be, melyik sarokban ül a buborék, külön elhelyezéssel mobilra. A Közzététel adja a beágyazási kódot és az engedélyezett eredetekre vonatkozó emlékeztetőt. Ez a szakasz közérthető referencia minden mezőhöz, így mindig tudod, mit csinál az egyes vezérlők, mielőtt hozzájuk nyúlnál.
Minden változtatás azonnal megjelenik az élő előnézetben, így pontosan láthatod, mit fognak látni a látogatók, mielőtt közzéteszed.
Az alapok, amelyeket a látogatóid először vesznek észre.
| Mező | Lehetőségek | Mit csinál |
|---|---|---|
| Botnév | Szöveg | A csevegőablak tetején megjelenő név, például a márkád vagy az asszisztens neve. |
| Avatar | SVG / PNG / JPG | A bot üzenetei melletti kép. Tölts fel SVG-, PNG- vagy JPG-fájlt, a hosszabb oldalán legfeljebb 1500px méretben. |
| Üdvözlő üzenet | Szöveg | Az első üzenet, amelyet a látogatók látnak a csevegés megnyitásakor. Használd a hangnem megadására és egy kérdés ösztönzésére. |
Chatbot futtatása más nyelven
A chatbot más nyelven való futtatásához két különálló beállításra van szükség, és a kettő közötti különbség ismerete sok zavartól megóv. A widget felületszövege (gombok, helykitöltők) angolul és magyarul érkezik; azt, hogy melyik, a beágyazási kódban a nyelvi kód beállításával választod ki — erre nincs kapcsoló a Tervezőben. Külön szabályozza a rendszerprompt, hogy a bot milyen nyelven válaszol, nem pedig az automatikus felismerés: magyar válaszokhoz mondd meg a botnak, hogy magyarul válaszoljon. Egy őszinte megjegyzés előre: a látogatók nem tudják maguk átváltani a csevegés nyelvét, ezért minden beágyazáshoz te állítod be a nyelvet, ahelyett hogy választót kínálnál.
Igen, a widget magyar felületszöveggel érkezik, és a bot is tud magyarul válaszolni. Csak épp nem a Tervezőben lévő kapcsoló, ezért feltételezik gyakran a tulajdonosok, hogy nem lehetséges. Két különálló kar van, és mindkettőt magad állítod be.
1. kar — A widget felületnyelve
A widget gombjai és helykitöltői angolul (az alapértelmezett) és magyarul érkeznek. Azt, hogy melyik, a beágyazási kódban a window.obdalConfig.locale beállításával választod ki. Add hozzá az alábbi kiemelt sort; a kimásolt kódrészlet nem tartalmazza, így ez kézi hozzáadás.
A widget nyelvi kódjának beállítása
Add hozzá a nyelvi kód sorát a beágyazási kódrészletedhez — alapból nincs ott.
<script> window.obdalConfig = { apiKey: "your-app-api-key", baseUrl: "https://obdal.com", locale: "hu" };</script><script async src="https://obdal.com/widget-loader.js"></script>2. kar — A nyelv, amelyen a bot válaszol
Azt, hogy a bot milyen nyelven válaszol, az App-beállításokban lévő rendszerprompt szabályozza, nem az automatikus felismerés. Magyar válaszokhoz adj hozzá egy utasítást, például: „Mindig magyarul válaszolj.” A bot a promptot követi; nem találgat a látogató üzenetéből.
Egy teljesen magyar chatbot
Nincs végfelhasználói nyelvi kapcsoló
Támogatott felületnyelvek: angol (en, az alapértelmezett) és magyar (hu).
A chatbot más nyelven való futtatása minden csomagban elérhető. Soha nem fizetős bővítmény.
Sötét, világos és a márkaszíneid
Az Obdalnak két teljesen különálló témája van, és ezek összekeverése a leggyakoribb zavarforrás. A vezérlőpult témája — a Világos, Sötét vagy Rendszer kapcsoló a vezérlőpultod jobb felső sarkában — csak azt változtatja meg, amit te látsz a chatbotod kezelése közben. A widgetre nincs hatással. A widget témáját a Tervező Megjelenés fülén, a Téma és szín részben állítod be, ahol Világosat vagy Sötétet választasz, és módonként hat színt finomhangolsz: háttér, szöveg, szegély, a felhasználói buborék, a botbuborék és az elsődleges kiemelőszín. A látogatóid az általad választott widgettémát látják; ők maguk nem tudják átváltani.
Két különálló téma
Az egyik megváltoztatása soha nem változtatja meg a másikat. A vezérlőpult témája a tiéd a munka közben; a widget témája az, amit a látogatók látnak a weboldaladon.
A Világos / Sötét / Rendszer kapcsoló a vezérlőpultod jobb felső sarkában. Csak azt érinti, amit a chatbotod kezelése közben látsz.
A Tervező Megjelenés fülén állítod be. Ezt látják ténylegesen a látogatóid a weboldaladon.
Téma és szín a Megjelenés fülön
A Tervező Megjelenés fülén válassz Világos vagy Sötét widgettémát, majd finomhangold a hat színt arra a módra.
Háttér
A csevegőablak fő felületszíne.
Szöveg
Az üzenet- és címkeszöveg színe.
Szegély
Az elválasztók és az ablakperem színe.
Felhasználói buborék
A látogatód által küldött üzenetek háttere.
Botbuborék
A bot által küldött üzenetek háttere.
Elsődleges
A gomboknál és kiemeléseknél használt kiemelőszín.
Válaszd ki a márkaszínedet a hat előbeállítás közül, vagy állíts be egyedit. Az általad választott elsődleges szín átöröklődik a felhasználói buborék színére, így a widget extra finomhangolás nélkül is márkahű marad.
A látogatók nem tudják átváltani a widget témáját
Alkalmazás- és profilbeállítások
Az App-beállítások a chatbotod viselkedésének vezérlőpultja, elkülönülve attól, hogyan néz ki. Itt kezeled az API-kulcsot (újragenerálhatod, de ezzel tönkreteszed a régit használó beágyazásokat), beállítod a személyiséget és a hangnemet, megírod a rendszerpromptot, amely minden választ és annak nyelvét alakítja, kiválasztasz egy pénznemet, és bekapcsolod az Élő csevegést az élő ügynöki átadáshoz. A saját fiókadataid — név, e-mail és jelszó — külön, a Profilbeállításokban találhatók. Ez a szakasz minden mezőt elmagyaráz, és hogy mikor változtatnád meg.
App-beállítások
Chatbotonkénti konfiguráció arra, hogyan viselkedik ez az alkalmazás.
| Mező | Lehetőségek | Mit csinál |
|---|---|---|
| API-kulcs | Maszkolt · Újragenerálás | Hitelesíti az alkalmazásodat. Csak az utolsó néhány karakterrel jelenik meg. Újragenerálhatod, de minden, a régi kulcsot használó beágyazás leáll. |
| Személyiség / Hangnem | Hangnem legördülő | Beállítja a hangot, amelyen a bot ír, egy Hangnem stílus legördülőből — például barátságos, hivatalos vagy tömör. |
| Rendszerprompt | Max. 2000 karakter | A fő utasítások, amelyek minden választ alakítanak, beleértve azt is, milyen nyelven válaszol a bot. A viselkedés legfontosabb beállítása. |
| Pénznem | 100+ kereshető | A pénznem, amelyet a bot az árakról beszélve használ. Válassz egy több mint száz elemű, kereshető listából. |
| Élő csevegés | Be / Ki | Bekapcsolja az élő ügynöki átadást, hogy egy élő ügynök átvehesse a beszélgetést, amikor a látogatónak emberre van szüksége. |
Az API-kulcs újragenerálása tönkreteszi a meglévő beágyazásokat
Profilbeállítások
A személyes fiókadataid — név, e-mail és jelszó — a Profilbeállításokban találhatók, bármely alkalmazástól elkülönülve. Megváltoztatásuk nem érinti a chatbotjaidat.
Az App-beállítások egy chatbotról szólnak; a Profilbeállítások rólad. Ha egy botvezérlőt keresel a fiókprofilod alatt, helyette az App-beállításokban nézd.
GYIK és a tudásbázisod
A GYIK-ek gyors, pontos válaszokat adnak a chatbotodnak azokra a kérdésekre, amelyekről már tudod, hogy a látogatók felteszik, a tudásbázisod fájljai mellett. Létrehozhatsz, szerkeszthetsz és törölhetsz GYIK-eket, kategóriákba csoportosíthatod őket, kitűzhetsz akár ötöt, hogy elsőként jelenjenek meg, átrendezheted őket, és bármelyiket aktívra vagy inaktívra kapcsolhatod. A GYIK-ek minden fizetős csomag részei, így ha az ingyenes csomagon vagy, frissítened kell a feloldásukhoz. Ez a szakasz a tudásbázisod kezeléséről szól, és arról, hogyan hozd ki a legtöbbet a kitűzött, jól kategorizált válaszokból.
Létrehozás, szerkesztés és törlés
Írj meg egy kérdést és a válaszát, frissítsd őket bármikor, és távolítsd el azokat, amelyekre már nincs szükséged.
Kategóriákba csoportosítás
Rendezd a GYIK-eket kategóriákba, hogy a kapcsolódó kérdések együtt maradjanak, és könnyebben kezelhetők legyenek.
Akár öt kitűzése
Tűzd ki a legfontosabb válaszaidat — akár ötöt —, hogy elsőként jelenjenek meg a látogatók számára.
Szabad átrendezés
Rendezd a GYIK-eket a kívánt sorrendbe, a leghasznosabb válaszokat a tetejéhez közel helyezve.
Aktívra vagy inaktívra állítás
Kapcsolj be vagy ki bármely GYIK-et törlés nélkül, így ideiglenesen visszavonhatsz egy választ.
A GYIK-ek fizetős csomag funkciója
Használj GYIK-eket a rövid, gyakran feltett kérdésekhez pontos válaszokkal, a feltöltött fájlokat pedig a hosszabb referenciaanyaghoz. Mindkettő ugyanazt a csevegést táplálja, így a bot azt használja, amelyik a kérdéshez a legjobban illik.
Egy csevegés átadása egy valódi személynek
Néha a látogatónak valódi személyre van szüksége, és az élő ügynöki átadás lehetővé teszi, hogy valaki közbelépjen. Kapcsold be az Élő csevegést az App-beállításokban, és a chatbotod átadhat egy beszélgetést egy élő ügynöknek, aki átveszi a csevegést. Minden csomag tartalmaz egy bizonyos számú ügynöki helyet — a te oldaladon lévő emberek, akik válaszolhatnak —, amely a nagyobb csomagokra lépve növekszik. Ez a szakasz elmagyarázza, hogyan engedélyezd az átadást, mi történik egy átvétel során, és hogyan illeszkednek a helyek a csomagodhoz.
Kapcsold be az Élő csevegést
Nyisd meg az App-beállításokat, és kapcsold be az Élő csevegést (élő ügynöki átadás). Ha be van kapcsolva, egy ügynök bármely beszélgetésbe beléphet, és átveheti a bottól. Beállíthatsz egy offline üzenetet is arra az esetre, ha nincs elérhető ügynök.
Az ügynöki helyek a csomagoddal együtt nőnek
Minden csomag tartalmaz egy bizonyos számú ügynöki helyet — a csapattagok, akik élő csevegésekre válaszolhatnak. A beállítások kártya megmutatja, hány hely van használatban a korlátodhoz képest, és a szám a nagyobb csomagokon nő. A pontos számokért lásd a Csomagok szakaszt.
Amikor nincs elérhető ügynök
Ha egy ügynök sincs online, a látogatók a beállított offline üzenetet látják — például egy e-mail-címet, ahol elérhetnek. A beszélgetés soha nem marad némán.
Az élő ügynöki átadás fizetős csomag funkciója
Csomagok és amit mindegyik felold
A csomagod dönti el, mit tudnak a chatbotjaid, és ez a szakasz minden képességet ahhoz köt, ahol feloldódik. A csomagoddal együtt skálázódó korlátokra érdemes figyelni: havi beszélgetések, a fájljaid tárhelye, hány widgetet futtathatsz, elérhetők-e a GYIK-ek, az élő ügynöki átadás és hány ügynöki helyet kapsz, a „Powered by” márkajelzés eltávolítása, az AI-modell szintje, valamint a támogatási és SLA-szinted. Az itt szereplő adatok közvetlenül az élő csomagadatokból származnak, így mindig naprakészek. Amikor készen állsz az egymás melletti összehasonlításra, irány az árazási oldal.
| Képesség | Free Ingyenes | Starter 15/hó | Growth 39/hóNépszerű | Pro 89/hó | Business 179/hó |
|---|---|---|---|---|---|
| Havi beszélgetésekA widgetjeid által havonta kezelt csevegések. | 50 | 500 | 1,500 | 4,000 | 10,000 |
| Tudás tárhelyHely a tudásbázisod fájljainak. | 100 MB | 1 GB | 5 GB | 20 GB | 50 GB |
| WidgetekHány külön chatbotot futtathatsz. | 1 | 1 | 3 | 10 | Unlimited |
| GYIK-ekGondozott kérdés-válasz bejegyzések. | |||||
| Élő ügynöki átadásHagyd, hogy egy élő ügynök átvegyen egy csevegést. | |||||
| Ügynöki helyekCsapattagok, akik élő csevegésekre válaszolhatnak. | 0 | 2 | 5 | 15 | Unlimited |
| „Powered by” márkajelzés eltávolításaRejtsd el az Obdal jelvényt a widgeten. | |||||
| AI-modell szintjeA válaszaid mögötti modell minősége. | Gyors | Gyors | Haladó | Prémium | Prémium |
- Havi beszélgetések
- 50
- Tudás tárhely
- 100 MB
- Widgetek
- 1
- GYIK-ek
- Élő ügynöki átadás
- Ügynöki helyek
- 0
- „Powered by” márkajelzés eltávolítása
- AI-modell szintje
- Gyors
- Havi beszélgetések
- 500
- Tudás tárhely
- 1 GB
- Widgetek
- 1
- GYIK-ek
- Élő ügynöki átadás
- Ügynöki helyek
- 2
- „Powered by” márkajelzés eltávolítása
- AI-modell szintje
- Gyors
- Havi beszélgetések
- 1,500
- Tudás tárhely
- 5 GB
- Widgetek
- 3
- GYIK-ek
- Élő ügynöki átadás
- Ügynöki helyek
- 5
- „Powered by” márkajelzés eltávolítása
- AI-modell szintje
- Haladó
- Havi beszélgetések
- 4,000
- Tudás tárhely
- 20 GB
- Widgetek
- 10
- GYIK-ek
- Élő ügynöki átadás
- Ügynöki helyek
- 15
- „Powered by” márkajelzés eltávolítása
- AI-modell szintje
- Prémium
- Havi beszélgetések
- 10,000
- Tudás tárhely
- 50 GB
- Widgetek
- Unlimited
- GYIK-ek
- Élő ügynöki átadás
- Ügynöki helyek
- Unlimited
- „Powered by” márkajelzés eltávolítása
- AI-modell szintje
- Prémium
Ezek minden csomagban elérhetők
A REST API fejlesztőknek
Fejlesztőknek az Obdal REST API-t kínál üzenetek küldéséhez és a chatbot saját alkalmazásaidba integrálásához. Ez a referencia szándékosan kódközpontú: egy gyorsindítás az első kérésed beüzemeléséhez, majd a fő végpontok a kéréseik és válaszaik szerkezetével. A hitelesítés az alkalmazásod API-kulcsát használja az App-beállításokból — tartsd titokban, és ne feledd, hogy az újragenerálása mindenhol érvényteleníti a régi kulcsot, ahol használatban van. Ha csak a widgetre van szükséged egy weboldalon, ezt a szakaszt teljesen átugorhatod; a beágyazási kódhoz nem kell programozni.
A szokásos akadályok megoldása
A legtöbb probléma néhány előre látható okra vezethető vissza, és mindegyikre van gyors megoldás. Ha a widget még mindig „Powered by Obdal” felirattal jelenik meg, a márkajelzés eltávolítása fizetős csomag funkció — frissíts az elrejtéséhez. Ha a bot rossz nyelven válaszol, a megoldás a rendszerpromptodban van, nem egy rejtett nyelvi beállításban: mondd meg neki, milyen nyelven válaszoljon. Ha pedig a widget egyáltalán nem jelenik meg, az ok szinte mindig az engedélyezett eredetek — add meg a weboldalad pontos címét a Közzététel fülön, hogy a widget betöltődhessen. Ez a szakasz végigveszi ezeket és a többi valós zavart, amelybe a tulajdonosok beleütköznek.
Miért jelenik meg a „Powered by Obdal”?
Ennek a jelvénynek az eltávolítása fizetős csomag funkció. Az ingyenes csomagon megjelenik, a Starter csomagtól felfelé eltávolítható. Frissíts, és a márkajelzés eltűnik. Lásd a Csomagok szakaszt.
Lásd: CsomagokMiért nem válaszol magyarul?
A bot nem ismeri fel automatikusan a nyelvet. A válasz nyelvét a rendszerpromptodban állítsd be (például „Mindig magyarul válaszolj”), a widget felületnyelvét pedig a beágyazási kódban lévő nyelvi kóddal. Lásd a Többnyelvű chatbot szakaszt.
Lásd: Többnyelvű chatbotA widget egyáltalán nem jelenik meg.
Ez szinte mindig az engedélyezett eredetek — a betöltő nem fut le egy fel nem sorolt domainen, és naplózza az origin_not_allowed üzenetet. További blokkolók, amelyeket naplóz: subscription_required, conversation_limit_reached, trial_limit_reached, owner_not_found, app_not_found és egy hibás API-kulcs. Nézd meg a Beágyazás szakaszt.
Lásd: BeágyazásA vezérlőpultom sötét, de a widget világos (vagy fordítva).
Ez így van rendjén. A vezérlőpult témája és a widget témája független beállítások, és az egyik megváltoztatása soha nem változtatja meg a másikat. Lásd a Témák szakaszt.
Lásd: TémákÚjrageneráltam az API-kulcsomat, és a widget elromlott.
A közzétett beágyazásodban lévő régi kulcs már nem működik. Másold ki a friss kódrészletet a Közzététel fülről, és illeszd be újra mindenhová, ahol a widget megjelenik. Lásd az Alkalmazás-beállítások szakaszt.
Lásd: BeállításokMég mindig blokkolva van valamilyen más okból.
Nyisd meg a böngésződ fejlesztői konzolját azon az oldalon, ahol a widget van. A betöltő naplózza a pontos okot, amiért nem jelent meg, ami egyenesen a megoldáshoz vezet.
Lásd: BeágyazásElőször a böngészőkonzolt nézd meg
Három lépés egy éles üzenetküldő élmény indításához.
Hozzon létre egy hatókörrel rendelkező kulcsot, korlátozza az eredeteket, és hívja meg a chat végpontot streaming válaszokkal. Az alapértelmezések biztonságban tartják csapatát, miközben gyorsan halad.
Hatókörrel rendelkező kulcs létrehozása
Adjon ki API kulcsot alkalmazásonként engedélyezett eredetekkel a hozzáférés szabályozásához.
Engedélyezett eredetek beállítása
Engedélyezze az éles és tesztelési domaineket a kulcs kiszivárgásának megelőzéséhez.
Chat kérés küldése
Küldjön felhasználói üzenetet, opcionálisan streamelje a tokeneket, és naplózza a munkamenet azonosítót.
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"message": "Summarize today’s incidents",
"stream": true
}'
const res = await fetch('/api/v1/chat', {
method: 'POST',
headers: {
'Authorization': `Bearer ${'$'}API_KEY`,
'Content-Type': 'application/json'
},
body: JSON.stringify({ message: 'Hey!', stream: true })
});
// Read chunks as they arrive
for await (const chunk of res.body) {
console.log(new TextDecoder().decode(chunk));
}
Fókuszált API felület, amely lefedi a teljes ügyfélfolyamatot.
Tartsa a válaszokat streamingelve és kövesse nyomon a munkameneteket extra infrastruktúra nélkül. Minden ésszerű alapértelmezésekkel érkezik.
/api/v1/chat
Küldjön felhasználói üzenetet és kapjon streaming AI választ az adathalmaza alapján. A munkamenetek megőrzik a kontextust a fordulók között.
Kérés
{
"message": "Summarize the outage playbook",
"api_key": "your_api_key",
"session_id": "sess_9Rna21",
"stream": true
}Válasz
event: message
data: {"content":"Hi there! I read through your playbook—here's the short version..."}
event: end
data: {"session_id":"sess_9Rna21"}/api/v1/usage
Kövesse nyomon a kéréseket, token használatot és költségeket alkalmazásonként, hogy csapata költségtudatos legyen.
Kérés
GET /api/v1/usage?api_key=your_api_key&start_date=2024-01-01
Válasz
{
"success": true,
"usage": {
"total_requests": 1842,
"total_input_tokens": 205401,
"total_output_tokens": 216529,
"total_tokens": 421930,
"total_cost": 12.45
},
"by_model": []
}/api/v1/sessions
Kérje le a chat munkameneteket üzenetelőzményekkel és használati metaadatokkal az alkalmazásához.
Kérés
GET /api/v1/sessions?api_key=your_api_key&include_all=true
Válasz
{
"success": true,
"sessions": [
{
"session_id": "sess_9Rna21",
"last_at": "2024-01-15T10:30:00Z",
"total_tokens": 2430,
"preview": "Hi there! I read through..."
}
],
"meta": {
"current_page": 1,
"per_page": 20,
"has_more": false
}
}Készen áll AI chatbotja építésére?
Töltse fel dokumentumait, ágyazza be a widgetet, és ügyfelei a nap 24 órájában azonnal választ kapnak. Kezdje ingyen, és csak akkor váltson nagyobb csomagra, ha a forgalma megnő.