KezdőlapDokumentáció

MCP Server Integration

A ChatReact megvalósítja a Model Context Protocol (MCP) protokollt, amely lehetővé teszi, hogy a ChatReact fiókját olyan AI asszisztensekhez csatlakoztassa, mint a Claude Desktop, Cursor és egyéb MCP-kompatibilis eszközök.

Mi az MCP?

A Model Context Protocol egy nyílt szabvány, amely lehetővé teszi az AI asszisztensek számára, hogy külső szolgáltatásokkal és adatforrásokkal kommunikáljanak. A ChatReact MCP integrációjával Ön képes:

  • Csevegőbotok kezelése — csevegőbotok létrehozása, konfigurálása (persona, nyelvek, widget, viselkedés, korlátozások), beágyazása és törlése
  • Tudásbázis építése — dokumentumok hozzáadása, weboldalak feltérképezése, feltérképezett oldalak és core-instructionök kezelése
  • GYIK-kezelés — GYIK-ek, kategóriák, javaslatok, fordítások és a GYIK widget
  • Csevegések felülvizsgálata — beszélgetések értékelése, bizalmi kategóriák hozzárendelése, Improvement Agent futtatása
  • Leadekkel és űrlapokkal való munka — leadek, lead kategóriák, capture beállítások, kapcsolatfelvételi űrlapok és beküldések
  • Élő chat ügynökként való működés — elérhetőségének beállítása, várakozó csevegések átvétele, válaszadás és munkamenetek lezárása
  • A cég adminisztrálása — profil, márkaszínek, csapattagok és meghívók
  • Email Assistant használata — postafiók kapcsolatok, kategóriák, névjegyek és aktivitás
  • Analitikák és értesítések olvasása

Minden, amit a dashboardon megtehet, elérhető az MCP-n keresztül (és a REST API); csak a böngészőhöz kötött műveletek, mint a fizetések, postafiók OAuth, passkey-ek, fiók törlése és API kulcs kezelése marad a dashboardon.

Első lépések

1. API kulcs generálása

  1. Navigáljon a Irányítópult → Cég → API fülre
  2. Kattintson a API-kulcs létrehozása gombra
  3. Adjon a kulcsnak egy leíró nevet (pl. "Claude Desktop") és válasszon legalább egy jogosultságot
  4. Másolja ki a generált kulcsot (cr_-szel kezdődik)

Az API kulcsok fizetős csomagokon érhetők el — lásd a Pricing page oldalunkat.

Tárolja az API kulcsot biztonságosan. Létrehozás után nem kérhető vissza.

2. MCP kliens konfigurálása

A ChatReact MCP szerver a https://www.chatreact.ai/api/mcp címen van hosztolva és HTTP-n (JSON-RPC) kommunikál. Hitelesítés Authorization: Bearer fejléc használatával — X-API-Key fejléc ugyanazzal a kulccsal szintén elfogadott.

Cursor IDE

A Cursor natívan támogat távoli MCP szervereket. Adja hozzá a Cursor MCP beállításaihoz:

{
  "mcpServers": {
    "chatreact": {
      "url": "https://www.chatreact.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer cr_your_api_key_here"
      }
    }
  }
}

Claude Desktop

A Claude Desktop konfigurációs fájl parancs-alapú szervereket támogat, ezért használja a szabványos mcp-remote hidat a hosztolt végpont csatlakoztatásához:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "chatreact": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.chatreact.ai/api/mcp",
        "--header",
        "X-API-Key:cr_your_api_key_here"
      ]
    }
  }
}

Ehhez a beállításhoz Node.js telepítése szükséges. A példa a X-API-Key fejlécet használja, mert néhány kliens nem kezeli megbízhatóan a szóközöket az argumentumokban.

3. AI asszisztens újraindítása

A konfiguráció mentése után indítsa újra a Claude Desktopot vagy a Cursort a kapcsolat létrehozásához.

Elérhető eszközök

A ChatReact MCP az alábbi eszközöket tárja fel, területenként csoportosítva. A Scope oszlop azt a API kulcs jogosultságot mutatja, amelyet egy eszköz igényel (any = minden érvényes kulcs). Az eszközök ugyanazokkal az alkalmazható jogosultságokkal, csomagkorlátokkal és mellékhatásokkal futnak, mint a dashboard műveletei. A böngészőhöz kötött fizetési, postafiók-engedélyezési, passkey, fióktörlési és kulcs-kezelési munkafolyamatok a dashboardon maradnak.

Destruktív eszközök (törlés, visszaállítás, lezárás, egyesítés) megerősítést kérnek, amikor a Dashboard Assistanton keresztül használják őket. API kulccsal azonnal végrehajtódnak.

Account

ToolDescriptionScope
account_usage_getLekéri a jelenlegi csomagot (szint, státusz), az aktuális számlázási időszak használati számlálóit (vállalatok, csevegőbotok, csapattagok, csevegések, tokenek) és a csomag korlátait, továbbá a hívásnak alávetett cég hatályos korlátait és funkciózászlóit.any
user_companiesFelsorolja az összes vállalatot, amelyhez a jelenlegi felhasználó hozzáfér, és a felhasználó szerepét mindegyikben.any
user_notification_mark_readMegjelöl egyike a jelenlegi felhasználó értesítéseinek olvasottként.any
user_notification_preferences_getLekéri a jelenlegi felhasználó értesítési beállításait: globális email/push kapcsolók, összegző gyakoriság/ido/napidőzóna, csendes időszak és típusonkénti csatorna beállítások.any
user_notification_preferences_updateFrissíti a jelenlegi felhasználó globális értesítési beállításait (email/push kapcsolók, összegző ütemezés, csendes órák).any
user_notification_type_setting_updateEngedélyezi vagy letiltja az email / in-app kézbesítést egyetlen értesítéstípusra a jelenlegi felhasználónál (pl.any
user_notification_types_listFelsorolja az összes értesítéstípust kategóriánként csoportosítva (chatbot, leadek, élő chat, tudás, csapat, számlázás).any
user_notification_unread_countLekéri a jelenlegi felhasználó olvasatlan értesítéseinek számát.any
user_notificationsFelsorolja a jelenlegi felhasználó értesítéseit, legújabb elöl, kurzoros lapozással.any
user_notifications_delete_oldKarbantartás: véglegesen törli a jelenlegi felhasználó már elolvasott, 30 napnál régebbi értesítéseit.any
user_notifications_mark_all_readMegjelöli az összes értesítést olvasottként a jelenlegi felhasználónál.any
user_profileLekéri a jelenlegi felhasználó profilját (id, név, email, szerep, előfizetési szint).any

Company & Team

ToolDescriptionScope
company_chatbots_listFelsorolja egy adott vállalat összes chatbotját összefoglaló statisztikákkal.chatbots:read
company_getRészletes információt ad a vállalatról: profil, tulajdonos, márka beállítások (színek, értesítési email) és darabszámok.any
company_invite_cancelTörli (visszavonja) egy csapatmeghívót, hogy a link ne működjön tovább.company:write
company_invite_resendÚjraküld egy függő csapatmeghívót: új tokent ad ki, 7 nappal meghosszabbítja a lejáratot, és újraküldi az emailt.company:write
company_invites_listFelsorolja egy vállalat csapatmeghívóit (alapértelmezésben függő; includeExpired beállítással lejártat is visszaad).company:read
company_listFelsorolja az összes vállalatot, amelyhez a felhasználó hozzáfér (API kulcsok és a Dashboard Assistant csak a saját vállalatukat látják).any
company_logo_removeEltávolítja a vállalati logót (törli a tárolt képet és kitörli a logo URL-t).company:write
company_member_inviteMeghív egy csapattagot emailben szereppel (ADMIN, MANAGER, AGENT vagy VIEWER).company:write
company_member_removeEltávolít egy csapattagot a vállalattól.company:write
company_member_update_roleMegváltoztat egy csapattag szerepét (ADMIN, MANAGER, AGENT vagy VIEWER).company:write
company_members_listFelsorolja a vállalat tagjait szerepük szerint (OWNER, ADMIN, MANAGER, AGENT, VIEWER).any
company_settings_updateFrissíti a vállalat márka beállításait: primaryColor / secondaryColor (#RRGGBB) és az értesítésiEmailt a csevegés-áttekintésekhez.company:write
company_updateFrissíti a vállalat profilját: név (2-100 karakter), leírás (max 1000 karakter) vagy weboldal (https:// automatikusan hozzáadódik; üres stringgel törölhető weboldal/leírás).company:write

Chatbot Management

ToolDescriptionScope
chatbot_add_instructionÚj core instruction hozzáadása egy chatbothoz (1-5000 karakter).chatbots:write
chatbot_confirm_embedMegjelöli, hogy a chatbot be van ágyazva a weboldalon (elrejti a dashboard beállítás emlékeztetőt).chatbots:write
chatbot_createLétrehoz egy új chatbotot (ugyanaz, mint a dashboard varázsló).chatbots:write
chatbot_deleteVéglegesen töröl egy chatbotot minden GYIK-jával, dokumentumával, csevegésével, leadjével és űrlapjaival együtt (visszafordíthatatlan).chatbots:write
chatbot_delete_instructionTöröl egy core instructiont egy chatbotból.chatbots:write
chatbot_getRészletes információt ad egy chatbotról: általános beállítások, személyiség (persona, tónus, nyelvek, korlátozások), widget beállítások, élő chat, tanulási fázis, beágyazottság és darabszámok.chatbots:read
chatbot_get_embed_codeLekéri a HTML snippetet egy chatbot telepítéséhez weboldalon (script URL + <script> tag) és hogy a beágyazás megerősítve van-e.chatbots:read
chatbot_get_instructionsLekéri az összes core instructiont egy chatbothoz.chatbots:read
chatbot_improve_instructionsÁtírja a core-instruction szövegét a platform AI javítójával (ugyanaz, mint a dashboard "Improve with AI").chatbots:write
chatbot_learning_phase_getLekéri egy chatbot tanulási fázis beállításait: viselkedés preset (CAUTIOUS, BALANCED, CONFIDENT), egyedi prompt és hogy a bot még mindig a tanulási fázisban van-e.chatbots:read
chatbot_learning_phase_updateBeállítja a tanulási fázis viselkedés presetjét (CAUTIOUS = bizonytalanság esetén emberhez irányít, BALANCED, CONFIDENT) és/vagy egy egyedi learning-phase promptot.chatbots:write
chatbot_listFelsorolja az összes chatbotot, amelyhez a felhasználónak hozzáférése van, összefoglaló statisztikákkal.chatbots:read
chatbot_reorder_instructionsBeállítja egy chatbot core instructionjeinek sorrendjét.chatbots:write
chatbot_templates_listFelsorolja a chatbot sablonokat (persona, tónus, üzenetek és widget viselkedés előbeállításai), amelyeket templateId-ként lehet átadni a chatbot_create-nek, és hogy a cég csomagja használhatja-e őket.chatbots:read
chatbot_toggle_activeAktivál vagy deaktivál egy chatbotot.chatbots:write
chatbot_toggle_learningVégezteti (false) vagy újra engedélyezteti (true) egy chatbot tanulási fázisát.chatbots:write
chatbot_updateFrissíti egy chatbot általános beállításait: név, leírás, isActive, élő chat (liveChatEnabled/liveChatMode, csomag funkció), showBranding (white-label csomagok), chat-review email-ek, FAQ automatikus generálás, legacy coreInstructions szöveg, tanulási fázis (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt).chatbots:write
chatbot_update_instructionFrissít egy meglévő core instructiont (tartalom, isActive, csatorna, sortOrder).chatbots:write
chatbot_update_personalityFrissíti egy chatbot személyiségét: persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), tónus csúszkák 1-5, nyelvek (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), üzenetek (welcomeMessage, fallbackMessage, proactive greeting) és korlátozások (blacklistTopics, complianceRules, maxResponseLength, human handoff).chatbots:write
widget_settings_getLekéri egy chatbot aktuális widget beállításait (minden megjelenési, márka-, viselkedési és pre-chat űrlap mező).chatbots:read
widget_settings_updateFrissíti egy chatbot chat widgetjét: pozíció (beleértve.chatbots:write
widget_translations_getLekéri egy chatbot nyelvenkénti widget fordításait: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }.chatbots:read
widget_translations_updateBeállítja a nyelvenkénti widget fordításokat.chatbots:write

Knowledge Base

ToolDescriptionScope
crawler_job_cancelMegszakít egy PENDING vagy RUNNING crawl feladatot; a fennmaradó oldalakat kihagyja.knowledge:write
crawler_job_getLekéri egy crawl feladat státuszát, előrehaladását (pagesCrawled/pagesFound, tokensUsed) és az egyes oldalak státuszát.knowledge:read
crawler_jobs_listFelsorolja egy chatbot crawl feladatait (legújabb elöl) státusszal és előrehaladással.knowledge:read
crawler_limitsLekéri a csomag crawl korlátait egy chatbothoz (max oldalak per crawl, tokenek oldalanként, crawls havonta) és hogy indítható-e új crawl ebben a hónapban.knowledge:read
crawler_preview_scanFeltérképez egy weboldalt és listázza a feltérképezhető oldalakat (url, cím, isRecommended) importálás nélkül.knowledge:write
crawler_startElindít egy crawl munkát, amely importálja a kiválasztott URL-eket a chatbot tudásbázisába (háttérben feldolgozva; poll crawler_job_get).knowledge:write
knowledge_document_add_from_urlLetölt egy dokumentumot (PDF, TXT, MD, CSV, JSON, DOCX; max 10 MB) egy nyilvános http(s) URL-ről és hozzáadja a chatbot tudásbázisához.knowledge:write
knowledge_document_add_textHozzáad egy szöveg vagy markdown dokumentumot egy chatbot tudásbázisához inline tartalomból (max 10 MB).knowledge:write
knowledge_document_deleteTöröl egy feltöltött dokumentumot a tudásbázisból.knowledge:write
knowledge_document_getLekéri egy feltöltött dokumentum részleteit, beleértve a feldolgozási státuszt, hibajelzést és egy rövid élettartamú letöltési URL-t.knowledge:read
knowledge_documents_listFelsorolja a feltöltött dokumentumokat (PDF, TXT, MD, CSV, JSON, DOCX) egy chatbot tudásbázisában státusszal és mérettel.knowledge:read
knowledge_page_addFeltérképez egyetlen URL-t és hozzáadja a chatbot tudásbázisához (CONFLICT hibát ad, ha az URL már indexelve van, FORBIDDEN-t, ha elérte a token limitet).knowledge:write
knowledge_page_deleteTöröl egy feltérképezett oldalt a tudásbázisból (eltávolítja a vektor-tároló fájlját).knowledge:write
knowledge_page_getLekéri egy feltérképezett oldalt, beleértve az indexelt markdown tartalmat a chatbot számára (hasznos annak ellenőrzéséhez, mit tud a bot egy oldalról).knowledge:read
knowledge_page_recrawlÚjra lekéri egy feltérképezett oldalt és kicseréli az indexelt tartalmát (pl.knowledge:write
knowledge_pages_deleteTöbb feltérképezett oldalt töröl egyszerre egy chatbotból.knowledge:write
knowledge_pages_listFelsorolja a feltérképezett oldalakat egy chatbot tudásbázisában, opcionálisan domain, státusz vagy keresőkifejezés (URL/cím) szerint szűrve.knowledge:read
knowledge_statsÁttekintés egy chatbot tudásbázisáról: dokumentumok (státusz, méret szerint), feltérképezett oldalak és weboldalak (státusz szerint), crawl feladatok, core instructionök forrás szerint bontva (kézi vs improvement agent), GYIK-ek, vektor tároló státusz/méret és tárhelyhasználat vs.knowledge:read
knowledge_website_deleteTöröl minden feltérképezett oldalt egy weboldalról (domain) a chatbot tudásbázisából.knowledge:write
knowledge_website_recrawlÚjrafeltérképez egy weboldal (domain) minden oldalát a chatbot tudásbázisában a tartalom frissítéséhez.knowledge:write
knowledge_website_recrawl_cancelMegszakít egy folyamatban lévő weboldal újrafeltérképezést: a domainhez sorolt sorban álló (PENDING) oldalak visszaállnak korábbi indexelt állapotukra.knowledge:write
knowledge_websites_listFelsorolja azokat a weboldalakat (domaineket), amelyek oldalai egy chatbot tudásbázisában vannak, oldalankénti darabszámokkal státusz szerint és token összesítőkkel.knowledge:read

Price Management

Ezek az eszközök strukturált árajánlat vázlatokat és explicit jóváhagyásokat kezelnek. Vázlat mentése külön van az adott verzió jóváhagyásától; jogosultság függ a státusztól és érvényességtől is. A meglévő API kulcsok nem kapnak automatikusan árkezelési jogosultságokat. Csak a vállalat tulajdonosa tud prices:write vagy prices:approve jogosultságot adni. API-kulcs hívások közvetlenül végrehajtódnak, ezért hívás előtt ellenőrizze a pontos bemenetet. Lásd a Prices & services oldalt az ügyfél munkafolyamatért.

ToolDescriptionScope
price_listLapozza az árfejléceket és külön kezeli az elfogadott verzió jogosultságát.prices:read
price_getTeljes tétel állapot és revíziók olvasása.prices:read
price_detailTétel részleteinek olvasása lapozott revíziós előzményekkel.prices:read
price_suggestions_listLapozás árjavaslatokon.prices:read
price_createVázlat létrehozása szerver-generált tétel ID-vel.prices:write
price_editÚj vázlat létrehozása explicit várt tétel verzióból.prices:write
price_import_csvVázlatok importálása explicit formátummal és stabil import ID-vel biztonságos újrapróbáláshoz.prices:write
price_suggestion_applyA kiválasztott javaslat jelölt alkalmazása vázlatként.prices:write
price_approveEgy explicit várt tétel verziójának jóváhagyása.prices:approve
price_approve_manyExplicit ID/verzió kiválasztás atomikus jóváhagyása; bármely elavult verzió elutasítja az egész kiválasztást.prices:approve
price_archiveEgy tétel archiválása az explicit várt verzión.prices:approve

A vázlat szerkesztések megőrzik az előző jóváhagyott revíziót. A CSV formátumot és a tizedeselválasztót explicit módon kell megadni; megváltozott CSV-tartalom új import ID-t igényel. Minden művelet az API kulcs vállalatához és a megadott chatbothoz kötődik.

FAQ Management

ToolDescriptionScope
faq_cache_purgeTörli a gyorsítótárazott GYIK widget adatokat az összes csatlakoztatott CMS oldalon (WordPress bővítmény).faqs:write
faq_categories_listFelsorolja egy chatbot GYIK kategóriáit azok GYIK számaival, slugjaival, rendezési módjával és fordításaival.faqs:read
faq_categories_reorderBeállítja a GYIK kategóriák sorrendjét a widgetben: a categoryIds pozíciója lesz a sortOrder.faqs:write
faq_category_createLétrehoz egy GYIK kategóriát egy chatbothoz (a slug a névből generálódik).faqs:write
faq_category_deleteTöröl egy GYIK kategóriát.faqs:write
faq_category_translations_updateKicseréli egy GYIK kategória fordításait, pl.faqs:write
faq_category_updateÁtnevezi egy GYIK kategóriát vagy megváltoztatja leírását, ikonját vagy rendezési módját.faqs:write
faq_createLétrehoz egy GYIK-et egy chatbot számára.faqs:write
faq_deleteVéglegesen töröl egy GYIK-et (egyben eltávolítja a chatbot tudásbázisából és kipucolja a CMS widget gyorsítótárakat).faqs:write
faq_embed_code_getLekéri a GYIK widget beágyazáshoz szükséges snippetjeit: script tag, WordPress shortcode és Shopify Liquid snippet, valamint kategória szerinti variánsok (használja a categorySlug-ot a faq_categories_list-ből, ha csak egy kategóriát akar beágyazni).chatbots:read
faq_getLekéri egy GYIK teljes részleteit: kérdés, válasz, kategória, publikálási állapot, rendezési sorrend, fordítások, SEO mezők és visszajelzési statisztikák.faqs:read
faq_listFelsorolja egy chatbot GYIK-jeit (használja a chatbot_list-et a chatbotId megtalálásához).faqs:read
faq_reorderBeállítja a GYIK-ek megjelenési sorrendjét a widgetben.faqs:write
faq_suggestion_approveJóváhagy egy PENDING GYIK javaslatot: létrehoz egy publikált GYIK-et (opcionálisan szerkesztett kérdéssel/válasszal/kategóriával) és megjelöli a javaslatot APPROVED-ként.faqs:write
faq_suggestion_getLekéri egy GYIK javaslat teljes részleteit (teljes válasz, AI érvelés, javasolt kategória, felülvizsgálati állapot).faqs:read
faq_suggestion_rejectElutasít egy PENDING GYIK javaslatot opcionális indoklással.faqs:write
faq_suggestions_generateHadd generáljon az AI új GYIK-eket a chatbot tudásbázisából (feltérképezett oldalak / feltöltött dokumentumok), opcionálisan egy kategóriára korlátozva.faqs:write
faq_suggestions_listFelsorolja az AI által generált GYIK javaslatokat egy chatbothoz (chat beszélgetésekből vagy faq_suggestions_generate-ből).faqs:read
faq_translateAI segítségével lefordít egy GYIK kérdését és válaszát a chatbot által támogatott további nyelvekre (vagy a megadott targetLanguages-re) és elmenti az eredményt.faqs:write
faq_translations_updateMent GYIK fordításokat nyelvenként, pl.faqs:write
faq_updateFrissít egy GYIK kérdését, válaszát, kategóriáját, publikálási állapotát vagy kézi rendezési sorrendjét.faqs:write
faq_widget_settings_getLekéri az beágyazható GYIK widget megjelenési és viselkedési beállításait (színek, border radius, cím, spacing, max width, allowMultipleOpen, autoOpenFirst, sort mode, cím fordítások).chatbots:read
faq_widget_settings_updateFrissíti a GYIK widget beállításait: színek (hex), borderRadius 0-32, cím (max 100) + showTitle, spacing compact|normal|relaxed, maxWidth 0-2000 (0 = teljes szélesség), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name és cím fordítások nyelvenként.chatbots:write

Chat History & Feedback

ToolDescriptionScope
chat_feedback_dismissMegjelöl egy csevegést felülvizsgáltként anélkül, hogy értékelné (eltávolítja a függő sorból, nem változtatja a bizalmi pontszámot).chats:write
chat_feedback_getLekéri egy csevegés felülvizsgálatát (visszajelzés) AI elemzéssel, súlyossággal, bizalmi kategóriával, pontszámváltozással és a kapcsolódó improvement sessionnel.chats:read
chat_feedback_listFelsorolja egy chatbot csevegés felülvizsgálatait (visszajelzési sorok) státusz szűrővel és darabszámokkal.chats:read
chat_feedback_set_severityFelülírod a súlyosság besorolást (MINOR|MODERATE|MAJOR|CRITICAL) egy negatív felülvizsgált csevegésnél; a súlyosság befolyásolja a bizalmi pontszám csökkenését.chats:write
chat_feedback_statsMunkamenet számlálók felülvizsgálati vödrönként egy chatbothoz (összesen, nincs, függő, pozitív, negatív, felülvizsgált, javított) — a dashboard chats oldal stat kártyái.chats:read
chat_feedback_submitÉrtékel egy csevegési munkamenetet Jó (isPositive=true) vagy Javítandó (isPositive=false) minősítéssel.chats:write
chat_session_getLekéri egy csevegési munkamenetet a teljes átirattal (üzenetenként token/model/latencia/pageUrl), látogató adatokkal, indító oldal URL-jével, bizalmi kategóriával, visszajelzéssel (súlyosság, AI elemzés, kapcsolódó improvement session) és címkékkel.chats:read
chat_session_searchÜzenettartalom és/vagy látogató email szerint keres csevegési munkamenetekben egy chatbotnál.chats:read
chat_session_set_categoryHozzárendeli vagy megváltoztatja egy csevegés munkamenet bizalmi kategóriáját (korrigálja az AI besorolást; per-kategória bizalom újraszámolódik, amikor a csevegést felülvizsgálták).chats:write
chat_sessions_listFelsorolja egy chatbot csevegési munkameneteit, legújabb elöl, ugyanazokkal a felülvizsgálati sor szűrőkkel, mint a dashboard chats oldala.chats:read

Improvement Agent

ToolDescriptionScope
confidence_categories_listFelsorolja egy chatbot bizalmi kategóriáit per-kategória bizalmi pontszámmal, felülvizsgálati számmal és felülvizsgálati email gyakorisággal.chats:read
confidence_category_createLétrehoz egy bizalmi kategóriát egy chatbothoz.chatbots:write
confidence_category_deleteTöröl egy bizalmi kategóriát.chatbots:write
confidence_category_mergeEgy bizalmi kategória egy másikba történő egyesítése ugyanannál a chatbotnál: minden csevegés/felülvizsgálat átkerül a célba, a forrás törlésre kerül és a pontszámok újraszámolódnak.chatbots:write
confidence_category_updateÁtnevezi egy bizalmi kategóriát és/vagy beállítja a felülvizsgálati email gyakoriságát (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1-24 csak HOURLY esetén).chatbots:write
confidence_status_getEgy chatbot bizalmi állapota: pontszám, graduációs küszöb, learning phase flag, learning-phase viselkedés (CAUTIOUS|BALANCED|CONFIDENT) és egyedi prompt, felülvizsgálati számlálók és per-kategória bizalmi pontszámok.analytics:read
improvement_proposal_approveJóváhagy egy PENDING improvement javaslatot és alkalmazza a változást a chatboton (core instruction hozzáadás/frissítés, FAQ létrehozás/frissítés vagy persona frissítése) — ugyanaz a logika és csomagkorlátok, mint a dashboardon.chatbots:write
improvement_proposal_rejectElutasít egy PENDING improvement javaslatot.chatbots:write
improvement_proposal_simulateSzimulálja, hogyan válaszolna a chatbot a problémás üzenetre a javaslat alkalmazásával (eredeti vs.chatbots:write
improvement_proposals_pendingFelsorolja a felülvizsgálatra váró improvement javaslatokat (PENDING státusz) a vállalaton belül vagy egy chatbotra vonatkozóan.chatbots:read
improvement_session_completeMegjelöli egy improvement sessiont COMPLETED-ként (a csevegés ezután Improved-ként számít a felülvizsgálati sorban).chatbots:write
improvement_session_createMegnyitja az Improvement Agent-et egy Needs Work-ként értékelt csevegéshez.chatbots:write
improvement_session_getLekéri egy improvement session részleteit az eredeti csevegéssel (az üzenetek 1-alapú indexet kapnak, amely használható targetMessageIndex-ként), az agent beszélgetéssel, az összes javaslattal (az utolsó szimulációval) és szimulációkkal.chatbots:read
improvement_session_resetÚjraindít egy improvement sessiont: törli az összes agent üzenetet, szimulációt és a PENDING/REJECTED javaslatokat (alkalmazott javaslatok megmaradnak) és új beszélgetést indít.chatbots:write
improvement_session_send_messageÜzenetet küld az Improvement Agent-nek (írja le, mi volt a probléma a bot válaszával; opcionálisan targetMessageIndex = az eredetiChat.messages-beli bot üzenet 1-alapú indexe).chatbots:write
improvement_sessions_listFelsorolja az improvement sessionöket (Improvement Agent beszélgetések, amelyeket negatív csevegés felülvizsgálatok indítottak) egy chatbotra vagy az egész vállalatra, legújabb elöl, javaslat számlálókkal.chatbots:read
improvement_simulation_assessÉrtékeli egy szimuláció eredményét: isApproved=true, ha a szimulált válasz jó (a javaslat ezután alkalmazható), false, ha további munkát igényel (komment 'almost' = majdnem jó).chatbots:write

Live Chat

ToolDescriptionScope
live_chat_agents_availableLekéri a jelenlegi felhasználó saját élő chat elérhetőségét, az aktuálisan elérhető ügynököket élő chathez (friss heartbeat, ugyanaz a jelzés, amelyet a widget használ) és hogy a cég csomagja tartalmazza-e az élő chat-et.chats:read
live_chat_heartbeatFrissíti a jelenlegi felhasználó élő chat jelenlét heartbeat-jét (csak amíg elérhetőként van megjelölve live_chat_set_availability-vel).chats:write
live_chat_message_sendÜzenetet küld a látogatónak a hozzárendelt ügynökként.chats:write
live_chat_queueLekéri az élő chat sort: munkamenetek, amelyek ügynököt várnak, legrégebbi elöl (FIFO).chats:read
live_chat_session_assignÁtvesz egy WAITING élő chat munkamenetet a sorból: hozzárendeli a jelenlegi felhasználóhoz (API kulcsok esetén a vállalat tulajdonosa) és értesíti a látogatót, hogy az ügynök csatlakozott.chats:write
live_chat_session_closeBefejez egy élő chat munkamenetet ügynökként (bármely nem-VIEWER vállalati tag).chats:write
live_chat_session_getLekéri egy élő chat munkamenet adatait látogató információval, hozzárendelt ügynökkel, minden üzenettel és az előző bot beszélgetéssel (handoff kontextus).chats:read
live_chat_sessions_listFelsorolja az élő chat munkameneteket (legújabb elöl; WAITING munkamenetek legrégebbitől) opcionális szűrőkkel chatbot, státusz és hozzárendelt ügynök szerint.chats:read
live_chat_set_availabilityKi-/bekapcsolja a jelenlegi felhasználó "Available for Live Chat" kapcsolóját egy vállalatra.chats:write

Leads

ToolDescriptionScope
lead_assignHozzárendel vagy eltávolít egy leadet egy vállalati tagnak (assignedToId: null).leads:write
lead_bulk_update_statusTöbb lead státuszát egyszerre állítja be (max 100).leads:write
lead_categories_listFelsorolja egy chatbot lead kategóriáit lead számlálásokkal és kategóriánként a csapattagokat, akiket értesítenek.leads:read
lead_category_assign_userHozzáad egy vállalati tagot egy lead kategória értesítési listájához (vagy frissíti értesítési jelzőit).leads:write
lead_category_createLétrehoz egy lead kategóriát egy chatbothoz.leads:write
lead_category_deleteTöröl egy lead kategóriát.leads:write
lead_category_remove_userEltávolít egy vállalati tagot egy lead kategória értesítési listájáról.leads:write
lead_category_updateFrissíti egy lead kategória nevét, leírását és/vagy színét.leads:write
lead_createLead létrehozása kézzel (pl.leads:write
lead_deleteVéglegesen töröl egy leadet.leads:write
lead_field_config_getLekéri egy chatbot lead capture konfigurációját: mezők (id-k megfelelnek a lead.data kulcsainak), megerősítő üzenet, mező/UI fordítások és AI felismerés beállítások.leads:read
lead_field_config_updateFrissíti egy chatbot lead capture konfigurációját.leads:write
lead_getLekéri egy lead teljes részleteit, beleértve a hozzárendeltet, kategóriát és az eredeti chat átiratot (lapozott messageOffset/messageLimit, alapértelmezésben az első 20 üzenet).leads:read
lead_listFelsorolja egy chatbot leadjeit (legújabb elöl) opcionális szűrőkkel státusz, kategória, hozzárendelt és szabad szöveges keresés (név/email/cég) szerint.leads:read
lead_statsLekéri egy chatbot lead statisztikáit: számlálások státusz szerint, az elmúlt 7 nap leadjei és a konverziós arány (százalék).leads:read
lead_updateFrissíti egy lead státuszát, kategóriáját, jegyzeteit, rögzített adatait és/vagy hozzárendeltjét.leads:write

Forms

ToolDescriptionScope
form_createLétrehoz egy kapcsolatfelvételi űrlapot egy chatbothoz (alapok, mezők, dizájn és spam beállítások egy hívásban).forms:write
form_deleteVéglegesen töröl egy kapcsolatfelvételi űrlapot és MINDEN beküldését (kaszkád).forms:write
form_getLekéri egy kapcsolatfelvételi űrlapot teljes egészében: mezők, fordítások, stílus, spam beállítások, aktív állapot, beküldési darabszám és a beágyazó script tag (embedCode).forms:read
form_listFelsorolja egy chatbot kapcsolatfelvételi űrlapjait mezőszámokkal, beküldési darabszámokkal és beágyazó kódokkal.forms:read
form_statsEgy kapcsolatfelvételi űrlap beküldési számai: összesen, függő, jóváhagyott, spam és elutasított.forms:read
form_submission_deleteVéglegesen töröl egy kapcsolatfelvételi űrlap beküldést (pl.forms:write
form_submission_getLekéri egy kapcsolatfelvételi űrlap beküldését teljes egészében: beküldött mezőadatok, spam pontszám és AI spam elemzés, IP/user agent/referrer metaadatok és felülvizsgálati információk.forms:read
form_submission_update_statusFelülvizsgál egy beküldést: státuszát APPROVED, SPAM vagy REJECTED értékre állítja opcionális felülvizsgálati megjegyzéssel.forms:write
form_submissions_listFelsorolja egy kapcsolatfelvételi űrlap beküldéseit, legújabb elöl, opcionálisan státusz (PENDING, APPROVED, SPAM, REJECTED) és létrehozás dátuma szerint szűrve.forms:read
form_updateFrissít egy kapcsolatfelvételi űrlapot: név, leírás, aktív állapot (isActive szabályozza, hogy a beágyazás megjelenik-e), mezők (teljes csere), dizájn (színek, gomb szöveg, sikerüzenet) és spam beállítások (spamThreshold, autoRejectSpam, notificationEmail).forms:write
form_update_translationsKicseréli egy űrlap mező és/vagy UI fordításait.forms:write

Email Assistant

ToolDescriptionScope
email_activity_listFelsorolja egy postafiók kapcsolat feldolgozott-email aktivitási naplóját (legújabb elöl): feladó, tárgy, hozzárendelt kategória, eredmény (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) és outcomeDetail.email:read
email_categories_listFelsorolja egy postafiók kapcsolat email kategóriáit (sortOrder szerint rendezve).email:read
email_category_createLétrehoz egy email kategóriát egy postafiók kapcsolathoz (max 20 per connection).email:write
email_category_deleteTöröl egy email kategóriát.email:write
email_category_updateFrissít egy email kategóriát (részleges: csak a megadott mezők változnak).email:write
email_connection_disconnectVéglegesen lekapcsol egy postafiókot.email:write
email_connection_getLekéri egy postafiók kapcsolódását beleértve.email:read
email_connection_updateFrissít egy postafiók kapcsolatot: szinkronizálás szüneteltetése/folytatása (paused true/false; csak ACTIVE<->DISABLED váltást végzi, soha nem írja felül TOKEN_EXPIRED/ERROR állapotot), választervezet készítésének kapcsolója (draftingEnabled) és kategorizálás/szervezés kapcsolója (organizingEnabled), a tápláló chatbot átirányítása (ugyanazon vállalat chatbotId-ja) vagy a HTML válasz aláírás beállítása (signatureHtml, max 20000 karakter; üres string törli).email:write
email_connections_listFelsorolja a vállalat Email Assistant postafiók kapcsolatait (cím, státusz ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, utolsó szinkron, utolsó hiba, drafting/organizing kapcsolók, powering chatbot, draftReadyCategoryCount = kategóriák, amelyekből vázlatok készülhetnek, baseRuleCount = chatbot-szintű 'Chat + Email' szabályok minden vázlathoz) a csomag korlátokkal együtt (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth).email:read
email_contact_deleteTöröl egy tanult email kapcsolattartót (elfelejti a feladó profilját, pl.email:write
email_contact_getLekéri egy tanult email kapcsolattartó minden tanult tényét, belső jegyzeteit, kapcsolatot, formális/informális megszólítás beállítást és email statisztikákat.email:read
email_contact_updateFrissít egy tanult email kapcsolattartót.email:write
email_contacts_listFelsorolja a vállalat tanult email kapcsolatait (legutóbbi email alapján rendezve) kapcsolat, formális/informális megszólítás (formalAddress: true = formális 'Ön', false = informális 'te', null = automatikus), tény számláló és jegyzet előnézet megjelenítésével.email:read
email_folder_createLétrehoz egy mappát a beérkező alá (visszaadja a meglévőt, ha a név foglalt), hogy célként használható legyen kategória áthelyezéshez.email:write
email_folders_listFelsorolja azokat a mappákat, amelyekbe egy email kategória levelet áthelyezhet élőben a postafiókból: beérkező almappái, egyéni felső szintű mappák, archivum, spam és kuka (id 'deleteditems').email:read
email_general_rules_listFelsorolja a chatbot-szintű szabályokat, amelyek minden postafiók vázlatra alkalmazandók: aktív core instructionok BOTH csatornával ("Chat + Email"), plusz legacy email-only szabályok, amelyek még nincsenek kategóriába migrálva.email:read

Analytics

ToolDescriptionScope
analytics_chat_volumeCsevegés volumen (indult munkamenetek) időbeli bontásban diagramokhoz és trendekhez: period week/month/quarter/year, granularitás hour/day/week/month, opcionálisan egy chatbothoz.analytics:read
analytics_chatbot_statsEgy hívásban a vállalat per-chatbot teljesítménye (a dashboard chatbot teljesítmény táblázata): id, név, slug, isActive, sessions, messages, FAQs és leads chatbotonként, sessions szerint rendezve.analytics:read
analytics_formsKapcsolatfelvételi űrlap beküldési statisztikák egy vállalatra vagy egy chatbotra (dashboard analytics widget): beküldések státusz szerint (pending/approved/rejected/spam), űrlapok száma, összesen, spam arány százalékban és az utolsó 7 nap beküldés-napi sorozata.analytics:read
analytics_leadsLead tölcsér egy vállalatra vagy egy chatbotra (dashboard analytics widget): leadek státusz szerint (new/contacted/qualified/converted/lost), összesen, konverziós arány százalékban és az utolsó 7 nap lead-napi sorozata.analytics:read
analytics_overviewAnalitika áttekintés egy vállalatra vagy egy chatbotra: csevegések, üzenetek, elégedettségi arány és top kérdések egy gördülő periódusra (day/week/month/year), plusz a dashboard áttekintő widgetje (összes chatbot/publikált GYIK/lead, sessions ma/ez a hét/ez a hónap, leadek ma/ez a hét, űrlap beküldések összesen/ma/pending).analytics:read
dashboard_activityMi igényel jelenleg figyelmet (a dashboard kezdő nézet): per vállalat, a chatbotok, amelyeknek új leadjei vannak ma, függő GYIK javaslatok, függő űrlap beküldések, várakozó/aktív élő chatek vagy egy folyamatban lévő tanulási fázis.any

Példa munkafolyamatok

Core Instruction hozzáadása

Kérje meg AI asszisztensét:

"Add a core instruction to my 'Support Bot' chatbot: we offer free shipping on orders over €50"

Az asszisztens a megfelelő paraméterekkel a chatbot_add_instruction hívást fogja használni.

Improvement javaslatok felülvizsgálata

"Show me all pending improvement proposals for my chatbot and explain what changes they suggest"

Az asszisztens a következőket teszi:

  1. Használja a improvement_proposals_pending-et a javaslatok lekéréséhez
  2. Elemezi és összefoglalja az egyes javaslatokat
  3. Jóváhagyja vagy elutasítja őket az Ön nevében a improvement_proposal_approve vagy improvement_proposal_reject segítségével

Csevegés teljesítményének elemzése

"Give me a weekly report of chat volume and customer satisfaction for my chatbot"

Az asszisztens a analytics_overview-et és a analytics_chat_volume-et használja egy átfogó jelentés összeállításához.

Weboldal importálása

"Scan https://example.com, import the product and pricing pages into my 'Support Bot' and tell me when the crawl is done"

Az asszisztens meghívja a crawler_preview_scan-et, kiválasztja a releváns oldalakat, elindítja az importot a crawler_start segítségével és lekérdezi a crawler_job_get-et, amíg a munka be nem fejeződik.

Leadek és űrlap beküldések felülvizsgálata

"Show me the new leads from this week, assign the qualified ones to Anna and approve the pending contact form submissions"

Az asszisztens kombinálja a lead_list-et, lead_assign-et, form_submissions_list-t és form_submission_update_status-t.

Élő chat átvétele

"Set me available for live chat and take the oldest waiting conversation"

Az asszisztens a live_chat_set_availability-et, live_chat_queue-öt és live_chat_session_assign-ot használja; a válaszok a live_chat_message_send-en keresztül mennek.

Biztonság

  • Az API kulcsok a vállalatához és azok jogosultsági scope-jához kötöttek, amelyeket létrehozáskor választ (lásd a Scope oszlopot fent)
  • A kulcsok a vállalat tulajdonosának jogosultságaival hajtódnak végre; a csomagkorlátok és funkciózárak pontosan úgy érvényesek, mint a dashboardon
  • A kulcsok bármikor visszavonhatók a dashboardról
  • Az API hozzáférés fizetős csomagokon érhető el — lásd a Pricing page

Hibaelhárítás

Csatlakozás sikertelen

  1. Ellenőrizze, hogy az API kulcs helyes-e
  2. Győződjön meg róla, hogy a kulcsot nem vonták vissza
  3. Ellenőrizze, hogy a csomagja tartalmazza-e az API hozzáférést
  4. Indítsa újra az MCP kliensét

Eszköz nem található

Indítsa újra az MCP kliensét a konfiguráció megváltoztatása után, hogy újratöltse az elérhető eszközöket. Az eszközök nevei kisbetűsek alulvonásokkal (pl. faq_list).


Szüksége van segítségre? Lépjen kapcsolatba a támogatási csapatunkkal →