MCP Servera integrācija
ChatReact ievieš Model Context Protocol (MCP), kas ļauj savienot jūsu ChatReact kontu ar AI asistentiem, piemēram, Claude Desktop, Cursor un citiem MCP saderīgiem rīkiem.
Kas ir MCP?
Model Context Protocol ir atvērts standarts, kas ļauj AI asistentiem mijiedarboties ar ārējiem pakalpojumiem un datu avotiem. Izmantojot ChatReact MCP integrāciju, Jūs varat:
- Pārvaldīt čatbotus — izveidot, konfigurēt (persona, valodas, logrīks, uzvedība, ierobežojumi), iegult un dzēst čatbotus
- Veidot zināšanu bāzi — pievienot dokumentus, indeksēt vietnes, pārvaldīt indeksētās lapas un pamata instrukcijas
- Pārvaldīt FAQ — FAQ, kategorijas, ieteikumus, tulkojumus un FAQ logrīku
- Pārskatīt sarunas — novērtēt sarunas, piešķirt pārliecības kategorijas, palaist Improvement Agent
- Strādāt ar potenciālajiem klientiem un veidlapām — leads, lead kategorijas, iesaistes iestatījumi, kontaktveidlapas un iesniegumi
- Darboties kā tiešraides tērzēšanas aģents — iestatīt pieejamību, pārņemt gaidošās tērzēšanas, atbildēt un aizvērt sesijas
- Administrēt uzņēmumu — profils, zīmola krāsas, komandas locekļi un ielūgumi
- Izmantot Email Assistant — pastkastu savienojumi, kategorijas, kontakti un aktivitāte
- Lasīt analītiku un paziņojumus
Viss, ko Jūs varat darīt informācijas panelī, ir pieejams caur MCP (un REST API); tikai ar pārlūkprogrammu saistītas darbības, piemēram, maksājumi, pastkastes OAuth, passkey, konta dzēšana un API atslēgu pārvaldība, paliek informācijas panelī.
Sākt darbu
1. Ģenerējiet API atslēgu
- Dodieties uz savu Informācijas panelis → Uzņēmums → API cilni
- Noklikšķiniet Izveidot API atslēgu
- Piešķiriet atslēgai aprakstošu nosaukumu (piem., "Claude Desktop") un izvēlieties vismaz vienu atļauju
- Kopējiet ģenerēto atslēgu (sākas ar
cr_)
API atslēgas ir pieejamas apmaksātajos plānos — skatiet mūsu Pricing page.
Glabājiet savu API atslēgu droši. To nevar atgūt pēc izveides.
2. Konfigurējiet savu MCP klientu
ChatReact MCP serveris tiek hostēts pie https://www.chatreact.ai/api/mcp un sazinās pa HTTP (JSON-RPC). Autentificējieties ar Authorization: Bearer galveni — tiek pieņemta arī X-API-Key galvene ar to pašu atslēgu.
Cursor IDE
Cursor atbalsta attālās MCP serverus tieši. Pievienojiet saviem Cursor MCP iestatījumiem:
{
"mcpServers": {
"chatreact": {
"url": "https://www.chatreact.ai/api/mcp",
"headers": {
"Authorization": "Bearer cr_your_api_key_here"
}
}
}
}
Claude Desktop
Claude Desktop konfigurācijas fails atbalsta komandu bāzētus serverus, tāpēc izmantojiet standarta mcp-remote tiltu, lai savienotu ar hostēto galapunktu:
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"
]
}
}
}
Šai uzstādīšanai ir nepieciešams instalēts Node.js. Piemērā tiek izmantota X-API-Key galvene, jo daži klienti neapstrādā atstarpes argumentos droši.
3. Restartējiet savu AI asistentu
Pēc konfigurācijas saglabāšanas restartējiet Claude Desktop vai Cursor, lai izveidotu savienojumu.
Pieejamie rīki
ChatReact MCP atklāj zemāk norādītos rīkus, sakārtotus pēc jomas. Kolonna Scope parāda API atslēgas atļauju, kas rīkam nepieciešama (any = katra derīga atslēga). Rīki darbojas ar tām pašām piemērojamajām atļaujām, plāna ierobežojumiem un blakus efektiem, kā atbalstītajām darbībām informācijas panelī. Ar pārlūkprogrammu saistītas maksājumu, pastkastes autorizācijas, passkey, konta dzēšanas un atslēgu pārvaldības darbplūsmas paliek informācijas panelī.
Destruktīvi rīki (dzēst, atiestatīt, aizvērt, apvienot) pieprasa apstiprinājumu, ja tos izmanto caur Dashboard Assistant. Ar API atslēgu tie izpildās uzreiz.
Konts
| Tool | Description | Scope |
|---|---|---|
account_usage_get | Iegūt pašreizējo plānu (līmenis, statuss), pašreizējā norēķinu perioda izmantošanas skaitītājus (uzņēmumi, čatboti, komandas locekļi, sarunas, tokeni) un plāna limitus, kā arī efektīvos limitus un funkciju karodziņus uzņēmumam, kuram zvans ir piesaistīts. | any |
user_companies | Uzskaitīt visus uzņēmumus, kuriem pašreizējam lietotājam ir piekļuve, kopā ar lietotāja lomu katrā no tiem. | any |
user_notification_mark_read | Atzīmēt vienu no pašreizējā lietotāja paziņojumiem kā izlasītu. | any |
user_notification_preferences_get | Iegūt pašreizējā lietotāja paziņojumu preferences: globālie e-pasta/push pārslēgi, kopsavilkuma biežums/laiks/dienas, klusuma stundas un kanālu iestatījumi pa tipu. | any |
user_notification_preferences_update | Atjaunināt pašreizējā lietotāja globālās paziņojumu preferences (e-pasta/push pārslēgi, kopsavilkuma grafiks, klusuma stundas). | any |
user_notification_type_setting_update | Iespējot vai atspējot e-pasta / lietotnes piegādi vienam paziņojumu tipam pašreizējam lietotājam (piem., | any |
user_notification_types_list | Uzskaitīt visus paziņojumu tipus, grupētus pa kategoriju (chatbot, leads, live chat, knowledge, team, billing). | any |
user_notification_unread_count | Iegūt pašreizējā lietotāja nelasīto paziņojumu skaitu. | any |
user_notifications | Uzskaitīt pašreizējā lietotāja paziņojumus, jaunākie vispirms, ar cursor lapošanas atbalstu. | any |
user_notifications_delete_old | Apkopes darbība: neatgriezeniski dzēst pašreizējā lietotāja paziņojumus, kas jau ir izlasīti un vecāki par 30 dienām. | any |
user_notifications_mark_all_read | Atzīmēt visus pašreizējā lietotāja paziņojumus kā izlasītus. | any |
user_profile | Iegūt pašreizējā lietotāja profilu (id, vārds, e-pasts, loma, abonēšanas līmenis). | any |
Uzņēmums un komanda
| Tool | Description | Scope |
|---|---|---|
company_chatbots_list | Uzskaitīt visus čatbotus konkrētam uzņēmumam ar kopsavilkuma statistiku. | chatbots:read |
company_get | Iegūt detalizētu informāciju par uzņēmumu: profils, īpašnieks, zīmola iestatījumi (krāsas, paziņojumu e-pasts) un skaitītāji. | any |
company_invite_cancel | Atcelt (dzēst) komandas ielūgumu, lai saite pārstātu darboties. | company:write |
company_invite_resend | Pārsūtīt gaidošu komandas ielūgumu: izsniegt jaunu tokenu, pagarināt derīgumu par 7 dienām un nosūtīt ielūguma e-pastu vēlreiz. | company:write |
company_invites_list | Uzskaitīt uzņēmuma komandas ielūgumus (pēc noklusējuma gaidošie; iestatiet includeExpired, lai atgrieztu arī beigušos). | company:read |
company_list | Uzskaitīt visus uzņēmumus, kuriem lietotājam ir piekļuve (API atslēgas un Dashboard Assistant redz tikai savu uzņēmumu). | any |
company_logo_remove | Noņemt uzņēmuma logotipu (dzēš saglabāto attēlu un notīra logo URL). | company:write |
company_member_invite | Ielūgt komandas locekli pa e-pastu ar lomu (ADMIN, MANAGER, AGENT vai VIEWER). | company:write |
company_member_remove | Noņemt komandas locekli no uzņēmuma. | company:write |
company_member_update_role | Mainīt komandas locekļa lomu (ADMIN, MANAGER, AGENT vai VIEWER). | company:write |
company_members_list | Uzskaitīt uzņēmuma dalībniekus ar viņu lomām (OWNER, ADMIN, MANAGER, AGENT, VIEWER). | any |
company_settings_update | Atjaunināt uzņēmuma zīmola iestatījumus: primaryColor / secondaryColor (#RRGGBB) un notificationEmail čatu pārskatīšanai. | company:write |
company_update | Atjaunināt uzņēmuma profilu: nosaukums (2-100 rakstzīmes), apraksts (maks. 1000 rakstzīmes) vai vietne (https:// tiek pievienots automātiski; nododiet tukšu virkni, lai notīrītu vietni/aprakstu). | company:write |
Čatbota pārvaldība
| Tool | Description | Scope |
|---|---|---|
chatbot_add_instruction | Pievienot jaunu pamata instrukciju čatbotam (1-5000 rakstzīmes). | chatbots:write |
chatbot_confirm_embed | Atzīmēt čatbotu kā iegultu vietnē (paslēpj uzstādīšanas atgādinājumu informācijas panelī). | chatbots:write |
chatbot_create | Izveidot jaunu čatbotu (tāpat kā informācijas paneļa vednī). | chatbots:write |
chatbot_delete | Neatgriezeniski izdzēst čatbotu kopā ar visiem tā FAQ, dokumentiem, sarunām, leadiem un veidlapām (nevar atsaukt). | chatbots:write |
chatbot_delete_instruction | Dzēst pamata instrukciju no čatbota. | chatbots:write |
chatbot_get | Iegūt detalizētu informāciju par čatbotu: vispārējie iestatījumi, personība (persona, tonalitāte, valodas, ierobežojumi), logrīka iestatījumi, tiešraide, mācību fāze, iegulšanas statuss un skaitītāji. | chatbots:read |
chatbot_get_embed_code | Iegūt HTML fragmentu čatbota instalēšanai vietnē (skripta URL + <script> tag) un vai iegulšana ir apstiprināta. | chatbots:read |
chatbot_get_instructions | Iegūt visas pamata instrukcijas čatbotam. | chatbots:read |
chatbot_improve_instructions | Pārrakstīt pamata instrukcijas tekstu, izmantojot platformas AI uzlabotāju (tāpat kā informācijas paneļa "Improve with AI"). | chatbots:write |
chatbot_learning_phase_get | Iegūt čatbota mācību fāzes iestatījumus: uzvedības presets (CAUTIOUS, BALANCED, CONFIDENT), pielāgots prompt un vai botiņš joprojām ir mācību fāzē. | chatbots:read |
chatbot_learning_phase_update | Iestatīt mācību fāzes uzvedības presetu (CAUTIOUS = atsaukties uz cilvēku, ja neesat pārliecināts, BALANCED, CONFIDENT) un/vai pielāgotu mācību fāzes promptu. | chatbots:write |
chatbot_list | Uzskaitīt visus čatbotus, kuriem lietotājam ir piekļuve, ar kopsavilkuma statistiku. | chatbots:read |
chatbot_reorder_instructions | Iestatīt čatbota pamata instrukciju kārtību. | chatbots:write |
chatbot_templates_list | Uzskaitīt čatbota veidnes (persona, tonalitāte, ziņas un logrīka uzvedības presets), kuras var nodot kā templateId uz chatbot_create, un vai uzņēmuma plāns drīkst tās izmantot. | chatbots:read |
chatbot_toggle_active | Aktivizēt vai deaktivizēt čatbotu. | chatbots:write |
chatbot_toggle_learning | Beigt (false) vai atkārtoti iespējot (true) čatbota mācību fāzi. | chatbots:write |
chatbot_update | Atjaunināt čatbota vispārējos iestatījumus: nosaukums, apraksts, isActive, tiešraide (liveChatEnabled/liveChatMode, plāna funkcija), showBranding (white-label plānos), čatu pārskatīšanas e-pasti, FAQ automātiskā ģenerēšana, leģendāro pamata instrukciju teksts, mācību fāze (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt). | chatbots:write |
chatbot_update_instruction | Atjaunināt esošu pamata instrukciju (saturs, isActive, kanāls, sortOrder). | chatbots:write |
chatbot_update_personality | Atjaunināt čatbota personību: persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), tonalitātes slīdņi 1-5, valodas (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), ziņas (welcomeMessage, fallbackMessage, proactive greeting) un ierobežojumi (blacklistTopics, complianceRules, maxResponseLength, human handoff). | chatbots:write |
widget_settings_get | Iegūt pašreizējos logrīka iestatījumus čatbotam (visa izskata, zīmola, uzvedības un pirms-čata formas lauki). | chatbots:read |
widget_settings_update | Atjaunināt čatbota čata logrīku: pozīcija (iekļauj. | chatbots:write |
widget_translations_get | Iegūt čatbota logrīka tulkojumus pa valodām: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }. | chatbots:read |
widget_translations_update | Iestatīt logrīka tulkojumus pa valodām. | chatbots:write |
Zināšanu bāze
| Tool | Description | Scope |
|---|---|---|
crawler_job_cancel | Atcelt PENDING vai RUNNING indeksēšanas darbu; atlikušās lapas tiek izlaistas. | knowledge:write |
crawler_job_get | Iegūt indeksēšanas darba statusu, progresu (pagesCrawled/pagesFound, tokensUsed) un katras lapas statusu. | knowledge:read |
crawler_jobs_list | Uzskaitīt čatbota indeksēšanas darbus (jaunākie vispirms) ar statusu un progresu. | knowledge:read |
crawler_limits | Iegūt plāna indeksēšanas limitus čatbotam (maks. lapu vienā indeksēšanā, tokeni uz lapu, indeksēšanas skaits mēnesī) un vai šomēnes var sākt jaunu indeksēšanu. | knowledge:read |
crawler_preview_scan | Skenēt vietni un uzskaitīt tās indeksējamās lapas (url, title, isRecommended) bez nekāda importa. | knowledge:write |
crawler_start | Sākt indeksēšanas darbu, kas importē izvēlētās URL uz čatbota zināšanu bāzi (apstrādā fonā; poll crawler_job_get). | knowledge:write |
knowledge_document_add_from_url | Lejupielādēt dokumentu (PDF, TXT, MD, CSV, JSON, DOCX; maks. 10 MB) no publiska http(s) URL un pievienot to čatbota zināšanu bāzei. | knowledge:write |
knowledge_document_add_text | Pievienot teksta vai markdown dokumentu čatbota zināšanu bāzei no inline satura (maks. 10 MB). | knowledge:write |
knowledge_document_delete | Dzēst augšupielādētu dokumentu no zināšanu bāzes. | knowledge:write |
knowledge_document_get | Iegūt informāciju par augšupielādētu dokumentu, ieskaitot apstrādes statusu, kļūdas ziņojumu un īslaicīgu lejupielādes URL. | knowledge:read |
knowledge_documents_list | Uzskaitīt augšupielādētos dokumentus (PDF, TXT, MD, CSV, JSON, DOCX) čatbota zināšanu bāzē ar statusu un izmēru. | knowledge:read |
knowledge_page_add | Indeksēt vienu URL un pievienot to čatbota zināšanu bāzei (neizdodas ar CONFLICT, ja URL jau indeksēts, FORBIDDEN, ja sasniegts tokenu limits). | knowledge:write |
knowledge_page_delete | Dzēst indeksētu lapu no zināšanu bāzes (noņem tās vektortāru failu). | knowledge:write |
knowledge_page_get | Iegūt indeksēto lapu, ieskaitot markdown saturu, kas tika indeksēts čatbotam (noderīgi, lai pārbaudītu, ko bots zina par lapu). | knowledge:read |
knowledge_page_recrawl | Atkal iegūt indeksēto lapu un aizstāt tās indeksēto saturu (piem., | knowledge:write |
knowledge_pages_delete | Dzēst vairākas indeksētas lapas no čatbota vienlaikus. | knowledge:write |
knowledge_pages_list | Uzskaitīt indeksētās lapas čatbota zināšanu bāzē, pēc izvēles filtrējot pēc domēna, statusa vai meklēšanas termina (URL/tituls). | knowledge:read |
knowledge_stats | Pārskats par čatbota zināšanu bāzi: dokumenti (pēc statusa, izmēra), indeksētās lapas un vietnes (pēc statusa), indeksēšanas darbi, pamata instrukcijas sadalītas pēc avota (manuāls vs improvement agent), FAQ, vektortāru statuss/izmērs un krātuves izmantošana pret. | knowledge:read |
knowledge_website_delete | Dzēst visas indeksētās lapas konkrētai vietnei (domēnam) no čatbota zināšanu bāzes. | knowledge:write |
knowledge_website_recrawl | Pārindeksēt visas vietnes lapas (domēnu) čatbota zināšanu bāzē, lai atsvaidzinātu saturu. | knowledge:write |
knowledge_website_recrawl_cancel | Atcelt procesā esošu vietnes pārindeksēšanu: rindā esošās (PENDING) domēna lapas tiek atjaunotas uz iepriekšējo indeksēto stāvokli. | knowledge:write |
knowledge_websites_list | Uzskaitīt vietnes (domēnus), kuru lapas atrodas čatbota zināšanu bāzē, ar lapu skaitu pēc statusa un tokenu summām. | knowledge:read |
Cenu pārvaldība
Šie rīki pārvalda strukturētus cenu melnrakstus un skaidras apstiprināšanas. Melnraksta saglabāšana ir atsevišķa no precīzas versijas apstiprināšanas; tiesības arī ir atkarīgas no statusa un derīguma. Esošās API atslēgas nepiegūst cenu atļaujas automātiski. Tikai uzņēmuma īpašnieks var piešķirt prices:write vai prices:approve. API atslēgu izsaukumi izpildās uzreiz, tāpēc pirms izsaukuma pārskatiet precīzus ievades datus mutācijai. Skatīt Prices & services klienta darbplūsmai.
| Tool | Description | Scope |
|---|---|---|
price_list | Lappot cenu galvenes un atsevišķi pārvaldīt apstiprinātās versijas tiesīgumu. | prices:read |
price_get | Lasīt pilnu vienuma stāvokli un revīzijas. | prices:read |
price_detail | Lasīt vienuma detaļas ar lapotu revīziju vēsturi. | prices:read |
price_suggestions_list | Lappot cenu ieteikumus. | prices:read |
price_create | Izveidot melnrakstu ar servera ģenerētu vienuma ID. | prices:write |
price_edit | Izveidot jaunu melnrakstu no skaidri gaidāmās vienuma versijas. | prices:write |
price_import_csv | Importēt melnrakstus ar skaidru formātu un stabilu importID drošām atkārtojuma reizēm. | prices:write |
price_suggestion_apply | Lietot izvēlēto ieteikumu kandidātu kā melnrakstu. | prices:write |
price_approve | Apstiprināt vienu skaidri gaidāmo vienuma versiju. | prices:approve |
price_approve_many | Atomiski apstiprināt skaidru ID/versijas izvēli; jebkura novecojusi versija noraida visu izvēli. | prices:approve |
price_archive | Archivēt vienumu pie tā skaidri gaidāmas versijas. | prices:approve |
Melnraksta rediģējumi saglabā iepriekšējo apstiprināto revīziju. CSV formāts un decimālais atdalītājs jānorāda eksplīcīti; mainīts CSV saturs prasa jaunu importID. Visas operācijas ir piesaistītas API atslēgas uzņēmumam un norādītajam čatbotam.
FAQ pārvaldība
| Tool | Description | Scope |
|---|---|---|
faq_cache_purge | Notīrīt kešoto FAQ logrīka datus visās savienotajās CMS vietnēs (WordPress spraudnis). | faqs:write |
faq_categories_list | Uzskaitīt čatbota FAQ kategorijas ar to FAQ skaitiem, slugiem, kārtošanas režīmu un tulkojumiem. | faqs:read |
faq_categories_reorder | Iestatīt FAQ kategoriju kārtību logrīkā: pozīcija categoryIds kļūst par sortOrder. | faqs:write |
faq_category_create | Izveidot FAQ kategoriju čatbotam (slug tiek ģenerēts no nosaukuma). | faqs:write |
faq_category_delete | Dzēst FAQ kategoriju. | faqs:write |
faq_category_translations_update | Aizstāt FAQ kategorijas tulkojumus, piem., | faqs:write |
faq_category_update | Pārdēvēt FAQ kategoriju vai mainīt tās aprakstu, ikonu vai kārtošanas režīmu. | faqs:write |
faq_create | Izveidot FAQ čatbotam. | faqs:write |
faq_delete | Neatgriezeniski dzēst FAQ (arī noņem to no čatbota zināšanu bāzes un attīra CMS logrīku kešus). | faqs:write |
faq_embed_code_get | Iegūt iegulšanas fragmentus FAQ logrīkam: skripta tags, WordPress shortcode un Shopify Liquid fragments, kā arī pa kategoriju varianti (izmantojiet categorySlug no faq_categories_list, lai iegultu tikai vienu kategoriju). | chatbots:read |
faq_get | Iegūt FAQ pilnas detaļas: jautājums, atbilde, kategorija, publicēšanas stāvoklis, kārtošanas secība, tulkojumi, SEO lauki un atsauksmju statistika. | faqs:read |
faq_list | Uzskaitīt čatbota FAQ (izmantojiet chatbot_list, lai atrastu chatbotId). | faqs:read |
faq_reorder | Iestatīt FAQ parādīšanas kārtību logrīkā. | faqs:write |
faq_suggestion_approve | Apstiprināt PENDING FAQ ieteikumu: izveido publicētu FAQ (pēc izvēles ar rediģētu jautājumu/atbildi/kategoriju) un atzīmē ieteikumu kā APPROVED. | faqs:write |
faq_suggestion_get | Iegūt FAQ ieteikuma pilnas detaļas (pilna atbilde, AI loģika, ieteiktā kategorija, pārskatīšanas stāvoklis). | faqs:read |
faq_suggestion_reject | Noraidīt PENDING FAQ ieteikumu ar izvēles iemeslu. | faqs:write |
faq_suggestions_generate | Ļaut AI ierosināt jaunus FAQ no čatbota zināšanu bāzes (indeksētās lapas / augšupielādētie dokumenti), pēc izvēles vienai kategorijai. | faqs:write |
faq_suggestions_list | Uzskaitīt AI ģenerētus FAQ ieteikumus čatbotam (no sarunām vai faq_suggestions_generate). | faqs:read |
faq_translate | Iztulkot FAQ jautājumu un atbildi ar AI uz čatbota citām atbalstītajām valodām (vai norādītajām targetLanguages) un saglabāt rezultātu. | faqs:write |
faq_translations_update | Saglabāt FAQ tulkojumus pa valodām, piem., | faqs:write |
faq_update | Atjaunināt FAQ jautājumu, atbildi, kategoriju, publicēšanas stāvokli vai manuālo kārtošanas secību. | faqs:write |
faq_widget_settings_get | Iegūt ieguljamā FAQ logrīka izskata un uzvedības iestatījumus (krāsas, stūra rādiuss, virsraksts, atstarpes, maksimālais platums, allowMultipleOpen, autoOpenFirst, kārtošanas režīms, virsraksta tulkojumi). | chatbots:read |
faq_widget_settings_update | Atjaunināt FAQ logrīka iestatījumus: krāsas (hex), borderRadius 0-32, title (maks. 100) + showTitle, spacing compact|normal|relaxed, maxWidth 0-2000 (0 = pilna platuma), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name un title tulkojumi pa valodām. | chatbots:write |
Čatu vēsture un atsauksmes
| Tool | Description | Scope |
|---|---|---|
chat_feedback_dismiss | Atzīmēt čatu kā pārskatītu bez tā novērtēšanas (izņem to no gaidošās rindas, nemaina pārliecības skaitli). | chats:write |
chat_feedback_get | Iegūt vienu čata pārskatu (atsauksmi) ar AI analīzi, smagumu, pārliecības kategoriju, punktu izmaiņām un saistīto uzlabošanas sesiju. | chats:read |
chat_feedback_list | Uzskaitīt čata pārskatus (atsauksmju rindas) čatbotam ar statusa filtru un skaitītājiem. | chats:read |
chat_feedback_set_severity | Pārrakstīt negatīvā pārskatītā čata smaguma klasifikāciju (MINOR|MODERATE|MAJOR|CRITICAL); smagums ietekmē pārliecības punktu kritumu. | chats:write |
chat_feedback_stats | Sesiju skaitītāji pēc pārskata spainja čatbotam (kopā, none, pending, positive, negative, reviewed, improved) — statistikas kartītes informācijas paneļa chats lapā. | chats:read |
chat_feedback_submit | Novērtēt čata sesiju kā Good (isPositive=true) vai Needs Work (isPositive=false). | chats:write |
chat_session_get | Iegūt čata sesiju ar pilnu transkriptu (ziņai tokeni/modelis/latentums/pageUrl), apmeklētāja detaļas, sākumlapas URL, pārliecības kategorija, atsauksmes (smagums, AI analīze, saistītā uzlabošanas sesija) un tagi. | chats:read |
chat_session_search | Meklēt čata sesijas čatbotā pēc ziņas satura un/vai apmeklētāja e-pasta. | chats:read |
chat_session_set_category | Piešķirt vai mainīt čata sesijas pārliecības kategoriju (koriģē AI kategorizāciju; pa kategoriju pārliecība pārrēķinās, kad čats ir pārskatīts). | chats:write |
chat_sessions_list | Uzskaitīt čata sesijas čatbotam, jaunākie vispirms, ar tiem pašiem pārskatīšanas rindas filtriem kā informācijas paneļa chats lapā. | chats:read |
Improvement Agent
| Tool | Description | Scope |
|---|---|---|
confidence_categories_list | Uzskaitīt čatbota pārliecības kategorijas ar pa-kategoriju pārliecības punktu, pārskatu skaitu un pārskatu e-pasta biežumu. | chats:read |
confidence_category_create | Izveidot pārliecības kategoriju čatbotam. | chatbots:write |
confidence_category_delete | Dzēst pārliecības kategoriju. | chatbots:write |
confidence_category_merge | Apvienot vienu pārliecības kategoriju ar citu tajā pašā čatbotā: visas sarunas/pārskati pārvietojas uz mērķi, avots tiek dzēsts un punkti pārrēķināti. | chatbots:write |
confidence_category_update | Pārdēvēt pārliecības kategoriju un/vai iestatīt tās pārskatu e-pasta biežumu (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1-24 tikai HOURLY). | chatbots:write |
confidence_status_get | Čatbota pārliecības statuss: score, graduation threshold, learning phase karodziņš, learning-phase uzvedība (CAUTIOUS|BALANCED|CONFIDENT) un pielāgots prompt, pārskatu skaiti un pa-kategoriju pārliecības punktus. | analytics:read |
improvement_proposal_approve | Apstiprināt PENDING uzlabošanas priekšlikumu un pielietot izmaiņu čatbotam (pamatu instrukcijas pievienošana/atjaunināšana, FAQ izveide/atjaunināšana vai personas atjauninājums) — tāda pati loģika un plāna ierobežojumi kā informācijas panelī. | chatbots:write |
improvement_proposal_reject | Noraidīt PENDING uzlabošanas priekšlikumu. | chatbots:write |
improvement_proposal_simulate | Simulēt, kā čatbots atbildētu uz problemātisku ziņu ar priekšlikumu piemērotu (oriģināls vs. | chatbots:write |
improvement_proposals_pending | Uzskaitīt uzlabošanas priekšlikumus, kas gaida pārskatīšanu (status PENDING) visā uzņēmumā vai vienam čatbotam. | chatbots:read |
improvement_session_complete | Atzīmēt uzlabošanas sesiju kā COMPLETED (tad čats tiek skaitīts kā Improved pārskatīšanas rindā). | chatbots:write |
improvement_session_create | Atvērt Improvement Agent čatam, kurš novērtēts kā Needs Work. | chatbots:write |
improvement_session_get | Iegūt uzlabošanas sesiju ar oriģinālo čatu (ziņas ir 1-bāzēts indekss, ko var izmantot kā targetMessageIndex), aģenta sarunu, visiem priekšlikumiem (ar to jaunākajām simulācijām) un simulācijām. | chatbots:read |
improvement_session_reset | Restartēt uzlabošanas sesiju: izdzēš visus aģenta ziņojumus, simulācijas un PENDING/REJECTED priekšlikumus (pielietotie tiek saglabāti) un sāk jaunu sarunu. | chatbots:write |
improvement_session_send_message | Nosūtīt ziņojumu Improvement Agent (aprakstīt, kas bija nepareizi ar bota atbildi; pēc izvēles targetMessageIndex = bota ziņas 1-bāzētais indekss oriģinālajāChat.messages). | chatbots:write |
improvement_sessions_list | Uzskaitīt uzlabošanas sesijas (Improvement Agent sarunas, kas sākas no negatīviem čata pārskatiem) čatbotam vai visam uzņēmumam, jaunākās vispirms, ar priekšlikumu skaitu. | chatbots:read |
improvement_simulation_assess | Novērtēt simulācijas rezultātu: isApproved=true, ja simulētā atbilde ir laba (priekšlikumu tad var pielietot), false, ja nepieciešams vairāk darba (komentārs 'almost' = gandrīz pareizi). | chatbots:write |
Tiešraides tērzēšana
| Tool | Description | Scope |
|---|---|---|
live_chat_agents_available | Iegūt pašreizējā lietotāja tiešraides tērzēšanas pieejamību, aģentus, kas šobrīd pieejami tiešraides tērzēšanai (svaigs sirds puksts, tas pats signāls, ko izmanto logrīks) un vai uzņēmuma plāns ietver tiešraidi. | chats:read |
live_chat_heartbeat | Atsvaidzināt pašreizējā lietotāja tiešraides tērzēšanas klātbūtnes sirds pukstu (tikai kamēr atzīmēts kā pieejams, izmantojot live_chat_set_availability). | chats:write |
live_chat_message_send | Nosūtīt ziņojumu apmeklētājam kā piešķirtais aģents. | chats:write |
live_chat_queue | Iegūt tiešraides tērzēšanas rindu: sesijas, kas gaida aģentu, vecākās vispirms (FIFO). | chats:read |
live_chat_session_assign | Pārņemt WAITING tiešraides tērzēšanas sesiju no rindas: piešķir to pašreizējam lietotājam (uzņēmuma īpašniekam API atslēgām) un paziņo apmeklētājam, ka aģents pievienojies. | chats:write |
live_chat_session_close | Beigt tiešraides tērzēšanas sesiju kā aģents (jebkurš uzņēmuma loceklis izņemot VIEWER). | chats:write |
live_chat_session_get | Iegūt tiešraides tērzēšanas sesiju ar apmeklētāja informāciju, piešķirto aģentu, visām ziņām un iepriekšējo bota sarunu (handoff konteksts). | chats:read |
live_chat_sessions_list | Uzskaitīt tiešraides tērzēšanas sesijas (jaunākās vispirms; WAITING sesijas vecākās vispirms) ar izvēles filtriem pēc čatbota, statusa un piešķirtā aģenta. | chats:read |
live_chat_set_availability | Pārslēgt pašreizējā lietotāja 'Available for Live Chat' slēdzi par uzņēmumu. | chats:write |
Leads
| Tool | Description | Scope |
|---|---|---|
lead_assign | Piešķirt lead uzņēmuma loceklim vai atcelt piešķiršanu (assignedToId: null). | leads:write |
lead_bulk_update_status | Iestatīt vairāku leadu statusu vienlaikus (maks. 100). | leads:write |
lead_categories_list | Uzskaitīt čatbota lead kategorijas ar lead skaitiem un komandas locekļiem, kas tiek paziņoti pa kategoriju. | leads:read |
lead_category_assign_user | Pievienot uzņēmuma locekli lead kategorijas paziņojumu sarakstam (vai atjaunināt viņu paziņojumu karodziņus). | leads:write |
lead_category_create | Izveidot lead kategoriju čatbotam. | leads:write |
lead_category_delete | Dzēst lead kategoriju. | leads:write |
lead_category_remove_user | Noņemt uzņēmuma locekli no lead kategorijas paziņojumu saraksta. | leads:write |
lead_category_update | Atjaunināt lead kategorijas nosaukumu, aprakstu un/vai krāsu. | leads:write |
lead_create | Manuāli izveidot lead (piem., | leads:write |
lead_delete | Neatgriezeniski dzēst lead. | leads:write |
lead_field_config_get | Iegūt čatbota lead capture konfigurāciju: lauki (id kartē uz atslēgām lead.data), apstiprinājuma ziņa, lauku/UI tulkojumi un AI atpazīšanas iestatījumi. | leads:read |
lead_field_config_update | Atjaunināt čatbota lead capture konfigurāciju. | leads:write |
lead_get | Iegūt lead pilnas detaļas, ieskaitot piešķirto personu, kategoriju un avota čata transkriptu (lappots ar messageOffset/messageLimit, pēc noklusējuma pirmās 20 ziņas). | leads:read |
lead_list | Uzskaitīt čatbota leadus (jaunākie vispirms) ar izvēles filtriem pēc statusa, kategorijas, piešķirtā un brīva teksta meklēšanas (vārds/e-pasts/uzņēmums). | leads:read |
lead_stats | Iegūt lead statistiku čatbotam: skaitītāji pēc statusa, leadi pēdējās 7 dienās un konversijas likme (procentos). | leads:read |
lead_update | Atjaunināt lead statusu, kategoriju, piezīmes, iegūtos datus un/vai piešķirto personu. | leads:write |
Veidlapas
| Tool | Description | Scope |
|---|---|---|
form_create | Izveidot kontaktveidlapu čatbotam (pamatdati, lauki, dizains un surogātpasta iestatījumi vienā izsaukumā). | forms:write |
form_delete | Neatgriezeniski dzēst kontaktveidlapu un VISUS tās iesniegumus (kaskādē). | forms:write |
form_get | Iegūt kontaktveidlapu pilnībā: lauki, tulkojumi, stils, surogātpasta iestatījumi, aktīvais stāvoklis, iesniegumu skaits un iegulšanas skripta tags (embedCode). | forms:read |
form_list | Uzskaitīt čatbota kontaktveidlapas ar lauku skaitiem, iesniegumu skaitiem un iegulšanas kodiem. | forms:read |
form_stats | Kontaktveidlapas iesniegumu skaitītāji: kopā, pending, approved, spam un rejected. | forms:read |
form_submission_delete | Neatgriezeniski dzēst kontaktveidlapas iesniegumu (piem., | forms:write |
form_submission_get | Iegūt kontaktveidlapas iesniegumu pilnībā: iesniegtie lauku dati, surogātpasta rezultāts un AI surogātpasta analīze, IP/user agent/referrer metadati un pārskatīšanas informācija. | forms:read |
form_submission_update_status | Pārskatīt kontaktveidlapas iesniegumu: iestatīt tā statusu uz APPROVED, SPAM vai REJECTED ar izvēles pārskata piezīmi. | forms:write |
form_submissions_list | Uzskaitīt kontaktveidlapas iesniegumus, jaunākie vispirms, pēc izvēles filtrējot pēc statusa (PENDING, APPROVED, SPAM, REJECTED) un izveides datuma. | forms:read |
form_update | Atjaunināt kontaktveidlapu: nosaukums, apraksts, aktīvais stāvoklis (isActive kontrolē, vai iegulšana renderējas), lauki (pilnīga aizstāšana), dizains (krāsas, pogas teksts, veiksmīgas ziņas) un surogātpasta iestatījumi (spamThreshold, autoRejectSpam, notificationEmail). | forms:write |
form_update_translations | Aizstāt lauku un/vai UI tulkojumus kontaktveidlapai. | forms:write |
Email Assistant
| Tool | Description | Scope |
|---|---|---|
email_activity_list | Uzskaitīt apstrādāto e-pastu aktivitātes žurnālu pastkastes savienojumam (jaunākais vispirms): sūtītājs, tēma, piešķirtā kategorija, iznākums (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) un outcomeDetail. | email:read |
email_categories_list | Uzskaitīt e-pasta kategorijas pastkastes savienojumam (sakārtotas pēc sortOrder). | email:read |
email_category_create | Izveidot e-pasta kategoriju pastkastes savienojumam (maks. 20 uz savienojumu). | email:write |
email_category_delete | Dzēst e-pasta kategoriju. | email:write |
email_category_update | Atjaunināt e-pasta kategoriju (daļēji: mainās tikai norādītie lauki). | email:write |
email_connection_disconnect | Atvienot pastkasti neatgriezeniski. | email:write |
email_connection_get | Iegūt pastkastes savienojumu, ieskaitot. | email:read |
email_connection_update | Atjaunināt pastkastes savienojumu: pauzēt/atsākt sinhronizāciju (paused true/false; tikai pārslēdz ACTIVE<->DISABLED, nekad nepārraksta TOKEN_EXPIRED/ERROR), pārslēgt atbildes melnrakstu sagatavošanu (draftingEnabled) un kategorizēšanu/organizēšanu (organizingEnabled), pāradresēt barojošo čatbotu (chatbotId tajā pašā uzņēmumā) vai iestatīt HTML atbildes parakstu (signatureHtml, maks. 20000 rakstzīmju; tukša virkne notīra to). | email:write |
email_connections_list | Uzskaitīt uzņēmuma Email Assistant pastkastes savienojumus (adrese, statuss ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, pēdējā sinhronizācija, pēdējā kļūda, drafting/organizing pārslēgi, barojošais čatbots, draftReadyCategoryCount = kategorijas, kas var radīt melnrakstus, baseRuleCount = čatbotu līmeņa 'Chat + Email' noteikumi, kas tiek piemēroti katram melnrakstam) kopā ar plāna limitiem (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth). | email:read |
email_contact_delete | Dzēst iemācītu e-pasta kontaktu (aizmirst sūtītāja profilu, piem., | email:write |
email_contact_get | Iegūt iemācītu e-pasta kontaktu ar visiem iemācītajiem faktiem, iekšējām piezīmēm, attiecībām, formālās/neformālās uzrunas iestatījumu un e-pasta statistiku. | email:read |
email_contact_update | Atjaunināt iemācītu e-pasta kontaktu. | email:write |
email_contacts_list | Uzskaitīt uzņēmuma iemācītos e-pasta kontaktus (pēdējais e-pasts pirmais) ar attiecību, formālās/neformālās uzrunas (formalAddress: true = formāls 'Sie', false = neformāls 'Du', null = automātisks), faktu skaitu un piezīmju priekšskatījumu. | email:read |
email_folder_create | Izveidot pastkastītes mapīti iesūtnei (atgriež esošo, ja nosaukums aizņemts), ko izmantot kā kategorijas pārvietošanas mērķi. | email:write |
email_folders_list | Uzskaitīt mapes, uz kurām e-pasta kategorija var pārvietot pastu tiešraidē no pastkastes: iesūtnes apakšmapes, pielāgotas augšējā līmeņa mapes, arhīvs, surogātpasts un trash (id 'deleteditems'). | email:read |
email_general_rules_list | Uzskaitīt čatbotu līmeņa noteikumus, kas tiek piemēroti katram atbildes melnrakstam pastkastei: aktīvās pamata instrukcijas ar kanālu BOTH ("Chat + Email"), plus leģendārie tikai e-pastam, kas vēl nav migrēti uz kategoriju. | email:read |
Analītika
| Tool | Description | Scope |
|---|---|---|
analytics_chat_volume | Čatu apjoms (sāktās sesijas) laika gaitā diagrammām un tendencēm: periods week/month/quarter/year, granularity hour/day/week/month, pēc izvēles vienam čatbotam. | analytics:read |
analytics_chatbot_stats | Pa-čatbotu veiktspēja uzņēmumam vienā izsaukumā (informācijas paneļa čatbota veiktspējas tabula): id, nosaukums, slug, isActive, sesijas, ziņas, FAQ un leadi pa čatbotu, kārtots pēc sesijām. | analytics:read |
analytics_forms | Kontaktveidlapu iesniegumu statistika uzņēmumam vai vienam čatbotam (informācijas paneļa analītikas logrīks): iesniegumi pēc statusa (pending/approved/rejected/spam), veidlapu skaits, kopā, surogātpasta likme procentos un pēdējo 7 dienu iesniegumu dienas sērija. | analytics:read |
analytics_leads | Lead piltuve uzņēmumam vai vienam čatbotam (informācijas paneļa analītikas logrīks): leadi pēc statusa (new/contacted/qualified/converted/lost), kopā, konversijas likme procentos un leadu dienas sērija pēdējās 7 dienās. | analytics:read |
analytics_overview | Analītikas pārskats uzņēmumam vai vienam čatbotam: čati, ziņas, apmierinātības rādītājs un top jautājumi pagriežamā periodā (day/week/month/year), plus informācijas paneļa pārskata logrīks (kopējie čatboti/publicētie FAQ/lead, sesijas šodien/šonedēļ/šomēnes, leadi šodien/šonedēļ, veidlapu iesniegumi kopā/šodien/pending). | analytics:read |
dashboard_activity | Kas pašlaik prasa uzmanību (informācijas paneļa sākumlapa): pa uzņēmumu — čatboti ar jauniem leadiem šodien, gaidošie FAQ ieteikumi, gaidošie veidlapu iesniegumi, gaidošas/aktīvas tiešraides tērzēšanas vai notiekoša mācību fāze. | any |
Piemēru darbplūsmas
Pamata instrukcijas pievienošana
Lūdziet savu AI asistentu:
"Pievienojiet pamata instrukciju manam 'Support Bot' čatbotam: mēs nodrošinām bezmaksas piegādi pasūtījumiem virs €50"
Assistent izmantos chatbot_add_instruction ar atbilstošiem parametriem.
Uzlabošanas ieteikumu pārskatīšana
"Rādiet man visus gaidošos uzlabošanas priekšlikumus manam čatbotam un izskaidrojiet, kādas izmaiņas tie iesaka"
Assistent veiks:
- Izmantot
improvement_proposals_pending, lai iegūtu priekšlikumus - Analizēt un apkopot katru ieteikumu
- Apstiprināt vai noraidīt tos Jūsu vietā ar
improvement_proposal_approvevaiimprovement_proposal_reject
Čatu veiktspējas analīze
"Dodiet man nedēļas ziņojumu par čatu apjomu un klientu apmierinātību manam čatbotam"
Assistent izmantos analytics_overview un analytics_chat_volume, lai sagatavotu visaptverošu ziņojumu.
Vietnes importēšana
"Skenējiet https://example.com, importējiet produktu un cenu lapas manā 'Support Bot' un paziņojiet, kad indeksēšana pabeigta"
Assistent izsauks crawler_preview_scan, izvēlēsies atbilstošās lapas, sāks importu ar crawler_start un periodiski vaicās crawler_job_get, līdz darbs būs pabeigts.
Leadu un veidlapu iesniegumu pārskatīšana
"Rādiet man jaunus leadus no šīs nedēļas, piešķiriet kvalificētos Annai un apstipriniet gaidošos kontaktveidlapu iesniegumus"
Assistents apvieno lead_list, lead_assign, form_submissions_list un form_submission_update_status.
Pārņemt tiešraides tērzēšanu
"Iestatiet mani pieejamu tiešraides tērzēšanai un pārņemiet vecāko gaidošo sarunu"
Assistent izmanto live_chat_set_availability, live_chat_queue un live_chat_session_assign; atbildes tiek nodotas caur live_chat_message_send.
Drošība
- API atslēgas ir piesaistītas Jūsu uzņēmumam un piešķirtajiem atļauju diapazoniem, ko izvēlaties to izveides brīdī (skat. kolonu Scope augstāk)
- Atslēgas darbojas ar uzņēmuma īpašnieka atļaujām; plāna ierobežojumi un funkciju slēdzējas tiek piemērotas tieši kā informācijas panelī
- Atslēgas var atsaukt jebkurā brīdī no informācijas paneļa
- API piekļuve ir pieejama apmaksātajos plānos — skatiet mūsu Pricing page
Problēmu novēršana
Savienojums neizdevās
- Pārbaudiet, vai Jūsu API atslēga ir pareiza
- Pārliecinieties, ka atslēga nav atsaukta
- Pārliecinieties, ka Jūsu plānā ir iekļauta API piekļuve
- Restartējiet savu MCP klientu
Rīks nav atrasts
Pēc konfigurācijas maiņas restartējiet savu MCP klientu, lai tas pārlādētu pieejamos rīkus. Rīku nosaukumi ir ar mazajiem burtiem un apakšsvītrām (piemēram, faq_list).
Nepieciešama palīdzība? Sazinieties ar mūsu atbalsta komandu →