Paġna ewlenijaDokumentazzjoni

MCP Server Integration

ChatReact jimplementa l-Model Context Protocol (MCP), li jippermetti li tikkonnettja l-kont tiegħek ta' ChatReact maʼ assistenti AI bħal Claude Desktop, Cursor u għodod oħra kompatibbli maʼ MCP.

X'inhu MCP?

Il-Model Context Protocol huwa standard miftuħ li jippermetti lill-assistenti AI jitkellmu maʼ servizzi u sorsi tad-data esterni. Bl-integrazzjoni MCP taʼ ChatReact, tista':

  • Immaniġġja chatbots — toħloq, tikkonfigura (persona, lingwi, widget, comportament, restrizzjonijiet), tinnetha u ttħassar chatbots
  • Ibni l-bażi tal-għarfien — żid dokumenti, skannja siti web, immaniġġja paġni skannjati u istruzzjonijiet bażiċi
  • Immaniġġja FAQs — FAQs, kategoriji, suġġerimenti, traduzzjonijiet u l-widget tal-FAQ
  • Irevedi chats — ivvaluta konversazzjonijiet, assenja kategoriji tal-kunfidenza, imexxi l-Improvement Agent
  • Iħdem ma' leads u formoli — leads, kategoriji ta' lead, settings ta' cattura, formoli ta' kuntatt u sottomissjonijiet
  • Act as a live chat agent — issettja l-available tiegħek, tieħu ż-żmien ta' chats li qed jistennew, tirrispondi u tispiċċa sessjonijiet
  • Immaniġġja l-kumpanija tiegħek — profil, kuluri tal-marka, membri tat-tim u stedina
  • Uża l-Email Assistant — konnessjonijiet tal-mailbox, kategoriji, kuntatti u attività
  • Qra analitiċi u notifiki

Kollox li tista' tagħmel fid-dashboard huwa disponibbli permezz taʼ MCP (u l-REST API); biss azzjonijiet li jiġu eżegwiti f'kuntest tal-browser bħal pagamenti, mailbox OAuth, passkeys, tħassir ta' kont u immaniġjar tal-API keys jibqgħu fil-dashboard.

Kif Tibda

1. Ġenera API Key

  1. Mur fil-Dashboard → Kumpanija → API tab
  2. Ikklikkja Oħloq Ċavetta API
  3. Agħti isem deskrittiv għall-key tiegħek (per eż., "Claude Desktop") u agħżel mill-inqas permess wieħed
  4. Kopja l-key ġenerat (jibda b'cr_)

Iż-keys tal-API huma disponibbli fuq pjanijiet imħallsa — ara l-Pricing page.

Aħżen il-API key tiegħek b'mod sikur. Ma tistax terġa' tirkuprah wara l-ħolqien.

2. Ikkonfigura l-MCP Client Tiegħek

Is-server MCP ta' ChatReact huwa hostjat f'https://www.chatreact.ai/api/mcp u jikkomunika fuq HTTP (JSON-RPC). Awtentika b'header Authorization: Bearer — header X-API-Key bl-istess key huwa wkoll aċċettat.

Cursor IDE

Cursor jappoġġja servers MCP remoti direttament. Żid fis-settings MCP ta' Cursor tiegħek:

{
  "mcpServers": {
    "chatreact": {
      "url": "https://www.chatreact.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer cr_your_api_key_here"
      }
    }
  }
}

Claude Desktop

Il-fajl taʼ konfigurazzjoni taʼ Claude Desktop jappoġġja servers bbażati fuq kmandi, u għalhekk uża l-bridge standard mcp-remote biex tikkonnettja mal-endpoint hostjat:

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"
      ]
    }
  }
}

Din il-konfigurazzjoni teħtieġ Node.js installat. L-eżempju juża l-header X-API-Key għax xi klijenti ma jimmaniġġjawx spazji fl-argumenti b'mod affidabbli.

3. Irrestarta l-AI Assistant Tiegħek

Wara li ssejvja l-konfigurazzjoni, irrestarta Claude Desktop jew Cursor biex tistabbilixxi l-konnessjoni.

Għodod Disponibbli

ChatReact MCP jesponi l-għodod hawn taħt, maqsuma skont il-qasam. Il-kolonna Scope turi l-permess tal-API key li għandha bżonn għaliha (any = kull key valida). L-għodod jinħadmu bl-istess permessi applikabbli, limiti tal-pjan u effetti sekondarji kif appoġġjat fl-operazzjonijiet tad-dashboard. Ħidmiet marbuta mal-browser bħal pagamenti, awtorizzazzjoni tal-mailbox, passkey, tħassir ta' kont u immaniġġjar ta' keys jibqgħu fil-dashboard.

Għodod distruttivi (ħassar, resetta, issara, ġebbed flimkien) jitlobu konfirmazzjoni meta jintużaw permezz tal-Dashboard Assistant. Permezz ta' API key jeżegwixxu immedjatament.

Kont

ToolDescriptionScope
account_usage_getAċċessa l-pjan attwali (tier, status), il-kontaturi tal-użu għall-perjodu tal-fatturazzjoni kurrenti (companies, chatbots, team members, chats, tokens) u l-limiti tal-pjan, flimkien mal-limiti effettivi u feature flags tal-kumpanija li sejħa hija skopjata għalih.any
user_companiesIlista l-kumpaniji kollha li l-utent kurrenti għandu aċċess għalihom, bil-role tal-utent f'kull waħda.any
user_notification_mark_readMarkja waħda minn notifikazzjonijiet l-utent kurrenti bħala mqarra.any
user_notification_preferences_getAċċessa l-preferenzi tan-notifika tal-utent kurrenti: toggles globali email/push, frekwenza/tar għas-digesti, ħinijiet tal-paċi u settings tal-kanal skont it-tip.any
user_notification_preferences_updateAġġorna l-preferenzi globali tan-notifika tal-utent kurrenti (toggles email/push, skeda tad-digest, ħinijiet tal-paċi).any
user_notification_type_setting_updateEnable jew disable il-kunsinna bl-email / in-app għal tip wieħed ta' notifika tal-utent kurrenti (eż.any
user_notification_types_listIlista t-tipi kollha tan-notifika maqsuma skont kategorija (chatbot, leads, live chat, knowledge, team, billing).any
user_notification_unread_countAċċessa n-numru tan-notifikazzjonijiet mhux mqarra tal-utent kurrenti.any
user_notificationsIlista n-notifikazzjonijiet tal-utent kurrenti, l-aktar riċenti l-ewwel, bil-pagination tal-cursor.any
user_notifications_delete_oldHousekeeping: tħassar permanentement in-notifikazzjonijiet tal-utent kurrenti li diġà ġew mqarra u huma aktar minn 30 jum.any
user_notifications_mark_all_readMarkja l-notifikazzjonijiet kollha tal-utent kurrenti bħala mqarra.any
user_profileAċċessa l-profil tal-utent kurrenti (id, isem, email, rwol, tier tas-subscription).any

Kumpanija u Tim

ToolDescriptionScope
company_chatbots_listIlista l-chatbots kollha għal kumpanija speċifika b'statistiċi sommarji.chatbots:read
company_getAċċessa informazzjoni dettaljata dwar kumpanija: profil, sid, settings tal-marka (kuluri, email tan-notifika) u counts.any
company_invite_cancelIkkanċella (tħassar) stedina tat-tim biex il-link ma jibqax jaħdem.company:write
company_invite_resendIritorna stedina tat-tim pendenti: toħroġ token ġdid, tespandi l-eżpirazzjoni b'7 ijiem u tibgħat l-email ta' stedina mill-ġdid.company:write
company_invites_listIlista stedina tat-tim ta' kumpanija (pendenti b'mod default; issetta includeExpired biex tirritorna wkoll dawk skaduti).company:read
company_listIlista l-kumpaniji kollha li l-utent għandu aċċess għalihom (API keys u Dashboard Assistant jaraw biss il-kumpanija tagħhom).any
company_logo_removeNeħħi l-logo tal-kumpanija (tħassar l-immaġni maħżuna u tħassar il-URL tal-logo).company:write
company_member_inviteIssedna membru tat-tim bl-email bi rwol (ADMIN, MANAGER, AGENT jew VIEWER).company:write
company_member_removeNeħħi membru tat-tim mill-kumpanija.company:write
company_member_update_roleIbdel ir-rwol ta' membru tat-tim (ADMIN, MANAGER, AGENT jew VIEWER).company:write
company_members_listIlista l-membri ta' kumpanija bil-ruoli tagħhom (OWNER, ADMIN, MANAGER, AGENT, VIEWER).any
company_settings_updateAġġorna settings tal-marka tal-kumpanija: primaryColor / secondaryColor (#RRGGBB) u l-notificationEmail għal reviżjonijiet tal-chat.company:write
company_updateAġġorna l-profil tal-kumpanija: isem (2-100 karattri), deskrizzjoni (max 1000 karattri) jew website (https:// jiżdied awtomatikament; passa string vojta biex tħassar website/deskrizzjoni).company:write

Immaniġġjar Chatbot

ToolDescriptionScope
chatbot_add_instructionŻid istruzzjoni bażika ġdida ma' chatbot (1-5000 karattri).chatbots:write
chatbot_confirm_embedMarkja chatbot bħala embedded fuq is-sit (jaħbi r-rimarka tas-setup fid-dashboard).chatbots:write
chatbot_createOħloq chatbot ġdid (l-istess bħall-wizard tad-dashboard).chatbots:write
chatbot_deleteĦassar permanentament chatbot b'kollox FAQs, dokumenti, chats, leads u formoli (ma jistax jiġi mkeċċ).chatbots:write
chatbot_delete_instructionĦassar istruzzjoni bażika minn chatbot.chatbots:write
chatbot_getAċċessa informazzjoni dettaljata dwar chatbot: settings ġenerali, personalità (persona, tonality, lingwi, restrizzjonijiet), settings tal-widget, live chat, fazi tat-tagħlim, status ta' embed u counts.chatbots:read
chatbot_get_embed_codeAċċessa l-HTML snippet biex tinstalla chatbot fuq sit (URL tal-script + <script> tag) u jekk l-embed ġie kkonfermat.chatbots:read
chatbot_get_instructionsAċċessa l-istruzzjonijiet bażiċi kollha għal chatbot.chatbots:read
chatbot_improve_instructionsRewrite test ta' istruzzjoni bażika bl-AI tal-pjattaforma (l-istess bħal 'Improve with AI' fid-dashboard).chatbots:write
chatbot_learning_phase_getAċċessa settings tal-fażi tat-tagħlim ta' chatbot: preset ta' comportamento (CAUTIOUS, BALANCED, CONFIDENT), prompt personalizzat u jekk il-bot għadu fil-fażi tat-tagħlim.chatbots:read
chatbot_learning_phase_updateIssettja l-preset tal-behaviour tal-fażi tat-tagħlim (CAUTIOUS = jirreferi lill-bniedem meta m'humiex ċerti, BALANCED, CONFIDENT) u/jew prompt personalizzat tal-fażi tat-tagħlim.chatbots:write
chatbot_listIlista l-chatbots kollha li l-utent għandu aċċess għalihom, b'statistiċi sommarji.chatbots:read
chatbot_reorder_instructionsIssettja l-ordni tal-istruzzjonijiet bażiċi ta' chatbot.chatbots:write
chatbot_templates_listIlista templates tal-chatbot (presets għal persona, tonality, messaġġi u comportament tal-widget) li jistgħu jiġu ppassati bħala templateId għal chatbot_create, u jekk il-pjan tal-kumpanija jista' jużahom.chatbots:read
chatbot_toggle_activeAttiva jew ddeattiva chatbot.chatbots:write
chatbot_toggle_learningEnd (false) jew jerġa' jippermetti (true) il-fażi tat-tagħlim tal-chatbot.chatbots:write
chatbot_updateAġġorna settings ġenerali ta' chatbot: isem, deskrizzjoni, isActive, live chat (liveChatEnabled/liveChatMode, feature tal-pjan), showBranding (pjanijiet white-label), emails għal reviżjoni chat, FAQ auto-generation, test legacy coreInstructions, fazi tat-tagħlim (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt).chatbots:write
chatbot_update_instructionAġġorna istruzzjoni bażika eżistenti (content, isActive, channel, sortOrder).chatbots:write
chatbot_update_personalityAġġorna l-personalità ta' chatbot: persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), sliders tal-tonality 1-5, lingwi (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), messaġġi (welcomeMessage, fallbackMessage, proactive greeting) u restrizzjonijiet (blacklistTopics, complianceRules, maxResponseLength, human handoff).chatbots:write
widget_settings_getAċċessa settings kurrenti tal-widget għal chatbot (apparenza kollha, branding, comportament u campi tal-formola qabel il-chat).chatbots:read
widget_settings_updateAġġorna l-chat widget ta' chatbot: pożizzjoni (inkl.chatbots:write
widget_translations_getAċċessa t-traduzzjonijiet tal-widget skont kull-lingwa ta' chatbot: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }.chatbots:read
widget_translations_updateIssettja traduzzjonijiet tal-widget skont lingwa.chatbots:write

Knowledge Base

ToolDescriptionScope
crawler_job_cancelIkanċella xogħol ta' crawl li huwa PENDING jew RUNNING; il-paġni li jifdal jitħallew barra.knowledge:write
crawler_job_getAċċessa l-istatus ta' xogħol ta' crawl, progress (pagesCrawled/pagesFound, tokensUsed) u l-istatus ta' kull paġna.knowledge:read
crawler_jobs_listIlista xogħlijiet ta' crawl ta' chatbot (l-aktar riċenti l-ewwel) bl-istatus u progress.knowledge:read
crawler_limitsAċċessa limiti ta' crawl tal-pjan għal chatbot (max pages per crawl, tokens per page, crawls per month) u jekk jista' jibda crawl ġdid din ix-xahar.knowledge:read
crawler_preview_scanSkannja sit web u lista l-paġni li jistgħu jiġu crawled (url, title, isRecommended) mingħajr ma timporta xejn.knowledge:write
crawler_startIbda xogħol ta' crawl li jimporta l-URLs magħżula fil-bażi tal-għarfien tal-chatbot (iproċessat fil-background; poll crawler_job_get).knowledge:write
knowledge_document_add_from_urlNiżżel dokument (PDF, TXT, MD, CSV, JSON, DOCX; max 10 MB) minn URL pubbliku http(s) u żidha mal-bażi tal-għarfien tal-chatbot.knowledge:write
knowledge_document_add_textŻid dokument ta' test jew markdown mal-bażi tal-għarfien tal-chatbot minn kontenut inline (max 10 MB).knowledge:write
knowledge_document_deleteĦassar dokument imħaddem mill-bażi tal-għarfien.knowledge:write
knowledge_document_getAċċessa dettalji ta' dokument imħaddem inkluż status tal-ipproċessar, messaġġ ta' żball u URL ta' download ta' ħajja qasira.knowledge:read
knowledge_documents_listIlista d-dokumenti mħaddma (PDF, TXT, MD, CSV, JSON, DOCX) fil-bażi tal-għarfien ta' chatbot b'status u daqs.knowledge:read
knowledge_page_addCrawl URL wieħed u żidha mal-bażi tal-għarfien tal-chatbot (jiflaħ b'CONFLICT meta l-URL diġà huwa indexjat, FORBIDDEN meta jintlaħaq il-limit tat-token).knowledge:write
knowledge_page_deleteĦassar paġna skannjata mill-bażi tal-għarfien (jneħħi l-fajl tal-vector-store tagħha).knowledge:write
knowledge_page_getAċċessa paġna skannjata inkluż il-kontenut markdown li ġie indexjat għall-chatbot (utli biex tivverifika x'jafu dwar paġna).knowledge:read
knowledge_page_recrawlErġa' ġib paġna skannjata u ibdel il-kontenut indexjat tagħha (eż.knowledge:write
knowledge_pages_deleteĦassar diversi paġni skannjati ta' chatbot f'daqqa.knowledge:write
knowledge_pages_listIlista paġni skannjati fil-bażi tal-għarfien ta' chatbot, bl-għażla ta' filtru skont domain, status jew termini ta' tfittxija (URL/title).knowledge:read
knowledge_statsPanoramika tal-bażi tal-għarfien ta' chatbot: dokumenti (skont status, daqs), paġni skannjati u siti (skont status), xogħlijiet ta' crawl, istruzzjonijiet bażiċi maqsmuin skont sors (manuali vs improvement agent), FAQs, status/daqs tal-vector store u użu tal-ħażna vs.knowledge:read
knowledge_website_deleteĦassar kull paġna skannjata ta' sit web (domain) mill-bażi tal-għarfien tal-chatbot.knowledge:write
knowledge_website_recrawlErġa' crawl kull paġna ta' sit (domain) fil-bażi tal-għarfien tal-chatbot biex tirrifreska l-kontenut tagħha.knowledge:write
knowledge_website_recrawl_cancelIkanċella re-crawl ta' sit web li qiegħed f'progress: paġni queued (PENDING) tad-domain jiġu rritornati għastat indexjat preċedenti tagħhom.knowledge:write
knowledge_websites_listIlista s-siti (domains) li l-paġni tagħhom huma fil-bażi tal-għarfien ta' chatbot, b'counts ta' paġni skont status u totali tat-tokens.knowledge:read

Price Management

Dawn l-għodod jimmaniġġjaw drafts ta' prezz strutturati u approvazzjonijiet espliciti. Is-salvataġġ ta' draft huwa separati mill-approvazzjoni tal-verżjoni eżatta; l-eligibilità tiddependi wkoll fuq status u validità. API keys eżistenti ma jirċevux permessi tal-prezz awtomatikament. Biss is-sid tal-kumpanija jista' jagħti prices:write jew prices:approve. Chiamijiet bl-API key jeżegwixxu direttament, għalhekk irrevedi l-input eżatt qabel ma ssejjaħ mutation. Ara Prices & services għall-workflow tal-klijent.

ToolDescriptionScope
price_listPaġina permezz ta' price heads u eligibility tal-verżjoni approvata separata.prices:read
price_getAqra state kompleta tal-oġġett u reviżjonijiet.prices:read
price_detailAqra dettalji tal-oġġett b'historja ta' reviżjonijiet paginata.prices:read
price_suggestions_listPaġina permezz ta' suġġerimenti ta' prezz.prices:read
price_createOħroġ draft b'ID tal-oġġett ġenerat mis-server.prices:write
price_editOħloq draft ġdid minn verżjoni eżpressament mistenni tal-oġġett.prices:write
price_import_csvImporta drafts b'format esplicitu u import ID stabbli għal retries sikuri.prices:write
price_suggestion_applyApplika s-suġġeriment magħżul bħala draft.prices:write
price_approveAppoġġa verżjoni eżpressament mistenni tal-oġġett.prices:approve
price_approve_manyAppoġġa selezzjoni ta' ID/verżjoni esplicita atomikament; kwalunkwe verżjoni stalja tirrifjuta s-selezzjoni kollha.prices:approve
price_archiveArkivja oġġett f'verżjoni eżpressament mistenni tiegħu.prices:approve

Il-modifiki tad-draft iżommu r-reviżjoni approvata preċedenti. Il-format CSV u separator deċimali jridu jkunu espliciti; kontenut CSV mibdul jeħtieġ import ID ġdid. Kull operazzjoni hija mogħnija lill-kumpanija tal-API key u lill-chatbot speċifikat.

Immaniġġjar tal-FAQ

ToolDescriptionScope
faq_cache_purgeĦassar id-data cached tal-widget tal-FAQ fuq is-siti CMS konnessi kollha (plugin WordPress).faqs:write
faq_categories_listIlista l-kategoriji tal-FAQ ta' chatbot bl-għadd ta' FAQs, slugs, modalità ta' sort u traduzzjonijiet.faqs:read
faq_categories_reorderIssettja l-ordni tal-kategoriji tal-FAQ fil-widget: il-pożizzjoni f'categoryIds issir sortOrder.faqs:write
faq_category_createOħloq kategorija ta' FAQ għal chatbot (slug jiġi ġenerat minn isem).faqs:write
faq_category_deleteĦassar kategorija ta' FAQ.faqs:write
faq_category_translations_updateIbdel it-traduzzjonijiet ta' kategorija ta' FAQ, eż.faqs:write
faq_category_updateRinomina kategorija ta' FAQ jew ibdel id-deskrizzjoni, l-ikona jew il-modalità tas-sort.faqs:write
faq_createOħloq FAQ għal chatbot.faqs:write
faq_deleteĦassar permanently FAQ (jieħu wkoll il-ħruġ mill-bażi tal-għarfien tal-chatbot u jpurgja caches tal-widget tal-CMS).faqs:write
faq_embed_code_getAċċessa l-embed snippets għall-widget tal-FAQ: script tag, shortcode ta' WordPress u Shopify Liquid snippet, plus varjanti skont il-kategorija (uża categorySlug minn faq_categories_list biex tinbeda biss kategorija waħda).chatbots:read
faq_getAċċessa d-dettalji sħaħ ta' FAQ: domanda, tweġiba, kategorija, state ta' pubblikazzjoni, ordni, traduzzjonijiet, kampi SEO u statistika tal-feedback.faqs:read
faq_listIlista FAQs ta' chatbot (uża chatbot_list biex issib chatbotId).faqs:read
faq_reorderIssettja l-ordni tal-wiri tal-FAQs fil-widget.faqs:write
faq_suggestion_approveApprova suġġeriment ta' FAQ PENDING: joħloq FAQ ppubblikat (għażilment bi domanda/tweġiba/kategorija editjata) u markja s-suġġeriment bħala APPROVED.faqs:write
faq_suggestion_getAċċessa d-dettalji sħaħ ta' suġġeriment ta' FAQ (tweġiba kompleta, reasoning tal-AI, kategorija suġġerita, state tar-reviżjoni).faqs:read
faq_suggestion_rejectIrrifjuta suġġeriment ta' FAQ PENDING b'raġuni opciona.faqs:write
faq_suggestions_generateĦalli lill-AI jissuġġerixxi FAQs ġodda mill-bażi tal-għarfien tal-chatbot (paġni skannjati / dokumenti mħaddma), għażilment għal kategorija waħda.faqs:write
faq_suggestions_listIlista suġġerimenti ta' FAQ ġenerati mill-AI ta' chatbot (minn konversazzjonijiet jew faq_suggestions_generate).faqs:read
faq_translateTraduzzjoni bil-AI tad-domanda u t-tweġiba ta' FAQ għall-oħrajn lingwi appoġġjati tal-chatbot (jew targetLanguages mogħtija) u ssejvja r-riżultat.faqs:write
faq_translations_updateSsejvja traduzzjonijiet ta' FAQ skont lingwa, eż.faqs:write
faq_updateAġġorna domanda, tweġiba, kategorija, state ta' pubblikazzjoni jew ordni manwali ta' FAQ.faqs:write
faq_widget_settings_getAċċessa settings tal-apparenza u comportament tal-widget tal-FAQ li jista' jinħeba (kuluri, border radius, titlu, spacing, max width, allowMultipleOpen, autoOpenFirst, sort mode, titlu traduzzjonijiet).chatbots:read
faq_widget_settings_updateAġġorna settings tal-widget tal-FAQ: kuluri (hex), borderRadius 0-32, titlu (max 100) + showTitle, spacing compact|normal|relaxed, maxWidth 0-2000 (0 = full width), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name u traduzzjonijiet tal-titlu skont kull-lingwa.chatbots:write

Storja tal-Chat u Feedback

ToolDescriptionScope
chat_feedback_dismissMarkja chat bħala rivedut mingħajr ma tgħaddi vot (jinneħħa mill-queue pendenti, ma jippermettix tibdel il-punteġġ tal-kunfidenza).chats:write
chat_feedback_getAċċessa reviżjoni waħda ta' chat (feedback) b'analiżi tal-AI, severità, kategorija tal-kunfidenza, bidla fil-punteġġ u s-sessjoni ta' improvement linkjata.chats:read
chat_feedback_listIlista reviżjonijiet tal-chat (rows tal-feedback) ta' chatbot b'filtru stat u counts.chats:read
chat_feedback_set_severityOverride klassifikazzjoni tas-severità (MINOR|MODERATE|MAJOR|CRITICAL) ta' chat negattiv rivedut; is-severità tipesa tnaqqis fil-punteġġ tal-kunfidenza.chats:write
chat_feedback_statsCounts tas-sessjonijiet skont bucket ta' reviżjoni għal chatbot (total, none, pending, positive, negative, reviewed, improved) — il-kards statistiċi tal-paġna tal-chats fid-dashboard.chats:read
chat_feedback_submitIvaluta sessjoni ta' chat bħala Good (isPositive=true) jew Needs Work (isPositive=false).chats:write
chat_session_getAċċessa sessjoni ta' chat bil-transkript sħiħ (per-messaġġ token/model/latency/pageUrl), dettalji tal-viżitatur, URL tal-paġna minn fejn beda, kategorija tal-kunfidenza, feedback (severità, analiżi tal-AI, sessjoni ta' improvement linkjata) u tags.chats:read
chat_session_searchFittex sessjonijiet ta' chat ta' chatbot skont kontenut tal-messaġġ u/jew email tal-viżitatur.chats:read
chat_session_set_categoryAssenja jew ibdel il-kategorija tal-kunfidenza ta' sessjoni ta' chat (tikkoreġi kategorizzazzjoni tal-AI; il-kunfidenza skont kull-kategorija tiġi rikalkulata meta l-chat jiġri rivedut).chats:write
chat_sessions_listIlista sessjonijiet ta' chat ta' chatbot, l-aktar riċenti l-ewwel, bl-istess filtri tal-queue ta' reviżjoni bħal paġna chats fid-dashboard.chats:read

Improvement Agent

ToolDescriptionScope
confidence_categories_listIlista kategoriji tal-kunfidenza ta' chatbot b'punteġġ tal-kunfidenza skont il-kategorija, count ta' reviżjonijiet u frekwenza ta' email tar-reviżjoni.chats:read
confidence_category_createOħloq kategorija tal-kunfidenza għal chatbot.chatbots:write
confidence_category_deleteĦassar kategorija tal-kunfidenza.chatbots:write
confidence_category_mergeImerge kategorija tal-kunfidenza f'oħra tal-istess chatbot: il-chats/reviews kollha jimxu lejn it-target, is-sors jinqered u l-punteġġi jiġu rikalkulati.chatbots:write
confidence_category_updateRinomina kategorija tal-kunfidenza u/jew issetja l-frekwenza tal-email tar-reviżjoni (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1-24 biss għal HOURLY).chatbots:write
confidence_status_getStatus tal-kunfidenza ta' chatbot: punteġġ, threshold tal-graduazzjoni, flag ta' fazi tat-tagħlim, comportament tal-fażi tat-tagħlim (CAUTIOUS|BALANCED|CONFIDENT) u prompt personalizzat, counts ta' reviżjonijiet u punteġġi tal-kunfidenza skont il-kategorija.analytics:read
improvement_proposal_approveAppoġġja proposta ta' improvement PENDING u applikha lill-chatbot (żieda/aġġornament ta' istruzzjoni bażika, oħloq/aġġorna FAQ jew aġġorna persona) — l-istess loġika u limiti tal-pjan kif fid-dashboard.chatbots:write
improvement_proposal_rejectIrrifjuta proposta ta' improvement PENDING.chatbots:write
improvement_proposal_simulateSimula kif il-chatbot wieġeb il-messaġġ problematiku b'proposta applikata (oriġinali vs.chatbots:write
improvement_proposals_pendingIlista proposti ta' improvement li qed jistennew reviżjoni (status PENDING) fil-kumpanija jew għal chatbot wieħed.chatbots:read
improvement_session_completeMarkja sessjoni ta' improvement bħala COMPLETED (imbagħad il-chat jgħaddi bħala Improved fil-queue ta' reviżjoni).chatbots:write
improvement_session_createIftaħ l-Improvement Agent għal chat imrated Needs Work.chatbots:write
improvement_session_getAċċessa sessjoni ta' improvement bl-oriġinali chat (messaġġi għandhom indeks 1-based usable as targetMessageIndex), konverżazzjoni tal-agent, il-proposti kollha (bil-aħħar simulazzjoni tagħhom) u simulazzjonijiet.chatbots:read
improvement_session_resetIrrestarta sessjoni ta' improvement: tħassar il-messaġġi kollha tal-agent, simulazzjonijiet u proposti PENDING/REJECTED (il-proposti applikati jibqgħu) u tibda konverżazzjoni ġdida.chatbots:write
improvement_session_send_messageIbgħat messaġġ lill-Improvement Agent (iddeskrivi x'kien ħażin fit-tweġiba tal-bot; għażilment targetMessageIndex = l-indeks 1-based tal-messaġġ tal-bot fl-originalChat.messages).chatbots:write
improvement_sessions_listIlista sessjonijiet ta' improvement (konverżazzjonijiet tal-Improvement Agent bdew minn reviżjonijiet negattivi tal-chat) għal chatbot jew il-kumpanija kollha, l-aktar riċenti l-ewwel, b'counts tal-proposti.chatbots:read
improvement_simulation_assessIvaluta riżultat ta' simulazzjoni: isApproved=true meta t-tweġiba simulata tkun tajba (il-proposta tista' mbagħad tiġi applikata), false meta teħtieġ aktar xogħol (kumment 'almost' = kważi dritt).chatbots:write

Live Chat

ToolDescriptionScope
live_chat_agents_availableAċċessa l-availability tal-live chat tal-utent kurrenti, l-aġenti li bħalissa huma disponibbli għall-live chat (heartbeat frisk, l-istess sinjal li juża l-widget) u jekk il-pjan tal-kumpanija jinkludi live chat.chats:read
live_chat_heartbeatIrfresh il-heartbeat tal-presenza tal-live chat tal-utent kurrenti (biss waqt li jkun immarkat available permezz ta' live_chat_set_availability).chats:write
live_chat_message_sendIbgħat messaġġ lill-viżitatur bħala l-aġent assenjat.chats:write
live_chat_queueAċċessa il-queue tal-live chat: sessjonijiet li qed jistennew għal aġent, l-aktar qodma l-ewwel (FIFO).chats:read
live_chat_session_assignĦu sessjoni ta' live chat WAITING mill-queue: tassenjaha lill-utent kurrenti (sid tal-kumpanija għall-API keys) u tinnotifika lill-viżitatur li l-aġent ġew.chats:write
live_chat_session_closeSpiċċa sessjoni ta' live chat bħala aġent (kull membru tal-kumpanija mhux VIEWER).chats:write
live_chat_session_getAċċessa sessjoni ta' live chat b'informazzjoni tal-viżitatur, aġent assenjat, il-messaġġi kollha u l-konverżazzjoni preċedenti tal-bot (kuntest tal-handoff).chats:read
live_chat_sessions_listIlista sessjonijiet ta' live chat (l-aktar riċenti l-ewwel; sessjonijiet WAITING l-aktar qodma l-ewwel) b'filtri opcjonali skont chatbot, status u aġent assenjat.chats:read
live_chat_set_availabilityToggle il-linja 'Available for Live Chat' tal-utent kurrenti għal kumpanija.chats:write

Leads

ToolDescriptionScope
lead_assignAssenja lead lil membru tal-kumpanija jew unassign (assignedToId: null).leads:write
lead_bulk_update_statusIssettja l-status ta' diversi leads (max 100) f'daqqa.leads:write
lead_categories_listIlista l-kategoriji tal-lead ta' chatbot b'counts ta' lead u l-membri tat-tim notifikati skont il-kategorija.leads:read
lead_category_assign_userŻid membru tal-kumpanija mal-lista tan-notifika ta' kategorija ta' lead (jew aġġorna l-flags tan-notifika tagħhom).leads:write
lead_category_createOħloq kategorija ta' lead għal chatbot.leads:write
lead_category_deleteĦassar kategorija ta' lead.leads:write
lead_category_remove_userNeħħi membru tal-kumpanija mill-lista tan-notifika ta' kategorija ta' lead.leads:write
lead_category_updateAġġorna isem, deskrizzjoni u/jew kulur ta' kategorija ta' lead.leads:write
lead_createOħloq lead manwalment (eż.leads:write
lead_deleteĦassar lead permanentement.leads:write
lead_field_config_getAċċessa konfigurazzjoni ta' catch tal-lead ta' chatbot: campi (ids jappartjenu għat-keys fi lead.data), messaġġ ta' konferma, traduzzjonijiet tal-field/UI u settings ta' rikognizzjoni tal-AI.leads:read
lead_field_config_updateAġġorna l-konfigurazzjoni ta' cattura tal-lead ta' chatbot.leads:write
lead_getAċċessa dettalji sħaħ ta' lead inkluż assignee, kategorija u sors transkript tal-chat (paginat bi messageOffset/messageLimit, default l-ewwel 20 messaġġi).leads:read
lead_listIlista leads ta' chatbot (l-aktar riċenti l-ewwel) b'filtri opcjonali skont status, kategorija, assignee u fittex test liberu (isem/email/kumpanija).leads:read
lead_statsAċċessa statistika ta' lead għal chatbot: counts skont status, leads tal-aħħar 7 ijiem u rata ta' konverżjoni (percent).leads:read
lead_updateAġġorna status, kategorija, noti, data catturata u/jew assignee ta' lead.leads:write

Forms

ToolDescriptionScope
form_createOħloq formola ta' kuntatt għal chatbot (bażiċi, campi, disinn u settings antispam f'ċajta waħda).forms:write
form_deleteĦassar permanentement formola ta' kuntatt u L-ALL sottomissjonijiet tagħha (cascade).forms:write
form_getAċċessa formola ta' kuntatt sħiħa: campi, traduzzjonijiet, styling, settings antispam, state attiv, count tas-sottomissjonijiet u l-embed script tag (embedCode).forms:read
form_listIlista l-formoli ta' kuntatt ta' chatbot b'counts tal-campi, counts tas-sottomissjonijiet u embed codes.forms:read
form_statsCounts tas-sottomissjonijiet ta' formola ta' kuntatt: total, pending, approved, spam u rejected.forms:read
form_submission_deleteĦassar permanentement sottomissjoni ta' formola ta' kuntatt (eż.forms:write
form_submission_getAċċessa sottomissjoni ta' formola ta' kuntatt sħiħa: data tal-campi sottomessi, spam score u analiżi antispam bil-AI, metadata IP/user agent/referrer u informazzjoni tar-reviżjoni.forms:read
form_submission_update_statusRivedi sottomissjoni ta' formola ta' kuntatt: issetta l-status tagħha għal APPROVED, SPAM jew REJECTED b'note ta' reviżjoni opciona.forms:write
form_submissions_listIlista s-sottomissjonijiet ta' formola ta' kuntatt, l-aktar riċenti l-ewwel, b'filtru opcjonali skont status (PENDING, APPROVED, SPAM, REJECTED) u data tal-ħolqien.forms:read
form_updateAġġorna formola ta' kuntatt: isem, deskrizzjoni, state attiv (isActive jikkontrolla jekk l-embed juri), campi (replace sħiħ), disinn (kuluri, test tal-buttuna, messaġġ ta' suċċess) u settings antispam (spamThreshold, autoRejectSpam, notificationEmail).forms:write
form_update_translationsIbdel it-traduzzjonijiet tal-field u/jew UI ta' formola ta' kuntatt.forms:write

Email Assistant

ToolDescriptionScope
email_activity_listIlista log tal-attività tal-email processjata ta' konnessjoni tal-mailbox (l-aktar riċenti l-ewwel): sender, subject, kategorija assenjata, outcome (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) u outcomeDetail.email:read
email_categories_listIlista l-kategoriji tal-email ta' konnessjoni tal-mailbox (ordered skont sortOrder).email:read
email_category_createOħloq kategorija ta' email għal konnessjoni tal-mailbox (max 20 kull konnessjoni).email:write
email_category_deleteĦassar kategorija ta' email.email:write
email_category_updateAġġorna kategorija ta' email (parzjalment: biss il-campi mogħtija jinbiddlu).email:write
email_connection_disconnectDisconnetti mailbox permanentement.email:write
email_connection_getAċċessa konnessjoni tal-mailbox inkl.email:read
email_connection_updateAġġorna konnessjoni tal-mailbox: waqqaf/irriżuma s-sync (paused true/false; biss toggles ACTIVE<->DISABLED, qatt ma jirreferixxi TOKEN_EXPIRED/ERROR), toggle reply drafting (draftingEnabled) u categorizing/organizing (organizingEnabled), repożizzjona chatbot li jqawwi (chatbotId tal-istess kumpanija) jew issetja l-signatura HTML tar-risposta (signatureHtml, max 20000 karattri; string vojta tħassarha).email:write
email_connections_listIlista konnessjonijiet tal-mailbox tal-Email Assistant tal-kumpanija (indirizz, status ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, last sync, last error, toggles drafting/organizing, chatbot li jqawwi, draftReadyCategoryCount = kategoriji li jistgħu jipproduċu drafts, baseRuleCount = regoli "Chat + Email" tal-chatbot applati għal kull draft) flimkien mal-limiti tal-pjan (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth).email:read
email_contact_deleteĦassar kuntatt tal-email maħdum (insew l-profil tal-sender, eż.email:write
email_contact_getAċċessa kuntatt tal-email maħdum b'kull fatti maħruġa, noti interni, relazzjoni, setting ta' indirizz formali/informali u statistika tal-email.email:read
email_contact_updateAġġorna kuntatt tal-email maħdum.email:write
email_contacts_listIlista kuntatti tal-email maħduma tal-kumpanija (l-iktar email reċenti l-ewwel) b'relazzjoni, indirizz formali/informali (formalAddress: true = formali 'Sie', false = informali 'Du', null = awtomatiku), count ta' fatti u preview tan-noti.email:read
email_folder_createOħloq folder tal-mail taħt inbox (jirrendiex il-preżenti jekk l-isem jintuża) biex jintuża bħala target ta' move kategorizzazzjoni.email:write
email_folders_listIlista l-folders li kategorija ta' email tista' tmove fihom il-mail, live mill-mailbox: subfolders tal-inbox, folders top-level personalizzati, archive, junk u trash (id 'deleteditems').email:read
email_general_rules_listIlista r-regoli tal-chatbot li japplikaw għal kull draft ta' risposta tal-mailbox: core instructions attivi bil-channel BOTH ("Chat + Email"), plus dawk legacy e-mail-only li għadhom mhumiex imigrati f'kategorija.email:read

Analitiċi

ToolDescriptionScope
analytics_chat_volumeVolum ta' chat (sessjonijiet bdew) matul iż-żmien għall-chart u trends: period week/month/quarter/year, granularity hour/day/week/month, għażilment għal chatbot wieħed.analytics:read
analytics_chatbot_statsPer-chatbot performance ta' kumpanija f'waħda sejħa (it-tabella tal-performance tal-chatbot fid-dashboard): id, name, slug, isActive, sessions, messages, FAQs u leads kull chatbot, ordnat skont sessions.analytics:read
analytics_formsStatistika tas-sottomissjonijiet tal-formola ta' kuntatt għal kumpanija jew chatbot wieħed (widget tal-analytics tad-dashboard): sottomissjonijiet skont status (pending/approved/rejected/spam), numru ta' formoli, total, rata ta' spam fil-percent u is-serje ta' submissions-per-day tal-aħħar 7 ijiem.analytics:read
analytics_leadsFunnel tal-lead għal kumpanija jew chatbot wieħed (widget tal-analytics tad-dashboard): leads skont status (new/contacted/qualified/converted/lost), total, rata ta' konverżjoni fil-percent u is-serje ta' leads-per-day tal-aħħar 7 ijiem.analytics:read
analytics_overviewPanoramika analitika għal kumpanija jew chatbot wieħed: chats, messages, satisfaction rate u top questions għal perjodu rolling (day/week/month/year), plus il-widget tal-overview tad-dashboard (total chatbots/published FAQs/leads, sessions today/this week/this month, leads today/this week, form submissions total/today/pending).analytics:read
dashboard_activityX'għadu jeħtieġ attenzjoni bħalissa (il-home view tad-dashboard): skont kumpanija, il-chatbots b'leads ġodda llum, suġġerimenti ta' FAQ pendenti, sottomissjonijiet ta' formoli pendenti, live chats li qed jistennew/attivi jew fazi tat-tagħlim li nħolqot.any

Eżempji ta' Workflows

Żid Istruzzjoni Bażika

Staqsi lill-assistant AI tiegħek:

"Żid istruzzjoni bażika ma' 'Support Bot' chatbot tiegħi: noffru spedizzjoni b'xejn fuq ordnijiet ta' aktar minn €50"

L-assistant se juża chatbot_add_instruction bil-parametri xierqa.

Rivedi Suġġerimenti ta' Improvement

"Uri lili l-proposti kollha ta' improvement pendenti għal chatbot tiegħi u spjega x'banedlijhom"

L-assistant se:

  1. Juża improvement_proposals_pending biex jiġbor il-proposti
  2. Janalizza u jissummarizza kull suġġeriment
  3. Japprova jew jirrifjuta fuq is-sehem tiegħek bi improvement_proposal_approve jew improvement_proposal_reject

Analiżi tal-Performance tal-Chat

"Agħti rapport ġimgħali tal-volum tal-chat u sodisfazzjon tal-klijent għall-chatbot tiegħi"

L-assistant se juża analytics_overview u analytics_chat_volume biex jikkumpila rapport komprensiv.

Importa Sit Web

"Skannja https://example.com, import it-trankazzjonijiet tal-prodott u tal-prezzijiet fil-'Support Bot' tiegħi u għidli meta l-crawl ikun lest"

L-assistant se sejjaħ crawler_preview_scan, jagħżel il-paġni rilevanti, jibda l-import bil-crawler_start u poll crawler_job_get sakemm il-job jispiċċa.

Rivedi Leads u Sottomissjonijiet ta' Formoli

"Uri lili l-leads ġodda ta' din il-ġimgħa, assenja dawk kwalifikati lil Anna u approva s-sottomissjonijiet pendenti tal-formola ta' kuntatt"

L-assistant jikkombina lead_list, lead_assign, form_submissions_list u form_submission_update_status.

Tieħu Kontroll ta' Live Chat

"Issettja lili disponibbli għall-live chat u ħu l-ikbar konverżazzjoni li qed tistenna"

L-assistant juża live_chat_set_availability, live_chat_queue u live_chat_session_assign; ir-risposti jgħaddu permezz ta' live_chat_message_send.

Sigurtà

  • Iż-keys tal-API huma skopjati lill-kumpanija tiegħek u għall-permessi li tagħżel waqt il-ħolqien tagħhom (ara l-kolonna Scope hawn fuq)
  • Iż-keys jeżegwixxu bil-permessi tas-sid tal-kumpanija; limiti tal-pjan u feature gates japplikaw eżattament bħal fil-dashboard
  • Iż-keys jistgħu jiġu revokati fi kwalunkwe ħin mid-dashboard
  • Aċċess tal-API huwa disponibbli fuq pjanijiet imħallsa — ara l-Pricing page

Troubleshooting

Konnessjoni Falliet

  1. Iċċekkja li l-API key tiegħek hija korretta
  2. Iċċekkja li l-key ma ġiex revokat
  3. Kun żgur li l-pjan tiegħek jinkludi aċċess għall-API
  4. Irrestarta l-MCP client tiegħek

Għodda Ma Nsibx

Irrestarta l-MCP client tiegħek wara li tbiddel il-konfigurazzjoni sabiex jerġa' jħaddem l-għodod disponibbli. Ismijiet tal-għodod huma bil-lowercase b'undelines (eż., faq_list).


Teħtieġ għajnuna? Ikkuntattja lit-tim ta' support →