MCP Serverio integracija
ChatReact įgyvendina Model Context Protocol (MCP), leidžiantį prijungti Jūsų ChatReact paskyrą prie AI asistentų, tokių kaip Claude Desktop, Cursor ir kitų MCP suderinamų įrankių.
Kas yra MCP?
Model Context Protocol yra atviras standartas, leidžiantis AI asistentams sąveikauti su išorinėmis paslaugomis ir duomenų šaltiniais. Naudodami ChatReact MCP integraciją, Jūs galite:
- Valdyti pokalbių robotus — kurti, konfigūruoti (persona, kalbos, valdiklis, elgsena, apribojimai), įdiegti ir trinti pokalbių robotus
- Kurkite žinių bazę — pridėti dokumentus, naršyti svetaines, tvarkyti nuskaitytas puslapius ir pagrindines instrukcijas
- Tvarkyti DUK — DUK, kategorijas, pasiūlymus, vertimus ir DUK valdiklį
- Peržiūrėti pokalbius — įvertinti pokalbius, priskirti pasitikėjimo kategorijas, paleisti Improvement Agent
- Dirbti su potencialiais klientais ir formomis — potencialūs klientai, potencialių klientų kategorijos, rinkimo nustatymai, kontaktinės formos ir pateikimai
- Veikti kaip gyvas pokalbių agentas — nustatyti savo prieinamumą, perimti laukiančius pokalbius, atsakyti ir uždaryti sesijas
- Administruoti įmonę — profilis, prekės ženklo spalvos, komandos nariai ir kvietimai
- Naudoti El. pašto asistentą — pašto dėžutės prijungimai, kategorijos, kontaktai ir veikla
- Skaityti analizę ir pranešimus
Viską, ką galite daryti informacijos suvestinėje, taip pat galima atlikti per MCP (ir REST API); tik naršyklei pririštos operacijos, tokios kaip mokėjimai, pašto dėžutės OAuth, passkey, paskyros ištrynimas ir API raktų valdymas, lieka informacijos suvestinėje.
Pradžia
1. Sugeneruokite API raktą
- Eikite į savo Pagrindinis → Įmonė → API skirtuką
- Spauskite Sukurti API raktą
- Pavadinkite raktą aprašomai (pvz., "Claude Desktop") ir pasirinkite bent vieną leidimą
- Nukopijuokite sugeneruotą raktą (pradedasi
cr_)
API raktai prieinami mokamuose planuose — žr. mūsų Kainodaros puslapį.
Saugojimo saugiai savo API rakto. Jo negalima atkurti po sukūrimo.
2. Konfigūruokite savo MCP klientą
ChatReact MCP serveris talpinamas adresu https://www.chatreact.ai/api/mcp ir bendrauja per HTTP (JSON-RPC). Autentifikuokite su Authorization: Bearer antrašte — taip pat priimama X-API-Key antraštė su tuo pačiu raktu.
Cursor IDE
Cursor tiesiogiai palaiko nuotolinius MCP serverius. Pridėkite į savo Cursor MCP nustatymus:
{
"mcpServers": {
"chatreact": {
"url": "https://www.chatreact.ai/api/mcp",
"headers": {
"Authorization": "Bearer cr_your_api_key_here"
}
}
}
}
Claude Desktop
Claude Desktop konfigūracijos failas palaiko komandų pagrindu veikiančius serverius, tad naudokite standartinį mcp-remote tiltą, kad prisijungtumėte prie talpinamo galutinio taš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"
]
}
}
}
Šiam nustatymui reikalinga įdiegta Node.js. Pavyzdyje naudojama X-API-Key antraštė, nes kai kurie klientai netiksliai tvarko tarpus argumentuose.
3. Perkraukite savo AI asistentą
Išsaugojus konfigūraciją, perkraukite Claude Desktop arba Cursor, kad užmegztumėte ryšį.
Prieinami įrankiai
ChatReact MCP atskleidžia žemiau esančius įrankius, suskirstytus pagal sritis. Stulpelyje Scope nurodytas API rakto leidimas, kurio reikalauja įrankis (any = kiekvienam galiojančiam raktui). Įrankai vykdomi su tais pačiais taikomais leidimais, plano apribojimais ir šalutiniais poveikiais, kaip ir palaikomos informacijos suvestinės operacijos. Naršyklei pririšti mokėjimų, pašto dėžutės autorizacijos, passkey, paskyros ištrynimo ir raktų valdymo srautai išlieka informacijos suvestinėje.
Destruktyvūs įrankiai (trinti, atstatyti, uždaryti, sujungti) klausia patvirtinimo naudojant Dashboard Assistant. Per API raktą jie vykdomi nedelsiant.
Paskyra
| Tool | Description | Scope |
|---|---|---|
account_usage_get | Gaukite esamą planą (lygis, būsena), einamojo sąskaitinio laikotarpio naudojimo skaitiklius (įmonės, pokalbių robotai, komandos nariai, pokalbiai, tokenai) ir plano apribojimus, taip pat efektyvius įmonės, kuriai skirta užklausa, apribojimus ir funkcijų žymes. | any |
user_companies | Išvardinkite visas įmones, prie kurių turi prieigą dabartinis vartotojas, kartu su vartotojo vaidmeniu kiekvienoje. | any |
user_notification_mark_read | Pažymėkite vieną iš dabartinio vartotojo pranešimų kaip perskaitytą. | any |
user_notification_preferences_get | Gaukite dabartinio vartotojo pranešimų nustatymus: globaliniai el. pašto / push įjungimai, santraukos dažnis/laikas/savaitės diena/laiko juosta, tylos valandos ir pagal tipą kanalų nustatymai. | any |
user_notification_preferences_update | Atnaujinkite dabartinio vartotojo globalius pranešimų nustatymus (el. paštas/push įjungimai, santraukos tvarkaraštis, tylos valandos). | any |
user_notification_type_setting_update | Įjunkite arba išjunkite el. pašto / programėlės pristatymą vienam dabartinio vartotojo pranešimo tipui (pvz. | any |
user_notification_types_list | Išvardinkite visus pranešimų tipus, suskirstytus pagal kategoriją (pokalbių robotas, potencialūs klientai, gyvas pokalbis, žinios, komanda, atsiskaitymas). | any |
user_notification_unread_count | Gaukite dabartinio vartotojo neperskaitytų pranešimų skaičių. | any |
user_notifications | Išvardinkite dabartinio vartotojo pranešimus, naujausi pirmi, su kursorine puslapiavimo sistema. | any |
user_notifications_delete_old | Techninė priežiūra: visam laikui ištrinkite dabartinio vartotojo pranešimus, kurie jau perskaityti ir vyresni nei 30 dienų. | any |
user_notifications_mark_all_read | Pažymėkite visus dabartinio vartotojo pranešimus kaip perskaitytus. | any |
user_profile | Gaukite dabartinio vartotojo profilį (id, vardas, el. paštas, vaidmuo, prenumeratos lygis). | any |
Įmonė ir komanda
| Tool | Description | Scope |
|---|---|---|
company_chatbots_list | Išvardinkite visus konkrečios įmonės pokalbių robotus su santraukos statistika. | chatbots:read |
company_get | Gaukite išsamią informaciją apie įmonę: profilį, savininką, prekės ženklo nustatymus (spalvos, pranešimų el. paštas) ir skaičius. | any |
company_invite_cancel | Atšaukti (ištrinti) komandos kvietimą, kad nuoroda nebebūtų galiojanti. | company:write |
company_invite_resend | Persiųsti laukiančią komandos kvietimą: sugeneruoja naują tokeną, prailgina galiojimą 7 dienomis ir vėl siunčia kvietimo el. laišką. | company:write |
company_invites_list | Išvardinkite įmonės komandos kvietimus (pagal nutylėjimą rodo laukiančius; nustatykite includeExpired, kad grąžintų ir pasibaigusius). | company:read |
company_list | Išvardinkite visas įmones, prie kurių vartotojas turi prieigą (API raktai ir Dashboard Assistant mato tik savo įmonę). | any |
company_logo_remove | Pašalinkite įmonės logotipą (ištrina saugomą vaizdą ir išvalo logotipo URL). | company:write |
company_member_invite | Pakvieskite komandos narį el. paštu nurodydami vaidmenį (ADMIN, MANAGER, AGENT arba VIEWER). | company:write |
company_member_remove | Pašalinkite komandos narį iš įmonės. | company:write |
company_member_update_role | Pakeiskite komandos nario vaidmenį (ADMIN, MANAGER, AGENT arba VIEWER). | company:write |
company_members_list | Išvardinkite įmonės narius su jų vaidmenimis (OWNER, ADMIN, MANAGER, AGENT, VIEWER). | any |
company_settings_update | Atnaujinkite įmonės prekės ženklo nustatymus: primaryColor / secondaryColor (#RRGGBB) ir notificationEmail pokalbių peržiūroms. | company:write |
company_update | Atnaujinkite įmonės profilį: pavadinimas (2-100 simbolių), aprašymas (max 1000 simbolių) arba svetainė (https:// pridedama automatiškai; perduokite tuščią eilutę, kad išvalytumėte svetainę/aprašymą). | company:write |
Pokalbių roboto valdymas
| Tool | Description | Scope |
|---|---|---|
chatbot_add_instruction | Pridėti naują pagrindinę instrukciją pokalbių robotui (1-5000 simbolių). | chatbots:write |
chatbot_confirm_embed | Pažymėti pokalbių robotą kaip įdėtą į svetainę (paslepia nustatymo priminimą suvestinėje). | chatbots:write |
chatbot_create | Sukurti naują pokalbių robotą (tas pats, kaip vedlio sąsajoje). | chatbots:write |
chatbot_delete | Visam laikui ištrinti pokalbių robotą su visais jo DUK, dokumentais, pokalbiais, potencialiais klientais ir formomis (negrįžtama). | chatbots:write |
chatbot_delete_instruction | Ištrinti pagrindinę instrukciją iš pokalbių roboto. | chatbots:write |
chatbot_get | Gauti išsamią informaciją apie pokalbių robotą: bendri nustatymai, asmenybė (persona, tonacija, kalbos, apribojimai), valdiklio nustatymai, gyvas pokalbis, mokymosi fazė, įdiegimo būsena ir skaičiai. | chatbots:read |
chatbot_get_embed_code | Gauti HTML fragmentą pokalbių roboto įdiegimui svetainėje (skripto URL + <script> žymė) ir informaciją, ar įdiegimas buvo patvirtintas. | chatbots:read |
chatbot_get_instructions | Gauti visas pagrindines instrukcijas pokalbių robotui. | chatbots:read |
chatbot_improve_instructions | Perrašyti pagrindinės instrukcijos tekstą naudojant platformos AI tobulintuvą (tas pats, kas suvestinėje „Improve with AI“). | chatbots:write |
chatbot_learning_phase_get | Gauti pokalbių roboto mokymosi fazės nustatymus: elgsenos nustatymą (CAUTIOUS, BALANCED, CONFIDENT), pasirinktinius promptus ir ar robotas vis dar yra mokymosi fazėje. | chatbots:read |
chatbot_learning_phase_update | Nustatyti mokymosi fazės elgsenos nustatymą (CAUTIOUS = nukreipti į žmogų, kai neaišku, BALANCED, CONFIDENT) ir/ar pasirinktą mokymosi fazės promptą. | chatbots:write |
chatbot_list | Išvardinti visus pokalbių robotus, prie kurių vartotojas turi prieigą, su santraukos statistika. | chatbots:read |
chatbot_reorder_instructions | Nustatyti pokalbių roboto pagrindinių instrukcijų tvarką. | chatbots:write |
chatbot_templates_list | Išvardinti pokalbių roboto šablonus (numatytieji nustatymai personai, tonacijai, žinutėms ir valdiklio elgsenai), kuriuos galima perduoti kaip templateId į chatbot_create, ir ar įmonės planas gali juos naudoti. | chatbots:read |
chatbot_toggle_active | Aktyvuoti arba deaktyvuoti pokalbių robotą. | chatbots:write |
chatbot_toggle_learning | Baigti (false) arba vėl įjungti (true) pokalbių roboto mokymosi fazę. | chatbots:write |
chatbot_update | Atnaujinti pokalbių roboto bendruosius nustatymus: pavadinimas, aprašymas, isActive, gyvas pokalbis (liveChatEnabled/liveChatMode, plano funkcija), showBranding (white-label planai), pokalbio peržiūros el. paštai, DUK automatinis generavimas, legacy coreInstructions tekstas, mokymosi fazė (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt). | chatbots:write |
chatbot_update_instruction | Atnaujinti esamą pagrindinę instrukciją (turinys, isActive, kanalas, sortOrder). | chatbots:write |
chatbot_update_personality | Atnaujinti pokalbių roboto asmenybę: persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), tonality slankikliai 1-5, kalbos (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), žinutės (welcomeMessage, fallbackMessage, proactive greeting) ir apribojimai (blacklistTopics, complianceRules, maxResponseLength, human handoff). | chatbots:write |
widget_settings_get | Gauti dabartinius valdiklio nustatymus pokalbių robotui (visi išvaizdos, prekės ženklo, elgsenos ir priešpokalbio formų laukai). | chatbots:read |
widget_settings_update | Atnaujinti pokalbių roboto valdiklį: pozicija (įskaitant | chatbots:write |
widget_translations_get | Gauti pokalbių roboto valdiklio vertimus kiekvienai kalbai: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }. | chatbots:read |
widget_translations_update | Nustatyti valdiklio vertimus pagal kalbą. | chatbots:write |
Žinių bazė
| Tool | Description | Scope |
|---|---|---|
crawler_job_cancel | Atšaukti PENDING arba RUNNING nuskaitymo darbą; likę puslapiai praleidžiami. | knowledge:write |
crawler_job_get | Gauti nuskaitymo darbo būseną, pažangą (pagesCrawled/pagesFound, tokensUsed) ir kiekvieno puslapio būseną. | knowledge:read |
crawler_jobs_list | Išvardinti pokalbių roboto nuskaitymo darbus (naujausi pirmi) su būsena ir pažanga. | knowledge:read |
crawler_limits | Gauti plano nuskaitymo apribojimus pokalbių robotui (max puslapių vienam nuskaitymui, tokenai vienam puslapiui, nuskaitymai per mėnesį) ir ar šį mėnesį galima pradėti naują nuskaitymą. | knowledge:read |
crawler_preview_scan | Nuskaityti svetainę ir išvardinti jos nuskaitymui tinkamus puslapius (url, pavadinimas, isRecommended) be importo. | knowledge:write |
crawler_start | Pradėti nuskaitymo darbą, kuris importuoja pasirinktus URL į pokalbių roboto žinių bazę (apdorojama fone; poll crawler_job_get). | knowledge:write |
knowledge_document_add_from_url | Atsisiųsti dokumentą (PDF, TXT, MD, CSV, JSON, DOCX; max 10 MB) iš viešo http(s) URL ir pridėti jį į pokalbių roboto žinių bazę. | knowledge:write |
knowledge_document_add_text | Pridėti teksto arba markdown dokumentą į pokalbių roboto žinių bazę iš inline turinio (max 10 MB). | knowledge:write |
knowledge_document_delete | Ištrinti įkeltą dokumentą iš žinių bazės. | knowledge:write |
knowledge_document_get | Gauti įkelto dokumento detales, įskaitant apdorojimo būseną, klaidos pranešimą ir trumpalaikį atsisiuntimo URL. | knowledge:read |
knowledge_documents_list | Išvardinti įkeltus dokumentus (PDF, TXT, MD, CSV, JSON, DOCX) pokalbių roboto žinių bazėje su būsena ir dydžiu. | knowledge:read |
knowledge_page_add | Nuskaityti vieną URL ir pridėti jį į pokalbių roboto žinių bazę (grąžina CONFLICT, kai URL jau indeksuotas, FORBIDDEN, kai pasiekti tokenų limitai). | knowledge:write |
knowledge_page_delete | Ištrinti nuskaitytą puslapį iš žinių bazės (pašalina jo vektorių saugyklos failą). | knowledge:write |
knowledge_page_get | Gauti nuskaitytą puslapį kartu su indeksuotu markdown turiniu pokalbių robotui (naudinga patikrinti, ką bot žino apie puslapį). | knowledge:read |
knowledge_page_recrawl | Pakartotinai nuskaityti puslapį ir pakeisti jo indeksuotą turinį (pvz. | knowledge:write |
knowledge_pages_delete | Ištrinti kelis nuskaitytus puslapius iš pokalbių roboto vienu metu. | knowledge:write |
knowledge_pages_list | Išvardinti nuskaitytus puslapius pokalbių roboto žinių bazėje, nebūtina filtruojant pagal domeną, būseną arba paieškos terminą (URL/pavadinimas). | knowledge:read |
knowledge_stats | Peržiūra pokalbių roboto žinių bazės: dokumentai (pagal būseną, dydį), nuskaityti puslapiai ir svetainės (pagal būseną), nuskaitymo darbai, pagrindinės instrukcijos suskirstytos pagal šaltinį (rankinis vs improvement agent), DUK, vektorių saugyklos būsena/dydis ir saugojimo naudojimas vs. | knowledge:read |
knowledge_website_delete | Ištrinti kiekvieną tam tikros svetainės (domeno) nuskaitytą puslapį iš pokalbių roboto žinių bazės. | knowledge:write |
knowledge_website_recrawl | Pakartotinai nuskaityti kiekvieną svetainės (domeno) puslapį pokalbių roboto žinių bazėje, kad atnaujintumėte turinį. | knowledge:write |
knowledge_website_recrawl_cancel | Atšaukti vykdomą svetainės pakartotinį nuskaitymą: eilėje (PENDING) buvę domeno puslapiai grąžinami į ankstesnę indeksuotą būseną. | knowledge:write |
knowledge_websites_list | Išvardinti svetaines (domenus), kurių puslapiai yra pokalbių roboto žinių bazėje, su puslapių skaičiais pagal būseną ir tokenų sumomis. | knowledge:read |
Kainodaros valdymas
Šie įrankiai tvarko struktūruotus kainų projektus ir aiškius patvirtinimus. Projekto išsaugojimas yra atskiras nuo tikslaus patvirtinimo; teisė į tai taip pat priklauso nuo būsenos ir galiojimo. Esami API raktai automatiškai neįgyja kainų leidimų. Tik įmonės savininkas gali skirti prices:write arba prices:approve. API rakto užklausos vykdomos iš karto, tad prieš kvazdami mutaciją peržiūrėkite tikslius įvesties duomenis. Žr. Prices & services klientų darbo eigai.
| Tool | Description | Scope |
|---|---|---|
price_list | Pereiti per kainų antraštes ir atskirti patvirtintos versijos tinkamumą. | prices:read |
price_get | Skaityti pilną elemento būseną ir peržiūras. | prices:read |
price_detail | Skaityti elemento išsamą informaciją su puslapiuota peržiūrų istorija. | prices:read |
price_suggestions_list | Pereiti per kainų pasiūlymus. | prices:read |
price_create | Sukurti projektą su serveryje sugeneruotu elemento ID. | prices:write |
price_edit | Sukurti naują projektą iš aiškiai tikėtinos elemento versijos. | prices:write |
price_import_csv | Importuoti projektus su aiškia formatu ir stabiliu importo ID saugiems pakartotiniams bandymams. | prices:write |
price_suggestion_apply | Taikyti pasirinktą pasiūlymo kandidatą kaip projektą. | prices:write |
price_approve | Patvirtinti vieną aiškiai tikimą elemento versiją. | prices:approve |
price_approve_many | Atlikti atomingą patvirtinimą su aiškiai pasirinktu ID/versija; bet kuri pasenusi versija atmeta visą pasirinkimą. | prices:approve |
price_archive | Archyvuoti elementą jo aiškiai tikimoje versijoje. | prices:approve |
Projekto redagavimai išsaugo ankstesnę patvirtintą peržiūrą. CSV formatas ir dešimtainis separatorius turi būti aiškūs; pakeitus CSV turinį reikia naujo importo ID. Visos operacijos siejamos su API rakto įmonė ir nurodytu pokalbių robotu.
DUK valdymas
| Tool | Description | Scope |
|---|---|---|
faq_cache_purge | Išvalyti talpinamus DUK valdiklio duomenis visuose prijungtuose CMS tinklalapiuose (WordPress papildinys). | faqs:write |
faq_categories_list | Išvardinti pokalbių roboto DUK kategorijas su jų DUK skaičiais, slug'ais, rūšiavimo režimu ir vertimais. | faqs:read |
faq_categories_reorder | Nustatyti DUK kategorijų tvarką valdiklyje: pozicija kategorijųIds masyve tampa sortOrder. | faqs:write |
faq_category_create | Sukurti DUK kategoriją pokalbių robotui (slug generuojamas iš pavadinimo). | faqs:write |
faq_category_delete | Ištrinti DUK kategoriją. | faqs:write |
faq_category_translations_update | Pakeisti DUK kategorijos vertimus, pvz. | faqs:write |
faq_category_update | Pervadinti DUK kategoriją arba pakeisti jos aprašymą, piktogramą ar rūšiavimo režimą. | faqs:write |
faq_create | Sukurti DUK pokalbių robotui. | faqs:write |
faq_delete | Visam laikui ištrinti DUK (taip pat pašalina jį iš pokalbių roboto žinių bazės ir išvalo CMS valdiklio kešus). | faqs:write |
faq_embed_code_get | Gauti įdėjimo fragmentus DUK valdikliui: skripto žymė, WordPress trumpasis kodas ir Shopify Liquid fragmentas, taip pat variantus pagal kategoriją (naudokite categorySlug iš faq_categories_list, kad įdėtumėte tik vieną kategoriją). | chatbots:read |
faq_get | Gauti pilnas DUK detales: klausimas, atsakymas, kategorija, publikavimo būsena, rūšiavimo tvarka, vertimai, SEO laukai ir atsiliepimų statistika. | faqs:read |
faq_list | Išvardinti pokalbių roboto DUK (naudokite chatbot_list, kad surastumėte chatbotId). | faqs:read |
faq_reorder | Nustatyti DUK rodymo tvarką valdiklyje. | faqs:write |
faq_suggestion_approve | Patvirtinti PENDING DUK pasiūlymą: sukuria paskelbtą DUK (nebūtinai su redaguotu klausimu/atsakymu/kategorija) ir pažymi pasiūlymą kaip APPROVED. | faqs:write |
faq_suggestion_get | Gauti pilnas DUK pasiūlymo detales (pilnas atsakymas, AI motyvacija, siūloma kategorija, peržiūros būsena). | faqs:read |
faq_suggestion_reject | Atmesti PENDING DUK pasiūlymą su neprivaloma priežastimi. | faqs:write |
faq_suggestions_generate | Leisti AI pasiūlyti naujas DUK iš pokalbių roboto žinių bazės (nuskaityti puslapiai / įkelti dokumentai), pasirinktinai vienai kategorijai. | faqs:write |
faq_suggestions_list | Išvardinti AI sugeneruotus DUK pasiūlymus pokalbių robotui (iš pokalbių ar faq_suggestions_generate). | faqs:read |
faq_translate | Išversti DUK klausimą ir atsakymą su AI į kitas pokalbių roboto palaikomas kalbas (arba nurodytas targetLanguages) ir išsaugoti rezultatą. | faqs:write |
faq_translations_update | Išsaugoti DUK vertimus pagal kalbą, pvz. | faqs:write |
faq_update | Atnaujinti DUK klausimą, atsakymą, kategoriją, publikavimo būseną arba rankinį rūšiavimo užsakymą. | faqs:write |
faq_widget_settings_get | Gauti įterpiamo DUK valdiklio išvaizdos ir elgsenos nustatymus (spalvos, kampo spindulys, pavadinimas, tarpai, max plotis, allowMultipleOpen, autoOpenFirst, rūšiavimo režimas, pavadinimo vertimai). | chatbots:read |
faq_widget_settings_update | Atnaujinti DUK valdiklio nustatymus: spalvos (hex), borderRadius 0-32, pavadinimas (max 100) + showTitle, spacing compact|normal|relaxed, maxWidth 0-2000 (0 = pilnas plotis), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name ir pavadinimo vertimai pagal kalbą. | chatbots:write |
Pokalbių istorija ir atsiliepimai
| Tool | Description | Scope |
|---|---|---|
chat_feedback_dismiss | Pažymėti pokalbį kaip peržiūrėtą be įvertinimo (išvalo jį iš laukiančios eilės, nepakeičia pasitikėjimo balo). | chats:write |
chat_feedback_get | Gauti vieną pokalbio peržiūrą (atsiliepimą) su AI analize, rimtumu, pasitikėjimo kategorija, balo pokyčiu ir susietu tobulinimo seansu. | chats:read |
chat_feedback_list | Išvardinti pokalbio peržiūras (atsiliepimų eilutes) pokalbių robotui su būsenos filtru ir skaičiais. | chats:read |
chat_feedback_set_severity | Pakeisti peržiūros klasifikacijos rimtumą (MINOR|MODERATE|MAJOR|CRITICAL) peržiūrėtam neigiamam pokalbiui; rimtumas veikia pasitikėjimo balo kritimą. | chats:write |
chat_feedback_stats | Sesijų skaičiai per peržiūros kaupiklį pokalbių robotui (viso, nėra, laukia, teigiami, neigiami, peržiūrėti, patobulinti) — statistikos kortelės suvestinės pokalbių puslapyje. | chats:read |
chat_feedback_submit | Įvertinti pokalbio sesiją kaip Good (isPositive=true) arba Needs Work (isPositive=false). | chats:write |
chat_session_get | Gauti pokalbio sesiją su pilna transkripcija (žinutės po žinutės tokenai/modelis/vėlavimas/pageUrl), lankytojo duomenys, pradžios puslapio URL, pasitikėjimo kategorija, atsiliepimai (rimtumas, AI analizė, susietas tobulinimo seansas) ir žymės. | chats:read |
chat_session_search | Ieškoti pokalbių sesijų pokalbių roboto pagal žinučių turinį ir/ar lankytojo el. paštą. | chats:read |
chat_session_set_category | Priskirti arba pakeisti pokalbio sesijos pasitikėjimo kategoriją (taisoma AI klasifikacija; per kategoriją pasitikėjimas perskaičiuojamas, kai pokalbis buvo peržiūrėtas). | chats:write |
chat_sessions_list | Išvardinti pokalbių sesijas pokalbių robotui, naujausi pirmi, su tais pačiais peržiūros eiles filtrais kaip suvestinės pokalbių puslapyje. | chats:read |
Improvement Agent
| Tool | Description | Scope |
|---|---|---|
confidence_categories_list | Išvardinti pokalbių roboto pasitikėjimo kategorijas su per kategoriją pasitikėjimo balu, peržiūrų skaičiumi ir peržiūros el. pašto dažniu. | chats:read |
confidence_category_create | Sukurti pasitikėjimo kategoriją pokalbių robotui. | chatbots:write |
confidence_category_delete | Ištrinti pasitikėjimo kategoriją. | chatbots:write |
confidence_category_merge | Sujungti vieną pasitikėjimo kategoriją į kitą to paties pokalbių roboto kategoriją: visi pokalbiai/peržiūros perkeliami į tikslinę, šaltinis ištrinamas ir balai perskaičiuojami. | chatbots:write |
confidence_category_update | Pervadinti pasitikėjimo kategoriją ir/ar nustatyti jos peržiūros el. pašto dažnį (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1-24 tik HOURLY). | chatbots:write |
confidence_status_get | Pokalbių roboto pasitikėjimo būsena: balas, baigimo slenkstis, mokymosi fazės žyma, mokymosi fazės elgsena (CAUTIOUS|BALANCED|CONFIDENT) ir pasirinktinis promptas, peržiūrų skaičiai ir per kategoriją pasitikėjimo balai. | analytics:read |
improvement_proposal_approve | Patvirtinti PENDING tobulinimo pasiūlymą ir pritaikyti pakeitimą pokalbių robotui (pagrindinės instrukcijos pridėjimas/atnaujinimas, DUK sukūrimas/atnaujinimas arba personos atnaujinimas) — ta pati logika ir plano apribojimai kaip suvestinėje. | chatbots:write |
improvement_proposal_reject | Atmesti PENDING tobulinimo pasiūlymą. | chatbots:write |
improvement_proposal_simulate | Simuliuoti, kaip pokalbių robotas atsakytų į probleminę žinutę, taikant pasiūlymą (originalas vs. | chatbots:write |
improvement_proposals_pending | Išvardinti laukiantčius peržiūros tobulinimo pasiūlymus (statusas PENDING) įmonėje arba vienam pokalbių robotui. | chatbots:read |
improvement_session_complete | Pažymėti tobulinimo sesiją kaip COMPLETED (pokalbis tada skaičiuojamas kaip Patobulintas peržiūros eilėje). | chatbots:write |
improvement_session_create | Atidaryti Improvement Agent pokalbiui, įvertintam kaip Needs Work. | chatbots:write |
improvement_session_get | Gauti tobulinimo sesiją su originaliu pokalbiu (žinutėms priskirtas 1 pagrindu indeksas, naudojamas kaip targetMessageIndex), agento pokalbis, visi pasiūlymai (su naujausia simuliacija) ir simuliacijos. | chatbots:read |
improvement_session_reset | Iš naujo paleisti tobulinimo sesiją: ištrina visus agento pranešimus, simuliacijas ir PENDING/REJECTED pasiūlymus (pritaikyti paliekami) ir pradeda naują pokalbį. | chatbots:write |
improvement_session_send_message | Siųsti žinutę Improvement Agent (apibūdinti, kas buvo negerai su boto atsakymu; neprivalomas targetMessageIndex = 1 pagrindu indekso bot žinutės originalChat.messages). | chatbots:write |
improvement_sessions_list | Išvardinti tobulinimo sesijas (Improvement Agent pokalbiai, pradėti iš neigiamų pokalbių peržiūrų) pokalbių robotui arba visai įmonei, naujausi pirmi, su pasiūlymų skaičiumi. | chatbots:read |
improvement_simulation_assess | Įvertinti simuliacijos rezultatą: isApproved=true, kai simuliuotas atsakymas yra geras (pasiūlymą tada galima pritaikyti), false kai reikia daugiau darbo (komentaras 'almost' = beveik teisinga). | chatbots:write |
Gyvas pokalbis
| Tool | Description | Scope |
|---|---|---|
live_chat_agents_available | Gauti dabartinio vartotojo gyvo pokalbio prieinamumą, agentus, kurie šiuo metu yra pasiekiami gyvam pokalbiui (šviežus širdies plakimas, tas pats signalas, kurį naudoja valdiklis) ir ar įmonės planas apima gyvą pokalbį. | chats:read |
live_chat_heartbeat | Atnaujinti dabartinio vartotojo gyvo pokalbio būsenos širdies plakimą (tik kai pažymėtas kaip prieinamas per live_chat_set_availability). | chats:write |
live_chat_message_send | Siųsti žinutę lankytojui kaip priskirtas agentas. | chats:write |
live_chat_queue | Gauti gyvo pokalbio eilę: sesijos, laikančios agentą, seniausios pirmos (FIFO). | chats:read |
live_chat_session_assign | Paimti WAITING gyvą pokalbio sesiją iš eilės: priskiria ją dabartiniam vartotojui (įmonės savininkas API raktams) ir praneša lankytojui, kad agentas prisijungė. | chats:write |
live_chat_session_close | Baigti gyvą pokalbio sesiją kaip agentas (bet kuris ne VIEWER įmonės narys). | chats:write |
live_chat_session_get | Gauti gyvą pokalbio sesiją su lankytojo informacija, priskirtu agentu, visomis žinutėmis ir ankstesniu boto pokalbiu (handoff kontekstas). | chats:read |
live_chat_sessions_list | Išvardinti gyvas pokalbio sesijas (naujausi pirmi; WAITING sesijos seniausios pirmos) su pasirenkamais filtrais pagal pokalbių robotą, būseną ir priskirtą agentą. | chats:read |
live_chat_set_availability | Perjungti dabartinio vartotojo „Available for Live Chat" perjungimą įmonėje. | chats:write |
Potencialūs klientai
| Tool | Description | Scope |
|---|---|---|
lead_assign | Priskirti potencialų klientą įmonės nariui arba atšaukti priskyrimą (assignedToId: null). | leads:write |
lead_bulk_update_status | Nustatyti kelių potencialių klientų būsenas vienu metu (max 100). | leads:write |
lead_categories_list | Išvardinti pokalbių roboto potencialių klientų kategorijas su potencialių klientų skaičiais ir komandos nariais, pranešančiais apie kiekvieną kategoriją. | leads:read |
lead_category_assign_user | Pridėti įmonės narį į potencialių klientų kategorijos pranešimų sąrašą (arba atnaujinti jų pranešimų žymes). | leads:write |
lead_category_create | Sukurti potencialių klientų kategoriją pokalbių robotui. | leads:write |
lead_category_delete | Ištrinti potencialių klientų kategoriją. | leads:write |
lead_category_remove_user | Pašalinti įmonės narį iš potencialių klientų kategorijos pranešimų sąrašo. | leads:write |
lead_category_update | Atnaujinti potencialių klientų kategorijos pavadinimą, aprašymą ir/ar spalvą. | leads:write |
lead_create | Rankiniu būdu sukurti potencialų klientą (pvz. | leads:write |
lead_delete | Visam laikui ištrinti potencialų klientą. | leads:write |
lead_field_config_get | Gauti pokalbių roboto potencialų klientų rinkimo konfigūraciją: laukai (ids žemėlapis atitinka raktus lead.data), patvirtinimo žinutė, lauko/UI vertimai ir AI atpažinimo nustatymai. | leads:read |
lead_field_config_update | Atnaujinti pokalbių roboto potencialių klientų rinkimo konfigūraciją. | leads:write |
lead_get | Gauti pilną potencialo kliento informaciją, įskaitant priskirtą asmenį, kategoriją ir šaltinio pokalbio transkriptą (puslapiuojama su messageOffset/messageLimit, numatyta pirmos 20 žinučių). | leads:read |
lead_list | Išvardinti pokalbių roboto potencialius klientus (naujausi pirmi) su pasirenkamais filtrais pagal būseną, kategoriją, priskirtą asmenį ir laisvos formos paiešką (vardas/el. paštas/įmonė). | leads:read |
lead_stats | Gauti potencialų klientų statistiką pokalbių robotui: skaičiai pagal būseną, paskutinės 7 dienos potencialai ir konversijos rodiklis (procentais). | leads:read |
lead_update | Atnaujinti potencialo kliento būseną, kategoriją, pastabas, surinktus duomenis ir/ar priskirtą asmenį. | leads:write |
Formos
| Tool | Description | Scope |
|---|---|---|
form_create | Sukurti kontaktinę formą pokalbių robotui (pagrindai, laukai, dizainas ir spam nustatymai vienu kvietimu). | forms:write |
form_delete | Visam laikui ištrinti kontaktinę formą ir VISUS jos pateikimus (kaskadinis). | forms:write |
form_get | Gauti pilną kontaktinę formą: laukus, vertimus, stilių, spam nustatymus, aktyvumo būseną, pateikimų skaičių ir įdėjimo skripto žymę (embedCode). | forms:read |
form_list | Išvardinti pokalbių roboto kontaktines formas su laukų skaičiais, pateikimų skaičiais ir įdėjimo kodais. | forms:read |
form_stats | Kontaktinės formos pateikimų skaičiai: iš viso, laukia, patvirtinta, spam ir atmesta. | forms:read |
form_submission_delete | Visam laikui ištrinti kontaktinės formos pateikimą (pvz. | forms:write |
form_submission_get | Gauti kontaktinės formos pateikimą pilnai: pateikti lauko duomenys, spam balas ir AI spam analizė, IP/user agent/referrer metaduomenys ir peržiūros informacija. | forms:read |
form_submission_update_status | Peržiūrėti kontaktinės formos pateikimą: nustatyti jo būseną kaip APPROVED, SPAM arba REJECTED su neprivalomu peržiūros pastabu. | forms:write |
form_submissions_list | Išvardinti kontaktinės formos pateikimus, naujausi pirmi, pasirenkamai filtruojant pagal būseną (PENDING, APPROVED, SPAM, REJECTED) ir sukūrimo datą. | forms:read |
form_update | Atnaujinti kontaktinę formą: pavadinimas, aprašymas, aktyvumas (isActive kontroliuoja, ar įdėjimas renderinamas), laukai (visiškai pakeisti), dizainas (spalvos, mygtuko tekstas, sėkmės žinutė) ir spam nustatymai (spamThreshold, autoRejectSpam, notificationEmail). | forms:write |
form_update_translations | Pakeisti lauko ir/ar UI vertimus kontaktinei formei. | forms:write |
El. pašto asistentas
| Tool | Description | Scope |
|---|---|---|
email_activity_list | Išvardinti apdoroto el. pašto veiklos žurnalą pašto dėžutės prijungime (naujausi pirmi): siuntėjas, tema, priskirta kategorija, rezultatas (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) ir outcomeDetail. | email:read |
email_categories_list | Išvardinti el. pašto kategorijas pašto dėžutės prijungime (rūšiuotos pagal sortOrder). | email:read |
email_category_create | Sukurti el. pašto kategoriją pašto dėžutės prijungime (max 20 per prisijungimą). | email:write |
email_category_delete | Ištrinti el. pašto kategoriją. | email:write |
email_category_update | Atnaujinti el. pašto kategoriją (iš dalies: keičiasi tik nurodyti laukai). | email:write |
email_connection_disconnect | Atjungti pašto dėžutę visam laikui. | email:write |
email_connection_get | Gauti pašto dėžutės prisijungimą įskaitant | email:read |
email_connection_update | Atnaujinti pašto dėžutės prisijungimą: pristabdyti/atnaujinti sinchronizaciją (paused true/false; tik perjungia ACTIVE<->DISABLED, niekada nepakeičia TOKEN_EXPIRED/ERROR), perjungti atsakymo juodraščių kūrimą (draftingEnabled) ir kategorizavimą/organizuojimą (organizingEnabled), peradresuoti tiekiantį pokalbių robotą (tos pačios įmonės chatbotId) arba nustatyti HTML atsakymo parašą (signatureHtml, max 20000 simbolių; tuščia eilutė išvalo). | email:write |
email_connections_list | Išvardinti įmonės El. pašto asistento pašto dėžučių prisijungimus (adresas, būsena ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, paskutinė sinchronizacija, paskutinė klaida, juodraščių/kategorizavimo perjungimai, tiekiantis pokalbių robotas, draftReadyCategoryCount = kategorijos, galinčios sukurti juodraščius, baseRuleCount = pokalbių roboto lygio 'Chat + Email' taisyklės, taikomos kiekvienam juodraščiui) kartu su plano apribojimais (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth). | email:read |
email_contact_delete | Ištrinti išmoktą el. pašto kontaktą (pamesti siuntėjo profilį, pvz. | email:write |
email_contact_get | Gauti išmoktą el. pašto kontaktą su visais išmoktais faktais, vidinėmis pastabomis, ryšiu, formal/informal adresavimo nustatymu ir el. pašto statistika. | email:read |
email_contact_update | Atnaujinti išmoktą el. pašto kontaktą. | email:write |
email_contacts_list | Išvardinti įmonės išmoktus el. pašto kontaktus (naujausias el. paštas pirmas) su santykiu, formal/informal adresavimu (formalAddress: true = formali „Jūs", false = neformali „tu", null = automatinė), faktų skaičiumi ir pastabų peržiūra. | email:read |
email_folder_create | Sukurti pašto aplanką gautuosiuose (grąžina esamą, jei pavadinimas užimtas), kurį naudoti kaip kategorijos perkėlimo tikslą. | email:write |
email_folders_list | Išvardinti aplankus, į kuriuos el. pašto kategorija gali perkelti laiškus, realiu laiku iš pašto dėžutės: gautųjų potaplai, pasirinktinis viršutinis lygis aplankai, archyvas, šiukšlės ir šiukšliadėžė (id 'deleteditems'). | email:read |
email_general_rules_list | Išvardinti pokalbių roboto lygio taisykles, kurios taikomos kiekvienam pašto juodraščio atsakymui: aktyvios pagrindinės instrukcijos su kanalu BOTH ("Chat + Email"), plius legacy el. pašto tik taisyklės, dar neperkelti į kategoriją. | email:read |
Analitika
| Tool | Description | Scope |
|---|---|---|
analytics_chat_volume | Pokalbių apimtis (sesijų pradžios) laikui bėgant diagramoms ir tendencijoms: periodas week/month/quarter/year, granuliarumas hour/day/week/month, pasirinktinai vienam pokalbių robotui. | analytics:read |
analytics_chatbot_stats | Įmonės pokalbių robotų našumas vienu kvietimu (suvestinės pokalbių robotų našumo lentelė): id, pavadinimas, slug, isActive, sesijos, žinutės, DUK ir potencialūs klientai kiekvienam pokalbių robotui, rūšiuota pagal sesijas. | analytics:read |
analytics_forms | Kontaktinės formos pateikimų statistika įmonei arba vienam pokalbių robotui (suvestinės analizės valdiklis): pateikimai pagal būseną (pending/approved/rejected/spam), formų skaičius, suma, spam rodiklis procentais ir paskutinių 7 dienų pateikimų per dieną serija. | analytics:read |
analytics_leads | Potencialių klientų tunelis įmonei arba vienam pokalbių robotui (suvestinės analizės valdiklis): potencialūs pagal būseną (new/contacted/qualified/converted/lost), suma, konversijos rodiklis procentais ir paskutinių 7 dienų potencialų per dieną serija. | analytics:read |
analytics_overview | Analitikos apžvalga įmonei arba vienam pokalbių robotui: pokalbiai, žinutės, pasitenkinimo rodiklis ir populiariausi klausimai per pasirinktą laikotarpį (day/week/month/year), plius suvestinės apžvalgos valdiklis (viso pokalbių robotų/paskelbtų DUK/potencialių klientų, sesijos šiandien/šią savaitę/šį mėnesį, potencialai šiandien/šią savaitę, formų pateikimai iš viso/šiandien/laukiantys). | analytics:read |
dashboard_activity | Kas šiuo metu reikalauja dėmesio (suvestinės pagrindinis vaizdas): pagal įmonę, pokalbių robotai su naujais potencialais šiandien, laukiančiais DUK pasiūlymais, laukiančiais formų pateikimais, laukiančiais/aktyviais gyvais pokalbiais arba vykstančia mokymosi faze. | any |
Pavyzdinės darbo eigos
Pagrindinės instrukcijos pridėjimas
Paklauskite savo AI asistento:
"Pridėkite pagrindinę instrukciją mano 'Support Bot' pokalbių robotui: mes siūlome nemokamą pristatymą užsakymams virš €50"
Asistentas naudos chatbot_add_instruction su tinkamais parametrais.
Tobulinimo pasiūlymų peržiūra
"Rodyk man visus laukiančius tobulinimo pasiūlymus mano pokalbių robotui ir paaiškink, kokius pakeitimus jie siūlo"
Asistentas:
- Naudos
improvement_proposals_pendingpasiūlymams gauti - Analizuos ir apibendrins kiekvieną pasiūlymą
- Patvirtins arba atmes juos Jūsų vardu naudodamas
improvement_proposal_approvearbaimprovement_proposal_reject
Pokalbių veiklos analizė
"Duok man savaitinę ataskaitą apie pokalbių apimtį ir klientų pasitenkinimą mano pokalbių robotui"
Asistentas naudos analytics_overview ir analytics_chat_volume, kad parengtų išsamią ataskaitą.
Svetainės importavimas
"Nuskaityk https://example.com, importuok produktų ir kainų puslapius į mano 'Support Bot' ir pranešk, kai nuskaitymas baigtas"
Asistentas iškvies crawler_preview_scan, parinks atitinkamus puslapius, pradės importą su crawler_start ir tikrins būseną su crawler_job_get, kol darbas bus baigtas.
Potencialių klientų ir formų pateikimų peržiūra
"Rodyk man naujus šios savaitės potencialus, priskirk kvalifikuotus Annai ir patvirtink laukiančius kontaktinių formų pateikimus"
Asistentas sujungia lead_list, lead_assign, form_submissions_list ir form_submission_update_status.
Perimti gyvą pokalbį
"Nustatyk mane prieinamą gyvam pokalbiui ir perimk seniausią laukiančią pokalbį"
Asistentas naudoja live_chat_set_availability, live_chat_queue ir live_chat_session_assign; atsakymai siunčiami per live_chat_message_send.
Saugumas
- API raktai pririšti prie Jūsų įmonės ir prie leidimų srities, kuriuos pasirinkote juos kuriant (žr. aukščiau esantį Scope stulpelį)
- Raktai vykdomi su įmonės savininko leidimais; plano apribojimai ir funkcijų apribojimai taikomi tiksliai taip pat kaip suvestinėje
- Raktai gali būti bet kada atšaukti iš suvestinės
- API prieiga prieinama mokamuose planuose — žr. mūsų Kainodaros puslapį
Problemų sprendimas
Nepavyko prisijungti
- Patikrinkite, ar Jūsų API raktas yra teisingas
- Patikrinkite, ar raktas nebuvo atšauktas
- Įsitikinkite, kad Jūsų planas apima API prieigą
- Perkraukite savo MCP klientą
Įrankis nerastas
Perkraukite savo MCP klientą po konfigūracijos pakeitimo, kad jis perkrautų prieinamus įrankius. Įrankių pavadinimai yra mažosiomis raidėmis su brūkšneliu (underscore), pvz., faq_list.
Reikia pagalbos? Kreipkitės į mūsų palaikymo komandą →