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
- Mur fil-Dashboard → Kumpanija → API tab
- Ikklikkja Oħloq Ċavetta API
- Agħti isem deskrittiv għall-key tiegħek (per eż., "Claude Desktop") u agħżel mill-inqas permess wieħed
- 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
| Tool | Description | Scope |
|---|---|---|
account_usage_get | Aċċ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_companies | Ilista 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_read | Markja waħda minn notifikazzjonijiet l-utent kurrenti bħala mqarra. | any |
user_notification_preferences_get | Aċċ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_update | Aġġorna l-preferenzi globali tan-notifika tal-utent kurrenti (toggles email/push, skeda tad-digest, ħinijiet tal-paċi). | any |
user_notification_type_setting_update | Enable jew disable il-kunsinna bl-email / in-app għal tip wieħed ta' notifika tal-utent kurrenti (eż. | any |
user_notification_types_list | Ilista t-tipi kollha tan-notifika maqsuma skont kategorija (chatbot, leads, live chat, knowledge, team, billing). | any |
user_notification_unread_count | Aċċessa n-numru tan-notifikazzjonijiet mhux mqarra tal-utent kurrenti. | any |
user_notifications | Ilista n-notifikazzjonijiet tal-utent kurrenti, l-aktar riċenti l-ewwel, bil-pagination tal-cursor. | any |
user_notifications_delete_old | Housekeeping: tħassar permanentement in-notifikazzjonijiet tal-utent kurrenti li diġà ġew mqarra u huma aktar minn 30 jum. | any |
user_notifications_mark_all_read | Markja l-notifikazzjonijiet kollha tal-utent kurrenti bħala mqarra. | any |
user_profile | Aċċessa l-profil tal-utent kurrenti (id, isem, email, rwol, tier tas-subscription). | any |
Kumpanija u Tim
| Tool | Description | Scope |
|---|---|---|
company_chatbots_list | Ilista l-chatbots kollha għal kumpanija speċifika b'statistiċi sommarji. | chatbots:read |
company_get | Aċċessa informazzjoni dettaljata dwar kumpanija: profil, sid, settings tal-marka (kuluri, email tan-notifika) u counts. | any |
company_invite_cancel | Ikkanċella (tħassar) stedina tat-tim biex il-link ma jibqax jaħdem. | company:write |
company_invite_resend | Iritorna 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_list | Ilista stedina tat-tim ta' kumpanija (pendenti b'mod default; issetta includeExpired biex tirritorna wkoll dawk skaduti). | company:read |
company_list | Ilista 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_remove | Neħħi l-logo tal-kumpanija (tħassar l-immaġni maħżuna u tħassar il-URL tal-logo). | company:write |
company_member_invite | Issedna membru tat-tim bl-email bi rwol (ADMIN, MANAGER, AGENT jew VIEWER). | company:write |
company_member_remove | Neħħi membru tat-tim mill-kumpanija. | company:write |
company_member_update_role | Ibdel ir-rwol ta' membru tat-tim (ADMIN, MANAGER, AGENT jew VIEWER). | company:write |
company_members_list | Ilista l-membri ta' kumpanija bil-ruoli tagħhom (OWNER, ADMIN, MANAGER, AGENT, VIEWER). | any |
company_settings_update | Aġġorna settings tal-marka tal-kumpanija: primaryColor / secondaryColor (#RRGGBB) u l-notificationEmail għal reviżjonijiet tal-chat. | company:write |
company_update | Aġġ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
| Tool | Description | Scope |
|---|---|---|
chatbot_add_instruction | Żid istruzzjoni bażika ġdida ma' chatbot (1-5000 karattri). | chatbots:write |
chatbot_confirm_embed | Markja chatbot bħala embedded fuq is-sit (jaħbi r-rimarka tas-setup fid-dashboard). | chatbots:write |
chatbot_create | Oħ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_get | Aċċ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_code | Aċċessa l-HTML snippet biex tinstalla chatbot fuq sit (URL tal-script + <script> tag) u jekk l-embed ġie kkonfermat. | chatbots:read |
chatbot_get_instructions | Aċċessa l-istruzzjonijiet bażiċi kollha għal chatbot. | chatbots:read |
chatbot_improve_instructions | Rewrite test ta' istruzzjoni bażika bl-AI tal-pjattaforma (l-istess bħal 'Improve with AI' fid-dashboard). | chatbots:write |
chatbot_learning_phase_get | Aċċ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_update | Issettja 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_list | Ilista l-chatbots kollha li l-utent għandu aċċess għalihom, b'statistiċi sommarji. | chatbots:read |
chatbot_reorder_instructions | Issettja l-ordni tal-istruzzjonijiet bażiċi ta' chatbot. | chatbots:write |
chatbot_templates_list | Ilista 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_active | Attiva jew ddeattiva chatbot. | chatbots:write |
chatbot_toggle_learning | End (false) jew jerġa' jippermetti (true) il-fażi tat-tagħlim tal-chatbot. | chatbots:write |
chatbot_update | Aġġ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_instruction | Aġġorna istruzzjoni bażika eżistenti (content, isActive, channel, sortOrder). | chatbots:write |
chatbot_update_personality | Aġġ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_get | Aċċessa settings kurrenti tal-widget għal chatbot (apparenza kollha, branding, comportament u campi tal-formola qabel il-chat). | chatbots:read |
widget_settings_update | Aġġorna l-chat widget ta' chatbot: pożizzjoni (inkl. | chatbots:write |
widget_translations_get | Aċċessa t-traduzzjonijiet tal-widget skont kull-lingwa ta' chatbot: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }. | chatbots:read |
widget_translations_update | Issettja traduzzjonijiet tal-widget skont lingwa. | chatbots:write |
Knowledge Base
| Tool | Description | Scope |
|---|---|---|
crawler_job_cancel | Ikanċella xogħol ta' crawl li huwa PENDING jew RUNNING; il-paġni li jifdal jitħallew barra. | knowledge:write |
crawler_job_get | Aċċessa l-istatus ta' xogħol ta' crawl, progress (pagesCrawled/pagesFound, tokensUsed) u l-istatus ta' kull paġna. | knowledge:read |
crawler_jobs_list | Ilista xogħlijiet ta' crawl ta' chatbot (l-aktar riċenti l-ewwel) bl-istatus u progress. | knowledge:read |
crawler_limits | Aċċ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_scan | Skannja sit web u lista l-paġni li jistgħu jiġu crawled (url, title, isRecommended) mingħajr ma timporta xejn. | knowledge:write |
crawler_start | Ibda 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_url | Niżż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_get | Aċċ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_list | Ilista 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_add | Crawl 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_get | Aċċ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_recrawl | Erġ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_list | Ilista 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_stats | Panoramika 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_recrawl | Erġ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_cancel | Ikanċ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_list | Ilista 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.
| Tool | Description | Scope |
|---|---|---|
price_list | Paġina permezz ta' price heads u eligibility tal-verżjoni approvata separata. | prices:read |
price_get | Aqra state kompleta tal-oġġett u reviżjonijiet. | prices:read |
price_detail | Aqra dettalji tal-oġġett b'historja ta' reviżjonijiet paginata. | prices:read |
price_suggestions_list | Paġina permezz ta' suġġerimenti ta' prezz. | prices:read |
price_create | Oħroġ draft b'ID tal-oġġett ġenerat mis-server. | prices:write |
price_edit | Oħloq draft ġdid minn verżjoni eżpressament mistenni tal-oġġett. | prices:write |
price_import_csv | Importa drafts b'format esplicitu u import ID stabbli għal retries sikuri. | prices:write |
price_suggestion_apply | Applika s-suġġeriment magħżul bħala draft. | prices:write |
price_approve | Appoġġa verżjoni eżpressament mistenni tal-oġġett. | prices:approve |
price_approve_many | Appoġġa selezzjoni ta' ID/verżjoni esplicita atomikament; kwalunkwe verżjoni stalja tirrifjuta s-selezzjoni kollha. | prices:approve |
price_archive | Arkivja 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
| Tool | Description | Scope |
|---|---|---|
faq_cache_purge | Ħassar id-data cached tal-widget tal-FAQ fuq is-siti CMS konnessi kollha (plugin WordPress). | faqs:write |
faq_categories_list | Ilista l-kategoriji tal-FAQ ta' chatbot bl-għadd ta' FAQs, slugs, modalità ta' sort u traduzzjonijiet. | faqs:read |
faq_categories_reorder | Issettja l-ordni tal-kategoriji tal-FAQ fil-widget: il-pożizzjoni f'categoryIds issir sortOrder. | faqs:write |
faq_category_create | Oħ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_update | Ibdel it-traduzzjonijiet ta' kategorija ta' FAQ, eż. | faqs:write |
faq_category_update | Rinomina kategorija ta' FAQ jew ibdel id-deskrizzjoni, l-ikona jew il-modalità tas-sort. | faqs:write |
faq_create | Oħ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_get | Aċċ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_get | Aċċ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_list | Ilista FAQs ta' chatbot (uża chatbot_list biex issib chatbotId). | faqs:read |
faq_reorder | Issettja l-ordni tal-wiri tal-FAQs fil-widget. | faqs:write |
faq_suggestion_approve | Approva 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_get | Aċċ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_reject | Irrifjuta 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_list | Ilista suġġerimenti ta' FAQ ġenerati mill-AI ta' chatbot (minn konversazzjonijiet jew faq_suggestions_generate). | faqs:read |
faq_translate | Traduzzjoni 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_update | Ssejvja traduzzjonijiet ta' FAQ skont lingwa, eż. | faqs:write |
faq_update | Aġġorna domanda, tweġiba, kategorija, state ta' pubblikazzjoni jew ordni manwali ta' FAQ. | faqs:write |
faq_widget_settings_get | Aċċ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_update | Aġġ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
| Tool | Description | Scope |
|---|---|---|
chat_feedback_dismiss | Markja 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_get | Aċċ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_list | Ilista reviżjonijiet tal-chat (rows tal-feedback) ta' chatbot b'filtru stat u counts. | chats:read |
chat_feedback_set_severity | Override klassifikazzjoni tas-severità (MINOR|MODERATE|MAJOR|CRITICAL) ta' chat negattiv rivedut; is-severità tipesa tnaqqis fil-punteġġ tal-kunfidenza. | chats:write |
chat_feedback_stats | Counts 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_submit | Ivaluta sessjoni ta' chat bħala Good (isPositive=true) jew Needs Work (isPositive=false). | chats:write |
chat_session_get | Aċċ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_search | Fittex sessjonijiet ta' chat ta' chatbot skont kontenut tal-messaġġ u/jew email tal-viżitatur. | chats:read |
chat_session_set_category | Assenja 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_list | Ilista 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
| Tool | Description | Scope |
|---|---|---|
confidence_categories_list | Ilista 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_create | Oħloq kategorija tal-kunfidenza għal chatbot. | chatbots:write |
confidence_category_delete | Ħassar kategorija tal-kunfidenza. | chatbots:write |
confidence_category_merge | Imerge 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_update | Rinomina 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_get | Status 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_approve | Appoġġ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_reject | Irrifjuta proposta ta' improvement PENDING. | chatbots:write |
improvement_proposal_simulate | Simula kif il-chatbot wieġeb il-messaġġ problematiku b'proposta applikata (oriġinali vs. | chatbots:write |
improvement_proposals_pending | Ilista proposti ta' improvement li qed jistennew reviżjoni (status PENDING) fil-kumpanija jew għal chatbot wieħed. | chatbots:read |
improvement_session_complete | Markja sessjoni ta' improvement bħala COMPLETED (imbagħad il-chat jgħaddi bħala Improved fil-queue ta' reviżjoni). | chatbots:write |
improvement_session_create | Iftaħ l-Improvement Agent għal chat imrated Needs Work. | chatbots:write |
improvement_session_get | Aċċ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_reset | Irrestarta 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_message | Ibgħ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_list | Ilista 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_assess | Ivaluta 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
| Tool | Description | Scope |
|---|---|---|
live_chat_agents_available | Aċċ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_heartbeat | Irfresh 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_send | Ibgħat messaġġ lill-viżitatur bħala l-aġent assenjat. | chats:write |
live_chat_queue | Aċċ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_close | Spiċċa sessjoni ta' live chat bħala aġent (kull membru tal-kumpanija mhux VIEWER). | chats:write |
live_chat_session_get | Aċċ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_list | Ilista 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_availability | Toggle il-linja 'Available for Live Chat' tal-utent kurrenti għal kumpanija. | chats:write |
Leads
| Tool | Description | Scope |
|---|---|---|
lead_assign | Assenja lead lil membru tal-kumpanija jew unassign (assignedToId: null). | leads:write |
lead_bulk_update_status | Issettja l-status ta' diversi leads (max 100) f'daqqa. | leads:write |
lead_categories_list | Ilista 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_create | Oħloq kategorija ta' lead għal chatbot. | leads:write |
lead_category_delete | Ħassar kategorija ta' lead. | leads:write |
lead_category_remove_user | Neħħi membru tal-kumpanija mill-lista tan-notifika ta' kategorija ta' lead. | leads:write |
lead_category_update | Aġġorna isem, deskrizzjoni u/jew kulur ta' kategorija ta' lead. | leads:write |
lead_create | Oħloq lead manwalment (eż. | leads:write |
lead_delete | Ħassar lead permanentement. | leads:write |
lead_field_config_get | Aċċ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_update | Aġġorna l-konfigurazzjoni ta' cattura tal-lead ta' chatbot. | leads:write |
lead_get | Aċċ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_list | Ilista 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_stats | Aċċ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_update | Aġġorna status, kategorija, noti, data catturata u/jew assignee ta' lead. | leads:write |
Forms
| Tool | Description | Scope |
|---|---|---|
form_create | Oħ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_get | Aċċ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_list | Ilista l-formoli ta' kuntatt ta' chatbot b'counts tal-campi, counts tas-sottomissjonijiet u embed codes. | forms:read |
form_stats | Counts 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_get | Aċċ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_status | Rivedi 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_list | Ilista 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_update | Aġġ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_translations | Ibdel it-traduzzjonijiet tal-field u/jew UI ta' formola ta' kuntatt. | forms:write |
Email Assistant
| Tool | Description | Scope |
|---|---|---|
email_activity_list | Ilista 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_list | Ilista l-kategoriji tal-email ta' konnessjoni tal-mailbox (ordered skont sortOrder). | email:read |
email_category_create | Oħ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_update | Aġġorna kategorija ta' email (parzjalment: biss il-campi mogħtija jinbiddlu). | email:write |
email_connection_disconnect | Disconnetti mailbox permanentement. | email:write |
email_connection_get | Aċċessa konnessjoni tal-mailbox inkl. | email:read |
email_connection_update | Aġġ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_list | Ilista 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_get | Aċċ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_update | Aġġorna kuntatt tal-email maħdum. | email:write |
email_contacts_list | Ilista 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_create | Oħ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_list | Ilista 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_list | Ilista 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
| Tool | Description | Scope |
|---|---|---|
analytics_chat_volume | Volum 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_stats | Per-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_forms | Statistika 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_leads | Funnel 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_overview | Panoramika 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_activity | X'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:
- Juża
improvement_proposals_pendingbiex jiġbor il-proposti - Janalizza u jissummarizza kull suġġeriment
- Japprova jew jirrifjuta fuq is-sehem tiegħek bi
improvement_proposal_approvejewimprovement_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
- Iċċekkja li l-API key tiegħek hija korretta
- Iċċekkja li l-key ma ġiex revokat
- Kun żgur li l-pjan tiegħek jinkludi aċċess għall-API
- 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 →