AvalehtDokumentatsioon

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

  1. Minge oma Töölauavaade → Ettevõte → API vahekaardile
  2. Klõpsake Loo API-võti
  3. Andke oma võtmele kirjeldav nimi (nt "Claude Desktop") ja valige vähemalt üks õigus
  4. 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

ToolDescriptionScope
account_usage_getHangi 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_companiesLoetle kõik ettevõtted, millele praegusel kasutajal on juurdepääs, koos kasutaja rolliga igaühes.any
user_notification_mark_readMärgi üks praeguse kasutaja teadetest loetuks.any
user_notification_preferences_getHangi 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_updateUuenda praeguse kasutaja globaalseid teavituse eelistusi (e-posti/push lülitused, kokkuvõtte ajakava, vaikne aeg).any
user_notification_type_setting_updateLuba või keela e-posti / rakendusesisene kohaletoimetamine ühe teat tüübi jaoks praegusel kasutajal (ntany
user_notification_types_listLoetle kõik teavituse tüübid rühmitatuna kategooria järgi (chatbot, leads, live chat, knowledge, team, billing).any
user_notification_unread_countHangi praeguse kasutaja lugemata teadete arv.any
user_notificationsLoetle praeguse kasutaja teated, uusimad ees, kursori pagineerimisega.any
user_notifications_delete_oldHooldus: kustuta jäädavalt praeguse kasutaja juba loetud ja üle 30 päeva vanad teated.any
user_notifications_mark_all_readMärgi kõik praeguse kasutaja teated loetuks.any
user_profileHangi praeguse kasutaja profiil (id, nimi, e-post, roll, tellimuse tase).any

Company & Team

ToolDescriptionScope
company_chatbots_listLoetle kõik konkreetse ettevõtte vestlusrobotid koos kokkuvõttstatistikaga.chatbots:read
company_getHangi ettevõtte üksikasjad: profiil, omanik, brändi seaded (värvid, teavituse e-post) ja arvud.any
company_invite_cancelTühista (kustuta) meeskonnakutse, nii et link enam ei tööta.company:write
company_invite_resendSaada ootel meeskonnakutse uuesti: väljastab uue tokeni, pikendab kehtivusaega 7 päeva võrra ja saadab kutsemeili uuesti.company:write
company_invites_listLoetle ettevõtte meeskonna kutseid (vaikimisi ootel; includeExpired seadistades tagastatakse ka aegunud kutseid).company:read
company_listLoetle kõik ettevõtted, millele kasutajal on juurdepääs (API-võtmed ja Dashboard Assistant näevad ainult oma ettevõtet).any
company_logo_removeEemalda ettevõtte logo (kustutab salvestatud pildi ja tühjendab logo URL-i).company:write
company_member_inviteKutsu meeskonnaliige e-posti aadressi alusel rolliga (ADMIN, MANAGER, AGENT või VIEWER).company:write
company_member_removeEemalda meeskonnaliige ettevõttest.company:write
company_member_update_roleMuuda meeskonnaliikme rolli (ADMIN, MANAGER, AGENT või VIEWER).company:write
company_members_listLoetle ettevõtte liikmed koos nende rollidega (OWNER, ADMIN, MANAGER, AGENT, VIEWER).any
company_settings_updateUuenda ettevõtte brändi seadeid: primaryColor / secondaryColor (#RRGGBB) ja notificationEmail vestlusülevaatuste jaoks.company:write
company_updateUuenda 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

ToolDescriptionScope
chatbot_add_instructionLisa vestlusrobotile uus põhijuhis (1-5000 tähemärki).chatbots:write
chatbot_confirm_embedMärgi vestlusrobot manustatuks veebilehel (peidab juhtpaneelil seadistuse meeldetuletuse).chatbots:write
chatbot_createLoo uus vestlusrobot (sama mis juhtpaneeli viisard).chatbots:write
chatbot_deleteKustuta vestlusrobot jäädavalt koos kõigi FAQde, dokumentide, vestluste, liidide ja vormidega (ei saa tagasi võtta).chatbots:write
chatbot_delete_instructionKustuta vestlusroboti põhijuhis.chatbots:write
chatbot_getHangi vestlusroboti detailne info: üldseaded, isiksus (persona, tonaalsus, keeled, piirangud), vidina seaded, reaalajas vestlus, õppimisfaas, manustamise staatus ja arvud.chatbots:read
chatbot_get_embed_codeHangi HTML-koodilõik vestlusroboti paigaldamiseks veebilehele (skripti URL + <script> silt) ja kas manustamine on kinnitatud.chatbots:read
chatbot_get_instructionsHangi kõik vestlusroboti põhijuhised.chatbots:read
chatbot_improve_instructionsKirjuta põhijuhise tekst ümber platvormi AI-ärendajaga (sama mis juhtpaneeli 'Improve with AI').chatbots:write
chatbot_learning_phase_getHangi vestlusroboti õppimisfaasi seaded: käitumispreset (CAUTIOUS, BALANCED, CONFIDENT), kohandatud prompt ja kas robot on endiselt õppimisfaasis.chatbots:read
chatbot_learning_phase_updateMäära õppimisfaasi käitumispreset (CAUTIOUS = suunab inimesele ebakindlal juhul, BALANCED, CONFIDENT) ja/või kohandatud õppimisfaasi prompt.chatbots:write
chatbot_listLoetle kõik vestlusrobotid, millele kasutajal on juurdepääs, kokkuvõttstatistikaga.chatbots:read
chatbot_reorder_instructionsMäära vestlusroboti põhijuhiste järjestus.chatbots:write
chatbot_templates_listLoetle 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_activeAktiveeri või deaktiveeri vestlusrobot.chatbots:write
chatbot_toggle_learningLõpeta (false) või taaskäivita (true) vestlusroboti õppimisfaas.chatbots:write
chatbot_updateUuenda 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_instructionUuenda olemasolevat põhijuhist (sisu, isActive, kanal, sortOrder).chatbots:write
chatbot_update_personalityUuenda 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_getHangi vestlusroboti praegused vidina seaded (kõik välimus, bränding, käitumine ja eelneva vestluse vormiväljad).chatbots:read
widget_settings_updateUuenda vestlusroboti chat-vidinat: positsioon (sh.chatbots:write
widget_translations_getHangi vestlusroboti keelepõhised vidina tõlked: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }.chatbots:read
widget_translations_updateMäära keelepõhised vidina tõlked.chatbots:write

Knowledge Base

ToolDescriptionScope
crawler_job_cancelTühista PENDING või RUNNING indekseerimisülesanne; ülejäänud lehed jäetakse vahele.knowledge:write
crawler_job_getHangi indekseerimisülesande staatus, edenemine (pagesCrawled/pagesFound, tokensUsed) ja iga lehe staatus.knowledge:read
crawler_jobs_listLoetle vestlusroboti indekseerimisülesanded (uusimad ees) koos staatus ja edenemisega.knowledge:read
crawler_limitsHangi 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_scanSkaneeri veebisait ja loetle indekseeritavad lehed (url, pealkiri, isRecommended) ilma midagi importimata.knowledge:write
crawler_startAlusta indekseerimisülesannet, mis impordib valitud URL-id vestlusroboti teadmistebaasi (taustal töödeldakse; pärige crawler_job_get).knowledge:write
knowledge_document_add_from_urlLaadige 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_textLisa tekst või markdown dokument vestlusroboti teadmistebaasi sisendina (max 10 MB).knowledge:write
knowledge_document_deleteKustuta üleslaaditud dokument teadmistebaasist.knowledge:write
knowledge_document_getHangi üleslaaditud dokumendi üksikasjad, sh töötlemise staatus, veateade ja lühiajaline allalaadimis-URL.knowledge:read
knowledge_documents_listLoetle üleslaaditud dokumendid (PDF, TXT, MD, CSV, JSON, DOCX) vestlusroboti teadmistebaasis koos staatuse ja suurusega.knowledge:read
knowledge_page_addIndekseeri ü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_deleteKustuta indekseeritud leht teadmistebaasist (eemaldab selle vektorpoe faili).knowledge:write
knowledge_page_getHangi indekseeritud leht koos indekseeritud markdown-sisuga just selle vestlusroboti jaoks (kasulik veendumaks, mida robot lehe kohta teab).knowledge:read
knowledge_page_recrawlHangi indekseeritud leht uuesti ja asenda selle indekseeritud sisu (ntknowledge:write
knowledge_pages_deleteKustuta korraga mitmeid vestlusroboti indekseeritud lehti.knowledge:write
knowledge_pages_listLoetle 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_deleteKustuta iga veebisaidi (domeeni) indekseeritud leht vestlusroboti teadmistebaasist.knowledge:write
knowledge_website_recrawlIndekseeri uuesti kõik veebisaidi (domeeni) lehed vestlusroboti teadmistebaasis, et värskendada sisu.knowledge:write
knowledge_website_recrawl_cancelTühista pooleli olev veebisaidi uuestiindekseerimine: järjekorras olevad (PENDING) domeeni lehed taastatakse nende varasemasse indekseeritud olekusse.knowledge:write
knowledge_websites_listLoetle 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.

ToolDescriptionScope
price_listKeri hinnapeade läbi ja eraldi heakskiidetud versiooni sobivuse vaatamine.prices:read
price_getLoe üksuse täielikku olekut ja revisioneid.prices:read
price_detailLoe üksuse detaili koos leheküljepagineeritud revisioni ajalooga.prices:read
price_suggestions_listKeri hinnasoovitusi.prices:read
price_createLoo mustand serveri genereeritud üksuse ID-ga.prices:write
price_editLoo uus mustand eeldatud üksuse versioonist.prices:write
price_import_csvImpordi mustandeid selgesõnalise formaadi ja stabiilse import ID-ga korduste jaoks.prices:write
price_suggestion_applyRakenda valitud soovituse kandidaat mustandina.prices:write
price_approveKiitke heaks üks selgesõnaline eeldatud üksuse versioon.prices:approve
price_approve_manyKiitke heaks selgesõnaline ID/versiooni valik atomaarse toiminguna; ükski aegunud versioon ei aktsepteeri kogu valikut.prices:approve
price_archiveArhiveeri ü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

ToolDescriptionScope
faq_cache_purgeTühjenda vahemällu salvestatud FAQ-vidina andmed kõigil ühendatud CMS saitidel (WordPress plugin).faqs:write
faq_categories_listLoetle vestlusroboti FAQ-kategooriad koos nende FAQ-arvuga, slugide, sortimismeetodi ja tõlgetega.faqs:read
faq_categories_reorderMäära FAQ-kategooriate järjekord vidinas: kategooriaIds positsioon muutub sortOrder-iks.faqs:write
faq_category_createLoo vestlusroboti jaoks FAQ-kategooria (slug genereeritakse nimest).faqs:write
faq_category_deleteKustuta FAQ-kategooria.faqs:write
faq_category_translations_updateAsenda FAQ-kategooria tõlked, ntfaqs:write
faq_category_updateNimeta FAQ-kategooria ümber või muuda selle kirjeldust, ikooni või sortimisviisi.faqs:write
faq_createLoo FAQ vestlusroboti jaoks.faqs:write
faq_deleteKustuta FAQ jäädavalt (eemaldab ka vestlusroboti teadmistebaasist ja puhastab CMS vidina vahemälud).faqs:write
faq_embed_code_getHangi 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_getHangi FAQ täielikud üksikasjad: küsimus, vastus, kategooria, avaldamise staatus, sortOrder, tõlked, SEO-väljad ja tagasiside statistika.faqs:read
faq_listLoetle vestlusroboti FAQd (kasutage chatbot_list, et leida chatbotId).faqs:read
faq_reorderMäära FAQ-de kuvamise järjekord vidinas.faqs:write
faq_suggestion_approveKinnita PENDING FAQ-ettepanek: loob avaldatud FAQ-i (valikuliselt muudetud küsimuse/vastuse/kategooriaga) ja märgib ettepaneku APPROVED.faqs:write
faq_suggestion_getHangi FAQ-ettepaneku täielikud üksikasjad (täielik vastus, AI selgitus, soovitatud kategooria, ülevaatuse staatus).faqs:read
faq_suggestion_rejectKeeldu PENDING FAQ-ettepanekust valikulise põhjusega.faqs:write
faq_suggestions_generateLas AI pakub uusi FAQ-sid vestlusroboti teadmistebaasist (indekseeritud lehed / üleslaaditud dokumendid), valikuliselt ühe kategooria jaoks.faqs:write
faq_suggestions_listLoetle AI-ga genereeritud FAQ-ettepanekud vestlusroboti jaoks (vestlustest või faq_suggestions_generate'ist).faqs:read
faq_translateTõlgi FAQ küsimus ja vastus AI abil vestlusroboti teistesse toetatud keeltesse (või antud targetLanguages) ja salvesta tulemus.faqs:write
faq_translations_updateSalvesta FAQ tõlked keele kaupa, ntfaqs:write
faq_updateUuenda FAQ küsimust, vastust, kategooriat, avaldamise staatus või manuaalset sortOrderit.faqs:write
faq_widget_settings_getHangi 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_updateUuenda 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

ToolDescriptionScope
chat_feedback_dismissMärgi vestlus ülevaatatud ilma hindeta (eemaldab selle ootejärjekorrast, ei muuda usalduskoefitsienti).chats:write
chat_feedback_getHangi üks vestluse ülevaatus (tagasiside) AI-analüüsiga, raskusaste, usalduskategooria, skoori muutus ja seotud parandussessioon.chats:read
chat_feedback_listLoetle vestlusülevaatused (tagasiside read) vestlusroboti kohta koos staatusfiltri ja arvudega.chats:read
chat_feedback_set_severityTühista ülevaatuse negatiivse vestluse raskusastme klassifikatsioon (MINOR|MODERATE|MAJOR|CRITICAL); raskusaste mõjutab usaldusskoori langust.chats:write
chat_feedback_statsSessioonide arvud ülevaatuskorvi kohta vestlusroboti jaoks (kokku, none, pending, positive, negative, reviewed, improved) — juhtpaneeli vestluste lehe statistika kaardid.chats:read
chat_feedback_submitHinda vestlussessiooni kui Good (isPositive=true) või Needs Work (isPositive=false).chats:write
chat_session_getHangi 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_searchOtsi vestlussessioone vestlusroboti kohta sõnumi sisu ja/või külastaja e-posti alusel.chats:read
chat_session_set_categoryMäära või muuda vestlussessiooni usalduskategooriat (korrigeerib AI kategoriseerimist; per-kategooria usaldus arvutatakse uuesti, kui vestlus on üle vaadatud).chats:write
chat_sessions_listLoetle vestlussessioone vestlusroboti kohta, uusimad ees, samade ülevaatusjärjekorra filtritega nagu juhtpaneeli vestluste lehel.chats:read

Improvement Agent

ToolDescriptionScope
confidence_categories_listLoetle vestlusroboti usalduskategooriad koos per-kategooria usaldusskoori, ülevaatuste arvu ja ülevaatuse e-posti sagedusega.chats:read
confidence_category_createLoo vestlusroboti jaoks usalduskategooria.chatbots:write
confidence_category_deleteKustuta usalduskategooria.chatbots:write
confidence_category_mergeLiida üks usalduskategooria teisega samas vestlusrobotis: kõik vestlused/ülevaatused liiguvad sihtkohta, allikas kustutatakse ja skoorid arvutatakse uuesti.chatbots:write
confidence_category_updateNimeta 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_getVestlusroboti 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_approveKinnita 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_rejectKeeldu PENDING paranduse ettepanekust.chatbots:write
improvement_proposal_simulateSimuleeri, kuidas robot vastaks probleemsele sõnumile koos ettepaneku rakendamisega (algne vs.chatbots:write
improvement_proposals_pendingLoetle paranduse ettepanekud, mis ootavad ülevaatust (staatus PENDING) kogu ettevõttes või ühele vestlusrobotile.chatbots:read
improvement_session_completeMärgi parandussessioon COMPLETED-iks (siis loetakse vestlus ülevaatusjärjekorras Improved'iks).chatbots:write
improvement_session_createAva Improvement Agent vestluse jaoks, mis on hinnatud Needs Work.chatbots:write
improvement_session_getHangi 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_resetTaaskä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_messageSaada sõnum Improvement Agentile (kirjelda, mis robotivastuses valesti oli; valikuliselt targetMessageIndex = boti sõnumi 1-baasiline indeks originalChat.messages'is).chatbots:write
improvement_sessions_listLoetle 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_assessHinda 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

ToolDescriptionScope
live_chat_agents_availableHangi 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_heartbeatVärskenda praeguse kasutaja reaalajas vestluse presence heartbeat'i (ainult kui märgitud saadaval live_chat_set_availability abil).chats:write
live_chat_message_sendSaada külastajale sõnum määratud agendina.chats:write
live_chat_queueHangi reaalajas vestluse järjekord: sessioonid, mis ootavad agenti, vanimad ees (FIFO).chats:read
live_chat_session_assignVõ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_closeLõpeta reaalajas vestlussessioon agendina (iga mitte-VIEWER ettevõtte liige).chats:write
live_chat_session_getHangi reaalajas vestlussessioon külastaja info, määratud agenti, kõikide sõnumite ja eelmise boti vestluse (handoff context) koosseisus.chats:read
live_chat_sessions_listLoetle reaalajas vestlussessioone (uusimad ees; WAITING sessioonid vanimad ees) koos valikuliste filtritega chatbot, staatus ja määratud agenti järgi.chats:read
live_chat_set_availabilityLülita praeguse kasutaja "Available for Live Chat" lüliti ettevõtte jaoks.chats:write

Leads

ToolDescriptionScope
lead_assignMäära liid ettevõtte liikmele või eemalda määramine (assignedToId: null).leads:write
lead_bulk_update_statusMäära mitme liidi staatus korraga (maksimaalselt 100).leads:write
lead_categories_listLoetle vestlusroboti liidide kategooriad liidide arvuga ja meeskonnaliikmetega, keda iga kategooria teavitab.leads:read
lead_category_assign_userLisa ettevõtte liige liidi kategooria teavituste nimekirja (või uuenda nende teavituse lippe).leads:write
lead_category_createLoo vestlusroboti jaoks liidi kategooria.leads:write
lead_category_deleteKustuta liidi kategooria.leads:write
lead_category_remove_userEemalda ettevõtte liige liidi kategooria teavituste nimekirjast.leads:write
lead_category_updateUuenda liidi kategooria nime, kirjeldust ja/või värvi.leads:write
lead_createLoo liid käsitsi (ntleads:write
lead_deleteKustuta liid jäädavalt.leads:write
lead_field_config_getHangi 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_updateUuenda vestlusroboti liidi kogumise konfiguratsiooni.leads:write
lead_getHangi liidi täielikud üksikasjad, sh vastutaja, kategooria ja algse vestluse transkriptsioon (pagineeritud messageOffset/messageLimit abil, vaikimisi esimesed 20 sõnumit).leads:read
lead_listLoetle vestlusroboti liidid (uusimad ees) koos valikuliste filtritega staatus, kategooria, vastutaja ja vabas tekstis otsingu (nimi/e-post/ettevõte).leads:read
lead_statsHangi liidi statistika vestlusroboti jaoks: arvud staatusi lõikes, viimase 7 päeva liidid ja konversioonimäär (protsent).leads:read
lead_updateUuenda liidi staatus, kategooria, märkmed, kogutud andmed ja/või vastutaja.leads:write

Forms

ToolDescriptionScope
form_createLoo vestlusroboti jaoks kontaktivorm (põhiseaded, väljad, disain ja rämpsseaded ühes kõnes).forms:write
form_deleteKustuta kontaktivorm ja KÕIK selle esildised jäädavalt (kaskaad).forms:write
form_getHangi kontaktivorm täielikult: väljad, tõlked, stiil, rämpsseaded, aktiivseis, esildiste arv ja manustamise skript (embedCode).forms:read
form_listLoetle vestlusroboti kontaktivormid väljade arvuga, esildiste arvuga ja manustuskoodidega.forms:read
form_statsKontaktivormi esildiste arvud: kokku, pending, approved, spam ja rejected.forms:read
form_submission_deleteKustuta kontaktivormi esildis jäädavalt (ntforms:write
form_submission_getHangi 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_listLoetle kontaktivormi esildised, uusimad ees, valikuliselt filtreeritud staatus (PENDING, APPROVED, SPAM, REJECTED) ja loomise kuupäeva järgi.forms:read
form_updateUuenda 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_translationsAsenda välja ja/või UI tõlked kontaktivormil.forms:write

Email Assistant

ToolDescriptionScope
email_activity_listLoetle 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_listLoetle postkasti ühenduse e-posti kategooriad (järjestatud sortOrder järgi).email:read
email_category_createLoo postkasti ühenduse jaoks e-posti kategooria (maksimaalselt 20 ühenduse kohta).email:write
email_category_deleteKustuta e-posti kategooria.email:write
email_category_updateUuenda e-posti kategooriat (osaline: ainult antud väljad muutuvad).email:write
email_connection_disconnectKatkesta postkasti ühendus jäädavalt.email:write
email_connection_getHangi postkasti ühendus koos, sh.email:read
email_connection_updateUuenda 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_listLoetle 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_deleteKustuta õpitud e-posti kontakt (unusta saatja profiil, ntemail:write
email_contact_getHangi õ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_updateUuenda õpitud e-posti kontakti.email:write
email_contacts_listLoetle 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_createLoo postikasti all oleva sissetuleku kausta alla kaust (tagastab olemasoleva, kui nimi on juba kasutusel), mida kasutada kategooria liigutuse sihtkohana.email:write
email_folders_listLoetle 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_listLoetle 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

ToolDescriptionScope
analytics_chat_volumeVestluste 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_statsEttevõ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_formsKontaktivormi 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_leadsLiidi 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_overviewAnalüü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_activityMis 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:

  1. Kasutab improvement_proposals_pending ettepanekute toomiseks
  2. Analüüsib ja kokkuvõtlikult esitab iga ettepaneku
  3. Kinnitab või lükkab need Teie nimel tagasi improvement_proposal_approve või improvement_proposal_reject abil

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

  1. Kontrollige, et Teie API-võti on õige
  2. Kontrollige, et võti pole tühistatud
  3. Veenduge, et Teie plaan sisaldab API-juurdepääsu
  4. 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 →