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č
- Pojdite v vaš Nadzorna plošča → Podjetje → API zavihek
- Kliknite Ustvari API ključ
- Dajte ključu opisno ime (npr. "Claude Desktop") in izberite vsaj eno dovoljenje
- 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
| Tool | Description | Scope |
|---|---|---|
account_usage_get | Pridobi 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_companies | Naštej vsa podjetja, do katerih ima trenutni uporabnik dostop, z vlogo uporabnika v vsakem od njih. | any |
user_notification_mark_read | Označi eno od obvestil trenutnega uporabnika kot prebrano. | any |
user_notification_preferences_get | Pridobi 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_update | Posodobi globalne nastavitve obveščanja trenutnega uporabnika (email/push stikala, urnik digestov, tihe ure). | any |
user_notification_type_setting_update | Omogoči ali onemogoči dostavo po e-pošti / v aplikaciji za en tip obvestila trenutnega uporabnika (npr. | any |
user_notification_types_list | Naštej vse tipe obvestil razvrščene po kategorijah (chatbot, leads, live chat, knowledge, team, billing). | any |
user_notification_unread_count | Pridobi število neprebranih obvestil trenutnega uporabnika. | any |
user_notifications | Naštej obvestila trenutnega uporabnika, najnovejša prva, z kurzorsko paginacijo. | any |
user_notifications_delete_old | Hišna opravila: trajno izbriši obvestila trenutnega uporabnika, ki so že prebrana in starejša od 30 dni. | any |
user_notifications_mark_all_read | Označi vsa obvestila trenutnega uporabnika kot prebrana. | any |
user_profile | Pridobi profil trenutnega uporabnika (id, name, email, role, subscription tier). | any |
Company & Team
| Tool | Description | Scope |
|---|---|---|
company_chatbots_list | Naštej vse klepetalne bote za določeno podjetje s povzetnimi statistikami. | chatbots:read |
company_get | Pridobi podrobne informacije o podjetju: profil, lastnik, nastavitve blagovne znamke (barve, e-pošta za obvestila) in štetja. | any |
company_invite_cancel | Prekliči (izbriši) povabilo v ekipo, da povezava preneha delovati. | company:write |
company_invite_resend | Ponovno 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_list | Naštej povabila v ekipo podjetja (privzeto čakajoča; nastavi includeExpired za vračanje tudi poteklih). | company:read |
company_list | Naštej vsa podjetja, do katerih ima uporabnik dostop (API ključi in Dashboard Assistant vidijo le svoje podjetje). | any |
company_logo_remove | Odstrani logotip podjetja (izbriše shranjeno sliko in počisti URL logotipa). | company:write |
company_member_invite | Povabi člana ekipe po e-pošti z vlogo (ADMIN, MANAGER, AGENT ali VIEWER). | company:write |
company_member_remove | Odstrani člana ekipe iz podjetja. | company:write |
company_member_update_role | Spremeni vlogo člana ekipe (ADMIN, MANAGER, AGENT ali VIEWER). | company:write |
company_members_list | Naštej člane podjetja z njihovimi vlogami (OWNER, ADMIN, MANAGER, AGENT, VIEWER). | any |
company_settings_update | Posodobi nastavitve blagovne znamke podjetja: primaryColor / secondaryColor (#RRGGBB) in notificationEmail za preglede klepetov. | company:write |
company_update | Posodobi 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
| Tool | Description | Scope |
|---|---|---|
chatbot_add_instruction | Dodaj novo osnovno navodilo (core instruction) klepetalnemu botu (1-5000 znakov). | chatbots:write |
chatbot_confirm_embed | Označi klepetalnega bota kot vgrajenega na spletni strani (skrije opomnik za nastavitev v nadzorni plošči). | chatbots:write |
chatbot_create | Ustvari novega klepetalnega bota (enako kot čarovnik v nadzorni plošči). | chatbots:write |
chatbot_delete | Trajno izbriši klepetalnega bota z vsemi njegovimi FAQ, dokumenti, pogovori, leadi in obrazci (nepovratno). | chatbots:write |
chatbot_delete_instruction | Izbriši osnovno navodilo iz klepetalnega bota. | chatbots:write |
chatbot_get | Pridobi 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_code | Pridobi HTML izrezek za namestitev klepetalnega bota na spletno stran (URL skripte + <script> tag) in ali je vgradnja potrjena. | chatbots:read |
chatbot_get_instructions | Pridobi vsa osnovna navodila za klepetalnega bota. | chatbots:read |
chatbot_improve_instructions | Prepiši besedilo osnovnega navodila z AI izboljševalcem platforme (enako kot 'Improve with AI' v nadzorni plošči). | chatbots:write |
chatbot_learning_phase_get | Pridobi 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_update | Nastavi 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_list | Naštej vse klepetalne bote, do katerih ima uporabnik dostop, s povzetnimi statistikami. | chatbots:read |
chatbot_reorder_instructions | Nastavi vrstni red osnovnih navodil klepetalnega bota. | chatbots:write |
chatbot_templates_list | Naš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_active | Aktiviraj ali deaktiviraj klepetalnega bota. | chatbots:write |
chatbot_toggle_learning | Končaj (false) ali ponovno omogoči (true) fazo učenja klepetalnega bota. | chatbots:write |
chatbot_update | Posodobi 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_instruction | Posodobi obstoječe osnovno navodilo (content, isActive, channel, sortOrder). | chatbots:write |
chatbot_update_personality | Posodobi 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_get | Pridobi trenutne nastavitve vtičnika za klepetalnega bota (vse videzne, blagovne znamke, vedenjske nastavitve in polja pred-klepetnega obrazca). | chatbots:read |
widget_settings_update | Posodobi klepetalni vtičnik klepetalnega bota: pozicija (vključno z | chatbots:write |
widget_translations_get | Pridobi prevode vtičnika po jezikih za klepetalnega bota: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }. | chatbots:read |
widget_translations_update | Nastavi prevode vtičnika po jezikih. | chatbots:write |
Knowledge Base
| Tool | Description | Scope |
|---|---|---|
crawler_job_cancel | Prekliči PENDING ali RUNNING nalogo prečesavanja; preostale strani se preskočijo. | knowledge:write |
crawler_job_get | Pridobi stanje naloge prečesavanja, napredek (pagesCrawled/pagesFound, tokensUsed) in stanje vsake strani. | knowledge:read |
crawler_jobs_list | Naštej naloge prečesavanja klepetalnega bota (najnovejše prve) z statusom in napredkom. | knowledge:read |
crawler_limits | Pridobi 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_scan | Skeniraj spletno stran in naštej prečesljive strani (url, title, isRecommended) brez uvoza ničesar. | knowledge:write |
crawler_start | Zač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_url | Prenesi 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_text | Dodaj besedilni ali markdown dokument v bazo znanja klepetalnega bota iz vstavljenih vsebin (max 10 MB). | knowledge:write |
knowledge_document_delete | Izbriši naložen dokument iz baze znanja. | knowledge:write |
knowledge_document_get | Pridobi podrobnosti naloženega dokumenta vključno s stanjem obdelave, sporočilom o napaki in kratkotrajno URL za prenos. | knowledge:read |
knowledge_documents_list | Naštej naložene dokumente (PDF, TXT, MD, CSV, JSON, DOCX) v bazi znanja klepetalnega bota z statusom in velikostjo. | knowledge:read |
knowledge_page_add | Preč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_delete | Izbriši prečesano stran iz baze znanja (odstrani datoteko vektor-trgovine). | knowledge:write |
knowledge_page_get | Pridobi 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_recrawl | Ponovno pridobi prečesano stran in zamenjaj njeno indeksirano vsebino (npr. | knowledge:write |
knowledge_pages_delete | Izbriši več prečesanih strani klepetalnega bota naenkrat. | knowledge:write |
knowledge_pages_list | Naštej prečesane strani v bazi znanja klepetalnega bota, po želji filtrirano po domeni, statusu ali iskalnem izrazu (URL/naslov). | knowledge:read |
knowledge_stats | Pregled 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_delete | Izbriši vse prečesane strani spletnega mesta (domena) iz baze znanja klepetalnega bota. | knowledge:write |
knowledge_website_recrawl | Ponovno prečesaj vse strani spletnega mesta (domena) v bazi znanja klepetalnega bota, da osvežite vsebino. | knowledge:write |
knowledge_website_recrawl_cancel | Preklič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_list | Naš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.
| Tool | Description | Scope |
|---|---|---|
price_list | Stranicenje po price heads in ločena upravičenost odobrene različice. | prices:read |
price_get | Preberi popolno stanje elementa in revizije. | prices:read |
price_detail | Preberi podrobnosti elementa z paginirano zgodovino revizij. | prices:read |
price_suggestions_list | Stranicenje po predlogih cen. | prices:read |
price_create | Ustvari osnutek s strežniško generiranim ID artikla. | prices:write |
price_edit | Ustvari nov osnutek iz eksplicitno pričakovane različice artikla. | prices:write |
price_import_csv | Uvozi osnutke z eksplicitnim formatom in stabilnim import ID za varne ponovitve. | prices:write |
price_suggestion_apply | Uporabi izbran kandidatov predlog kot osnutek. | prices:write |
price_approve | Odobri eno eksplicitno pričakovano različico artikla. | prices:approve |
price_approve_many | Atomarno odobri izbrano ID/različico; katerakoli zastarela različica zavrne celotno izbiro. | prices:approve |
price_archive | Arhiviraj 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
| Tool | Description | Scope |
|---|---|---|
faq_cache_purge | Počisti predpomnjene podatke FAQ vtičnika na vseh povezanih CMS straneh (WordPress vtičnik). | faqs:write |
faq_categories_list | Naštej FAQ kategorije klepetalnega bota z njihovimi številkami FAQ, slugi, načinom sortiranja in prevodi. | faqs:read |
faq_categories_reorder | Nastavi vrstni red FAQ kategorij v vtičniku: položaj v categoryIds postane sortOrder. | faqs:write |
faq_category_create | Ustvari FAQ kategorijo za klepetalnega bota (slug se generira iz imena). | faqs:write |
faq_category_delete | Izbriši FAQ kategorijo. | faqs:write |
faq_category_translations_update | Zamenjaj prevode FAQ kategorije, npr. | faqs:write |
faq_category_update | Preimenuj FAQ kategorijo ali spremeni njen opis, ikono ali način sortiranja. | faqs:write |
faq_create | Ustvari FAQ za klepetalnega bota. | faqs:write |
faq_delete | Trajno izbriši FAQ (prav tako ga odstrani iz baze znanja klepetalnega bota in počisti predpomnilnike CMS vtičnika). | faqs:write |
faq_embed_code_get | Pridobi 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_get | Pridobi polne podrobnosti FAQ: vprašanje, odgovor, kategorija, stanje objave, vrstni red, prevodi, SEO polja in statistike povratnih informacij. | faqs:read |
faq_list | Naštej FAQ klepetalnega bota (uporabite chatbot_list za iskanje chatbotId). | faqs:read |
faq_reorder | Nastavi prikazni vrstni red FAQ v vtičniku. | faqs:write |
faq_suggestion_approve | Odobri PENDING predlog FAQ: ustvari objavljen FAQ (neobvezno z urejenim vprašanjem/odgovorom/kategorijo) in označi predlog kot APPROVED. | faqs:write |
faq_suggestion_get | Pridobi polne podrobnosti predloga FAQ (popoln odgovor, AI razlaga, predlagana kategorija, stanje pregleda). | faqs:read |
faq_suggestion_reject | Zavrni PENDING predlog FAQ z neobveznim razlogom. | faqs:write |
faq_suggestions_generate | Naj AI predlaga nove FAQ iz baze znanja klepetalnega bota (prečesane strani / naloženi dokumenti), neobvezno za eno kategorijo. | faqs:write |
faq_suggestions_list | Naštej AI-generirane predloge FAQ klepetalnega bota (iz pogovorov ali faq_suggestions_generate). | faqs:read |
faq_translate | Prevedi vprašanje in odgovor FAQ z AI v druge podprte jezike klepetalnega bota (ali v podane targetLanguages) in shrani rezultat. | faqs:write |
faq_translations_update | Shrani prevode FAQ po jezikih, npr. | faqs:write |
faq_update | Posodobi vprašanje, odgovor, kategorijo, stanje objave ali ročni vrstni red FAQ. | faqs:write |
faq_widget_settings_get | Pridobi 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_update | Posodobi 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
| Tool | Description | Scope |
|---|---|---|
chat_feedback_dismiss | Označi klepet kot pregledan brez ocene (odstrani ga iz čakalne vrste, ne spremeni confidence score). | chats:write |
chat_feedback_get | Pridobi en pregled pogovora (feedback) z AI analizo, resnostjo, kategorijo zaupanja, spremembo ocene in povezano izboljševalno sejo. | chats:read |
chat_feedback_list | Naštej preglede pogovorov (vrstice povratnih informacij) klepetalnega bota s filtrom po statusu in številih. | chats:read |
chat_feedback_set_severity | Prepiš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_submit | Ocenite sejo klepeta kot Good (isPositive=true) ali Needs Work (isPositive=false). | chats:write |
chat_session_get | Pridobi 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_search | Iskanje sej klepeta klepetalnega bota po vsebini sporočila in/ali e-pošti obiskovalca. | chats:read |
chat_session_set_category | Dodeli ali spremeni kategorijo zaupanja seji klepeta (popravi AI kategorizacijo; per-kategorija zaupanje se preberecuna, ko je klepet pregledan). | chats:write |
chat_sessions_list | Naštej seje klepeta klepetalnega bota, najnovejše prve, z enakimi filtri kot stran chats v nadzorni plošči. | chats:read |
Improvement Agent
| Tool | Description | Scope |
|---|---|---|
confidence_categories_list | Naštej kategorije zaupanja klepetalnega bota z per-kategorijo confidence score, številom pregledov in frekvenco e-poštnih pregledov. | chats:read |
confidence_category_create | Ustvari kategorijo zaupanja za klepetalnega bota. | chatbots:write |
confidence_category_delete | Izbriši kategorijo zaupanja. | chatbots:write |
confidence_category_merge | Združ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_update | Preimenuj 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_get | Status 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_approve | Odobri 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_reject | Zavrni PENDING izboljševalni predlog. | chatbots:write |
improvement_proposal_simulate | Simuliraj, kako bi klepetalni bot odgovoril na problematično sporočilo s predlogom (original vs. | chatbots:write |
improvement_proposals_pending | Naštej izboljševalne predloge, ki čakajo na pregled (status PENDING) po podjetju ali za en klepetalni bot. | chatbots:read |
improvement_session_complete | Označi izboljševalno sejo kot COMPLETED (klepet nato šteje kot Improved v pregledni vrsti). | chatbots:write |
improvement_session_create | Odpri Improvement Agent za klepet, ocenjen kot Needs Work. | chatbots:write |
improvement_session_get | Pridobi 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_reset | Ponovno 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_message | Poš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_list | Naš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_assess | Ocenite 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
| Tool | Description | Scope |
|---|---|---|
live_chat_agents_available | Pridobi 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_heartbeat | Osvež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_send | Pošlji sporočilo obiskovalcu kot dodeljeni agent. | chats:write |
live_chat_queue | Pridobi čakalno vrsto živega klepeta: seje, ki čakajo na agenta, najstarejše prve (FIFO). | chats:read |
live_chat_session_assign | Prevzemi č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_close | Zaključi sejo živega klepeta kot agent (kateri koli član podjetja razen VIEWER). | chats:write |
live_chat_session_get | Pridobi sejo živega klepeta z informacijami o obiskovalcu, dodeljenim agentom, vsemi sporočili in prejšnjim botovim pogovorom (handoff kontekst). | chats:read |
live_chat_sessions_list | Naš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_availability | Preklopi trenutnemu uporabniku stikalo 'Available for Live Chat' za podjetje. | chats:write |
Leads
| Tool | Description | Scope |
|---|---|---|
lead_assign | Dodeli lead članu podjetja ali ga odvozda (assignedToId: null). | leads:write |
lead_bulk_update_status | Nastavi status več leadov hkrati (max 100). | leads:write |
lead_categories_list | Naštej kategorije leadov klepetalnega bota z njihovimi številkami in člani ekipe, obveščenimi po kategoriji. | leads:read |
lead_category_assign_user | Dodaj člana podjetja v seznam obveščanja kategorije leadov (ali posodobi njihove zastavice obveščanja). | leads:write |
lead_category_create | Ustvari kategorijo leadov za klepetalnega bota. | leads:write |
lead_category_delete | Izbriši kategorijo leadov. | leads:write |
lead_category_remove_user | Odstrani člana podjetja s seznama obveščanja kategorije leadov. | leads:write |
lead_category_update | Posodobi ime, opis in/ali barvo kategorije leadov. | leads:write |
lead_create | Ustvari lead ročno (npr. | leads:write |
lead_delete | Trajno izbriši lead. | leads:write |
lead_field_config_get | Pridobi 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_update | Posodobi konfiguracijo zajema leadov klepetalnega bota. | leads:write |
lead_get | Pridobi polne podrobnosti leada vključno z dodeljenim, kategorijo in izvorno transkripcija klepeta (paginirano z messageOffset/messageLimit, privzeto prvih 20 sporočil). | leads:read |
lead_list | Naš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_stats | Pridobi statistike leadov za klepetalni bot: štetje po statusu, leadi zadnjih 7 dni in stopnja konverzije (v odstotkih). | leads:read |
lead_update | Posodobi status, kategorijo, zapiske, zajete podatke in/ali dodeljenega leada. | leads:write |
Forms
| Tool | Description | Scope |
|---|---|---|
form_create | Ustvari kontaktni obrazec za klepetalnega bota (osnove, polja, oblikovanje in nastavitve proti neželeni pošti v enem klicu). | forms:write |
form_delete | Trajno izbriši kontaktni obrazec in VSE njegove oddaje (kaskada). | forms:write |
form_get | Pridobi kontaktni obrazec v celoti: polja, prevodi, styling, nastavitve proti spam-u, aktivno stanje, števec oddaj in embed skriptno oznako (embedCode). | forms:read |
form_list | Naš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_delete | Trajno izbriši oddajo kontaktnega obrazca (npr. | forms:write |
form_submission_get | Pridobi 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_status | Preglej oddajo kontaktnega obrazca: nastavi njen status na APPROVED, SPAM ali REJECTED z neobveznim komentarjem pregleda. | forms:write |
form_submissions_list | Naštej oddaje kontaktnega obrazca, najnovejše prve, po želji filtrirano po statusu (PENDING, APPROVED, SPAM, REJECTED) in datumu ustvarjanja. | forms:read |
form_update | Posodobi 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_translations | Zamenjaj prevode polj in/ali UI kontaktnega obrazca. | forms:write |
Email Assistant
| Tool | Description | Scope |
|---|---|---|
email_activity_list | Naš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_list | Naštej e-poštne kategorije povezave poštnega predala (urejene po sortOrder). | email:read |
email_category_create | Ustvari e-poštno kategorijo za povezavo poštnega predala (max 20 na povezavo). | email:write |
email_category_delete | Izbriši e-poštno kategorijo. | email:write |
email_category_update | Posodobi e-poštno kategorijo (delno: spremenijo se samo podana polja). | email:write |
email_connection_disconnect | Trajno odklopi poštni predal. | email:write |
email_connection_get | Pridobi povezavo poštnega predala vključno z | email:read |
email_connection_update | Posodobi 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_list | Naš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_delete | Izbriši naučen e-poštni stik (pozabi profil pošiljatelja, npr. | email:write |
email_contact_get | Pridobi 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_update | Posodobi naučen e-poštni stik. | email:write |
email_contacts_list | Naš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_create | Ustvari mapo pošte pod inboxom (vrne obstoječo, če je ime zasedeno) za uporabo kot cilj premika kategorije. | email:write |
email_folders_list | Naš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_list | Naš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
| Tool | Description | Scope |
|---|---|---|
analytics_chat_volume | Volumen 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_stats | Per-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_forms | Statistika 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_leads | Lead 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_overview | Analitič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_activity | Kaj 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:
- Uporabil
improvement_proposals_pendingza pridobitev predlogov - Analiziral in povzeto opisal vsak predlog
- V vašem imenu odobril ali zavrnil z
improvement_proposal_approvealiimprovement_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
- Preverite, ali je vaš API ključ pravilen
- Preverite, ali ključ ni bil preklican
- Prepričajte se, da vaš načrt vključuje dostop do API
- 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 →