PradžiaDokumentacija

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ą

  1. Eikite į savo Pagrindinis → Įmonė → API skirtuką
  2. Spauskite Sukurti API raktą
  3. Pavadinkite raktą aprašomai (pvz., "Claude Desktop") ir pasirinkite bent vieną leidimą
  4. 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

ToolDescriptionScope
account_usage_getGaukite 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_companiesIšvardinkite visas įmones, prie kurių turi prieigą dabartinis vartotojas, kartu su vartotojo vaidmeniu kiekvienoje.any
user_notification_mark_readPažymėkite vieną iš dabartinio vartotojo pranešimų kaip perskaitytą.any
user_notification_preferences_getGaukite 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_updateAtnaujinkite 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_listIšvardinkite visus pranešimų tipus, suskirstytus pagal kategoriją (pokalbių robotas, potencialūs klientai, gyvas pokalbis, žinios, komanda, atsiskaitymas).any
user_notification_unread_countGaukite dabartinio vartotojo neperskaitytų pranešimų skaičių.any
user_notificationsIšvardinkite dabartinio vartotojo pranešimus, naujausi pirmi, su kursorine puslapiavimo sistema.any
user_notifications_delete_oldTechninė priežiūra: visam laikui ištrinkite dabartinio vartotojo pranešimus, kurie jau perskaityti ir vyresni nei 30 dienų.any
user_notifications_mark_all_readPažymėkite visus dabartinio vartotojo pranešimus kaip perskaitytus.any
user_profileGaukite dabartinio vartotojo profilį (id, vardas, el. paštas, vaidmuo, prenumeratos lygis).any

Įmonė ir komanda

ToolDescriptionScope
company_chatbots_listIšvardinkite visus konkrečios įmonės pokalbių robotus su santraukos statistika.chatbots:read
company_getGaukite išsamią informaciją apie įmonę: profilį, savininką, prekės ženklo nustatymus (spalvos, pranešimų el. paštas) ir skaičius.any
company_invite_cancelAtšaukti (ištrinti) komandos kvietimą, kad nuoroda nebebūtų galiojanti.company:write
company_invite_resendPersių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_listIšvardinkite įmonės komandos kvietimus (pagal nutylėjimą rodo laukiančius; nustatykite includeExpired, kad grąžintų ir pasibaigusius).company:read
company_listIšvardinkite visas įmones, prie kurių vartotojas turi prieigą (API raktai ir Dashboard Assistant mato tik savo įmonę).any
company_logo_removePašalinkite įmonės logotipą (ištrina saugomą vaizdą ir išvalo logotipo URL).company:write
company_member_invitePakvieskite komandos narį el. paštu nurodydami vaidmenį (ADMIN, MANAGER, AGENT arba VIEWER).company:write
company_member_removePašalinkite komandos narį iš įmonės.company:write
company_member_update_rolePakeiskite komandos nario vaidmenį (ADMIN, MANAGER, AGENT arba VIEWER).company:write
company_members_listIšvardinkite įmonės narius su jų vaidmenimis (OWNER, ADMIN, MANAGER, AGENT, VIEWER).any
company_settings_updateAtnaujinkite įmonės prekės ženklo nustatymus: primaryColor / secondaryColor (#RRGGBB) ir notificationEmail pokalbių peržiūroms.company:write
company_updateAtnaujinkite į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

ToolDescriptionScope
chatbot_add_instructionPridėti naują pagrindinę instrukciją pokalbių robotui (1-5000 simbolių).chatbots:write
chatbot_confirm_embedPažymėti pokalbių robotą kaip įdėtą į svetainę (paslepia nustatymo priminimą suvestinėje).chatbots:write
chatbot_createSukurti naują pokalbių robotą (tas pats, kaip vedlio sąsajoje).chatbots:write
chatbot_deleteVisam laikui ištrinti pokalbių robotą su visais jo DUK, dokumentais, pokalbiais, potencialiais klientais ir formomis (negrįžtama).chatbots:write
chatbot_delete_instructionIštrinti pagrindinę instrukciją iš pokalbių roboto.chatbots:write
chatbot_getGauti 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_codeGauti HTML fragmentą pokalbių roboto įdiegimui svetainėje (skripto URL + <script> žymė) ir informaciją, ar įdiegimas buvo patvirtintas.chatbots:read
chatbot_get_instructionsGauti visas pagrindines instrukcijas pokalbių robotui.chatbots:read
chatbot_improve_instructionsPerrašyti pagrindinės instrukcijos tekstą naudojant platformos AI tobulintuvą (tas pats, kas suvestinėje „Improve with AI“).chatbots:write
chatbot_learning_phase_getGauti 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_updateNustatyti mokymosi fazės elgsenos nustatymą (CAUTIOUS = nukreipti į žmogų, kai neaišku, BALANCED, CONFIDENT) ir/ar pasirinktą mokymosi fazės promptą.chatbots:write
chatbot_listIšvardinti visus pokalbių robotus, prie kurių vartotojas turi prieigą, su santraukos statistika.chatbots:read
chatbot_reorder_instructionsNustatyti pokalbių roboto pagrindinių instrukcijų tvarką.chatbots:write
chatbot_templates_listIš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_activeAktyvuoti arba deaktyvuoti pokalbių robotą.chatbots:write
chatbot_toggle_learningBaigti (false) arba vėl įjungti (true) pokalbių roboto mokymosi fazę.chatbots:write
chatbot_updateAtnaujinti 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_instructionAtnaujinti esamą pagrindinę instrukciją (turinys, isActive, kanalas, sortOrder).chatbots:write
chatbot_update_personalityAtnaujinti 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_getGauti dabartinius valdiklio nustatymus pokalbių robotui (visi išvaizdos, prekės ženklo, elgsenos ir priešpokalbio formų laukai).chatbots:read
widget_settings_updateAtnaujinti pokalbių roboto valdiklį: pozicija (įskaitantchatbots:write
widget_translations_getGauti pokalbių roboto valdiklio vertimus kiekvienai kalbai: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }.chatbots:read
widget_translations_updateNustatyti valdiklio vertimus pagal kalbą.chatbots:write

Žinių bazė

ToolDescriptionScope
crawler_job_cancelAtšaukti PENDING arba RUNNING nuskaitymo darbą; likę puslapiai praleidžiami.knowledge:write
crawler_job_getGauti nuskaitymo darbo būseną, pažangą (pagesCrawled/pagesFound, tokensUsed) ir kiekvieno puslapio būseną.knowledge:read
crawler_jobs_listIšvardinti pokalbių roboto nuskaitymo darbus (naujausi pirmi) su būsena ir pažanga.knowledge:read
crawler_limitsGauti 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_scanNuskaityti svetainę ir išvardinti jos nuskaitymui tinkamus puslapius (url, pavadinimas, isRecommended) be importo.knowledge:write
crawler_startPradėti nuskaitymo darbą, kuris importuoja pasirinktus URL į pokalbių roboto žinių bazę (apdorojama fone; poll crawler_job_get).knowledge:write
knowledge_document_add_from_urlAtsisių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_textPridėti teksto arba markdown dokumentą į pokalbių roboto žinių bazę iš inline turinio (max 10 MB).knowledge:write
knowledge_document_deleteIštrinti įkeltą dokumentą iš žinių bazės.knowledge:write
knowledge_document_getGauti įkelto dokumento detales, įskaitant apdorojimo būseną, klaidos pranešimą ir trumpalaikį atsisiuntimo URL.knowledge:read
knowledge_documents_listIšvardinti įkeltus dokumentus (PDF, TXT, MD, CSV, JSON, DOCX) pokalbių roboto žinių bazėje su būsena ir dydžiu.knowledge:read
knowledge_page_addNuskaityti 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_deleteIštrinti nuskaitytą puslapį iš žinių bazės (pašalina jo vektorių saugyklos failą).knowledge:write
knowledge_page_getGauti nuskaitytą puslapį kartu su indeksuotu markdown turiniu pokalbių robotui (naudinga patikrinti, ką bot žino apie puslapį).knowledge:read
knowledge_page_recrawlPakartotinai nuskaityti puslapį ir pakeisti jo indeksuotą turinį (pvz.knowledge:write
knowledge_pages_deleteIštrinti kelis nuskaitytus puslapius iš pokalbių roboto vienu metu.knowledge:write
knowledge_pages_listIšvardinti nuskaitytus puslapius pokalbių roboto žinių bazėje, nebūtina filtruojant pagal domeną, būseną arba paieškos terminą (URL/pavadinimas).knowledge:read
knowledge_statsPerž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_deleteIštrinti kiekvieną tam tikros svetainės (domeno) nuskaitytą puslapį iš pokalbių roboto žinių bazės.knowledge:write
knowledge_website_recrawlPakartotinai nuskaityti kiekvieną svetainės (domeno) puslapį pokalbių roboto žinių bazėje, kad atnaujintumėte turinį.knowledge:write
knowledge_website_recrawl_cancelAtšaukti vykdomą svetainės pakartotinį nuskaitymą: eilėje (PENDING) buvę domeno puslapiai grąžinami į ankstesnę indeksuotą būseną.knowledge:write
knowledge_websites_listIš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.

ToolDescriptionScope
price_listPereiti per kainų antraštes ir atskirti patvirtintos versijos tinkamumą.prices:read
price_getSkaityti pilną elemento būseną ir peržiūras.prices:read
price_detailSkaityti elemento išsamą informaciją su puslapiuota peržiūrų istorija.prices:read
price_suggestions_listPereiti per kainų pasiūlymus.prices:read
price_createSukurti projektą su serveryje sugeneruotu elemento ID.prices:write
price_editSukurti naują projektą iš aiškiai tikėtinos elemento versijos.prices:write
price_import_csvImportuoti projektus su aiškia formatu ir stabiliu importo ID saugiems pakartotiniams bandymams.prices:write
price_suggestion_applyTaikyti pasirinktą pasiūlymo kandidatą kaip projektą.prices:write
price_approvePatvirtinti vieną aiškiai tikimą elemento versiją.prices:approve
price_approve_manyAtlikti atomingą patvirtinimą su aiškiai pasirinktu ID/versija; bet kuri pasenusi versija atmeta visą pasirinkimą.prices:approve
price_archiveArchyvuoti 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

ToolDescriptionScope
faq_cache_purgeIšvalyti talpinamus DUK valdiklio duomenis visuose prijungtuose CMS tinklalapiuose (WordPress papildinys).faqs:write
faq_categories_listIšvardinti pokalbių roboto DUK kategorijas su jų DUK skaičiais, slug'ais, rūšiavimo režimu ir vertimais.faqs:read
faq_categories_reorderNustatyti DUK kategorijų tvarką valdiklyje: pozicija kategorijųIds masyve tampa sortOrder.faqs:write
faq_category_createSukurti DUK kategoriją pokalbių robotui (slug generuojamas iš pavadinimo).faqs:write
faq_category_deleteIštrinti DUK kategoriją.faqs:write
faq_category_translations_updatePakeisti DUK kategorijos vertimus, pvz.faqs:write
faq_category_updatePervadinti DUK kategoriją arba pakeisti jos aprašymą, piktogramą ar rūšiavimo režimą.faqs:write
faq_createSukurti DUK pokalbių robotui.faqs:write
faq_deleteVisam 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_getGauti į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_getGauti pilnas DUK detales: klausimas, atsakymas, kategorija, publikavimo būsena, rūšiavimo tvarka, vertimai, SEO laukai ir atsiliepimų statistika.faqs:read
faq_listIšvardinti pokalbių roboto DUK (naudokite chatbot_list, kad surastumėte chatbotId).faqs:read
faq_reorderNustatyti DUK rodymo tvarką valdiklyje.faqs:write
faq_suggestion_approvePatvirtinti 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_getGauti pilnas DUK pasiūlymo detales (pilnas atsakymas, AI motyvacija, siūloma kategorija, peržiūros būsena).faqs:read
faq_suggestion_rejectAtmesti PENDING DUK pasiūlymą su neprivaloma priežastimi.faqs:write
faq_suggestions_generateLeisti AI pasiūlyti naujas DUK iš pokalbių roboto žinių bazės (nuskaityti puslapiai / įkelti dokumentai), pasirinktinai vienai kategorijai.faqs:write
faq_suggestions_listIšvardinti AI sugeneruotus DUK pasiūlymus pokalbių robotui (iš pokalbių ar faq_suggestions_generate).faqs:read
faq_translateIšversti DUK klausimą ir atsakymą su AI į kitas pokalbių roboto palaikomas kalbas (arba nurodytas targetLanguages) ir išsaugoti rezultatą.faqs:write
faq_translations_updateIšsaugoti DUK vertimus pagal kalbą, pvz.faqs:write
faq_updateAtnaujinti DUK klausimą, atsakymą, kategoriją, publikavimo būseną arba rankinį rūšiavimo užsakymą.faqs:write
faq_widget_settings_getGauti į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_updateAtnaujinti 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

ToolDescriptionScope
chat_feedback_dismissPaž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_getGauti vieną pokalbio peržiūrą (atsiliepimą) su AI analize, rimtumu, pasitikėjimo kategorija, balo pokyčiu ir susietu tobulinimo seansu.chats:read
chat_feedback_listIšvardinti pokalbio peržiūras (atsiliepimų eilutes) pokalbių robotui su būsenos filtru ir skaičiais.chats:read
chat_feedback_set_severityPakeisti 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_statsSesijų 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_getGauti 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_searchIeškoti pokalbių sesijų pokalbių roboto pagal žinučių turinį ir/ar lankytojo el. paštą.chats:read
chat_session_set_categoryPriskirti 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_listIš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

ToolDescriptionScope
confidence_categories_listIš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_createSukurti pasitikėjimo kategoriją pokalbių robotui.chatbots:write
confidence_category_deleteIštrinti pasitikėjimo kategoriją.chatbots:write
confidence_category_mergeSujungti 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_updatePervadinti 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_getPokalbių 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_approvePatvirtinti 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_rejectAtmesti PENDING tobulinimo pasiūlymą.chatbots:write
improvement_proposal_simulateSimuliuoti, kaip pokalbių robotas atsakytų į probleminę žinutę, taikant pasiūlymą (originalas vs.chatbots:write
improvement_proposals_pendingIšvardinti laukiantčius peržiūros tobulinimo pasiūlymus (statusas PENDING) įmonėje arba vienam pokalbių robotui.chatbots:read
improvement_session_completePažymėti tobulinimo sesiją kaip COMPLETED (pokalbis tada skaičiuojamas kaip Patobulintas peržiūros eilėje).chatbots:write
improvement_session_createAtidaryti Improvement Agent pokalbiui, įvertintam kaip Needs Work.chatbots:write
improvement_session_getGauti 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_resetIš 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_messageSių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_listIš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

ToolDescriptionScope
live_chat_agents_availableGauti 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_heartbeatAtnaujinti 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_sendSiųsti žinutę lankytojui kaip priskirtas agentas.chats:write
live_chat_queueGauti gyvo pokalbio eilę: sesijos, laikančios agentą, seniausios pirmos (FIFO).chats:read
live_chat_session_assignPaimti 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_closeBaigti gyvą pokalbio sesiją kaip agentas (bet kuris ne VIEWER įmonės narys).chats:write
live_chat_session_getGauti gyvą pokalbio sesiją su lankytojo informacija, priskirtu agentu, visomis žinutėmis ir ankstesniu boto pokalbiu (handoff kontekstas).chats:read
live_chat_sessions_listIš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_availabilityPerjungti dabartinio vartotojo „Available for Live Chat" perjungimą įmonėje.chats:write

Potencialūs klientai

ToolDescriptionScope
lead_assignPriskirti potencialų klientą įmonės nariui arba atšaukti priskyrimą (assignedToId: null).leads:write
lead_bulk_update_statusNustatyti kelių potencialių klientų būsenas vienu metu (max 100).leads:write
lead_categories_listIš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_userPridėti įmonės narį į potencialių klientų kategorijos pranešimų sąrašą (arba atnaujinti jų pranešimų žymes).leads:write
lead_category_createSukurti potencialių klientų kategoriją pokalbių robotui.leads:write
lead_category_deleteIštrinti potencialių klientų kategoriją.leads:write
lead_category_remove_userPašalinti įmonės narį iš potencialių klientų kategorijos pranešimų sąrašo.leads:write
lead_category_updateAtnaujinti potencialių klientų kategorijos pavadinimą, aprašymą ir/ar spalvą.leads:write
lead_createRankiniu būdu sukurti potencialų klientą (pvz.leads:write
lead_deleteVisam laikui ištrinti potencialų klientą.leads:write
lead_field_config_getGauti 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_updateAtnaujinti pokalbių roboto potencialių klientų rinkimo konfigūraciją.leads:write
lead_getGauti pilną potencialo kliento informaciją, įskaitant priskirtą asmenį, kategoriją ir šaltinio pokalbio transkriptą (puslapiuojama su messageOffset/messageLimit, numatyta pirmos 20 žinučių).leads:read
lead_listIš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_statsGauti potencialų klientų statistiką pokalbių robotui: skaičiai pagal būseną, paskutinės 7 dienos potencialai ir konversijos rodiklis (procentais).leads:read
lead_updateAtnaujinti potencialo kliento būseną, kategoriją, pastabas, surinktus duomenis ir/ar priskirtą asmenį.leads:write

Formos

ToolDescriptionScope
form_createSukurti kontaktinę formą pokalbių robotui (pagrindai, laukai, dizainas ir spam nustatymai vienu kvietimu).forms:write
form_deleteVisam laikui ištrinti kontaktinę formą ir VISUS jos pateikimus (kaskadinis).forms:write
form_getGauti pilną kontaktinę formą: laukus, vertimus, stilių, spam nustatymus, aktyvumo būseną, pateikimų skaičių ir įdėjimo skripto žymę (embedCode).forms:read
form_listIšvardinti pokalbių roboto kontaktines formas su laukų skaičiais, pateikimų skaičiais ir įdėjimo kodais.forms:read
form_statsKontaktinės formos pateikimų skaičiai: iš viso, laukia, patvirtinta, spam ir atmesta.forms:read
form_submission_deleteVisam laikui ištrinti kontaktinės formos pateikimą (pvz.forms:write
form_submission_getGauti 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_statusPerž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_listIšvardinti kontaktinės formos pateikimus, naujausi pirmi, pasirenkamai filtruojant pagal būseną (PENDING, APPROVED, SPAM, REJECTED) ir sukūrimo datą.forms:read
form_updateAtnaujinti 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_translationsPakeisti lauko ir/ar UI vertimus kontaktinei formei.forms:write

El. pašto asistentas

ToolDescriptionScope
email_activity_listIš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_listIšvardinti el. pašto kategorijas pašto dėžutės prijungime (rūšiuotos pagal sortOrder).email:read
email_category_createSukurti el. pašto kategoriją pašto dėžutės prijungime (max 20 per prisijungimą).email:write
email_category_deleteIštrinti el. pašto kategoriją.email:write
email_category_updateAtnaujinti el. pašto kategoriją (iš dalies: keičiasi tik nurodyti laukai).email:write
email_connection_disconnectAtjungti pašto dėžutę visam laikui.email:write
email_connection_getGauti pašto dėžutės prisijungimą įskaitantemail:read
email_connection_updateAtnaujinti 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_listIš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_deleteIštrinti išmoktą el. pašto kontaktą (pamesti siuntėjo profilį, pvz.email:write
email_contact_getGauti 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_updateAtnaujinti išmoktą el. pašto kontaktą.email:write
email_contacts_listIš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_createSukurti pašto aplanką gautuosiuose (grąžina esamą, jei pavadinimas užimtas), kurį naudoti kaip kategorijos perkėlimo tikslą.email:write
email_folders_listIš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_listIš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

ToolDescriptionScope
analytics_chat_volumePokalbių 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_formsKontaktinė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_leadsPotencialių 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_overviewAnalitikos 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_activityKas š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:

  1. Naudos improvement_proposals_pending pasiūlymams gauti
  2. Analizuos ir apibendrins kiekvieną pasiūlymą
  3. Patvirtins arba atmes juos Jūsų vardu naudodamas improvement_proposal_approve arba improvement_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

  1. Patikrinkite, ar Jūsų API raktas yra teisingas
  2. Patikrinkite, ar raktas nebuvo atšauktas
  3. Įsitikinkite, kad Jūsų planas apima API prieigą
  4. 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ą →