BaileDoiciméadú

MCP Server Integration

Cuireann ChatReact an Model Context Protocol (MCP) i bhfeidhm, rud a cheadaíonn duit do chuntas ChatReact a nascadh le cúntóirí AI mar Claude Desktop, Cursor, agus uirlisí eile comhoiriúnach MCP.

Cad é MCP?

Is caighdeán oscailte é an Model Context Protocol a chuireann ar chumas cúntóirí AI idirghníomhú le seirbhísí seachtracha agus foinsí sonraí. Le hionchuinge ChatReact ar MCP, is féidir leat:

  • Bainistiú chatbot — cruthaigh, cumraigh (pearsona, teangacha, widget, iompar, srianta), ionchlannú agus scrioschatbots
  • Tóg an bhonn eolais — cuir doiciméid leis, crawl suíomhanna gréasáin, bainistiú leathanach a chraolaíodh agus treoracha croí
  • Bainistiú FAQs — FAQs, catagóirí, moltaí, aistriúcháin agus an widget FAQ
  • Athbhreithniú comhráite — rátáil comhráite, catagóirí muiníne a leithdháileadh, an Gníomhaire Feabhsúcháin a rith
  • Oibriú le luaidhe agus foirmeacha — luaidhe, catagóirí luaidhe, socruithe ghabhdála, foirmeacha teag contact agus cúrsálacha
  • Gníomhú mar ghníomhairí comhrá beo — socraigh do infhaighteacht, glac le comhráite atá ag fanacht, freagair agus dún seisiúin
  • Riar do chomhlacht — próifíl, dathanna branda, baill foirne agus cuireadh
  • Úsáid an Email Assistant — nascanna bosca poist, catagóirí, teagmhálaithe agus gníomhaíocht
  • Léigh anailísíocht agus fógraí

Is féidir gach rud is féidir leat a dhéanamh sa dashboard a dhéanamh trí MCP (agus an REST API); ní fanann ach gníomhartha a cheanglaíonn ar an mbrabhsálaí amhail íocaíochtaí, OAuth bosca poist, passkeys, scriosadh cuntais agus bainistíocht eochracha API sa dashboard.

Tús a chur

1. Gineadh Eochair API

  1. Téigh go dtí do Painéal → Cuideachta → API cluaisín
  2. Cliceáil Cruthaigh Eochair API
  3. Tabhair ainm tuairisciúil don eochair (m.sh. "Claude Desktop") agus roghnaigh ar a laghad ceadúnas amháin
  4. Cóipeáil an eochair ghiniúna (tosaíonn sé le cr_)

Tá eochracha API ar fáil ar phleananna íoctha — féach ar ár leathanach Praghsála.

Stóráil do eochair API go slán. Ní féidir í a aisghabháil tar éis a cruthaithe.

2. Cumraigh Do Chliaint MCP

Tá freastalaí MCP ChatReact óstáilte ag https://www.chatreact.ai/api/mcp agus cumarsáideann sé thar HTTP (JSON-RPC). Déan údarú le ceannlíne Authorization: Bearer — glacfar freisin le ceannlíne X-API-Key leis an eochair chéanna.

Cursor IDE

Tacaíonn Cursor le freastalaithe MCP iargúlta go díreach. Cuir leis do shocruithe MCP Cursor:

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

Claude Desktop

Tacaíonn comhad cumraíochta Claude Desktop le freastalaithe bunaithe ar ordú, mar sin bain úsáid as an droichead caighdeánach mcp-remote chun nasc a dhéanamh leis an deireadh óstáilte:

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

Éilíonn an socrú seo Node.js a bheith suiteáilte. Úsáideann an sampla an ceannlíne X-API-Key mar gheall ar nach bhfuil roinnt cliant in ann spásanna i argóintí a láimhseáil go iontaofa.

3. Athchealraigh Do Chúnntóir AI

Tar éis an chumraíocht a shábháil, athchealraigh Claude Desktop nó Cursor chun an nasc a bhunú.

Uirlisí atá ar Fáil

Nochtann MCP ChatReact na huirlisí thíos, grúpáilte de réir réimse. Taispeánann colún an Scope an ceadúnas eochair API a éilíonn uirlis (any = gach eochair bailí). Rithfidh uirlisí leis na ceadanna i bhfeidhm chéanna, teorainneacha plean agus éifeachtaí taobh a bhíonn i bhfeidhm ar oibríochtaí an dashboard. Fanann sreafaí íocaíochta, údarú bosca poist, passkey, scriosadh cuntais agus bainistíocht eochracha a shaincheapadh sa dashboard.

Iarrann uirlisí dochracha (scrios, athshocraigh, dún, comhcheangail) deimhniú nuair a úsáidtear iad trí Dashboard Assistant. Trí eochair API a úsáideann siad láithreach.

Cuntas

ToolDescriptionScope
account_usage_getFaigh an plean reatha (sraith, stádas), comptóirí úsáide thréimhse billeála reatha (comhlachtaí, chatbots, baill foirne, comhráite, tiontaí) agus teorainneacha an phlean, chomh maith leis na teorainneacha agus bratacha gné éifeachtacha an chomhlachta atá scóipithe don ghlao.any
user_companiesLiostaigh gach comhlacht atá rochtain ag an úsáideoir reatha orthu, le ról an úsáideora i ngach ceann.any
user_notification_mark_readMarcáil ceann de fhógraí an úsáideora reatha mar léite.any
user_notification_preferences_getFaigh roghanna fógraíochta an úsáideora reatha: lascáin ríomhphoist/pressa domhanda, min rithe digear/time/weekday/timezone, uaireanta ciúine agus socruithe chanála in aghaidh an chine.any
user_notification_preferences_updateNuashonraigh roghanna fógraíochta domhanda an úsáideora reatha (lascáin ríomhphoist/pressa, sceideal digear, uaireanta ciúine).any
user_notification_type_setting_updateCumasaigh nó díghníomhachtaigh seachdelivery ríomhphoist / in-app do chine amháin fógra den úsáideoir reatha (m.sh.any
user_notification_types_listLiostaigh gach cine fógra grúpáilte de réir catagóire (chatbot, luaidhe, comhrá beo, eolas, foireann, billeáil).any
user_notification_unread_countFaigh líon na bhfógraí neamhléite don úsáideoir reatha.any
user_notificationsLiostaigh fógraí an úsáideora reatha, is nuaí ar dtús, le págiú cursor.any
user_notifications_delete_oldBainistíocht: scrios go buan fógraí an úsáideora reatha atá léite cheana agus níos sine ná 30 lá.any
user_notifications_mark_all_readMarcáil gach fógra an úsáideora reatha mar léite.any
user_profileFaigh próifíl an úsáideora reatha (id, ainm, ríomhphost, ról, sraith síntiúis).any

Comhlacht & Foireann

ToolDescriptionScope
company_chatbots_listLiostaigh gach chatbot do chomhlacht sonrach le staitisticí achoimre.chatbots:read
company_getFaigh sonraí mionsonraithe faoi chomhlacht: próifíl, úinéir, socruithe branda (dathanna, ríomhphost fógraíochta) agus comptóirí.any
company_invite_cancelCealaigh (scrios) cuireadh foirne ionas nach n-oibreodh an nasc a thuilleadh.company:write
company_invite_resendSeol cuireadh foirne atá ar feitheamh arís: táirgeann sé token nua, síneann sé an éagtha trí 7 lá agus seolann sé r-phost an chuiúide arís.company:write
company_invites_listLiostaigh cuidiúcháin foirne comhlachta (ar feitheamh de réir réamhshocraithe; socraigh includeExpired chun iad atá éagtha a thabhairt ar ais freisin).company:read
company_listLiostaigh gach comhlacht atá rochtain ag an úsáideoir orthu (feiceann eochracha API agus Dashboard Assistant a gcomhlacht féin amháin).any
company_logo_removeBain lógó an chomhlachta (scriosann sé an íomhá stóráilte agus glanann sé an URL lógó).company:write
company_member_inviteCuireadh ball foirne trí r-phost le ról (ADMIN, MANAGER, AGENT nó VIEWER).company:write
company_member_removeBain ball foirne den chomhlacht.company:write
company_member_update_roleAthraigh ról ball foirne (ADMIN, MANAGER, AGENT nó VIEWER).company:write
company_members_listLiostaigh baill chomhlachta lena róil (OWNER, ADMIN, MANAGER, AGENT, VIEWER).any
company_settings_updateNuashonraigh socruithe branda an chomhlachta: primaryColor / secondaryColor (#RRGGBB) agus an notificationEmail do athbhreithnithe comhrá.company:write
company_updateNuashonraigh próifíl an chomhlachta: ainm (2-100 carachtar), cur síos (uasmhéid 1000 carachtair) nó suíomh gréasáin (cuirtear https:// leis go huathoibríoch; pasáil stríng fhánach chun suíomh/cur síos a ghlanadh).company:write

Bainistíocht Chatbot

ToolDescriptionScope
chatbot_add_instructionCuir treoir chroí nua le chatbot (1-5000 carachtar).chatbots:write
chatbot_confirm_embedMarcáil chatbot mar ionchlannaithe ar an suíomh (folach an cuimhneachán socraithe sa dashboard).chatbots:write
chatbot_createCruthaigh chatbot nua (cosúil leis an draoi sa dashboard).chatbots:write
chatbot_deleteScrios chatbot go buan le gach a FAQs, doiciméid, comhráite, luaidhe agus foirmeacha (ní féidir é a aisiompú).chatbots:write
chatbot_delete_instructionScrios treoir chroí ó chatbot.chatbots:write
chatbot_getFaigh faisnéis mhionsonraithe faoi chatbot: socruithe ginearálta, pearsantacht (pearsona, tonality, teangacha, srianta), socruithe widget, comhrá beo, céim foghlama, stádas ionchlannaithe agus comptóirí.chatbots:read
chatbot_get_embed_codeFaigh an slisnigh HTML chun chatbot a shuiteáil ar shuíomh (URL script + <script> tag) agus an bhfuil an ionchlannú dearbhaithe.chatbots:read
chatbot_get_instructionsFaigh na treoracha croí go léir do chatbot.chatbots:read
chatbot_improve_instructionsAthscríobh téacs treorach chroí le feabhsóir AI an ardáin (mar an "Improve with AI" sa dashboard).chatbots:write
chatbot_learning_phase_getFaigh socruithe céim foghlama chatbot: réamhshocraíocht iompair (CAUTIOUS, BALANCED, CONFIDENT), spreagadh saincheaptha agus an bhfuil an bot fós i gcéim foghlama.chatbots:read
chatbot_learning_phase_updateSocraigh réamhshocraíocht iompair céim foghlama (CAUTIOUS = tagair do dhuine nuair nach bhfuil cinnte, BALANCED, CONFIDENT) agus/nó spreagadh céim foghlama saincheaptha.chatbots:write
chatbot_listLiostaigh gach chatbot atá rochtain ag an úsáideoir orthu, le staitisticí achoimre.chatbots:read
chatbot_reorder_instructionsSocraigh ordú treoracha croí chatbot.chatbots:write
chatbot_templates_listLiostaigh na téamaí chatbot (réamhshocruithe do persona, tonality, teachtaireachtaí agus iompar widget) ar féidir iad a pasáil mar templateId chuig chatbot_create, agus an bhféadfaidh plean an chomhlachta iad a úsáid.chatbots:read
chatbot_toggle_activeGníomhachtaigh nó díghníomhachtaigh chatbot.chatbots:write
chatbot_toggle_learningCríochnaigh (false) nó cuir ar ais (true) céim foghlama chatbot.chatbots:write
chatbot_updateNuashonraigh socruithe ginearálta chatbot: ainm, cur síos, isActive, comhrá beo (liveChatEnabled/liveChatMode, gné plean), showBranding (pleananna white-label), ríomhphoist athbhreithnithe comhrá, giniúint FAQ uathoibríoch, téacs treoracha croí oidhreachta, céim foghlama (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt).chatbots:write
chatbot_update_instructionNuashonraigh treoir chroí atá ann cheana (ábhar, isActive, channel, sortOrder).chatbots:write
chatbot_update_personalityNuashonraigh pearsantacht chatbot: persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), sleamhnáin tonality 1-5, teangacha (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), teachtaireachtaí (welcomeMessage, fallbackMessage, proactive greeting) agus srianta (blacklistTopics, complianceRules, maxResponseLength, human handoff).chatbots:write
widget_settings_getFaigh socruithe reatha an widget do chatbot (gach cuma, branda, iompair agus réimsí foirm réamh-chomhrá).chatbots:read
widget_settings_updateNuashonraigh an widget comhrá do chatbot: suíomh (incl.chatbots:write
widget_translations_getFaigh na haistriúcháin widget in aghaidh teanga do chatbot: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }.chatbots:read
widget_translations_updateSocraigh aistriúcháin widget in aghaidh teanga.chatbots:write

Bonn Eolais

ToolDescriptionScope
crawler_job_cancelCealú post crawl PENDING nó RUNNING; ní dhéanfar na leathanaigh fágtha a phróiseáil.knowledge:write
crawler_job_getFaigh stádas post crawl, dul chun cinn (pagesCrawled/pagesFound, tokensUsed) agus stádas gach leathanach.knowledge:read
crawler_jobs_listLiostaigh poist crawl chatbot (is nuaí ar dtús) le stádas agus dul chun cinn.knowledge:read
crawler_limitsFaigh teorainneacha crawl an phlean do chatbot (uasmhéid leathanach in aghaidh crawl, token in aghaidh leathanach, crawls in aghaidh na míosa) agus an féidir crawl nua a thosú an mhí seo.knowledge:read
crawler_preview_scanScan suíomh gréasáin agus liostaigh a leathanaigh crawlable (url, teideal, isRecommended) gan aon rud a iompórtáil.knowledge:write
crawler_startTosaigh post crawl a iompraíonn na URLanna roghnaithe isteach i mbonn eolais an chatbot (próiseáilte sa chúlra; poll crawler_job_get).knowledge:write
knowledge_document_add_from_urlÍoslódáil doiciméad (PDF, TXT, MD, CSV, JSON, DOCX; uasmhéid 10 MB) ó URL http(s) poiblí agus cuir isteach i mbonn eolais chatbot.knowledge:write
knowledge_document_add_textCuir doiciméad téacs nó markdown le mbonn eolais chatbot ó ábhar inline (uasmhéid 10 MB).knowledge:write
knowledge_document_deleteScrios doiciméad uaslódáilte ón mbun eolais.knowledge:write
knowledge_document_getFaigh sonraí do dhoiciméad uaslódáilte lena stádas próiseála, teachtaireacht earráide agus URL íoslódála sealadach.knowledge:read
knowledge_documents_listLiostaigh na doiciméid uaslódáilte (PDF, TXT, MD, CSV, JSON, DOCX) i mbonn eolais chatbot le stádas agus méid.knowledge:read
knowledge_page_addCrawl URL aonair agus cuir isteach i mbonn eolais chatbot (teipíonn le CONFLICT nuair atá an URL innéacsaithe cheana, FORBIDDEN nuair a shroicheann an teorainn token).knowledge:write
knowledge_page_deleteScrios leathanach a craoladh ón mbun eolais (bainfidh sé a chomhad stór stór veicteoir).knowledge:write
knowledge_page_getFaigh leathanach a craoladh lena ábhar markdown a innéacsadh don chatbot (úsáideach chun a fhíorú cad atá ar eolas ag an bot faoi leathanach).knowledge:read
knowledge_page_recrawlFaigh leathanach a craoladh arís agus cuir ina áit a ábhar innéacsaithe (m.sh.knowledge:write
knowledge_pages_deleteScrios roinnt leathanach a craoladh de chatbot in aon uair.knowledge:write
knowledge_pages_listLiostaigh leathanach a craoladh i mbonn eolais chatbot, scagtha go roghnach de réir fearann, stádas nó téarma cuardaigh (URL/teideal).knowledge:read
knowledge_statsForbhreathnú ar bhonn eolais chatbot: doiciméid (de réir stádas, méid), leathanach a craoladh agus suíomhanna gréasáin (de réir stádas), poist crawl, treoracha croí roinnte de réir foinse (láimhe vs gníomhaire feabhsúcháin), FAQs, stádas/méid stór veicteoir agus úsáid stórála vs.knowledge:read
knowledge_website_deleteScrios gach leathanach a craoladh de shuíomh (fearann) ón mbun eolais chatbot.knowledge:write
knowledge_website_recrawlAthchraolaigh gach leathanach de shuíomh (fearann) i mbonn eolais chatbot chun a ábhar a athnuachan.knowledge:write
knowledge_website_recrawl_cancelCealú athchraoladh suíomh i mbun próiseála: filltear leathanaigh sanárthaithe (PENDING) ar a stádas innéacsaithe roimhe.knowledge:write
knowledge_websites_listLiostaigh na suíomhanna gréasáin (fearainn) atá leathanacha iontu i mbonn eolais chatbot, le comhaireamh leathanaigh de réir stádas agus suimhní token.knowledge:read

Bainistíocht Praghais

Bainistíonn na huirlisí seo dréachtpraghsanna struchtúrtha agus faomhadh soiléir. Is rud ar leith é dréacht a shábháil ó fhomhadh an leagan cruinn; tá incháilitheacht ag brath freisin ar stádas agus bailíocht. Ní fhaigheann eochracha API atá ann cheana ceadanna praghais go huathoibríoch. Ní féidir prices:write nó prices:approve a thabhairt ach ag úinéir an chomhlachta. Rithfidh glaonna le eochair API láithreach, mar sin déan an ionchur cruinn a athbhreithniú sula nglaoimid ar athrú. Féach Prices & services don shruth oibre custaiméara.

ToolDescriptionScope
price_listLeathanaigh ceannas praghais agus iarmhéid incháilitheachta leagan faofa.prices:read
price_getLéigh staid iomlán mír agus athruithe.prices:read
price_detailLéigh sonraí mír le stair athruithe páidiúnaithe.prices:read
price_suggestions_listLeathanaigh moltaí praghais.prices:read
price_createCruthaigh dréacht le ID mír ginte ón bhfreastalaí.prices:write
price_editCruthaigh dréacht nua ó leagan mír beartaithe go soiléir.prices:write
price_import_csvIompórtáil dréachtanna le formáid shoiléir agus ID iompórtála seasta le haghaidh athghlaonna sábháilte.prices:write
price_suggestion_applyCuir an moladh tosaíochta roghnaithe i bhfeidhm mar dréacht.prices:write
price_approveFaomh leagan mír beartaithe go soiléir amháin.prices:approve
price_approve_manyFaomh roghnú ID/leagan soiléir go hadanach; diúltaítear don rogha iomlán má tá leagan seanbhailithe ann.prices:approve
price_archiveAchar mír ag a leagan beartaithe go soiléir a chartlannú.prices:approve

Coinnítear eagarthóireachtaí dréachta an leagan faofa roimhe. Ní mór foirmát CSV agus scaradóir deachúlach a bheith soiléir; éilítear ID iompórtála nua má athraíonn ábhar CSV. Tá gach oibríocht nasctha le comhlacht na heochair API agus an chatbot sonraithe.

Bainistíocht FAQ

ToolDescriptionScope
faq_cache_purgeGlan sonraí taisce widget FAQ ar gach suíomh CMS nasctha (breiseán WordPress).faqs:write
faq_categories_listLiostaigh catagóirí FAQ chatbot le comhaireamh FAQ, slugs, mód eagar agus aistriúcháin.faqs:read
faq_categories_reorderSocraigh ord FAQ catagóirí sa widget: éireoidh suíomh i categoryIds mar sortOrder.faqs:write
faq_category_createCruthaigh catagóir FAQ do chatbot (gintear slug ón ainm).faqs:write
faq_category_deleteScrios catagóir FAQ.faqs:write
faq_category_translations_updateAthsholáthar aistriúcháin catagóir FAQ, m.sh.faqs:write
faq_category_updateAthainmníonn catagóir FAQ nó athraigh a cur síos, deilbhín nó mód eagar.faqs:write
faq_createCruthaigh FAQ do chatbot.faqs:write
faq_deleteScrios FAQ go buan (bainfidh sé é freisin as bonn eolais an chatbot agus glanfaidh sé taiscí widget CMS).faqs:write
faq_embed_code_getFaigh slisnigh ionchlannaithe do widget FAQ: tag script, shortcode WordPress agus snippet Shopify Liquid, chomh maith le éagsúlachtaí in aghaidh catagóire (úsáid categorySlug ó faq_categories_list chun catagóir amháin a ionchlannú).chatbots:read
faq_getFaigh na sonraí iomlána de FAQ: ceist, freagra, catagóir, stádas foilseacháin, ord eagar, aistriúcháin, réimsí SEO agus staitisticí aiseolais.faqs:read
faq_listLiostaigh FAQs chatbot (úsáid chatbot_list chun chatbotId a fháil).faqs:read
faq_reorderSocraigh ord taispeána FAQs sa widget.faqs:write
faq_suggestion_approveFaomh moladh FAQ PENDING: cruthaítear FAQ foilsithe (roghnach le ceist/freagra/catagóir eedithe) agus marcálann sé an moladh mar APPROVED.faqs:write
faq_suggestion_getFaigh na sonraí iomlána de mholadh FAQ (freagra iomlán, réasúnaíocht AI, catagóir molta, stádas athbhreithnithe).faqs:read
faq_suggestion_rejectDiúltaigh moladh FAQ PENDING le cúis roghnach.faqs:write
faq_suggestions_generateLig don AI moltaí FAQ nua a mholadh ó bhonn eolais an chatbot (leathanaigh a craoladh / doiciméid uaslódáilte), go roghnach do chatagóir amháin.faqs:write
faq_suggestions_listLiostaigh moltaí FAQ a ghintear ag AI do chatbot (ó chomhráite nó faq_suggestions_generate).faqs:read
faq_translateAistrigh ceist agus freagra FAQ le AI go teangacha eile an chatbot (nó na targetLanguages tugtha) agus sábháil an toradh.faqs:write
faq_translations_updateSábháil aistriúcháin FAQ in aghaidh teanga, m.sh.faqs:write
faq_updateNuashonraigh ceist, freagra, catagóir, stádas foilseacháin nó ord eagar láimhe FAQ.faqs:write
faq_widget_settings_getFaigh socruithe cuma agus iompair an widget FAQ ionchlannaithe (dathanna, radius imeall, teideal, spásáil, leithead uasta, allowMultipleOpen, autoOpenFirst, mód eagar, aistriúcháin teidil).chatbots:read
faq_widget_settings_updateNuashonraigh socruithe widget FAQ: dathanna (hex), borderRadius 0-32, teideal (uasmhéid 100) + showTitle, spásáil compact|normal|relaxed, maxWidth 0-2000 (0 = leithead iomlán), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name agus aistriúcháin teidil in aghaidh na teanga.chatbots:write

Stair Comhrá & Aiseolas

ToolDescriptionScope
chat_feedback_dismissMarcáil comhrá mar athbhreithnithe gan é a rátáil (bainfidh sé é ón scuaine ar feitheamh, ní athróidh sé an scór muiníne).chats:write
chat_feedback_getFaigh athbhreithniú comhrá amháin (aiseolas) le anailís AI, déine, catagóir muiníne, athrú scóir agus an seisiún feabhsúcháin nasctha.chats:read
chat_feedback_listLiostaigh athbhreithnithe comhrá (rónta aiseolais) de chatbot le scagaire stádais agus comptóirí.chats:read
chat_feedback_set_severitySárshocrú an aicmíochta déine (MINOR|MODERATE|MAJOR|CRITICAL) de chomhrá diúltach a athbhreithíodh; tá meáchan déine ar titim scór muiníne.chats:write
chat_feedback_statsComtéamaí seisiún in aghaidh buicéad athbhreithnithe do chatbot (iomlán, níl, ar feitheamh, dearfach, diúltach, athbhreithnithe, feabhsaithe) — na cártaí staitisticí ar leathanach comhráite an dashboard.chats:read
chat_feedback_submitRátáil seisiún comhrá mar Maith (isPositive=true) nó Teastaíonn Obair (isPositive=false).chats:write
chat_session_getFaigh seisiún comhrá le trascríbhinn iomlán (in aghaidh theachtaireacht token/model/latency/pageUrl), sonraí cuairteora, URL an leathanaigh thosaigh, catagóir muiníne, aiseolas (déine, anailís AI, seisiún feabhsúcháin nasctha) agus lipéid.chats:read
chat_session_searchCuardaigh seisiún comhrá de chatbot de réir ábhar teachtaireachta agus/nó ríomhphost cuairteora.chats:read
chat_session_set_categoryCuireann nó athraíonn catagóir muiníne seisiún comhrá (ceartóidh sé aicmithe AI; ríomhtar muinín in aghaidh catagóire nuair a rinneadh an comhrá a athbhreithniú).chats:write
chat_sessions_listLiostaigh seisiún comhrá de chatbot, is nuaí ar dtús, leis na scagairí scuaine athbhreithnithe céanna leis an leathanach comhráite sa dashboard.chats:read

Gníomhaire Feabhsúcháin

ToolDescriptionScope
confidence_categories_listLiostaigh catagóirí muiníne chatbot le scór muiníne in aghaidh catagóire, comhaireamh athbhreithnithe agus min rithe r-phoist athbhreithnithe.chats:read
confidence_category_createCruthaigh catagóir muiníne do chatbot.chatbots:write
confidence_category_deleteScrios catagóir muiníne.chatbots:write
confidence_category_mergeComhcheangail catagóir muiníne amháin isteach in ceann eile den chatbot céanna: bogann gach comhrá/athbhreithniú chuig an sprioc, scriostar an fhoinse agus ríomhfar scóir arís.chatbots:write
confidence_category_updateAthainmníonn catagóir muiníne agus/nó socraíonn minicíocht r-phoist athbhreithnithe (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1-24 ach do HOURLY).chatbots:write
confidence_status_getStádas muiníne chatbot: scór, teorainn céimniú, brata foghlama, iompair céim foghlama (CAUTIOUS|BALANCED|CONFIDENT) agus spreagadh saincheaptha, comhaireamh athbhreithnithe agus scóir muiníne in aghaidh catagóire.analytics:read
improvement_proposal_approveFaomh moladh feabhsúcháin PENDING agus cuir an t-athrú i bhfeidhm ar an chatbot (treoir chroí a chur leis/núasghrádú, FAQ a chruthú/nuashonrú nó pearsona a nuashonrú) — an loighic agus teorainneacha plean céanna leis an dashboard.chatbots:write
improvement_proposal_rejectDiúltaigh moladh feabhsúcháin PENDING.chatbots:write
improvement_proposal_simulateSamhlaigh conas a fhreagródh an chatbot don teachtaireacht fhadhbacha le moladh curtha i bhfeidhm (bunaidh vs.chatbots:write
improvement_proposals_pendingLiostaigh moltaí feabhsúcháin ag fanacht le hathbhreithniú (stádas PENDING) trasna an chomhlachta nó do chatbot amháin.chatbots:read
improvement_session_completeMarcáil seisiún feabhsúcháin mar COMPLETED (an comhrá ansin á líonadh mar Feabhsaithe sa scuaine athbhreithnithe).chatbots:write
improvement_session_createOscail an Gníomhaire Feabhsúcháin do chomhrá a rátáil Teastaíonn Obair.chatbots:write
improvement_session_getFaigh seisiún feabhsúcháin le an comhrá bunaidh (tá teachtaireachtaí le innéacs 1-bhunúsach inúsáidte mar targetMessageIndex), comhrá an ghníomhaire, gach moladh (le a shimulation is déanaí) agus samhlacha.chatbots:read
improvement_session_resetAthsheol seisiún feabhsúcháin: scriosann sé gach teachtaireacht ghníomhaire, samhlacha agus moltaí PENDING/REJECTED (coinneofar na curtha i bhfeidhm) agus tosaíonn comhrá úr.chatbots:write
improvement_session_send_messageSeol teachtaireacht chuig an Gníomhaire Feabhsúcháin (míníodh cad a bhí mícheart leis an fhreagra a d'fhéadfadh an bot; roghnach targetMessageIndex = innéacs 1-bhunúsach den teachtaireacht bot i originalChat.messages).chatbots:write
improvement_sessions_listLiostaigh seisiúin feabhsúcháin (comhráite Gníomhaire Feabhsúcháin a thosaíodh ó athbhreithnithe comhrá diúltacha) do chatbot nó do chuideachta ar fad, is nuaí ar dtús, le comhaire moltaí.chatbots:read
improvement_simulation_assessRátáil toradh samhail: isApproved=true nuair atá an freagra samhlaithe go maith (is féidir an moladh ansin a chur i bhfeidhm), false nuair a theastaíonn tuilleadh oibre (tuairim 'almost' = beagnach ceart).chatbots:write

Comhrá Bheo

ToolDescriptionScope
live_chat_agents_availableFaigh infhaighteacht comhrá beo an úsáideora féin, na gníomhairí atá ar fáil faoi láthair do chomhrá beo (croí-beat úr, an comhartha céanna a úsáideann an widget) agus an bhfuil comhrá beo san áireamh i bplean an chomhlachta.chats:read
live_chat_heartbeatAthnuachan croí-beat láithreacht comhrá beo an úsáideora reatha (ach amháin nuair atá sé marcáilte mar infhaighte via live_chat_set_availability).chats:write
live_chat_message_sendSeol teachtaireacht chuig an gcuairteoir mar an gníomhairí ainmnithe.chats:write
live_chat_queueFaigh scuaine comhrá beo: seisiún ag fanacht le gníomhaire, is sine ar dtús (FIFO).chats:read
live_chat_session_assignGlac seisiún comhrá beo WAITING ón scuaine: sannann sé don úsáideoir reatha (úinéir comhlachta do eochracha API) agus fógraíonn sé don chuairteoir go ndeachaigh an gníomhaire isteach.chats:write
live_chat_session_closeCríochnaigh seisiún comhrá beo mar ghníomhairí (aon bhall nach VIEWER den chomhlacht).chats:write
live_chat_session_getFaigh seisiún comhrá beo le faisnéis cuairteora, gníomhaí ainmnithe, gach teachtaireacht agus an comhrá bot roimhe seo (comhthéacs lámh-thóin).chats:read
live_chat_sessions_listLiostaigh seisiúin comhrá beo (is nuaí ar dtús; seisiúin WAITING is sine ar dtús) le scagairí roghnach de réir chatbot, stádas agus gníomhaí ainmnithe.chats:read
live_chat_set_availabilityCasann an lasc 'Available for Live Chat' an úsáideora reatha do chomhlacht.chats:write

Luaidhe

ToolDescriptionScope
lead_assignSann luaidhe do bhall comhlachta nó déan dí-sann é (assignedToId: null).leads:write
lead_bulk_update_statusSocraigh stádas roinnt luaidhe (uasmhéid 100) ag an am.leads:write
lead_categories_listLiostaigh catagóirí luaidhe chatbot le comhaireamh luaidhe agus na baill foirne a fógraíodh in aghaidh catagóire.leads:read
lead_category_assign_userCuir ball comhlachta leis an liosta fógraíochta catagóir luaidhe (nó nuashonraigh a bflags fógraíochta).leads:write
lead_category_createCruthaigh catagóir luaidhe do chatbot.leads:write
lead_category_deleteScrios catagóir luaidhe.leads:write
lead_category_remove_userBain ball comhlachta as liosta fógraíochta catagóir luaidhe.leads:write
lead_category_updateNuashonraigh ainm, cur síos agus/nó dath catagóir luaidhe.leads:write
lead_createCruthaigh luaidhe de láimh (m.sh.leads:write
lead_deleteScrios luaidhe go buan.leads:write
lead_field_config_getFaigh cumraíocht ghabhdála luaidhe chatbot: réimsí (ids mapa chuig eochracha i lead.data), teachtaireacht dearbhaithe, aistriúcháin réimse/UI agus socruithe aithint AI.leads:read
lead_field_config_updateNuashonraigh cumraíocht ghabhdála luaidhe chatbot.leads:write
lead_getFaigh sonraí iomlána luaidhe lena shannadh, catagóir agus trascríbhinn an chomhrá foinse (páidithe le messageOffset/messageLimit, réamhshocraithe na chéad 20 teachtaireacht).leads:read
lead_listLiostaigh luaidhe chatbot (is nuaí ar dtús) le scagairí roghnach de réir stádas, catagóir, assignee agus cuardach téacs saor (ainm/ríomhphost/comhlacht).leads:read
lead_statsFaigh staitisticí luaidhe do chatbot: comhaireanna de réir stádas, luaidhe na 7 lá deireanaí agus ráta tiontaithe (céatadán).leads:read
lead_updateNuashonraigh stádas, catagóir, nótaí, sonraí ghabhdaithe agus/nó assignee luaidhe.leads:write

Foirmeacha

ToolDescriptionScope
form_createCruthaigh foirm teag contact do chatbot (bunúsacha, réimsí, dearadh agus socruithe spam i gcéad glao amháin).forms:write
form_deleteScrios foirm teag contact go buan agus GACH a cúrsálacha (cascade).forms:write
form_getFaigh foirm teag contact ina hiomlán: réimsí, aistriúcháin, stíliú, socruithe spam, stádas réidh, comhaireamh cúrsála agus an tag script ionchlannaithe (embedCode).forms:read
form_listLiostaigh foirmeacha teag contact chatbot le comhaire réimse, comhaire cúrsála agus códanna ionchlannaithe.forms:read
form_statsComhaire cúrsála foirme teag contact: iomlán, ar feitheamh, ceadaithe, spam agus diúltaithe.forms:read
form_submission_deleteScrios cúrsáil foirme teag contact go buan (m.sh.forms:write
form_submission_getFaigh cúrsáil foirme teag contact ina hiomlán: sonraí réimse a cuireadh isteach, scór spam agus anailís spam AI, metadata IP/user agent/referrer agus faisnéis athbhreithnithe.forms:read
form_submission_update_statusAthbhreithnigh cúrsáil foirme teag contact: socraigh a stádas go APPROVED, SPAM nó REJECTED le nóta athbhreithnithe roghnach.forms:write
form_submissions_listLiostaigh cúrsálacha foirme, is nuaí ar dtús, go roghnach scagtha de réir stádas (PENDING, APPROVED, SPAM, REJECTED) agus dáta cruthaithe.forms:read
form_updateNuashonraigh foirm teag contact: ainm, cur síos, stádas gníomhach (isActive riallaíonn an ionchlannú má léirítear é), réimsí (athsholáthar iomlán), dearadh (dathanna, téacs cnaipe, teachtaireacht rathúnais) agus socruithe spam (spamThreshold, autoRejectSpam, notificationEmail).forms:write
form_update_translationsAthsholáthar réimse agus/nó aistriúcháin UI foirme teag contact.forms:write

Email Assistant

ToolDescriptionScope
email_activity_listLiostaigh log gníomhaíochta ríomhphoist phróiseáilte nasc bosca poist (is nuaí ar dtús): seolta, ábhar, catagóir ainmniúcháin, toradh (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) agus outcomeDetail.email:read
email_categories_listLiostaigh catagóirí ríomhphoist nasc bosca poist (ordaithe de réir sortOrder).email:read
email_category_createCruthaigh catagóir ríomhphoist do nasc bosca poist (uasmhéid 20 in aghaidh an nasc).email:write
email_category_deleteScrios catagóir ríomhphoist.email:write
email_category_updateNuashonraigh catagóir ríomhphoist (páirteach: athraítear ach na réimsí tugtha).email:write
email_connection_disconnectDícheangail bosca poist go buan.email:write
email_connection_getFaigh nasc bosca poist incl.email:read
email_connection_updateNuashonraigh nasc bosca poist: móide/athnua an sintéise (paused true/false; aistríonn sé ACH ACTIVE<->DISABLED, ní sáraíonn sé TOKEN_EXPIRED/ERROR), cas ar dréachtú freagra (draftingEnabled) agus catagóiriú/eagrú (organizingEnabled), athaird an chatbot cumhachtach (chatbotId den chomhlacht céanna) nó socraigh síniú freagra HTML (signatureHtml, uasmhéid 20000 carachtair; glanann stríng fhánach é).email:write
email_connections_listLiostaigh nascanna bosca poist Email Assistant an chomhlachta (seoladh, stádas ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, an t-am sync deireanach, earráid dheireanach, lascáin dréachtaithe/eagraithe, chatbot cumhachtach, draftReadyCategoryCount = catagóirí a d'fhéadfadh dréacht a tháirgeadh, baseRuleCount = rialacha "Chat + Email" ar fud an chatbot i bhfeidhm ar gach dréacht) le teorainneacha an phlean (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth).email:read
email_contact_deleteScrios teagmhála ríomhphoist fhoghlaithe (dearmad an próifíl seoltaí, m.sh.email:write
email_contact_getFaigh teagmháil ríomhphoist fhoghlaithe le gach fíric foghlaithe, nótaí inmheánacha, caidreamh, socrú seoladh foirmiúil/neofoirmiúil agus staitisticí ríomhphoist.email:read
email_contact_updateNuashonraigh teagmháil ríomhphoist fhoghlaithe.email:write
email_contacts_listLiostaigh teagmhálacha ríomhphoist foghlaithe an chomhlachta (an r-phost is déanaí ar dtús) le caidreamh, seoladh foirmiúil/neofoirmiúil (formalAddress: true = seoladh foirmiúil 'Sie', false = neamhfhoirmiúil 'Du', null = uathoibríoch), comhaireamh fíricí agus réamhamharc nótaí.email:read
email_folder_createCruthaigh fillteán ríomhphoist faoin inbox (taispeánann an ceann atá ann má tá an t-ainm tógtha) le húsáid mar sprioc bogadh catagóir.email:write
email_folders_listLiostaigh na fillteáin is féidir le catagóir ríomhphoist ríomhphoist a aistriú isteach iontu, beo ón mbosca poist: fo-fillteáin inbox, fillteáin uachtarleibhéil saincheaptha, cartlann, spam agus truflais (id 'deleteditems').email:read
email_general_rules_listLiostaigh na rialacha ar fud an chatbot a bhaineann le gach dréacht freagra ríomhphoist: treoracha croí gníomhacha le channel BOTH ("Chat + Email"), plus treoracha seanaimseartha ríomhphoist atá fós le hinimiriú i gcatagóir.email:read

Anailísíocht

ToolDescriptionScope
analytics_chat_volumeToir comhrá (seisiúin tosaithe) thar am do chairteacha agus treochtaí: tréimhse week/month/quarter/year, garántúlachta hour/day/week/month, go roghnach do chatbot amháin.analytics:read
analytics_chatbot_statsFeidhmíocht in aghaidh gach chatbot do chomhlacht i nglao amháin (tábla feidhmíochta chatbot sa dashboard): id, ainm, slug, isActive, seisiúin, teachtaireachtaí, FAQs agus luaidhe in aghaidh chatbot, rioscáilte de réir seisiún.analytics:read
analytics_formsStaitisticí cúrsála foirm teag do chomhlacht nó chatbot amháin (widet anailíse dashboard): cúrsálacha de réir stádas (pending/approved/rejected/spam), líon foirmí, iomlán, ráta spam i gcéadán agus an tsraith cúrsálacha-in aghaidh-lá na 7 lá deireanacha.analytics:read
analytics_leadsUalach luaidhe do chomhlacht nó chatbot amháin (widet anailíse dashboard): luaidhe de réir stádas (new/contacted/qualified/converted/lost), iomlán, ráta tiontaithe i gcéadán agus an tsraith luaidhe-in aghaidh-lá na 7 lá deireanacha.analytics:read
analytics_overviewForbhreathnú anailíse do chomhlacht nó chatbot amháin: comhráite, teachtaireachtaí, ráta sástachta agus ceisteanna barr do thréimhse rothlach (day/week/month/year), plus widet forbhreathnaithe an dashboard (iomlán chatbots/FAQs foilseáilte/luaidhe, seisiúin inniu/an tseachtain/an mhí, luaidhe inniu/an tseachtain, cúrsálacha foirm iomlán/inniu/ar feitheamh).analytics:read
dashboard_activityCad a theastaíonn air faoi láthair (radharc baile dashboard): in aghaidh an chomhlachta, na chatbots le luaidhe nua inniu, moltaí FAQ ar feitheamh, cúrsálacha foirme ar feitheamh, comhráite beo ag fanacht/ghníomhach nó céim foghlama ar siúl.any

Samhlacha Sreafaí Oibre

Treoir Chroí a Chur Leis

Iarr ar do chúntóir AI:

"Cuir treoir chroí le mo chatbot 'Support Bot': tairgimid loingseoireacht saor in aisce ar orduithe thar €50"

Úsáidfidh an cúntóir chatbot_add_instruction leis na paraiméadair chuí.

Athbhreithniú Moltaí Feabhsúcháin

"Taispeáin dom na moltaí feabhsúcháin ar feitheamh do mo chatbot agus mínigh na hathruithe a mholann siad"

Déanfaidh an cúntóir:

  1. improvement_proposals_pending a úsáid chun moltaí a fheiceáil
  2. Anailís agus achoimriú a dhéanamh ar gach moladh
  3. Faomhadh nó diúltú dóibh thar do shon le improvement_proposal_approve nó improvement_proposal_reject

Anailísíocht Feidhmíochta Comhrá

"Tabhair tuarascáil seachtainiúil ar thóir comhrá agus sásamh custaiméara do mo chatbot"

Úsáidfidh an cúntóir analytics_overview agus analytics_chat_volume chun tuarascáil chuimsitheach a chur le chéile.

Suíomh Gréasáin a Iompórtáil

"Scan https://example.com, iompórtáil na leathanaigh táirgí agus praghsála isteach i mo 'Support Bot' agus inis dom nuair a bheidh an crawl críochnaithe"

Glaofaidh an cúntóir crawler_preview_scan, roghnóidh sé na leathanaigh ábhartha, tosóidh an iompórtáil le crawler_start agus poll crawler_job_get go dtí go mbeidh an post críochnaithe.

Luaidhe agus Cúrsálacha Foirme a Athbhreithniú

"Taispeáin dom na luaidhe nua ón seachtain seo, sann na cinn cáilithe go Anna agus faomh na cúrsálacha foirme teag ar feitheamh"

Comhcheanglaíonn an cúntóir lead_list, lead_assign, form_submissions_list agus form_submission_update_status.

Glacadh le Comhrá Bheo

"Cuir mé ar fáil do chomhrá beo agus glac an comhrá is sine atá ag fanacht"

Úsáidfidh an cúntóir live_chat_set_availability, live_chat_queue agus live_chat_session_assign; téann freagraí tríd live_chat_message_send.

Slándáil

  • Tá eochracha API scóipithe do do chomhlacht agus don réimsí ceadúnais a roghnaíonn tú nuair a chruthaíonn tú iad (féach colún an Scope thuas)
  • Rithfidh eochracha le ceadanna úinéara an chomhlachta; tá teorainneacha plean agus geataí gné i bhfeidhm go díreach mar atá sa dashboard
  • Is féidir eochracha a chealú ag am ar bith ón dashboard
  • Tá rochtain API ar fáil ar phleananna íoctha — féach ar ár leathanach Praghsála

Eolas Fadhbacha

Teip Ceangail

  1. Dearbhaigh go bhfuil do eochair API ceart
  2. Seiceáil nach bhfuil an eochair cealaithe
  3. Bí cinnte go bhfuil do phlean ag cuimsíonn rochtain API
  4. Athchealraigh do chliaint MCP

Uirlis Níor Aimsíodh

Athchealraigh do chliaint MCP tar éis an chumraíocht a athrú ionas go luchtóidh siad na huirlisí ar fáil arís. Tá ainmneacha uirlisí i gcaighdeán ísealliotáin le sousvre: underscores (m.sh., faq_list).


An gá cabhrach? Déan teagmháil lenár bhfoireann tacaíochta →