MCP Server Integration
ChatReact toetab Model Context Protocol (MCP)-i, mis võimaldab ühendada Teie ChatReact konto AI-assistentidega nagu Claude Desktop, Cursor ja teiste MCP-ga ühilduvate tööriistadega.
Mis on MCP?
Model Context Protocol on avatud standard, mis võimaldab AI-assistentidel suhelda välist teenuste ja andmeallikatega. ChatReacti MCP-integratsiooni abil saate:
- Haldada vestlusroboteid — luua, konfigureerida (persona, keeled, vidin, käitumine, piirangud), manustada ja kustutada vestlusroboteid
- Ehita teadmistebaasi — lisada dokumente, indekseerida veebisaite, hallata indekseeritud lehti ja põhijuhiseid
- Haldada korduma kippuvaid küsimusi (FAQ) — FAQd, kategooriad, ettepanekud, tõlked ja FAQ-vidin
- Ülevaadata vestlusi — hinnata vestlusi, määrata usaldusastmeid, käivitada Improvement Agenti
- Töötada liideste ja vormidega — liidid, liidi kategooriad, andmete kogumise seaded, kontaktivormid ja esildised
- Tegutseda reaalajas vestlusagendina — seadistada oma kättesaadavust, võtta üle ootel vestlusi, vastata ja sulgeda sessioone
- Administreerida ettevõtet — profiil, brändivärvid, meeskonnaliikmed ja kutseid
- Kasutada Email Assistantit — postkastide ühendused, kategooriad, kontaktid ja tegevused
- Lugeda analüütikat ja teateid
Kõik, mida saab teha juhtpaneelil, on saadaval ka MCP kaudu (ja REST API); ainult brauseriga seotud toimingud nagu maksed, postkasti OAuth, passkey'd, konto kustutamine ja API-võtmete haldus jäävad juhtpaneelile.
Alustamine
1. Genereerige API-võti
- Minge oma Töölauavaade → Ettevõte → API vahekaardile
- Klõpsake Loo API-võti
- Andke oma võtmele kirjeldav nimi (nt "Claude Desktop") ja valige vähemalt üks õigus
- Kopeerige genereeritud võti (algab
cr_)
API-võtmed on saadaval tasulistel plaanidel — vaadake meie Pricing page.
Hoidke oma API-võti turvaliselt. Seda ei saa pärast loomist taastada.
2. Konfigureerige oma MCP klient
ChatReact MCP-server töötab aadressil https://www.chatreact.ai/api/mcp ja suhtleb HTTP (JSON-RPC) kaudu. Autentimiseks kasutage Authorization: Bearer päist — samuti aktsepteeritakse X-API-Key päist sama võtmega.
Cursor IDE
Cursor toetab kaug-MCP servereid otse. Lisage oma Cursor MCP seadistustesse:
{
"mcpServers": {
"chatreact": {
"url": "https://www.chatreact.ai/api/mcp",
"headers": {
"Authorization": "Bearer cr_your_api_key_here"
}
}
}
}
Claude Desktop
Claude Desktopi konfiguratsioonifail toetab käsupõhiseid servereid, seega kasutage standardset mcp-remote silda, et ühendada hostitud lõpp-punktiga:
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"
]
}
}
}
Selleks vajate Node.js paigaldust. Näites kasutatakse X-API-Key päist, kuna mõned kliendid ei käsitle argumentides olevaid tühikuid usaldusväärselt.
3. Taaskäivitage oma AI-assistent
Pärast konfiguratsiooni salvestamist taaskäivitage Claude Desktop või Cursor, et ühendus üles ehitada.
Saadaval olevad tööriistad
ChatReact MCP eksponeerib allolevaid tööriistu, rühmitatuna valdkondade järgi. Veerg Scope näitab API-võtme õigust, mida tööriist nõuab (any = iga kehtiv võti). Tööriistad töötavad samade kohaldatavate õigustega, plaani piirangute ja kõrvalmõjudega nagu juhtpaneeli toimingud. Brauseriga seotud makse-, postkasti autoriseerimise-, passkey-, konto-kustutamise- ja võtmehalduse töövood jäävad juhtpaneelile.
Destruktiivsed tööriistad (kustuta, lähtesta, sulge, liida) küsivad Dashboard Assistanti kaudu kasutamisel kinnitust. API-võtme kaudu täidetakse need viivitamatult.
Account
| Tool | Description | Scope |
|---|---|---|
account_usage_get | Hangi praegune plaan (tier, staatus), jooksva arvelduse perioodi kasutuskontorid (ettevõtted, vestlusrobotid, meeskonnaliikmed, vestlused, tokenid) ja plaani piirid, ning ettevõtte efektiivsed piirid ja funktsioonilipud, millele kõne on suunatud. | any |
user_companies | Loetle kõik ettevõtted, millele praegusel kasutajal on juurdepääs, koos kasutaja rolliga igaühes. | any |
user_notification_mark_read | Märgi üks praeguse kasutaja teadetest loetuks. | any |
user_notification_preferences_get | Hangi praeguse kasutaja teavituse eelistused: globaalne e-posti/push lülitus, kokkuvõtte sagedus/aeg/nädalapäev/aegzöönd, vaikne aeg ja tüübi kaupa kanaliseaded. | any |
user_notification_preferences_update | Uuenda praeguse kasutaja globaalseid teavituse eelistusi (e-posti/push lülitused, kokkuvõtte ajakava, vaikne aeg). | any |
user_notification_type_setting_update | Luba või keela e-posti / rakendusesisene kohaletoimetamine ühe teat tüübi jaoks praegusel kasutajal (nt | any |
user_notification_types_list | Loetle kõik teavituse tüübid rühmitatuna kategooria järgi (chatbot, leads, live chat, knowledge, team, billing). | any |
user_notification_unread_count | Hangi praeguse kasutaja lugemata teadete arv. | any |
user_notifications | Loetle praeguse kasutaja teated, uusimad ees, kursori pagineerimisega. | any |
user_notifications_delete_old | Hooldus: kustuta jäädavalt praeguse kasutaja juba loetud ja üle 30 päeva vanad teated. | any |
user_notifications_mark_all_read | Märgi kõik praeguse kasutaja teated loetuks. | any |
user_profile | Hangi praeguse kasutaja profiil (id, nimi, e-post, roll, tellimuse tase). | any |
Company & Team
| Tool | Description | Scope |
|---|---|---|
company_chatbots_list | Loetle kõik konkreetse ettevõtte vestlusrobotid koos kokkuvõttstatistikaga. | chatbots:read |
company_get | Hangi ettevõtte üksikasjad: profiil, omanik, brändi seaded (värvid, teavituse e-post) ja arvud. | any |
company_invite_cancel | Tühista (kustuta) meeskonnakutse, nii et link enam ei tööta. | company:write |
company_invite_resend | Saada ootel meeskonnakutse uuesti: väljastab uue tokeni, pikendab kehtivusaega 7 päeva võrra ja saadab kutsemeili uuesti. | company:write |
company_invites_list | Loetle ettevõtte meeskonna kutseid (vaikimisi ootel; includeExpired seadistades tagastatakse ka aegunud kutseid). | company:read |
company_list | Loetle kõik ettevõtted, millele kasutajal on juurdepääs (API-võtmed ja Dashboard Assistant näevad ainult oma ettevõtet). | any |
company_logo_remove | Eemalda ettevõtte logo (kustutab salvestatud pildi ja tühjendab logo URL-i). | company:write |
company_member_invite | Kutsu meeskonnaliige e-posti aadressi alusel rolliga (ADMIN, MANAGER, AGENT või VIEWER). | company:write |
company_member_remove | Eemalda meeskonnaliige ettevõttest. | company:write |
company_member_update_role | Muuda meeskonnaliikme rolli (ADMIN, MANAGER, AGENT või VIEWER). | company:write |
company_members_list | Loetle ettevõtte liikmed koos nende rollidega (OWNER, ADMIN, MANAGER, AGENT, VIEWER). | any |
company_settings_update | Uuenda ettevõtte brändi seadeid: primaryColor / secondaryColor (#RRGGBB) ja notificationEmail vestlusülevaatuste jaoks. | company:write |
company_update | Uuenda ettevõtte profiili: nimi (2-100 tähemärki), kirjeldus (kuni 1000 tähemärki) või veebisait (https:// lisatakse automaatselt; tühja stringi edastamine tühjendab veebisaidi/kirjelduse). | company:write |
Chatbot Management
| Tool | Description | Scope |
|---|---|---|
chatbot_add_instruction | Lisa vestlusrobotile uus põhijuhis (1-5000 tähemärki). | chatbots:write |
chatbot_confirm_embed | Märgi vestlusrobot manustatuks veebilehel (peidab juhtpaneelil seadistuse meeldetuletuse). | chatbots:write |
chatbot_create | Loo uus vestlusrobot (sama mis juhtpaneeli viisard). | chatbots:write |
chatbot_delete | Kustuta vestlusrobot jäädavalt koos kõigi FAQde, dokumentide, vestluste, liidide ja vormidega (ei saa tagasi võtta). | chatbots:write |
chatbot_delete_instruction | Kustuta vestlusroboti põhijuhis. | chatbots:write |
chatbot_get | Hangi vestlusroboti detailne info: üldseaded, isiksus (persona, tonaalsus, keeled, piirangud), vidina seaded, reaalajas vestlus, õppimisfaas, manustamise staatus ja arvud. | chatbots:read |
chatbot_get_embed_code | Hangi HTML-koodilõik vestlusroboti paigaldamiseks veebilehele (skripti URL + <script> silt) ja kas manustamine on kinnitatud. | chatbots:read |
chatbot_get_instructions | Hangi kõik vestlusroboti põhijuhised. | chatbots:read |
chatbot_improve_instructions | Kirjuta põhijuhise tekst ümber platvormi AI-ärendajaga (sama mis juhtpaneeli 'Improve with AI'). | chatbots:write |
chatbot_learning_phase_get | Hangi vestlusroboti õppimisfaasi seaded: käitumispreset (CAUTIOUS, BALANCED, CONFIDENT), kohandatud prompt ja kas robot on endiselt õppimisfaasis. | chatbots:read |
chatbot_learning_phase_update | Määra õppimisfaasi käitumispreset (CAUTIOUS = suunab inimesele ebakindlal juhul, BALANCED, CONFIDENT) ja/või kohandatud õppimisfaasi prompt. | chatbots:write |
chatbot_list | Loetle kõik vestlusrobotid, millele kasutajal on juurdepääs, kokkuvõttstatistikaga. | chatbots:read |
chatbot_reorder_instructions | Määra vestlusroboti põhijuhiste järjestus. | chatbots:write |
chatbot_templates_list | Loetle vestlusroboti mallid (persona, tonaalsus, sõnumid ja vidina käitumise presets), mida saab edastada kui templateId chatbot_create'ile, ja kas ettevõtte plaan võib neid kasutada. | chatbots:read |
chatbot_toggle_active | Aktiveeri või deaktiveeri vestlusrobot. | chatbots:write |
chatbot_toggle_learning | Lõpeta (false) või taaskäivita (true) vestlusroboti õppimisfaas. | chatbots:write |
chatbot_update | Uuenda vestlusroboti üldseadeid: nimi, kirjeldus, isActive, reaalajas vestlus (liveChatEnabled/liveChatMode, plaani funktsioon), showBranding (white-label plaanid), chat-review e-kirjad, FAQ automaatgeneratsioon, pärand põhijuhiste tekst, õppimisfaas (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt). | chatbots:write |
chatbot_update_instruction | Uuenda olemasolevat põhijuhist (sisu, isActive, kanal, sortOrder). | chatbots:write |
chatbot_update_personality | Uuenda vestlusroboti isiksust: persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), tonaalsuse liugurid 1-5, keeled (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), sõnumid (welcomeMessage, fallbackMessage, proactive greeting) ja piirangud (blacklistTopics, complianceRules, maxResponseLength, human handoff). | chatbots:write |
widget_settings_get | Hangi vestlusroboti praegused vidina seaded (kõik välimus, bränding, käitumine ja eelneva vestluse vormiväljad). | chatbots:read |
widget_settings_update | Uuenda vestlusroboti chat-vidinat: positsioon (sh. | chatbots:write |
widget_translations_get | Hangi vestlusroboti keelepõhised vidina tõlked: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }. | chatbots:read |
widget_translations_update | Määra keelepõhised vidina tõlked. | chatbots:write |
Knowledge Base
| Tool | Description | Scope |
|---|---|---|
crawler_job_cancel | Tühista PENDING või RUNNING indekseerimisülesanne; ülejäänud lehed jäetakse vahele. | knowledge:write |
crawler_job_get | Hangi indekseerimisülesande staatus, edenemine (pagesCrawled/pagesFound, tokensUsed) ja iga lehe staatus. | knowledge:read |
crawler_jobs_list | Loetle vestlusroboti indekseerimisülesanded (uusimad ees) koos staatus ja edenemisega. | knowledge:read |
crawler_limits | Hangi plaani indekseerimispiirangud vestlusroboti kohta (maksimaalne lehtede arv per crawl, tokenid per leht, crawleid kuus) ja kas uue indekseerimise alustamine on sellel kuul lubatud. | knowledge:read |
crawler_preview_scan | Skaneeri veebisait ja loetle indekseeritavad lehed (url, pealkiri, isRecommended) ilma midagi importimata. | knowledge:write |
crawler_start | Alusta indekseerimisülesannet, mis impordib valitud URL-id vestlusroboti teadmistebaasi (taustal töödeldakse; pärige crawler_job_get). | knowledge:write |
knowledge_document_add_from_url | Laadige dokument (PDF, TXT, MD, CSV, JSON, DOCX; max 10 MB) avalikust http(s) URL-ist alla ja lisage see vestlusroboti teadmistebaasi. | knowledge:write |
knowledge_document_add_text | Lisa tekst või markdown dokument vestlusroboti teadmistebaasi sisendina (max 10 MB). | knowledge:write |
knowledge_document_delete | Kustuta üleslaaditud dokument teadmistebaasist. | knowledge:write |
knowledge_document_get | Hangi üleslaaditud dokumendi üksikasjad, sh töötlemise staatus, veateade ja lühiajaline allalaadimis-URL. | knowledge:read |
knowledge_documents_list | Loetle üleslaaditud dokumendid (PDF, TXT, MD, CSV, JSON, DOCX) vestlusroboti teadmistebaasis koos staatuse ja suurusega. | knowledge:read |
knowledge_page_add | Indekseeri üksik URL ja lisa see vestlusroboti teadmistebaasi (ebaõnnestub CONFLICT-iga, kui URL on juba indekseeritud, FORBIDDEN, kui tokenite limiit on ületatud). | knowledge:write |
knowledge_page_delete | Kustuta indekseeritud leht teadmistebaasist (eemaldab selle vektorpoe faili). | knowledge:write |
knowledge_page_get | Hangi indekseeritud leht koos indekseeritud markdown-sisuga just selle vestlusroboti jaoks (kasulik veendumaks, mida robot lehe kohta teab). | knowledge:read |
knowledge_page_recrawl | Hangi indekseeritud leht uuesti ja asenda selle indekseeritud sisu (nt | knowledge:write |
knowledge_pages_delete | Kustuta korraga mitmeid vestlusroboti indekseeritud lehti. | knowledge:write |
knowledge_pages_list | Loetle indekseeritud lehed vestlusroboti teadmistebaasis, valikuliselt filtreerituna domeeni, staatusi või otsinguterminiga (URL/pealkiri). | knowledge:read |
knowledge_stats | Ülevaade vestlusroboti teadmistebaasist: dokumendid (staatuse ja suuruse järgi), indekseeritud lehed ja veebisaidid (staatuse järgi), indekseerimisülesanded, põhijuhised allika järgi (manuaalne vs improvement agent), FAQd, vektorpoe staatus/suurus ja salvestuse kasutus vs. | knowledge:read |
knowledge_website_delete | Kustuta iga veebisaidi (domeeni) indekseeritud leht vestlusroboti teadmistebaasist. | knowledge:write |
knowledge_website_recrawl | Indekseeri uuesti kõik veebisaidi (domeeni) lehed vestlusroboti teadmistebaasis, et värskendada sisu. | knowledge:write |
knowledge_website_recrawl_cancel | Tühista pooleli olev veebisaidi uuestiindekseerimine: järjekorras olevad (PENDING) domeeni lehed taastatakse nende varasemasse indekseeritud olekusse. | knowledge:write |
knowledge_websites_list | Loetle veebisaidid (domeenid), mille lehed on vestlusroboti teadmistebaasis, koos lehtede arvudega staatuse kaupa ja tokenite summadega. | knowledge:read |
Price Management
Need tööriistad haldavad struktureeritud hinnakujunduse mustandeid ja selgesõnalisi heakskiite. Mustandi salvestamine on eraldi heakskiitmisest; sobivus sõltub ka staatusest ja kehtivusest. Olemasolevad API-võtmed ei saa hinnahaldusõigusi automaatselt. Ainult ettevõtte omanik saab anda prices:write või prices:approve. API-võtme kõned täidetakse koheselt, seega vaadake mutatsiooni täpset sisendit enne kutsumist. Vaadake klienditöövoo kohta Prices & services.
| Tool | Description | Scope |
|---|---|---|
price_list | Keri hinnapeade läbi ja eraldi heakskiidetud versiooni sobivuse vaatamine. | prices:read |
price_get | Loe üksuse täielikku olekut ja revisioneid. | prices:read |
price_detail | Loe üksuse detaili koos leheküljepagineeritud revisioni ajalooga. | prices:read |
price_suggestions_list | Keri hinnasoovitusi. | prices:read |
price_create | Loo mustand serveri genereeritud üksuse ID-ga. | prices:write |
price_edit | Loo uus mustand eeldatud üksuse versioonist. | prices:write |
price_import_csv | Impordi mustandeid selgesõnalise formaadi ja stabiilse import ID-ga korduste jaoks. | prices:write |
price_suggestion_apply | Rakenda valitud soovituse kandidaat mustandina. | prices:write |
price_approve | Kiitke heaks üks selgesõnaline eeldatud üksuse versioon. | prices:approve |
price_approve_many | Kiitke heaks selgesõnaline ID/versiooni valik atomaarse toiminguna; ükski aegunud versioon ei aktsepteeri kogu valikut. | prices:approve |
price_archive | Arhiveeri üksus selle selgesõnalises eeldatud versioonis. | prices:approve |
Mustandi redigeerimised säilitavad eelmise heakskiidetud revisioni. CSV-formaat ja kümnendiku eraldaja peavad olema selgesõnaliselt määratud; muudetud CSV-sisu nõuab uut import ID-d. Kõik toimingud on seotud API-võtme ettevõtte ja määratud vestlusrobotiga.
FAQ Management
| Tool | Description | Scope |
|---|---|---|
faq_cache_purge | Tühjenda vahemällu salvestatud FAQ-vidina andmed kõigil ühendatud CMS saitidel (WordPress plugin). | faqs:write |
faq_categories_list | Loetle vestlusroboti FAQ-kategooriad koos nende FAQ-arvuga, slugide, sortimismeetodi ja tõlgetega. | faqs:read |
faq_categories_reorder | Määra FAQ-kategooriate järjekord vidinas: kategooriaIds positsioon muutub sortOrder-iks. | faqs:write |
faq_category_create | Loo vestlusroboti jaoks FAQ-kategooria (slug genereeritakse nimest). | faqs:write |
faq_category_delete | Kustuta FAQ-kategooria. | faqs:write |
faq_category_translations_update | Asenda FAQ-kategooria tõlked, nt | faqs:write |
faq_category_update | Nimeta FAQ-kategooria ümber või muuda selle kirjeldust, ikooni või sortimisviisi. | faqs:write |
faq_create | Loo FAQ vestlusroboti jaoks. | faqs:write |
faq_delete | Kustuta FAQ jäädavalt (eemaldab ka vestlusroboti teadmistebaasist ja puhastab CMS vidina vahemälud). | faqs:write |
faq_embed_code_get | Hangi FAQ-vidina manustuse koodilõigud: skriptitükk, WordPress shortcode ja Shopify Liquid snippet, koos per-kategooria variantidega (kasutage categorySlug'i faq_categories_list'ist, et manustada ainult ühte kategooriat). | chatbots:read |
faq_get | Hangi FAQ täielikud üksikasjad: küsimus, vastus, kategooria, avaldamise staatus, sortOrder, tõlked, SEO-väljad ja tagasiside statistika. | faqs:read |
faq_list | Loetle vestlusroboti FAQd (kasutage chatbot_list, et leida chatbotId). | faqs:read |
faq_reorder | Määra FAQ-de kuvamise järjekord vidinas. | faqs:write |
faq_suggestion_approve | Kinnita PENDING FAQ-ettepanek: loob avaldatud FAQ-i (valikuliselt muudetud küsimuse/vastuse/kategooriaga) ja märgib ettepaneku APPROVED. | faqs:write |
faq_suggestion_get | Hangi FAQ-ettepaneku täielikud üksikasjad (täielik vastus, AI selgitus, soovitatud kategooria, ülevaatuse staatus). | faqs:read |
faq_suggestion_reject | Keeldu PENDING FAQ-ettepanekust valikulise põhjusega. | faqs:write |
faq_suggestions_generate | Las AI pakub uusi FAQ-sid vestlusroboti teadmistebaasist (indekseeritud lehed / üleslaaditud dokumendid), valikuliselt ühe kategooria jaoks. | faqs:write |
faq_suggestions_list | Loetle AI-ga genereeritud FAQ-ettepanekud vestlusroboti jaoks (vestlustest või faq_suggestions_generate'ist). | faqs:read |
faq_translate | Tõlgi FAQ küsimus ja vastus AI abil vestlusroboti teistesse toetatud keeltesse (või antud targetLanguages) ja salvesta tulemus. | faqs:write |
faq_translations_update | Salvesta FAQ tõlked keele kaupa, nt | faqs:write |
faq_update | Uuenda FAQ küsimust, vastust, kategooriat, avaldamise staatus või manuaalset sortOrderit. | faqs:write |
faq_widget_settings_get | Hangi manustatava FAQ-vidina välimuse ja käitumise seaded (värvid, serva raadius, pealkiri, ruumistus, max width, allowMultipleOpen, autoOpenFirst, sort mode, pealkirja tõlked). | chatbots:read |
faq_widget_settings_update | Uuenda FAQ-vidina seadeid: värvid (hex), borderRadius 0-32, title (max 100) + showTitle, spacing compact|normal|relaxed, maxWidth 0-2000 (0 = täislaius), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name ja pealkirja tõlked keele kaupa. | chatbots:write |
Chat History & Feedback
| Tool | Description | Scope |
|---|---|---|
chat_feedback_dismiss | Märgi vestlus ülevaatatud ilma hindeta (eemaldab selle ootejärjekorrast, ei muuda usalduskoefitsienti). | chats:write |
chat_feedback_get | Hangi üks vestluse ülevaatus (tagasiside) AI-analüüsiga, raskusaste, usalduskategooria, skoori muutus ja seotud parandussessioon. | chats:read |
chat_feedback_list | Loetle vestlusülevaatused (tagasiside read) vestlusroboti kohta koos staatusfiltri ja arvudega. | chats:read |
chat_feedback_set_severity | Tühista ülevaatuse negatiivse vestluse raskusastme klassifikatsioon (MINOR|MODERATE|MAJOR|CRITICAL); raskusaste mõjutab usaldusskoori langust. | chats:write |
chat_feedback_stats | Sessioonide arvud ülevaatuskorvi kohta vestlusroboti jaoks (kokku, none, pending, positive, negative, reviewed, improved) — juhtpaneeli vestluste lehe statistika kaardid. | chats:read |
chat_feedback_submit | Hinda vestlussessiooni kui Good (isPositive=true) või Needs Work (isPositive=false). | chats:write |
chat_session_get | Hangi vestlussessioon koos täieliku transkriptsiooniga (sõnumi kohta token/model/latentsus/pageUrl), külastaja andmed, alustamise lehe URL, usalduskategooria, tagasiside (raskusaste, AI-analüüs, seotud parandussessioon) ja sildid. | chats:read |
chat_session_search | Otsi vestlussessioone vestlusroboti kohta sõnumi sisu ja/või külastaja e-posti alusel. | chats:read |
chat_session_set_category | Määra või muuda vestlussessiooni usalduskategooriat (korrigeerib AI kategoriseerimist; per-kategooria usaldus arvutatakse uuesti, kui vestlus on üle vaadatud). | chats:write |
chat_sessions_list | Loetle vestlussessioone vestlusroboti kohta, uusimad ees, samade ülevaatusjärjekorra filtritega nagu juhtpaneeli vestluste lehel. | chats:read |
Improvement Agent
| Tool | Description | Scope |
|---|---|---|
confidence_categories_list | Loetle vestlusroboti usalduskategooriad koos per-kategooria usaldusskoori, ülevaatuste arvu ja ülevaatuse e-posti sagedusega. | chats:read |
confidence_category_create | Loo vestlusroboti jaoks usalduskategooria. | chatbots:write |
confidence_category_delete | Kustuta usalduskategooria. | chatbots:write |
confidence_category_merge | Liida üks usalduskategooria teisega samas vestlusrobotis: kõik vestlused/ülevaatused liiguvad sihtkohta, allikas kustutatakse ja skoorid arvutatakse uuesti. | chatbots:write |
confidence_category_update | Nimeta usalduskategooria ümber ja/või määra selle ülevaatuse e-posti sagedus (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1-24 kehtib ainult HOURLY puhul). | chatbots:write |
confidence_status_get | Vestlusroboti usalduse staatus: skoor, lõpetamise lävi, õppimisfaasi lipp, õppimisfaasi käitumine (CAUTIOUS|BALANCED|CONFIDENT) ja kohandatud prompt, ülevaatuste arvud ning per-kategooria usaldusskoorid. | analytics:read |
improvement_proposal_approve | Kinnita PENDING paranduse ettepanek ja rakenda muudatus vestlusrobotile (põhijuhis lisa/uuendus, FAQ loo/uuenda või persona uuendus) — sama loogika ja plaani piirid nagu juhtpaneelil. | chatbots:write |
improvement_proposal_reject | Keeldu PENDING paranduse ettepanekust. | chatbots:write |
improvement_proposal_simulate | Simuleeri, kuidas robot vastaks probleemsele sõnumile koos ettepaneku rakendamisega (algne vs. | chatbots:write |
improvement_proposals_pending | Loetle paranduse ettepanekud, mis ootavad ülevaatust (staatus PENDING) kogu ettevõttes või ühele vestlusrobotile. | chatbots:read |
improvement_session_complete | Märgi parandussessioon COMPLETED-iks (siis loetakse vestlus ülevaatusjärjekorras Improved'iks). | chatbots:write |
improvement_session_create | Ava Improvement Agent vestluse jaoks, mis on hinnatud Needs Work. | chatbots:write |
improvement_session_get | Hangi parandussessioon koos algse vestlusega (sõnumitel on 1-baasiline indeks, mida saab kasutada targetMessageIndex'ina), agendi vestlus, kõik ettepanekud (nende viimaste simulatsioonidega) ja simulatsioonid. | chatbots:read |
improvement_session_reset | Taaskäivita parandussessioon: kustutab kõik agendi sõnumid, simulatsioonid ja PENDING/REJECTED ettepanekud (rakendatud jäävad alles) ja alustab uut vestlust. | chatbots:write |
improvement_session_send_message | Saada sõnum Improvement Agentile (kirjelda, mis robotivastuses valesti oli; valikuliselt targetMessageIndex = boti sõnumi 1-baasiline indeks originalChat.messages'is). | chatbots:write |
improvement_sessions_list | Loetle parandussessioonid (Improvement Agent vestlused, mis algasid negatiivsetest vestluse ülevaatustest) vestlusroboti või kogu ettevõtte kohta, uusimad ees, koos ettepanekute arvuga. | chatbots:read |
improvement_simulation_assess | Hinda simulatsiooni tulemus: isApproved=true kui simuleeritud vastus on hea (ettepanekut saab seejärel rakendada), false kui vajab parandamist (kommentaar 'almost' = peaaegu õige). | chatbots:write |
Live Chat
| Tool | Description | Scope |
|---|---|---|
live_chat_agents_available | Hangi praeguse kasutaja reaalajas vestluse kättesaadavus, hetkel saadaval olevad agendid reaalajas (värske heartbeat, sama signaal, mida vidin kasutab) ja kas ettevõtte plaan sisaldab reaalajas vestlust. | chats:read |
live_chat_heartbeat | Värskenda praeguse kasutaja reaalajas vestluse presence heartbeat'i (ainult kui märgitud saadaval live_chat_set_availability abil). | chats:write |
live_chat_message_send | Saada külastajale sõnum määratud agendina. | chats:write |
live_chat_queue | Hangi reaalajas vestluse järjekord: sessioonid, mis ootavad agenti, vanimad ees (FIFO). | chats:read |
live_chat_session_assign | Võtke ootel olev WAITING reaalajas vestlussessioon järjekorrast: määrab selle praegusele kasutajale (API-võtmete puhul ettevõtte omanik) ja teavitab külastajat, et agent liitus. | chats:write |
live_chat_session_close | Lõpeta reaalajas vestlussessioon agendina (iga mitte-VIEWER ettevõtte liige). | chats:write |
live_chat_session_get | Hangi reaalajas vestlussessioon külastaja info, määratud agenti, kõikide sõnumite ja eelmise boti vestluse (handoff context) koosseisus. | chats:read |
live_chat_sessions_list | Loetle reaalajas vestlussessioone (uusimad ees; WAITING sessioonid vanimad ees) koos valikuliste filtritega chatbot, staatus ja määratud agenti järgi. | chats:read |
live_chat_set_availability | Lülita praeguse kasutaja "Available for Live Chat" lüliti ettevõtte jaoks. | chats:write |
Leads
| Tool | Description | Scope |
|---|---|---|
lead_assign | Määra liid ettevõtte liikmele või eemalda määramine (assignedToId: null). | leads:write |
lead_bulk_update_status | Määra mitme liidi staatus korraga (maksimaalselt 100). | leads:write |
lead_categories_list | Loetle vestlusroboti liidide kategooriad liidide arvuga ja meeskonnaliikmetega, keda iga kategooria teavitab. | leads:read |
lead_category_assign_user | Lisa ettevõtte liige liidi kategooria teavituste nimekirja (või uuenda nende teavituse lippe). | leads:write |
lead_category_create | Loo vestlusroboti jaoks liidi kategooria. | leads:write |
lead_category_delete | Kustuta liidi kategooria. | leads:write |
lead_category_remove_user | Eemalda ettevõtte liige liidi kategooria teavituste nimekirjast. | leads:write |
lead_category_update | Uuenda liidi kategooria nime, kirjeldust ja/või värvi. | leads:write |
lead_create | Loo liid käsitsi (nt | leads:write |
lead_delete | Kustuta liid jäädavalt. | leads:write |
lead_field_config_get | Hangi vestlusroboti liidi kogumise konfiguratsioon: väljad (ids vastavad võtmetele lead.data-s), kinnitussõnum, välja/UI tõlked ja AI tunnustamise seaded. | leads:read |
lead_field_config_update | Uuenda vestlusroboti liidi kogumise konfiguratsiooni. | leads:write |
lead_get | Hangi liidi täielikud üksikasjad, sh vastutaja, kategooria ja algse vestluse transkriptsioon (pagineeritud messageOffset/messageLimit abil, vaikimisi esimesed 20 sõnumit). | leads:read |
lead_list | Loetle vestlusroboti liidid (uusimad ees) koos valikuliste filtritega staatus, kategooria, vastutaja ja vabas tekstis otsingu (nimi/e-post/ettevõte). | leads:read |
lead_stats | Hangi liidi statistika vestlusroboti jaoks: arvud staatusi lõikes, viimase 7 päeva liidid ja konversioonimäär (protsent). | leads:read |
lead_update | Uuenda liidi staatus, kategooria, märkmed, kogutud andmed ja/või vastutaja. | leads:write |
Forms
| Tool | Description | Scope |
|---|---|---|
form_create | Loo vestlusroboti jaoks kontaktivorm (põhiseaded, väljad, disain ja rämpsseaded ühes kõnes). | forms:write |
form_delete | Kustuta kontaktivorm ja KÕIK selle esildised jäädavalt (kaskaad). | forms:write |
form_get | Hangi kontaktivorm täielikult: väljad, tõlked, stiil, rämpsseaded, aktiivseis, esildiste arv ja manustamise skript (embedCode). | forms:read |
form_list | Loetle vestlusroboti kontaktivormid väljade arvuga, esildiste arvuga ja manustuskoodidega. | forms:read |
form_stats | Kontaktivormi esildiste arvud: kokku, pending, approved, spam ja rejected. | forms:read |
form_submission_delete | Kustuta kontaktivormi esildis jäädavalt (nt | forms:write |
form_submission_get | Hangi kontaktivormi esildis täielikult: esitatud väljade andmed, spam-skoor ja AI spam-analüüs, IP/user agent/viitaja metaandmed ja ülevaatusinfo. | forms:read |
form_submission_update_status | Ülevaata kontaktivormi esildis: määra selle staatus APPROVED, SPAM või REJECTED koos valikulise ülevaatusmärkusega. | forms:write |
form_submissions_list | Loetle kontaktivormi esildised, uusimad ees, valikuliselt filtreeritud staatus (PENDING, APPROVED, SPAM, REJECTED) ja loomise kuupäeva järgi. | forms:read |
form_update | Uuenda kontaktivormi: nimi, kirjeldus, aktiivne seis (isActive kontrollib, kas manustus joonistub), väljad (täielik asendus), disain (värvid, nupu tekst, edukuse sõnum) ja rämpsseaded (spamThreshold, autoRejectSpam, notificationEmail). | forms:write |
form_update_translations | Asenda välja ja/või UI tõlked kontaktivormil. | forms:write |
Email Assistant
| Tool | Description | Scope |
|---|---|---|
email_activity_list | Loetle postkasti ühenduse töödeldud e-kirjade tegevuslogi (uusimad ees): saatja, teema, määratud kategooria, tulemus (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) ja outcomeDetail. | email:read |
email_categories_list | Loetle postkasti ühenduse e-posti kategooriad (järjestatud sortOrder järgi). | email:read |
email_category_create | Loo postkasti ühenduse jaoks e-posti kategooria (maksimaalselt 20 ühenduse kohta). | email:write |
email_category_delete | Kustuta e-posti kategooria. | email:write |
email_category_update | Uuenda e-posti kategooriat (osaline: ainult antud väljad muutuvad). | email:write |
email_connection_disconnect | Katkesta postkasti ühendus jäädavalt. | email:write |
email_connection_get | Hangi postkasti ühendus koos, sh. | email:read |
email_connection_update | Uuenda postkasti ühendust: paus/taasita sünkroonimine (paused true/false; ainult lülitab ACTIVE<->DISABLED, ei üle kirjuta TOKEN_EXPIRED/ERROR), lülita vastuse mustandi koostamine (draftingEnabled) ja kategoriseerimine/korraldamine (organizingEnabled), suuna toitlev vestlusrobot (chatbotId samast ettevõttest) või määra HTML vastuse allkiri (signatureHtml, max 20000 tähemärki; tühi string tühjab selle). | email:write |
email_connections_list | Loetle ettevõtte Email Assistant postkasti ühendused (aadress, staatus ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, viimane sünkroonimine, viimane viga, drafting/organizing lülitused, toitlev vestlusrobot, draftReadyCategoryCount = kategooriad, mis võivad luua mustandeid, baseRuleCount = chatbot-laia 'Chat + Email' reeglid, mis rakenduvad kõigile mustanditele) koos plaani piirangutega (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth). | email:read |
email_contact_delete | Kustuta õpitud e-posti kontakt (unusta saatja profiil, nt | email:write |
email_contact_get | Hangi õpitud e-posti kontakt koos kõigi õpitud faktide, sisemiste märkmete, suhte, formaalse/mitteformaalse pöördumise seade ja e-posti statistikaga. | email:read |
email_contact_update | Uuenda õpitud e-posti kontakti. | email:write |
email_contacts_list | Loetle ettevõtte õpitud e-posti kontaktid (hiljutise e-kirja järgi järjestatud) suhte, formaalse/mitteformaalse pöördumise (formalAddress: true = formaalne 'Sie', false = mitteametlik 'Du', null = automaatne), faktide arvu ja märkmete eelvaatega. | email:read |
email_folder_create | Loo postikasti all oleva sissetuleku kausta alla kaust (tagastab olemasoleva, kui nimi on juba kasutusel), mida kasutada kategooria liigutuse sihtkohana. | email:write |
email_folders_list | Loetle kaustad, kuhu e-posti kategooria saab kirju liigutada, otse postkastist: inbox alamkaustad, kohandatud ülemised kaustad, arhiiv, rämps ja prügikast (id 'deleteditems'). | email:read |
email_general_rules_list | Loetle chatbot-laia reeglid, mis kehtivad iga postkasti vastuse mustandi kohta: aktiivsed põhijuhised kanaliga BOTH ("Chat + Email"), pluss pärand e-posti-spetsiifilised, mida pole veel kategooriasse migreeritud. | email:read |
Analytics
| Tool | Description | Scope |
|---|---|---|
analytics_chat_volume | Vestluste maht (algatatud sessioonid) aja jooksul diagrammide ja trendide jaoks: periood week/month/quarter/year, granulaarsus hour/day/week/month, valikuliselt ühe vestlusroboti kohta. | analytics:read |
analytics_chatbot_stats | Ettevõtte per-vestlusroboti tulemuslikkus ühes kõnes (juhtpaneeli vestlusrobotide tulemuslikkuse tabel): id, nimi, slug, isActive, sessioonid, sõnumid, FAQd ja liidid per vestlusrobot, järjestatud sessioonide järgi. | analytics:read |
analytics_forms | Kontaktivormi esildiste statistika ettevõtte või ühe vestlusroboti kohta (juhtpaneeli analüütika vidin): esildised staatusi lõikes (pending/approved/rejected/spam), vormide arv, kokku, rämpsprotsent ja viimase 7 päeva esildiste-per-päev seeria. | analytics:read |
analytics_leads | Liidi lehter ettevõtte või ühe vestlusroboti kohta (juhtpaneeli analüütika vidin): liidid staatusi lõikes (new/contacted/qualified/converted/lost), kokku, konversioonimäär protsentides ja viimase 7 päeva liidid-per-päev seeria. | analytics:read |
analytics_overview | Analüütika ülevaade ettevõtte või ühe vestlusroboti kohta: vestlused, sõnumid, rahulolumäär ja top küsimused valitaval perioodil (day/week/month/year), pluss juhtpaneeli ülevaade vidin (kokku vestlusrobotid/publikuleitud FAQd/liidid, sessioonid täna/selles nädalas/selles kuus, liidid täna/selles nädalas, vormi esildised kokku/täna/pending). | analytics:read |
dashboard_activity | Mis vajab praegu tähelepanu (juhtpaneeli avaleht): per ettevõte, vestlusrobotid, millel on täna uued liidid, pending FAQ ettepanekud, pending vormi esildised, ootel/aktiivsed reaalajas vestlused või käimasolev õppimisfaas. | any |
Näidistöödvood
Põhijuhise lisamine
Küsige oma AI-assistendilt:
"Lisa põhijuhis minu 'Support Bot' vestlusrobotile: me pakume tasuta kohaletoimetamist tellimustele üle 50 €"
Assistent kasutab chatbot_add_instruction sobivate parameetritega.
Paranduse ettepanekute ülevaatamine
"Näita mulle kõiki ootel paranduse ettepanekuid minu vestlusrobotile ja selgita, milliseid muudatusi need soovitavad"
Assistent:
- Kasutab
improvement_proposals_pendingettepanekute toomiseks - Analüüsib ja kokkuvõtlikult esitab iga ettepaneku
- Kinnitab või lükkab need Teie nimel tagasi
improvement_proposal_approvevõiimprovement_proposal_rejectabil
Vestluse tulemuslikkuse analüüs
"Anna mulle nädalane aruanne vestluste mahust ja kliendirahulolust minu vestlusroboti kohta"
Assistent kasutab analytics_overview ja analytics_chat_volume, et koostada põhjalik aruanne.
Veebisaidi importimine
"Skaneeri https://example.com, impordi tootearu ja hinnalehed minu 'Support Bot' sisse ja ütle mulle, kui indekseerimine on lõpetatud"
Assistent kutsub crawler_preview_scan, valib asjakohased lehed, alustab importi crawler_start abil ja pärib crawler_job_get kuni töö on lõpetatud.
Liidide ja vormi esildiste ülevaatamine
"Näita mulle selle nädala uusi liide, määra kvalifitseerunud Anna'le ja kinnita ootel kontaktivormi esildised"
Assistent kombineerib lead_list, lead_assign, form_submissions_list ja form_submission_update_status.
Reaalajas vestluse üle võtmine
"Sea mind reaalajas vestluseks kättesaadavaks ja võta vanim ootel vestlus üle"
Assistent kasutab live_chat_set_availability, live_chat_queue ja live_chat_session_assign; vastused lähevad läbi live_chat_message_send.
Turvalisus
- API-võtmed on seotud Teie ettevõtte ja nende õigustega, mida valite loomisel (vaadake ülalolevat Scope veergu)
- Võtmed täidavad toiminguid ettevõtte omaniku õigustega; plaani piirangud ja funktsioonipiirangud kehtivad täpselt nagu juhtpaneelil
- Võtmeid saab igal ajal juhtpaneelilt tühistada
- API-juurdepääs on saadaval tasulistel plaanidel — vaadake meie Pricing page
Tõrkeotsing
Ühendus ebaõnnestus
- Kontrollige, et Teie API-võti on õige
- Kontrollige, et võti pole tühistatud
- Veenduge, et Teie plaan sisaldab API-juurdepääsu
- Taaskäivitage oma MCP klient
Tööriista ei leitud
Pärast konfiguratsiooni muutmist taaskäivitage oma MCP klient, et see laadiks uuesti saadaolevad tööriistad. Tööriistade nimed on väikeste tähtedega ja alakriipsudega (nt faq_list).
Vaja abi? Võtke ühendust meie tugimeeskonnaga →