DomovDokumentacija

MCP Server Integration

ChatReact uvaja Model Context Protocol (MCP), kar vam omogoča povezavo vašega računa ChatReact z AI asistenti, kot sta Claude Desktop, Cursor in druga orodja, združljiva z MCP.

Kaj je MCP?

Model Context Protocol je odprt standard, ki omogoča AI asistentom interakcijo z zunanjimi storitvami in viri podatkov. Z MCP integracijo ChatReact lahko:

  • Upravljate klepetalne bote — ustvarite, konfigurirate (persona, jeziki, vtičnik, vedenje, omejitve), vgradite in izbrišete klepetalne bote
  • Gradite bazo znanja — dodajate dokumente, prečesavate spletna mesta, upravljate prečesane strani in osnovna navodila
  • Upravljate pogosta vprašanja (FAQ) — FAQ, kategorije, predlogi, prevodi in FAQ vtičnik
  • Pregledujete pogovore — ocenjujete pogovore, dodeljujete kategorije z zaupanjem, zaženete Improvement Agent
  • Delate s potencialnimi strankami in obrazci — potencialne stranke, kategorije leadov, nastavitve zajema, kontaktni obrazci in oddaje
  • Delujete kot agent za živi klepet — nastavite svojo razpoložljivost, prevzamete čakajoče klepete, odgovarjate in zapirate seje
  • Upravljate podjetje — profil, barve blagovne znamke, člane ekipe in povabila
  • Uporabljate Email Assistant — povezave poštnih predalov, kategorije, stike in dejavnost
  • Beredete analitiko in obvestila

Vse, kar lahko storite v nadzorni plošči, je na voljo prek MCP (in REST API); le dejanja, vezana na brskalnik, kot so plačila, OAuth poštnih predalov, passkeyi, brisanje računa in upravljanje API ključev, ostajajo v nadzorni plošči.

Začetek

1. Ustvarite API ključ

  1. Pojdite v vaš Nadzorna plošča → Podjetje → API zavihek
  2. Kliknite Ustvari API ključ
  3. Dajte ključu opisno ime (npr. "Claude Desktop") in izberite vsaj eno dovoljenje
  4. Kopirajte ustvarjeni ključ (se začne s cr_)

API ključi so na voljo v plačljivih paketih — oglejte si našo Pricing page.

Shranite svoj API ključ varno. Po ustvarjanju ga ni mogoče pridobiti nazaj.

2. Konfigurirajte vašega MCP odjemalca

ChatReact MCP strežnik gostuje na https://www.chatreact.ai/api/mcp in komunicira preko HTTP (JSON-RPC). Avtentificirajte se z glavo Authorization: Bearer — sprejeta je tudi glava X-API-Key z istim ključem.

Cursor IDE

Cursor neposredno podpira oddaljene MCP strežnike. Dodajte v svoje Cursor MCP nastavitve:

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

Claude Desktop

Konfiguracijska datoteka Claude Desktop podpira strežnike, ki temeljijo na ukazih, zato uporabite standardni mcp-remote bridge za povezavo na gostujočo končno točko:

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"
      ]
    }
  }
}

Ta postavitev zahteva nameščen Node.js. Primer uporablja glavo X-API-Key, ker nekateri odjemalci ne obravnavajo presledkov v argumentih zanesljivo.

3. Znova zaženite vaš AI asistenta

Po shranjevanju konfiguracije znova zaženite Claude Desktop ali Cursor, da vzpostavite povezavo.

Na voljo orodja

ChatReact MCP izpostavi spodnja orodja, združena po področjih. Stolpec Scope prikazuje dovoljenje API ključa, ki ga orodje zahteva (any = vsak veljaven ključ). Orodja delujejo z enakimi ustreznimi dovoljenji, omejitvami načrta in stranskimi učinki kot operacije, podprte v nadzorni plošči. Dejavnosti, vezane na brskalnik, kot so plačila, avtorizacija poštnih predalov, passkeyi, brisanje računa in upravljanje ključev, ostajajo v nadzorni plošči.

Uničujoča orodja (izbriši, ponastavi, zapri, združi) zahtevajo potrditev, ko se uporabljajo preko Dashboard Assistant. Preko API ključa se izvedejo takoj.

Account

ToolDescriptionScope
account_usage_getPridobi trenutni načrt (tier, status), števec porabe za tekoče obračunsko obdobje (companies, chatbots, team members, chats, tokens) in omejitve načrta, plus dejanske omejitve in funkcijske zastavice podjetja, za katerega je klic omejen.any
user_companiesNaštej vsa podjetja, do katerih ima trenutni uporabnik dostop, z vlogo uporabnika v vsakem od njih.any
user_notification_mark_readOznači eno od obvestil trenutnega uporabnika kot prebrano.any
user_notification_preferences_getPridobi nastavitve obveščanja trenutnega uporabnika: globalni email/push stikala, frekvenco/čas/tedenski dan/časovni pas digestov, tihe ure in nastavitve kanalov po vrsti.any
user_notification_preferences_updatePosodobi globalne nastavitve obveščanja trenutnega uporabnika (email/push stikala, urnik digestov, tihe ure).any
user_notification_type_setting_updateOmogoči ali onemogoči dostavo po e-pošti / v aplikaciji za en tip obvestila trenutnega uporabnika (npr.any
user_notification_types_listNaštej vse tipe obvestil razvrščene po kategorijah (chatbot, leads, live chat, knowledge, team, billing).any
user_notification_unread_countPridobi število neprebranih obvestil trenutnega uporabnika.any
user_notificationsNaštej obvestila trenutnega uporabnika, najnovejša prva, z kurzorsko paginacijo.any
user_notifications_delete_oldHišna opravila: trajno izbriši obvestila trenutnega uporabnika, ki so že prebrana in starejša od 30 dni.any
user_notifications_mark_all_readOznači vsa obvestila trenutnega uporabnika kot prebrana.any
user_profilePridobi profil trenutnega uporabnika (id, name, email, role, subscription tier).any

Company & Team

ToolDescriptionScope
company_chatbots_listNaštej vse klepetalne bote za določeno podjetje s povzetnimi statistikami.chatbots:read
company_getPridobi podrobne informacije o podjetju: profil, lastnik, nastavitve blagovne znamke (barve, e-pošta za obvestila) in štetja.any
company_invite_cancelPrekliči (izbriši) povabilo v ekipo, da povezava preneha delovati.company:write
company_invite_resendPonovno pošlji čakajoče povabilo v ekipo: izda nov žeton, podaljša potek za 7 dni in ponovno pošlje povabilo po e-pošti.company:write
company_invites_listNaštej povabila v ekipo podjetja (privzeto čakajoča; nastavi includeExpired za vračanje tudi poteklih).company:read
company_listNaštej vsa podjetja, do katerih ima uporabnik dostop (API ključi in Dashboard Assistant vidijo le svoje podjetje).any
company_logo_removeOdstrani logotip podjetja (izbriše shranjeno sliko in počisti URL logotipa).company:write
company_member_invitePovabi člana ekipe po e-pošti z vlogo (ADMIN, MANAGER, AGENT ali VIEWER).company:write
company_member_removeOdstrani člana ekipe iz podjetja.company:write
company_member_update_roleSpremeni vlogo člana ekipe (ADMIN, MANAGER, AGENT ali VIEWER).company:write
company_members_listNaštej člane podjetja z njihovimi vlogami (OWNER, ADMIN, MANAGER, AGENT, VIEWER).any
company_settings_updatePosodobi nastavitve blagovne znamke podjetja: primaryColor / secondaryColor (#RRGGBB) in notificationEmail za preglede klepetov.company:write
company_updatePosodobi profil podjetja: ime (2-100 znakov), opis (max 1000 znakov) ali spletno stran (https:// se doda samodejno; pošljite prazen niz za izbris spletne strani/opisa).company:write

Chatbot Management

ToolDescriptionScope
chatbot_add_instructionDodaj novo osnovno navodilo (core instruction) klepetalnemu botu (1-5000 znakov).chatbots:write
chatbot_confirm_embedOznači klepetalnega bota kot vgrajenega na spletni strani (skrije opomnik za nastavitev v nadzorni plošči).chatbots:write
chatbot_createUstvari novega klepetalnega bota (enako kot čarovnik v nadzorni plošči).chatbots:write
chatbot_deleteTrajno izbriši klepetalnega bota z vsemi njegovimi FAQ, dokumenti, pogovori, leadi in obrazci (nepovratno).chatbots:write
chatbot_delete_instructionIzbriši osnovno navodilo iz klepetalnega bota.chatbots:write
chatbot_getPridobi podrobne informacije o klepetalnem botu: splošne nastavitve, osebnost (persona, tonality, jeziki, omejitve), nastavitve vtičnika, živi klepet, faza učenja, status vgradnje in štetja.chatbots:read
chatbot_get_embed_codePridobi HTML izrezek za namestitev klepetalnega bota na spletno stran (URL skripte + <script> tag) in ali je vgradnja potrjena.chatbots:read
chatbot_get_instructionsPridobi vsa osnovna navodila za klepetalnega bota.chatbots:read
chatbot_improve_instructionsPrepiši besedilo osnovnega navodila z AI izboljševalcem platforme (enako kot 'Improve with AI' v nadzorni plošči).chatbots:write
chatbot_learning_phase_getPridobi nastavitve faze učenja klepetalnega bota: vedenjski prednastavitev (CAUTIOUS, BALANCED, CONFIDENT), po meri napisani poziv in ali je bot še v fazi učenja.chatbots:read
chatbot_learning_phase_updateNastavi vedenjski prednastavitev faze učenja (CAUTIOUS = napotitev na človeka, kadar ni prepričan, BALANCED, CONFIDENT) in/ali po meri napisan poziv faze učenja.chatbots:write
chatbot_listNaštej vse klepetalne bote, do katerih ima uporabnik dostop, s povzetnimi statistikami.chatbots:read
chatbot_reorder_instructionsNastavi vrstni red osnovnih navodil klepetalnega bota.chatbots:write
chatbot_templates_listNaštej predloge za klepetalne bote (prednastavitve za persono, tonality, sporočila in vedenje vtičnika), ki jih je mogoče posredovati kot templateId v chatbot_create, in ali jih lahko podjetje uporablja glede na načrt.chatbots:read
chatbot_toggle_activeAktiviraj ali deaktiviraj klepetalnega bota.chatbots:write
chatbot_toggle_learningKončaj (false) ali ponovno omogoči (true) fazo učenja klepetalnega bota.chatbots:write
chatbot_updatePosodobi splošne nastavitve klepetalnega bota: ime, opis, isActive, živi klepet (liveChatEnabled/liveChatMode, funkcija načrta), showBranding (white-label paketi), e-poštna obvestila za preglede klepetov, samodejna generacija FAQ, besedilo legacy coreInstructions, faza učenja (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt).chatbots:write
chatbot_update_instructionPosodobi obstoječe osnovno navodilo (content, isActive, channel, sortOrder).chatbots:write
chatbot_update_personalityPosodobi osebnost klepetalnega bota: persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), tonality drsniki 1-5, jeziki (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), sporočila (welcomeMessage, fallbackMessage, proactive greeting) in omejitve (blacklistTopics, complianceRules, maxResponseLength, human handoff).chatbots:write
widget_settings_getPridobi trenutne nastavitve vtičnika za klepetalnega bota (vse videzne, blagovne znamke, vedenjske nastavitve in polja pred-klepetnega obrazca).chatbots:read
widget_settings_updatePosodobi klepetalni vtičnik klepetalnega bota: pozicija (vključno zchatbots:write
widget_translations_getPridobi prevode vtičnika po jezikih za klepetalnega bota: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }.chatbots:read
widget_translations_updateNastavi prevode vtičnika po jezikih.chatbots:write

Knowledge Base

ToolDescriptionScope
crawler_job_cancelPrekliči PENDING ali RUNNING nalogo prečesavanja; preostale strani se preskočijo.knowledge:write
crawler_job_getPridobi stanje naloge prečesavanja, napredek (pagesCrawled/pagesFound, tokensUsed) in stanje vsake strani.knowledge:read
crawler_jobs_listNaštej naloge prečesavanja klepetalnega bota (najnovejše prve) z statusom in napredkom.knowledge:read
crawler_limitsPridobi omejitve prečesavanja načrta za klepetalnega bota (max strani na prečesavanje, tokeni na stran, prečesavanja na mesec) in ali se lahko ta mesec začne novo prečesavanje.knowledge:read
crawler_preview_scanSkeniraj spletno stran in naštej prečesljive strani (url, title, isRecommended) brez uvoza ničesar.knowledge:write
crawler_startZačni nalogo prečesavanja, ki uvozi izbrane URL naslove v bazo znanja klepetalnega bota (procesira se v ozadju; poll crawler_job_get).knowledge:write
knowledge_document_add_from_urlPrenesi dokument (PDF, TXT, MD, CSV, JSON, DOCX; max 10 MB) s javnega http(s) URL in ga dodaj v bazo znanja klepetalnega bota.knowledge:write
knowledge_document_add_textDodaj besedilni ali markdown dokument v bazo znanja klepetalnega bota iz vstavljenih vsebin (max 10 MB).knowledge:write
knowledge_document_deleteIzbriši naložen dokument iz baze znanja.knowledge:write
knowledge_document_getPridobi podrobnosti naloženega dokumenta vključno s stanjem obdelave, sporočilom o napaki in kratkotrajno URL za prenos.knowledge:read
knowledge_documents_listNaštej naložene dokumente (PDF, TXT, MD, CSV, JSON, DOCX) v bazi znanja klepetalnega bota z statusom in velikostjo.knowledge:read
knowledge_page_addPrečesaj en URL in ga dodaj v bazo znanja klepetalnega bota (ne uspe z CONFLICT, ko je URL že indeksiran, FORBIDDEN, ko je dosežen limit tokenov).knowledge:write
knowledge_page_deleteIzbriši prečesano stran iz baze znanja (odstrani datoteko vektor-trgovine).knowledge:write
knowledge_page_getPridobi prečesano stran vključno z markdown vsebino, ki je bila indeksirana za klepetalnega bota (uporabno za preverjanje, kaj bot ve o strani).knowledge:read
knowledge_page_recrawlPonovno pridobi prečesano stran in zamenjaj njeno indeksirano vsebino (npr.knowledge:write
knowledge_pages_deleteIzbriši več prečesanih strani klepetalnega bota naenkrat.knowledge:write
knowledge_pages_listNaštej prečesane strani v bazi znanja klepetalnega bota, po želji filtrirano po domeni, statusu ali iskalnem izrazu (URL/naslov).knowledge:read
knowledge_statsPregled baze znanja klepetalnega bota: dokumenti (po statusu, velikosti), prečesane strani in spletna mesta (po statusu), naloge prečesavanja, osnovna navodila razdeljena po viru (ročno vs. improvement agent), FAQ, stanje/velikost vektor-trgovine in raba prostora v primerjavi z.knowledge:read
knowledge_website_deleteIzbriši vse prečesane strani spletnega mesta (domena) iz baze znanja klepetalnega bota.knowledge:write
knowledge_website_recrawlPonovno prečesaj vse strani spletnega mesta (domena) v bazi znanja klepetalnega bota, da osvežite vsebino.knowledge:write
knowledge_website_recrawl_cancelPrekliči v teku ponovnega prečesavanja spletnega mesta: v čakalni vrsti (PENDING) strani domene se vrnejo v prejšnje indeksirano stanje.knowledge:write
knowledge_websites_listNaštej spletna mesta (domene), katerih strani so v bazi znanja klepetalnega bota, s številom strani po statusu in skupnimi tokeni.knowledge:read

Price Management

Ta orodja upravljajo strukturirane osnutke cen in eksplicitne odobritve. Shranjevanje osnutka je ločeno od odobritve natančne različice; upravičenost je odvisna tudi od statusa in veljavnosti. Obstoječi API ključi avtomatsko ne pridobijo cenovnih dovoljenj. Samo lastnik podjetja lahko dodeli prices:write ali prices:approve. Klice API ključa se izvedejo neposredno, zato pred mutacijo pregledajte natančen vnos. Oglejte si Prices & services za potek delovanja za stranke.

ToolDescriptionScope
price_listStranicenje po price heads in ločena upravičenost odobrene različice.prices:read
price_getPreberi popolno stanje elementa in revizije.prices:read
price_detailPreberi podrobnosti elementa z paginirano zgodovino revizij.prices:read
price_suggestions_listStranicenje po predlogih cen.prices:read
price_createUstvari osnutek s strežniško generiranim ID artikla.prices:write
price_editUstvari nov osnutek iz eksplicitno pričakovane različice artikla.prices:write
price_import_csvUvozi osnutke z eksplicitnim formatom in stabilnim import ID za varne ponovitve.prices:write
price_suggestion_applyUporabi izbran kandidatov predlog kot osnutek.prices:write
price_approveOdobri eno eksplicitno pričakovano različico artikla.prices:approve
price_approve_manyAtomarno odobri izbrano ID/različico; katerakoli zastarela različica zavrne celotno izbiro.prices:approve
price_archiveArhiviraj artikel pri njegovi eksplicitno pričakovani različici.prices:approve

Urejanja osnutkov ohranjajo prejšnjo odobreno revizijo. Format CSV in decimalni ločevalnik morata biti eksplicitna; spremenjena vsebina CSV zahteva nov import ID. Vse operacije so vezane na podjetje API ključa in določeni klepetalni bot.

FAQ Management

ToolDescriptionScope
faq_cache_purgePočisti predpomnjene podatke FAQ vtičnika na vseh povezanih CMS straneh (WordPress vtičnik).faqs:write
faq_categories_listNaštej FAQ kategorije klepetalnega bota z njihovimi številkami FAQ, slugi, načinom sortiranja in prevodi.faqs:read
faq_categories_reorderNastavi vrstni red FAQ kategorij v vtičniku: položaj v categoryIds postane sortOrder.faqs:write
faq_category_createUstvari FAQ kategorijo za klepetalnega bota (slug se generira iz imena).faqs:write
faq_category_deleteIzbriši FAQ kategorijo.faqs:write
faq_category_translations_updateZamenjaj prevode FAQ kategorije, npr.faqs:write
faq_category_updatePreimenuj FAQ kategorijo ali spremeni njen opis, ikono ali način sortiranja.faqs:write
faq_createUstvari FAQ za klepetalnega bota.faqs:write
faq_deleteTrajno izbriši FAQ (prav tako ga odstrani iz baze znanja klepetalnega bota in počisti predpomnilnike CMS vtičnika).faqs:write
faq_embed_code_getPridobi embed izrezke za FAQ vtičnik: script tag, WordPress shortcode in Shopify Liquid izrezek, plus variacije po kategorijah (uporabite categorySlug iz faq_categories_list za vgradnjo le ene kategorije).chatbots:read
faq_getPridobi polne podrobnosti FAQ: vprašanje, odgovor, kategorija, stanje objave, vrstni red, prevodi, SEO polja in statistike povratnih informacij.faqs:read
faq_listNaštej FAQ klepetalnega bota (uporabite chatbot_list za iskanje chatbotId).faqs:read
faq_reorderNastavi prikazni vrstni red FAQ v vtičniku.faqs:write
faq_suggestion_approveOdobri PENDING predlog FAQ: ustvari objavljen FAQ (neobvezno z urejenim vprašanjem/odgovorom/kategorijo) in označi predlog kot APPROVED.faqs:write
faq_suggestion_getPridobi polne podrobnosti predloga FAQ (popoln odgovor, AI razlaga, predlagana kategorija, stanje pregleda).faqs:read
faq_suggestion_rejectZavrni PENDING predlog FAQ z neobveznim razlogom.faqs:write
faq_suggestions_generateNaj AI predlaga nove FAQ iz baze znanja klepetalnega bota (prečesane strani / naloženi dokumenti), neobvezno za eno kategorijo.faqs:write
faq_suggestions_listNaštej AI-generirane predloge FAQ klepetalnega bota (iz pogovorov ali faq_suggestions_generate).faqs:read
faq_translatePrevedi vprašanje in odgovor FAQ z AI v druge podprte jezike klepetalnega bota (ali v podane targetLanguages) in shrani rezultat.faqs:write
faq_translations_updateShrani prevode FAQ po jezikih, npr.faqs:write
faq_updatePosodobi vprašanje, odgovor, kategorijo, stanje objave ali ročni vrstni red FAQ.faqs:write
faq_widget_settings_getPridobi nastavitve videza in vedenja vgradljivega FAQ vtičnika (barve, radij roba, naslov, razmiki, max širina, allowMultipleOpen, autoOpenFirst, način sortiranja, prevodi naslovov).chatbots:read
faq_widget_settings_updatePosodobi nastavitve FAQ vtičnika: barve (hex), borderRadius 0-32, naslov (max 100) + showTitle, spacing compact|normal|relaxed, maxWidth 0-2000 (0 = polna širina), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name in prevodi naslovov po jezikih.chatbots:write

Chat History & Feedback

ToolDescriptionScope
chat_feedback_dismissOznači klepet kot pregledan brez ocene (odstrani ga iz čakalne vrste, ne spremeni confidence score).chats:write
chat_feedback_getPridobi en pregled pogovora (feedback) z AI analizo, resnostjo, kategorijo zaupanja, spremembo ocene in povezano izboljševalno sejo.chats:read
chat_feedback_listNaštej preglede pogovorov (vrstice povratnih informacij) klepetalnega bota s filtrom po statusu in številih.chats:read
chat_feedback_set_severityPrepiši klasifikacijo resnosti (MINOR|MODERATE|MAJOR|CRITICAL) pregledanega negativnega klepeta; resnost uteži padec confidence-score.chats:write
chat_feedback_statsŠtetja sej po preglednih vedrih za klepetalnega bota (skupaj, none, pending, positive, negative, reviewed, improved) — kartice statistike na strani chats nadzorne plošče.chats:read
chat_feedback_submitOcenite sejo klepeta kot Good (isPositive=true) ali Needs Work (isPositive=false).chats:write
chat_session_getPridobi sejo klepeta s celotnim prepisom (po-sporočilu token/model/latenca/pageUrl), podatki obiskovalca, URL začetne strani, kategorija zaupanja, povratne informacije (resnost, AI analiza, povezana izboljševalna seja) in oznake.chats:read
chat_session_searchIskanje sej klepeta klepetalnega bota po vsebini sporočila in/ali e-pošti obiskovalca.chats:read
chat_session_set_categoryDodeli ali spremeni kategorijo zaupanja seji klepeta (popravi AI kategorizacijo; per-kategorija zaupanje se preberecuna, ko je klepet pregledan).chats:write
chat_sessions_listNaštej seje klepeta klepetalnega bota, najnovejše prve, z enakimi filtri kot stran chats v nadzorni plošči.chats:read

Improvement Agent

ToolDescriptionScope
confidence_categories_listNaštej kategorije zaupanja klepetalnega bota z per-kategorijo confidence score, številom pregledov in frekvenco e-poštnih pregledov.chats:read
confidence_category_createUstvari kategorijo zaupanja za klepetalnega bota.chatbots:write
confidence_category_deleteIzbriši kategorijo zaupanja.chatbots:write
confidence_category_mergeZdruži eno kategorijo zaupanja v drugo istega klepetalnega bota: vsi klepeti/pregledi se premaknejo na cilj, vir se izbriše in ocene se ponovno izračunajo.chatbots:write
confidence_category_updatePreimenuj kategorijo zaupanja in/ali nastavi frekvenco e-poštnih pregledov (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1-24 samo za HOURLY).chatbots:write
confidence_status_getStatus zaupanja klepetalnega bota: ocena, prag za prehod, zastavica faze učenja, vedenje faze učenja (CAUTIOUS|BALANCED|CONFIDENT) in po meri poziv, štetja pregledov in per-kategorija confidence score.analytics:read
improvement_proposal_approveOdobri PENDING izboljševalni predlog in uporabi spremembo na klepetalnem botu (dodaj/posodobi core instruction, ustvarjanje/posodobitev FAQ ali posodobitev persone) — enaka logika in omejitve načrta kot v nadzorni plošči.chatbots:write
improvement_proposal_rejectZavrni PENDING izboljševalni predlog.chatbots:write
improvement_proposal_simulateSimuliraj, kako bi klepetalni bot odgovoril na problematično sporočilo s predlogom (original vs.chatbots:write
improvement_proposals_pendingNaštej izboljševalne predloge, ki čakajo na pregled (status PENDING) po podjetju ali za en klepetalni bot.chatbots:read
improvement_session_completeOznači izboljševalno sejo kot COMPLETED (klepet nato šteje kot Improved v pregledni vrsti).chatbots:write
improvement_session_createOdpri Improvement Agent za klepet, ocenjen kot Needs Work.chatbots:write
improvement_session_getPridobi izboljševalno sejo z originalnim klepetom (sporočila imajo 1-bazni indeks, uporaben kot targetMessageIndex), pogovorom agenta, vsemi predlogi (z njihovo zadnjo simulacijo) in simulacijami.chatbots:read
improvement_session_resetPonovno zaženi izboljševalno sejo: izbriše vsa sporočila agenta, simulacije in PENDING/REJECTED predloge (uporabljeni ostanejo) in začne nov pogovor.chatbots:write
improvement_session_send_messagePošlji sporočilo Improvement Agentu (opisi, kaj je bilo narobe z odgovorom bota; neobvezno targetMessageIndex = 1-bazni indeks botovega sporočila v originalChat.messages).chatbots:write
improvement_sessions_listNaštej izboljševalne seje (pogovori Improvement Agent, začeti iz negativnih pregledov) za klepetalni bot ali celo podjetje, najnovejše prve, s številom predlogov.chatbots:read
improvement_simulation_assessOcenite rezultat simulacije: isApproved=true, kadar je simuliran odgovor dober (predlog se potem lahko uporabi), false, ko potrebuje izboljšave (komentar 'almost' = skoraj prav).chatbots:write

Live Chat

ToolDescriptionScope
live_chat_agents_availablePridobi trenutno uporabnikovo razpoložljivost za živi klepet, agente trenutno na voljo za živi klepet (svež heartbeat, isti signal, ki ga uporablja vtičnik) in ali načrt podjetja vključuje živi klepet.chats:read
live_chat_heartbeatOsveži heartbeat prisotnosti trenutnega uporabnika za živi klepet (samo, kadar je označen kot na voljo prek live_chat_set_availability).chats:write
live_chat_message_sendPošlji sporočilo obiskovalcu kot dodeljeni agent.chats:write
live_chat_queuePridobi čakalno vrsto živega klepeta: seje, ki čakajo na agenta, najstarejše prve (FIFO).chats:read
live_chat_session_assignPrevzemi čakaJOčo sejo živega klepeta iz čakalne vrste: dodeli jo trenutnemu uporabniku (lastnik podjetja za API ključe) in obvesti obiskovalca, da se je agent pridružil.chats:write
live_chat_session_closeZaključi sejo živega klepeta kot agent (kateri koli član podjetja razen VIEWER).chats:write
live_chat_session_getPridobi sejo živega klepeta z informacijami o obiskovalcu, dodeljenim agentom, vsemi sporočili in prejšnjim botovim pogovorom (handoff kontekst).chats:read
live_chat_sessions_listNaštej seje živega klepeta (najnovejše prve; WAITING seje najstarejše prve) z neobveznimi filtri po klepetalnem botu, statusu in dodeljenem agentu.chats:read
live_chat_set_availabilityPreklopi trenutnemu uporabniku stikalo 'Available for Live Chat' za podjetje.chats:write

Leads

ToolDescriptionScope
lead_assignDodeli lead članu podjetja ali ga odvozda (assignedToId: null).leads:write
lead_bulk_update_statusNastavi status več leadov hkrati (max 100).leads:write
lead_categories_listNaštej kategorije leadov klepetalnega bota z njihovimi številkami in člani ekipe, obveščenimi po kategoriji.leads:read
lead_category_assign_userDodaj člana podjetja v seznam obveščanja kategorije leadov (ali posodobi njihove zastavice obveščanja).leads:write
lead_category_createUstvari kategorijo leadov za klepetalnega bota.leads:write
lead_category_deleteIzbriši kategorijo leadov.leads:write
lead_category_remove_userOdstrani člana podjetja s seznama obveščanja kategorije leadov.leads:write
lead_category_updatePosodobi ime, opis in/ali barvo kategorije leadov.leads:write
lead_createUstvari lead ročno (npr.leads:write
lead_deleteTrajno izbriši lead.leads:write
lead_field_config_getPridobi konfiguracijo zajema leadov klepetalnega bota: polja (id-ji se preslikajo na ključe v lead.data), potrditveno sporočilo, prevodi polj/UI in AI nastavitve prepoznavanja.leads:read
lead_field_config_updatePosodobi konfiguracijo zajema leadov klepetalnega bota.leads:write
lead_getPridobi polne podrobnosti leada vključno z dodeljenim, kategorijo in izvorno transkripcija klepeta (paginirano z messageOffset/messageLimit, privzeto prvih 20 sporočil).leads:read
lead_listNaštej lead-e klepetalnega bota (najnovejši prvi) z neobveznimi filtri po statusu, kategoriji, dodeljenemu in besedilnem iskanju (ime/e-pošta/podjetje).leads:read
lead_statsPridobi statistike leadov za klepetalni bot: štetje po statusu, leadi zadnjih 7 dni in stopnja konverzije (v odstotkih).leads:read
lead_updatePosodobi status, kategorijo, zapiske, zajete podatke in/ali dodeljenega leada.leads:write

Forms

ToolDescriptionScope
form_createUstvari kontaktni obrazec za klepetalnega bota (osnove, polja, oblikovanje in nastavitve proti neželeni pošti v enem klicu).forms:write
form_deleteTrajno izbriši kontaktni obrazec in VSE njegove oddaje (kaskada).forms:write
form_getPridobi kontaktni obrazec v celoti: polja, prevodi, styling, nastavitve proti spam-u, aktivno stanje, števec oddaj in embed skriptno oznako (embedCode).forms:read
form_listNaštej kontaktne obrazce klepetalnega bota s številom polj, številom oddaj in embed kodi.forms:read
form_statsŠtetje oddaj kontaktnega obrazca: total, pending, approved, spam in rejected.forms:read
form_submission_deleteTrajno izbriši oddajo kontaktnega obrazca (npr.forms:write
form_submission_getPridobi oddajo kontaktnega obrazca v celoti: oddana polja, spam score in AI analiza spama, IP/user agent/referrer metapodatki in informacije pregleda.forms:read
form_submission_update_statusPreglej oddajo kontaktnega obrazca: nastavi njen status na APPROVED, SPAM ali REJECTED z neobveznim komentarjem pregleda.forms:write
form_submissions_listNaštej oddaje kontaktnega obrazca, najnovejše prve, po želji filtrirano po statusu (PENDING, APPROVED, SPAM, REJECTED) in datumu ustvarjanja.forms:read
form_updatePosodobi kontaktni obrazec: ime, opis, aktivno stanje (isActive nadzoruje, ali se vgradnja prikaže), polja (popolna zamenjava), oblikovanje (barve, besedilo gumba, sporočilo ob uspehu) in nastavitve proti spam-u (spamThreshold, autoRejectSpam, notificationEmail).forms:write
form_update_translationsZamenjaj prevode polj in/ali UI kontaktnega obrazca.forms:write

Email Assistant

ToolDescriptionScope
email_activity_listNaštej dnevnik obdelane e-poštne dejavnosti povezave poštnega predala (najnovejše prve): pošiljatelj, zadeva, dodeljena kategorija, izid (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) in outcomeDetail.email:read
email_categories_listNaštej e-poštne kategorije povezave poštnega predala (urejene po sortOrder).email:read
email_category_createUstvari e-poštno kategorijo za povezavo poštnega predala (max 20 na povezavo).email:write
email_category_deleteIzbriši e-poštno kategorijo.email:write
email_category_updatePosodobi e-poštno kategorijo (delno: spremenijo se samo podana polja).email:write
email_connection_disconnectTrajno odklopi poštni predal.email:write
email_connection_getPridobi povezavo poštnega predala vključno zemail:read
email_connection_updatePosodobi povezavo poštnega predala: začasno ustavi/pokrene sinhronizacijo (paused true/false; samo preklopi ACTIVE<->DISABLED, nikoli ne preglasi TOKEN_EXPIRED/ERROR), vklopi/izklopi pripravo osnutkov odgovorov (draftingEnabled) in kategorizacijo/organizacijo (organizingEnabled), preusmeri napajajočega klepetalnega bota (chatbotId istega podjetja) ali nastavi HTML podpis odgovora (signatureHtml, max 20000 znakov; prazen niz ga počisti).email:write
email_connections_listNaštej povezave poštnih predalov Email Assistant podjetja (naslov, status ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, zadnja sinhronizacija, zadnja napaka, stikala za pripravo/organizacijo, napajajoči chatbot, draftReadyCategoryCount = kategorije, ki lahko ustvarijo osnutke, baseRuleCount = chatbot-splošna 'Chat + Email' pravila, uporabljena za vsak osnutek) skupaj z omejitvami načrta (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth).email:read
email_contact_deleteIzbriši naučen e-poštni stik (pozabi profil pošiljatelja, npr.email:write
email_contact_getPridobi naučen e-poštni stik z vsemi naučenimi dejstvi, internimi zapiski, razmerjem, nastavitvijo formalnega/neformalnega naslavljanja in statistikami e-pošte.email:read
email_contact_updatePosodobi naučen e-poštni stik.email:write
email_contacts_listNaštej naučene e-poštne stike podjetja (zadnja e-pošta prva) z razmerjem, formal/informal address (formalAddress: true = formalno 'Sie', false = neformalno 'Du', null = samodejno), številom dejstev in predogledom zapiskov.email:read
email_folder_createUstvari mapo pošte pod inboxom (vrne obstoječo, če je ime zasedeno) za uporabo kot cilj premika kategorije.email:write
email_folders_listNaštej mape, v katere lahko e-poštna kategorija premakne pošto, v živo iz poštnega predala: podmape inboxa, po meri vrhnje mape, arhiv, vsiljena pošta in smeti (id 'deleteditems').email:read
email_general_rules_listNaštej chatbot-splošna pravila, ki veljajo za vsak osnutek odgovora poštnega predala: aktivna osnovna navodila z channel BOTH ("Chat + Email"), plus legacy samo-za-e-pošto, ki še niso migrirana v kategorijo.email:read

Analytics

ToolDescriptionScope
analytics_chat_volumeVolumen klepetov (začetih sej) skozi čas za grafikone in trende: obdobje week/month/quarter/year, granularnost hour/day/week/month, neobvezno za en klepetalni bot.analytics:read
analytics_chatbot_statsPer-klepetalni bot uspešnost podjetja v enem klicu (tabela uspešnosti klepetalnikov v nadzorni plošči): id, name, slug, isActive, sessions, messages, FAQs in leads na klepetalnega bota, sortirano po sessions.analytics:read
analytics_formsStatistika oddaj kontaktnih obrazcev za podjetje ali en klepetalni bot (widget analitike nadzorni plošče): oddaje po statusu (pending/approved/rejected/spam), število obrazcev, total, spam rate v odstotkih in serija oddaj-na-dan za zadnjih 7 dni.analytics:read
analytics_leadsLead funnel za podjetje ali en klepetalni bot (widget analitike nadzorni plošče): leadi po statusu (new/contacted/qualified/converted/lost), total, stopnja konverzije v odstotkih in serija leadov-na-dan za zadnjih 7 dni.analytics:read
analytics_overviewAnalitični pregled za podjetje ali en klepetalni bot: klepeti, sporočila, stopnja zadovoljstva in top vprašanja za tekoče obdobje (day/week/month/year), plus pregledni widget nadzorni plošče (skupaj chatboti/publikirani FAQ/leadi, seje danes/ta teden/ta mesec, leadi danes/ta teden, oddaje obrazcev total/danes/čakajoči).analytics:read
dashboard_activityKaj trenutno potrebuje pozornost (domači pogled nadzorni plošče): po podjetju, klepetalniki z novimi leadi danes, čakajočimi FAQ predlogi, čakajočimi oddajami obrazcev, čakajočimi/aktivnimi živimi klepeti ali tekočo fazo učenja.any

Primeri potekov dela

Dodajanje osnovnega navodila

Povprašajte vašega AI asistenta:

"Dodaj osnovno navodilo v moj klepetalni bot 'Support Bot': ponujamo brezplačno pošiljanje pri naročilih nad 50 €"

Asistent bo uporabil chatbot_add_instruction z ustreznimi parametri.

Pregled izboljševalnih predlogov

"Pokaži mi vse čakajoče izboljševalne predloge za mojega klepetalnega bota in razloži, katere spremembe predlagajo"

Asistent bo:

  1. Uporabil improvement_proposals_pending za pridobitev predlogov
  2. Analiziral in povzeto opisal vsak predlog
  3. V vašem imenu odobril ali zavrnil z improvement_proposal_approve ali improvement_proposal_reject

Analiza uspešnosti klepeta

"Daj mi tedensko poročilo o volumnu klepetov in zadovoljstvu strank za mojega klepetalnega bota"

Asistent bo uporabil analytics_overview in analytics_chat_volume za sestavo obsežnega poročila.

Uvoz spletnega mesta

"Skeniraj https://example.com, uvozi strani s produkti in cenami v moj 'Support Bot' in mi sporoči, ko je prečesavanje končano"

Asistent bo poklical crawler_preview_scan, izbral ustrezne strani, začel uvoz z crawler_start in povpraševal crawler_job_get, dokler se naloga ne zaključi.

Pregled leadov in oddaj obrazcev

"Pokaži mi nove lead-e iz tega tedna, dodeli kvalificirane Ani in odobri čakajoče oddaje kontaktnih obrazcev"

Asistent kombinira lead_list, lead_assign, form_submissions_list in form_submission_update_status.

Prevzem živega klepeta

"Nastavi me kot razpoložljivega za živi klepet in prevzemi najstarejši čakajoči pogovor"

Asistent uporabi live_chat_set_availability, live_chat_queue in live_chat_session_assign; odgovori se pošljejo preko live_chat_message_send.

Varnost

  • API ključi so omejeni na vaše podjetje in dovoljenja, ki jih izberete ob ustvarjanju (glejte stolpec Scope zgoraj)
  • Ključi se izvajajo z dovoljenji lastnika podjetja; omejitve načrta in funkcijske omejitve veljajo enako kot v nadzorni plošči
  • Ključe lahko kadar koli prekličete iz nadzorni plošče
  • Dostop do API je na voljo v plačljivih paketih — oglejte si našo Pricing page

Odpravljanje težav

Povezava ni uspela

  1. Preverite, ali je vaš API ključ pravilen
  2. Preverite, ali ključ ni bil preklican
  3. Prepričajte se, da vaš načrt vključuje dostop do API
  4. Znova zaženite vaš MCP odjemalec

Orodje ni najdeno

Znova zaženite vaš MCP odjemalec po spremembi konfiguracije, da ponovno naloži na voljo orodja. Imena orodij so v malih črkah z podčrtaji (npr. faq_list).


Potrebujete pomoč? Kontaktirajte našo podporo →