AcasăDocumentație

MCP Server Integration

ChatReact implementează Model Context Protocol (MCP), permițându-vă să vă conectați contul ChatReact la asistenți AI precum Claude Desktop, Cursor și alte unelte compatibile MCP.

Ce este MCP?

Model Context Protocol este un standard deschis care permite asistenților AI să interacționeze cu servicii și surse de date externe. Cu integrarea MCP a ChatReact, puteți:

  • Gestiona chatbot-uri — creați, configurați (persoană, limbi, widget, comportament, restricții), încorporați și ștergeți chatbot-uri
  • Construi baza de cunoștințe — adăugați documente, scanați site-uri web, gestionați paginile scanate și instrucțiunile de bază
  • Gestiona FAQ-uri — FAQ-uri, categorii, sugestii, traduceri și widget-ul FAQ
  • Revizui conversații — evaluați conversațiile, atribuiți categorii de încredere, rulați Improvement Agent
  • Lucra cu lead-uri și formulare — lead-uri, categorii de lead, setări de captare, formulare de contact și trimitere
  • Acționa ca agent live chat — setați-vă disponibilitatea, preluați conversațiile în așteptare, răspundeți și închideți sesiunile
  • ** administrați compania** — profil, culori de brand, membri ai echipei și invitații
  • Utilizați Email Assistant — conexiuni mailbox, categorii, contacte și activitate
  • Citiți analize și notificări

Tot ceea ce puteți face în dashboard este disponibil prin MCP (și REST API); doar acțiunile care necesită browser, precum plăți, mailbox OAuth, passkeys, ștergerea contului și gestionarea cheilor API rămân în dashboard.

Începeți

1. Generați o cheie API

  1. Navigați la Tablou de bord → Companie → API din contul dumneavoastră
  2. Faceți clic pe Creați cheie API
  3. Dați cheii un nume descriptiv (de ex., "Claude Desktop") și selectați cel puțin o permisiune
  4. Copiați cheia generată (începe cu cr_)

Cheile API sunt disponibile pe planuri plătite — vedeți Pricing page.

Stocați cheia API în siguranță. Nu poate fi recuperată după creare.

2. Configurați clientul MCP

Serverul MCP al ChatReact este găzduit la https://www.chatreact.ai/api/mcp și comunică prin HTTP (JSON-RPC). Autentificați-vă cu antetul Authorization: Bearer — se acceptă și un antet X-API-Key cu aceeași cheie.

Cursor IDE

Cursor acceptă servere MCP remote direct. Adăugați la setările MCP din Cursor:

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

Claude Desktop

Fișierul de configurare Claude Desktop acceptă servere bazate pe comandă, așa că folosiți bridge-ul standard mcp-remote pentru a vă conecta la endpointul găzduit:

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

Această configurare necesită Node.js instalat. Exemplul folosește antetul X-API-Key deoarece unii clienți nu gestionează spațiile în argumente în mod fiabil.

3. Repornirea asistentului AI

După salvarea configurației, reporniți Claude Desktop sau Cursor pentru a stabili conexiunea.

Unelte disponibile

ChatReact MCP expune uneltele de mai jos, grupate pe domenii. Coloana Scope arată permisiunea cheii API necesară pentru fiecare unealtă (any = orice cheie validă). Uneltele rulează cu aceleași permisiuni aplicabile, limite de plan și efecte secundare ca și operațiile suportate în dashboard. Fluxurile legate de browser pentru plăți, autorizare mailbox, passkey-uri, ștergerea contului și gestionarea cheilor rămân în dashboard.

Uneltele distructive (delete, reset, close, merge) cer confirmare când sunt folosite prin Dashboard Assistant. Prin cheie API execută imediat.

Cont

ToolDescriptionScope
account_usage_getObține planul curent (tier, status), contoarele de utilizare pentru perioada curentă de facturare (companies, chatbots, team members, chats, tokens) și limitele planului, plus limitele efective și feature flags ale companiei la care este scoped apelul.any
user_companiesListează toate companiile la care utilizatorul curent are acces, cu rolul utilizatorului în fiecare.any
user_notification_mark_readMarchează una dintre notificările utilizatorului curent ca citită.any
user_notification_preferences_getObține preferințele de notificare ale utilizatorului curent: butoane globale email/push, frecvența/timpul/ziua/timpzona pentru digest, ore de liniște și setări pe tip de canal.any
user_notification_preferences_updateActualizează preferințele globale de notificare ale utilizatorului curent (toggler email/push, program digest, ore de liniște).any
user_notification_type_setting_updateActivează sau dezactivează livrarea prin email / in-app pentru un singur tip de notificare al utilizatorului curent (de ex.any
user_notification_types_listListează toate tipurile de notificare grupate pe categorii (chatbot, leads, live chat, knowledge, team, billing).any
user_notification_unread_countObține numărul de notificări necitite ale utilizatorului curent.any
user_notificationsListează notificările utilizatorului curent, cele mai noi primele, cu paginare cursor.any
user_notifications_delete_oldMentenanță: șterge definitiv notificările utilizatorului curent care sunt deja citite și mai vechi de 30 de zile.any
user_notifications_mark_all_readMarchează toate notificările utilizatorului curent ca citite.any
user_profileObține profilul utilizatorului curent (id, name, email, role, subscription tier).any

Companie & Echipa

ToolDescriptionScope
company_chatbots_listListează toate chatbot-urile unei companii specifice cu statistici sumare.chatbots:read
company_getObține informații detaliate despre o companie: profil, owner, setări de brand (culori, email pentru notificări) și contorizări.any
company_invite_cancelAnulează (șterge) o invitație de echipă astfel încât linkul să nu mai funcționeze.company:write
company_invite_resendRetrimite o invitație de echipă în așteptare: emite un token nou, extinde expirarea cu 7 zile și retrimite emailul de invitație.company:write
company_invites_listListează invitațiile de echipă ale unei companii (implicit PENDING; setați includeExpired pentru a returna și cele expirate).company:read
company_listListează toate companiile la care utilizatorul are acces (cheile API și Dashboard Assistant văd doar propria lor companie).any
company_logo_removeElimină logo-ul companiei (șterge imaginea stocată și curăță URL-ul logo-ului).company:write
company_member_inviteInvitați un membru în echipă prin email cu un rol (ADMIN, MANAGER, AGENT sau VIEWER).company:write
company_member_removeElimină un membru din companie.company:write
company_member_update_roleSchimbați rolul unui membru al echipei (ADMIN, MANAGER, AGENT sau VIEWER).company:write
company_members_listListează membrii unei companii cu rolurile lor (OWNER, ADMIN, MANAGER, AGENT, VIEWER).any
company_settings_updateActualizează setările de brand ale companiei: primaryColor / secondaryColor (#RRGGBB) și notificationEmail pentru revizuirile de chat.company:write
company_updateActualizează profilul companiei: nume (2-100 caractere), descriere (max 1000 caractere) sau website (https:// este adăugat automat; pasați un string gol pentru a șterge website/descriere).company:write

Management Chatbot

ToolDescriptionScope
chatbot_add_instructionAdaugă o nouă instrucțiune de bază la un chatbot (1-5000 caractere).chatbots:write
chatbot_confirm_embedMarchează un chatbot ca fiind încorporat pe site (ascunde memento-ul de configurare din dashboard).chatbots:write
chatbot_createCreează un nou chatbot (la fel ca wizard-ul din dashboard).chatbots:write
chatbot_deleteȘterge permanent un chatbot cu toate FAQ-urile, documentele, conversațiile, lead-urile și formularele sale (nu se poate anula).chatbots:write
chatbot_delete_instructionȘterge o instrucțiune de bază dintr-un chatbot.chatbots:write
chatbot_getObține informații detaliate despre un chatbot: setări generale, personalitate (persona, tonalitate, limbi, restricții), setări widget, live chat, faza de învățare, statut de embed și contorizări.chatbots:read
chatbot_get_embed_codeObține fragmentul HTML pentru instalarea unui chatbot pe un site (URL script + <script> tag) și dacă embed-ul a fost confirmat.chatbots:read
chatbot_get_instructionsObține toate instrucțiunile de bază pentru un chatbot.chatbots:read
chatbot_improve_instructionsRescrie textul unei instrucțiuni de bază cu ajutorul AI-ului platformei (la fel ca 'Improve with AI' din dashboard).chatbots:write
chatbot_learning_phase_getObține setările fazei de învățare ale unui chatbot: preset comportament (CAUTIOUS, BALANCED, CONFIDENT), prompt personalizat și dacă botul este încă în faza de învățare.chatbots:read
chatbot_learning_phase_updateSetează presetul de comportament al fazei de învățare (CAUTIOUS = trimite la uman când nu e sigur, BALANCED, CONFIDENT) și/sau un prompt personalizat pentru faza de învățare.chatbots:write
chatbot_listListează toate chatbot-urile la care utilizatorul are acces, cu statistici sumare.chatbots:read
chatbot_reorder_instructionsSetează ordinea instrucțiunilor de bază ale unui chatbot.chatbots:write
chatbot_templates_listListează template-urile de chatbot (preseturi pentru persona, tonalitate, mesaje și comportament widget) care pot fi transmise ca templateId către chatbot_create, și dacă planul companiei le poate folosi.chatbots:read
chatbot_toggle_activeActivează sau dezactivează un chatbot.chatbots:write
chatbot_toggle_learningÎncheie (false) sau reactivează (true) faza de învățare a unui chatbot.chatbots:write
chatbot_updateActualizează setările generale ale unui chatbot: nume, descriere, isActive, live chat (liveChatEnabled/liveChatMode, feature de plan), showBranding (planuri white-label), emailuri pentru revizuiri de chat, generare automată FAQ, text legacy coreInstructions, faza de învățare (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt).chatbots:write
chatbot_update_instructionActualizează o instrucțiune de bază existentă (content, isActive, channel, sortOrder).chatbots:write
chatbot_update_personalityActualizează personalitatea unui chatbot: persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), glisoare de tonalitate 1-5, limbi (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), mesaje (welcomeMessage, fallbackMessage, proactive greeting) și restricții (blacklistTopics, complianceRules, maxResponseLength, human handoff).chatbots:write
widget_settings_getObține setările curente ale widget-ului pentru un chatbot (toată aparența, brandingul, comportamentul și câmpurile formularului pre-chat).chatbots:read
widget_settings_updateActualizează widget-ul de chat al unui chatbot: poziție (incl.chatbots:write
widget_translations_getObține traducerile widget-ului per limbă pentru un chatbot: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }.chatbots:read
widget_translations_updateSetează traducerile widget-ului per limbă.chatbots:write

Baza de cunoștințe

ToolDescriptionScope
crawler_job_cancelAnulează un job de crawl aflat în starea PENDING sau RUNNING; paginile rămase sunt omise.knowledge:write
crawler_job_getObține starea unui job de crawl, progresul (pagesCrawled/pagesFound, tokensUsed) și starea fiecărei pagini.knowledge:read
crawler_jobs_listListează job-urile de crawl ale unui chatbot (cele mai noi primele) cu starea și progresul.knowledge:read
crawler_limitsObține limitele de crawl ale planului pentru un chatbot (max pagini per crawl, tokens per pagină, crawls per lună) și dacă se poate porni un nou crawl în această lună.knowledge:read
crawler_preview_scanScanează un site și listează paginile care pot fi crawl-uite (url, title, isRecommended) fără a importa nimic.knowledge:write
crawler_startPornește un job de crawl care importă URL-urile selectate în baza de cunoștințe a chatbot-ului (procesat în fundal; interogați crawler_job_get).knowledge:write
knowledge_document_add_from_urlDescarcă un document (PDF, TXT, MD, CSV, JSON, DOCX; max 10 MB) de la un URL public http(s) și îl adaugă în baza de cunoștințe a chatbot-ului.knowledge:write
knowledge_document_add_textAdaugă un document text sau markdown la baza de cunoștințe a chatbot-ului din conținut inline (max 10 MB).knowledge:write
knowledge_document_deleteȘterge un document încărcat din baza de cunoștințe.knowledge:write
knowledge_document_getObține detalii despre un document încărcat incluzând starea de procesare, mesajul de eroare și un URL de descărcare cu viață scurtă.knowledge:read
knowledge_documents_listListează documentele încărcate (PDF, TXT, MD, CSV, JSON, DOCX) din baza de cunoștințe a unui chatbot cu stare și dimensiune.knowledge:read
knowledge_page_addCrawl-uiește un singur URL și îl adaugă în baza de cunoștințe a chatbot-ului (eșuează cu CONFLICT când URL-ul este deja indexat, FORBIDDEN când s-a atins limita de tokeni).knowledge:write
knowledge_page_deleteȘterge o pagină crawl-uită din baza de cunoștințe (elimină fișierul din vector-store).knowledge:write
knowledge_page_getObține o pagină crawl-uită incluzând conținutul markdown care a fost indexat pentru chatbot (util pentru a verifica ce știe botul despre o pagină).knowledge:read
knowledge_page_recrawlRepreia o pagină crawl-uită și înlocuiește conținutul indexat (de ex.knowledge:write
knowledge_pages_deleteȘterge mai multe pagini crawl-uite ale unui chatbot odată.knowledge:write
knowledge_pages_listListează paginile crawl-uite din baza de cunoștințe a unui chatbot, opțional filtrate după domeniu, stare sau un termen de căutare (URL/title).knowledge:read
knowledge_statsPrezentare generală a bazei de cunoștințe a unui chatbot: documente (după stare, dimensiune), pagini crawl-uite și site-uri (după stare), job-uri de crawl, instrucțiuni de bază separate pe sursă (manual vs improvement agent), FAQ-uri, status/size vector store și utilizarea stocării vs.knowledge:read
knowledge_website_deleteȘterge toate paginile crawl-uite ale unui site (domeniu) din baza de cunoștințe a chatbot-ului.knowledge:write
knowledge_website_recrawlRe-crawl-uiește toate paginile unui site (domeniu) din baza de cunoștințe a chatbot-ului pentru a le reîmprospăta conținutul.knowledge:write
knowledge_website_recrawl_cancelAnulează un re-crawl în curs pentru un site: paginile în coadă (PENDING) ale domeniului revin la starea lor indexată anterioară.knowledge:write
knowledge_websites_listListează site-urile (domeniile) ale căror pagini sunt în baza de cunoștințe a unui chatbot, cu numărul de pagini pe stare și totaluri de tokeni.knowledge:read

Management Prețuri

Aceste unelte gestionează drafturi structurate de prețuri și aprobări explicite. Salvarea unui draft este separată de aprobarea versiunii exacte; eligibilitatea depinde și de statut și validitate. Cheile API existente nu primesc automat permisiuni pentru prețuri. Doar owner-ul companiei poate acorda prices:write sau prices:approve. Apelurile prin cheie API se execută direct, deci revizuiți inputul exact înainte de a apela o mutație. Vedeți Prices & services pentru fluxul de lucru al clientului.

ToolDescriptionScope
price_listParcurge head-urile de preț și eligibilitatea versiunii aprobate separat.prices:read
price_getCitește starea completă a unui item și reviziunile.prices:read
price_detailCitește detaliul itemului cu istoric de revizuiri paginat.prices:read
price_suggestions_listParcurge sugestiile de preț.prices:read
price_createCreează un draft cu un ID de item generat de server.prices:write
price_editCreează un nou draft dintr-o versiune de item explicit așteptată.prices:write
price_import_csvImportă drafturi cu un format explicit și un import ID stabil pentru retry-uri sigure.prices:write
price_suggestion_applyAplică candidatul de sugestie selectat ca draft.prices:write
price_approveAprobă o versiune de item explicit așteptată.prices:approve
price_approve_manyAprobă atomic o selecție explicită ID/versiune; orice versiune învechită respinge întreaga selecție.prices:approve
price_archiveArhivează un item la versiunea sa explicit așteptată.prices:approve

Editările draft păstrează revizia aprobată anterioară. Formatul CSV și separatorul zecimal trebuie să fie explicite; conținutul CSV modificat necesită un nou import ID. Toate operațiile sunt legate de compania cheii API și de chatbot-ul specificat.

Management FAQ

ToolDescriptionScope
faq_cache_purgeCurăță datele cache ale widget-ului FAQ pe toate site-urile CMS conectate (plugin WordPress).faqs:write
faq_categories_listListează categoriile FAQ ale unui chatbot cu numărul de FAQ-uri, slug-uri, modul de sortare și traducerile.faqs:read
faq_categories_reorderSetează ordinea categoriilor FAQ în widget: poziția în categoryIds devine sortOrder.faqs:write
faq_category_createCreează o categorie FAQ pentru un chatbot (slug-ul se generează din nume).faqs:write
faq_category_deleteȘterge o categorie FAQ.faqs:write
faq_category_translations_updateÎnlocuiește traducerile unei categorii FAQ, de ex.faqs:write
faq_category_updateRedenumește o categorie FAQ sau schimbă descrierea, iconița sau modul de sortare.faqs:write
faq_createCreează un FAQ pentru un chatbot.faqs:write
faq_deleteȘterge permanent un FAQ (îl elimină și din baza de cunoștințe a chatbot-ului și purgează cache-urile widget-ului CMS).faqs:write
faq_embed_code_getObține snippet-urile de embed pentru widget-ul FAQ: tag script, shortcode WordPress și fragment Shopify Liquid, plus variante per categorie (folosiți categorySlug din faq_categories_list pentru a încorpora o singură categorie).chatbots:read
faq_getObține detaliile complete ale unui FAQ: întrebare, răspuns, categorie, stare de publicare, ordinea, traduceri, câmpuri SEO și statistici de feedback.faqs:read
faq_listListează FAQ-urile unui chatbot (folosiți chatbot_list pentru a găsi chatbotId).faqs:read
faq_reorderSetează ordinea de afișare a FAQ-urilor în widget.faqs:write
faq_suggestion_approveAprobă o sugestie FAQ aflată în PENDING: creează un FAQ publicat (opțional cu întrebare/răspuns/categorie editate) și marchează sugestia ca APPROVED.faqs:write
faq_suggestion_getObține detaliile complete ale unei sugestii FAQ (răspuns complet, raționament AI, categorie sugerată, stare de revizuire).faqs:read
faq_suggestion_rejectRespingere o sugestie FAQ în PENDING cu un motiv opțional.faqs:write
faq_suggestions_generatePermite AI-ului să propună FAQ-uri noi din baza de cunoștințe a chatbot-ului (pagini crawl-uite / documente încărcate), opțional pentru o singură categorie.faqs:write
faq_suggestions_listListează sugestiile FAQ generate de AI ale unui chatbot (din conversații de chat sau faq_suggestions_generate).faqs:read
faq_translateTraduce cu AI întrebarea și răspunsul unui FAQ în celelalte limbi suportate de chatbot (sau în targetLanguages specificate) și salvează rezultatul.faqs:write
faq_translations_updateSalvează traducerile unui FAQ per limbă, de ex.faqs:write
faq_updateActualizează întrebarea, răspunsul, categoria, starea de publicare sau ordinea manuală a unui FAQ.faqs:write
faq_widget_settings_getObține setările de aspect și comportament ale widget-ului FAQ încorporabil (culori, border radius, titlu, spațiere, max width, allowMultipleOpen, autoOpenFirst, sort mode, traduceri de titlu).chatbots:read
faq_widget_settings_updateActualizează setările widget-ului FAQ: culori (hex), borderRadius 0-32, titlu (max 100) + showTitle, spacing compact|normal|relaxed, maxWidth 0-2000 (0 = lățime completă), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name și traduceri de titlu per limbă.chatbots:write

Istoric Chat & Feedback

ToolDescriptionScope
chat_feedback_dismissMarchează un chat ca revizuit fără a-l evalua (îl elimină din coada în așteptare, nu schimbă scorul de încredere).chats:write
chat_feedback_getObține o revizuire de chat (feedback) cu analiză AI, severitate, categorie de încredere, schimbare de scor și sesiune de îmbunătățire legată.chats:read
chat_feedback_listListează revizuirile de chat (rânduri de feedback) ale unui chatbot cu filtrare pe stare și contorizări.chats:read
chat_feedback_set_severitySuprascrie clasificarea severității (MINOR|MODERATE|MAJOR|CRITICAL) a unui chat negativ revizuit; severitatea cântărește scăderea scorului de încredere.chats:write
chat_feedback_statsContoare de sesiuni per bucket de revizuire pentru un chatbot (total, none, pending, positive, negative, reviewed, improved) — cardurile statistice din pagina chats a dashboard-ului.chats:read
chat_feedback_submitEvaluează o sesiune de chat ca Good (isPositive=true) sau Needs Work (isPositive=false).chats:write
chat_session_getObține o sesiune de chat cu transcriptul complet (per-mesaj token/model/latency/pageUrl), detalii vizitator, URL-ul paginii de start, categoria de încredere, feedback (severitate, analiză AI, sesiune de îmbunătățire legată) și tag-uri.chats:read
chat_session_searchCaută sesiuni de chat ale unui chatbot după conținutul mesajelor și/sau emailul vizitatorului.chats:read
chat_session_set_categoryAtribuie sau schimbă categoria de încredere a unei sesiuni de chat (corectează clasificarea AI; încrederea per categorie se recalculează când chat-ul a fost revizuit).chats:write
chat_sessions_listListează sesiuni de chat ale unui chatbot, cele mai noi primele, cu aceleași filtre din coada de revizuire ca pagina chats din dashboard.chats:read

Improvement Agent

ToolDescriptionScope
confidence_categories_listListează categoriile de încredere ale unui chatbot cu scor pe categorie, număr de revizuiri și frecvența emailurilor de revizuire.chats:read
confidence_category_createCreează o categorie de încredere pentru un chatbot.chatbots:write
confidence_category_deleteȘterge o categorie de încredere.chatbots:write
confidence_category_mergeUnește o categorie de încredere într-alta a aceluiași chatbot: toate chat-urile/revizuirile se mută la țintă, sursa este ștearsă și scorurile sunt recalculare.chatbots:write
confidence_category_updateRedenumește o categorie de încredere și/sau setează frecvența emailurilor de revizuire (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1-24 doar pentru HOURLY).chatbots:write
confidence_status_getStarea de încredere a unui chatbot: scor, prag de absolvire, flag fază de învățare, comportament fază de învățare (CAUTIOUS|BALANCED|CONFIDENT) și prompt personalizat, număr de revizuiri și scoruri per categorie.analytics:read
improvement_proposal_approveAprobă o propunere de îmbunătățire aflată în PENDING și aplică schimbarea la chatbot (adăugare/actualizare instrucțiune de bază, creare/actualizare FAQ sau actualizare persona) — aceeași logică și limite de plan ca în dashboard.chatbots:write
improvement_proposal_rejectRespinge o propunere de îmbunătățire aflată în PENDING.chatbots:write
improvement_proposal_simulateSimulează cum ar răspunde chatbot-ul la mesajul problematic cu o propunere aplicată (original vs.chatbots:write
improvement_proposals_pendingListează propunerile de îmbunătățire care așteaptă revizuirea (status PENDING) la nivelul companiei sau pentru un chatbot.chatbots:read
improvement_session_completeMarchează o sesiune de îmbunătățire ca COMPLETED (chat-ul este atunci contabilizat ca Improved în coada de revizuire).chatbots:write
improvement_session_createDeschide Improvement Agent pentru un chat evaluat Needs Work.chatbots:write
improvement_session_getObține o sesiune de îmbunătățire cu chat-ul original (mesajele au un index bazat pe 1 utilizabil ca targetMessageIndex), conversația agentului, toate propunerile (cu ultima lor simulare) și simulările.chatbots:read
improvement_session_resetRepornește o sesiune de îmbunătățire: șterge toate mesajele agentului, simulările și propunerile PENDING/REJECTED (cele aplicate rămân) și pornește o conversație nouă.chatbots:write
improvement_session_send_messageTrimite un mesaj către Improvement Agent (descrie ce a fost greșit la răspunsul botului; opțional targetMessageIndex = indexul bazat pe 1 al mesajului bot în originalChat.messages).chatbots:write
improvement_sessions_listListează sesiunile de îmbunătățire (conversații Improvement Agent pornite din recenzii negative) pentru un chatbot sau întreaga companie, cele mai noi primele, cu numărul de propuneri.chatbots:read
improvement_simulation_assessEvaluează rezultatul unei simulări: isApproved=true când răspunsul simulat este bun (propunerea poate fi atunci aplicată), false când mai are nevoie de muncă (comentariu 'almost' = aproape corect).chatbots:write

Live Chat

ToolDescriptionScope
live_chat_agents_availableObține disponibilitatea live chat a utilizatorului curent, agenții disponibili pentru live chat (heartbeat recent, același semnal folosit de widget) și dacă planul companiei include live chat.chats:read
live_chat_heartbeatReîmprospătează heartbeat-ul de prezență live chat al utilizatorului curent (doar în timp ce este marcat disponibil prin live_chat_set_availability).chats:write
live_chat_message_sendTrimite un mesaj vizitatorului ca agentul atribuit.chats:write
live_chat_queueObține coada live chat: sesiunile care așteaptă un agent, cele mai vechi primele (FIFO).chats:read
live_chat_session_assignPreia o sesiune live chat în WAITING din coadă: o atribuie utilizatorului curent (owner-ul companiei pentru chei API) și notifică vizitatorul că agentul s-a alăturat.chats:write
live_chat_session_closeÎncheie o sesiune live chat ca agent (orice membru al companiei non-VIEWER).chats:write
live_chat_session_getObține o sesiune live chat cu info vizitator, agent atribuit, toate mesajele și convorbirea anterioară a botului (contextul handoff).chats:read
live_chat_sessions_listListează sesiunile live chat (cele mai noi primele; sesiunile WAITING cele mai vechi primele) cu filtre opționale după chatbot, stare și agent atribuit.chats:read
live_chat_set_availabilityComută switch-ul 'Available for Live Chat' al utilizatorului curent pentru o companie.chats:write

Lead-uri

ToolDescriptionScope
lead_assignAtribuie un lead unui membru al companiei sau îl dezatribue (assignedToId: null).leads:write
lead_bulk_update_statusSetează starea mai multor lead-uri (max 100) simultan.leads:write
lead_categories_listListează categoriile de lead ale unui chatbot cu numărul de lead-uri și membrii echipei notificați per categorie.leads:read
lead_category_assign_userAdaugă un membru al companiei la lista de notificare a unei categorii de lead (sau actualizează flag-urile lor de notificare).leads:write
lead_category_createCreează o categorie de lead pentru un chatbot.leads:write
lead_category_deleteȘterge o categorie de lead.leads:write
lead_category_remove_userElimină un membru al companiei din lista de notificare a unei categorii de lead.leads:write
lead_category_updateActualizează numele, descrierea și/sau culoarea unei categorii de lead.leads:write
lead_createCreează manual un lead (de ex.leads:write
lead_deleteȘterge un lead permanent.leads:write
lead_field_config_getObține configurația de captare a lead-urilor a unui chatbot: câmpuri (ids map to keys in lead.data), mesaj de confirmare, traduceri de câmp/UI și setări de recunoaștere AI.leads:read
lead_field_config_updateActualizează configurația de captare a lead-urilor a unui chatbot.leads:write
lead_getObține detalii complete ale unui lead incluzând assignee, categorie și transcriptul chat-ului sursă (paginat cu messageOffset/messageLimit, implicit primele 20 de mesaje).leads:read
lead_listListează lead-urile unui chatbot (cele mai noi primele) cu filtre opționale după stare, categorie, assignee și căutare text liber (nume/email/companie).leads:read
lead_statsObține statistici despre lead-uri pentru un chatbot: număr pe stări, lead-uri din ultimele 7 zile și rata de conversie (procent).leads:read
lead_updateActualizează starea, categoria, notițele, datele captate și/sau assignee-ul unui lead.leads:write

Formulare

ToolDescriptionScope
form_createCreează un formular de contact pentru un chatbot (bază, câmpuri, design și setări anti-spam într-un singur apel).forms:write
form_deleteȘterge permanent un formular de contact și TOATE trimitere sale (cascade).forms:write
form_getObține un formular de contact în integralitate: câmpuri, traduceri, styling, setări anti-spam, stare activă, număr de trimitere și tag-ul de embed (embedCode).forms:read
form_listListează formularele de contact ale unui chatbot cu numărul de câmpuri, contorul trimitere și coduri de embed.forms:read
form_statsContoare de trimitere ale unui formular de contact: total, pending, approved, spam și rejected.forms:read
form_submission_deleteȘterge permanent o trimitere a unui formular de contact (de ex.forms:write
form_submission_getObține o trimitere de formular de contact în integralitate: datele câmpurilor trimise, scor spam și analiză AI anti-spam, metadata IP/user agent/referrer și informații de revizuire.forms:read
form_submission_update_statusRevizuiește o trimitere de formular de contact: setează starea la APPROVED, SPAM sau REJECTED cu o notă de revizuire opțională.forms:write
form_submissions_listListează trimitere ale unui formular de contact, cele mai noi primele, opțional filtrate după stare (PENDING, APPROVED, SPAM, REJECTED) și data creării.forms:read
form_updateActualizează un formular de contact: nume, descriere, stare activă (isActive controlează dacă embed-ul se afișează), câmpuri (înlocuire completă), design (culori, text buton, mesaj de succes) și setări anti-spam (spamThreshold, autoRejectSpam, notificationEmail).forms:write
form_update_translationsÎnlocuiește traducerile câmpurilor și/sau UI ale unui formular de contact.forms:write

Email Assistant

ToolDescriptionScope
email_activity_listListează jurnalul de activitate al email-urilor procesate pentru o conexiune mailbox (cele mai noi primele): expeditor, subiect, categorie atribuită, rezultat (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) și outcomeDetail.email:read
email_categories_listListează categoriile de email ale unei conexiuni mailbox (ordonate după sortOrder).email:read
email_category_createCreează o categorie de email pentru o conexiune mailbox (max 20 per conexiune).email:write
email_category_deleteȘterge o categorie de email.email:write
email_category_updateActualizează o categorie de email (parțial: doar câmpurile date se schimbă).email:write
email_connection_disconnectDeconectează definitiv un mailbox.email:write
email_connection_getObține o conexiune mailbox incl.email:read
email_connection_updateActualizează o conexiune mailbox: pune/pornește sincronizarea (paused true/false; doar comută ACTIVE<->DISABLED, nu suprascrie TOKEN_EXPIRED/ERROR), comută draftarea răspunsurilor (draftingEnabled) și organizarea/categorizarea (organizingEnabled), re-îndreaptă chatbot-ul care oferă suport (chatbotId din aceeași companie) sau setează semnătura reply HTML (signatureHtml, max 20000 caractere; string gol o șterge).email:write
email_connections_listListează conexiunile mailbox-urilor Email Assistant ale companiei (adresă, stare ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, ultima sincronizare, ultima eroare, toggles pentru drafting/organizing, chatbot care alimentează, draftReadyCategoryCount = categoriile care pot genera drafturi, baseRuleCount = regulile globale 'Chat + Email' aplicate fiecărui draft) împreună cu limitele planului (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth).email:read
email_contact_deleteȘterge un contact de email învățat (uită profilul expeditorului, de ex.email:write
email_contact_getObține un contact de email învățat cu toate faptele învățate, notițe interne, relație, setarea adresării formal/informal și statistici de email.email:read
email_contact_updateActualizează un contact de email învățat.email:write
email_contacts_listListează contactele de email învățate ale companiei (ultimul email primul) cu relație, adresare formal/informal (formalAddress: true = adresare formală, false = adresare informală, null = automat), număr de fapte și previzualizare notițe.email:read
email_folder_createCreează un folder de mail sub inbox (returnează pe cel existent dacă numele e deja folosit) pentru a-l folosi ca țintă de mutare categorie.email:write
email_folders_listListează folderele în care o categorie de email poate muta mail-uri, live din mailbox: subfoldere inbox, foldere top-level personalizate, archive, junk și trash (id 'deleteditems').email:read
email_general_rules_listListează regulile globale ale chatbot-ului care se aplică fiecărui draft de răspuns al unui mailbox: instrucțiuni de bază active cu channel BOTH ("Chat + Email"), plus cele legacy doar email ne-migrate încă într-o categorie.email:read

Analitică

ToolDescriptionScope
analytics_chat_volumeVolumul de chat (sesiuni începute) în timp pentru grafice și tendințe: perioadă week/month/quarter/year, granularitate hour/day/week/month, opțional pentru un chatbot.analytics:read
analytics_chatbot_statsPerformanța per-chatbot a unei companii într-un singur apel (tabelul de performanță chatbot din dashboard): id, name, slug, isActive, sessions, messages, FAQs și leads per chatbot, sortate după sessions.analytics:read
analytics_formsStatistici de trimitere formular pentru o companie sau un singur chatbot (widget analitic dashboard): trimitere pe stări (pending/approved/rejected/spam), număr de formulare, total, rata de spam în procente și seria submissions-per-day din ultimele 7 zile.analytics:read
analytics_leadsFunnel de lead-uri pentru o companie sau un chatbot (widget analitic dashboard): lead-uri pe stări (new/contacted/qualified/converted/lost), total, rata de conversie în procente și seria leads-per-day din ultimele 7 zile.analytics:read
analytics_overviewPrezentare analitică pentru o companie sau un chatbot: chat-uri, mesaje, rata de satisfacție și întrebări de top pentru o perioadă rulantă (day/week/month/year), plus widget-ul overview al dashboard-ului (total chatbots/published FAQs/leads, sesiuni azi/această săptămână/această lună, lead-uri azi/această săptămână, trimitere formulare total/azi/pending).analytics:read
dashboard_activityCe necesită atenție în prezent (view-ul home al dashboard-ului): per companie, chatbot-urile cu lead-uri noi azi, sugestii FAQ pending, trimitere formulare pending, live chats waiting/active sau o fază de învățare în curs.any

Exemple de fluxuri de lucru

Adăugarea unei instrucțiuni de bază

Întrebați asistentul dumneavoastră AI:

"Adaugă o instrucțiune de bază la chatbot-ul meu 'Support Bot': oferim transport gratuit pentru comenzile peste €50"

Asistentul va folosi chatbot_add_instruction cu parametrii corespunzători.

Revizuirea sugestiilor de îmbunătățire

"Arată-mi toate propunerile de îmbunătățire în așteptare pentru chatbot-ul meu și explică ce schimbări propun"

Asistentul va:

  1. Folosi improvement_proposals_pending pentru a prelua propunerile
  2. Analiza și rezuma fiecare sugestie
  3. Aprobă sau respinge în numele dumneavoastră cu improvement_proposal_approve sau improvement_proposal_reject

Analiza performanței chat-ului

"Dă-mi un raport săptămânal al volumului de chat și satisfacției clienților pentru chatbot-ul meu"

Asistentul va folosi analytics_overview și analytics_chat_volume pentru a compila un raport cuprinzător.

Importarea unui site

"Scanează https://example.com, importă paginile de produs și prețuri în 'Support Bot' și anunță-mă când crawl-ul s-a terminat"

Asistentul va apela crawler_preview_scan, va selecta paginile relevante, va porni importul cu crawler_start și va interoga crawler_job_get până când job-ul se finalizează.

Revizuirea lead-urilor și a trimiterilor din formulare

"Arată-mi lead-urile noi din această săptămână, atribuie-le pe cele calificate Annei și aprobă trimiterele de formulare în așteptare"

Asistentul combină lead_list, lead_assign, form_submissions_list și form_submission_update_status.

Preluarea unui live chat

"Setează-mă disponibil pentru live chat și preia cea mai veche conversație în așteptare"

Asistentul folosește live_chat_set_availability, live_chat_queue și live_chat_session_assign; răspunsurile trec prin live_chat_message_send.

Securitate

  • Cheile API sunt limitate la compania dumneavoastră și la scope-urile de permisiune pe care le selectați la crearea lor (vedeți coloana Scope de mai sus)
  • Cheile execută cu permisiunile owner-ului companiei; limitele de plan și gate-urile de funcționalitate se aplică exact ca în dashboard
  • Cheile pot fi revocate în orice moment din dashboard
  • Accesul API este disponibil pe planuri plătite — vedeți Pricing page

Depanare

Conexiune eșuată

  1. Verificați că cheia API este corectă
  2. Verificați că cheia nu a fost revocată
  3. Asigurați-vă că planul dumneavoastră include accesul API
  4. Reporniti clientul MCP

Unealtă negăsită

Repornți clientul MCP după schimbarea configurației astfel încât să reîncarce uneltele disponibile. Numele uneltelor sunt lowercase cu underscore (de ex., faq_list).


Aveți nevoie de ajutor? Contactați echipa noastră de suport →