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
- Navigați la Tablou de bord → Companie → API din contul dumneavoastră
- Faceți clic pe Creați cheie API
- Dați cheii un nume descriptiv (de ex., "Claude Desktop") și selectați cel puțin o permisiune
- 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
| Tool | Description | Scope |
|---|---|---|
account_usage_get | Obț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_companies | Listează toate companiile la care utilizatorul curent are acces, cu rolul utilizatorului în fiecare. | any |
user_notification_mark_read | Marchează una dintre notificările utilizatorului curent ca citită. | any |
user_notification_preferences_get | Obț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_update | Actualizează preferințele globale de notificare ale utilizatorului curent (toggler email/push, program digest, ore de liniște). | any |
user_notification_type_setting_update | Activează sau dezactivează livrarea prin email / in-app pentru un singur tip de notificare al utilizatorului curent (de ex. | any |
user_notification_types_list | Listează toate tipurile de notificare grupate pe categorii (chatbot, leads, live chat, knowledge, team, billing). | any |
user_notification_unread_count | Obține numărul de notificări necitite ale utilizatorului curent. | any |
user_notifications | Listează notificările utilizatorului curent, cele mai noi primele, cu paginare cursor. | any |
user_notifications_delete_old | Mentenanță: șterge definitiv notificările utilizatorului curent care sunt deja citite și mai vechi de 30 de zile. | any |
user_notifications_mark_all_read | Marchează toate notificările utilizatorului curent ca citite. | any |
user_profile | Obține profilul utilizatorului curent (id, name, email, role, subscription tier). | any |
Companie & Echipa
| Tool | Description | Scope |
|---|---|---|
company_chatbots_list | Listează toate chatbot-urile unei companii specifice cu statistici sumare. | chatbots:read |
company_get | Obține informații detaliate despre o companie: profil, owner, setări de brand (culori, email pentru notificări) și contorizări. | any |
company_invite_cancel | Anulează (șterge) o invitație de echipă astfel încât linkul să nu mai funcționeze. | company:write |
company_invite_resend | Retrimite 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_list | Listează invitațiile de echipă ale unei companii (implicit PENDING; setați includeExpired pentru a returna și cele expirate). | company:read |
company_list | Listează toate companiile la care utilizatorul are acces (cheile API și Dashboard Assistant văd doar propria lor companie). | any |
company_logo_remove | Elimină logo-ul companiei (șterge imaginea stocată și curăță URL-ul logo-ului). | company:write |
company_member_invite | Invitați un membru în echipă prin email cu un rol (ADMIN, MANAGER, AGENT sau VIEWER). | company:write |
company_member_remove | Elimină un membru din companie. | company:write |
company_member_update_role | Schimbați rolul unui membru al echipei (ADMIN, MANAGER, AGENT sau VIEWER). | company:write |
company_members_list | Listează membrii unei companii cu rolurile lor (OWNER, ADMIN, MANAGER, AGENT, VIEWER). | any |
company_settings_update | Actualizează setările de brand ale companiei: primaryColor / secondaryColor (#RRGGBB) și notificationEmail pentru revizuirile de chat. | company:write |
company_update | Actualizează 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
| Tool | Description | Scope |
|---|---|---|
chatbot_add_instruction | Adaugă o nouă instrucțiune de bază la un chatbot (1-5000 caractere). | chatbots:write |
chatbot_confirm_embed | Marchează un chatbot ca fiind încorporat pe site (ascunde memento-ul de configurare din dashboard). | chatbots:write |
chatbot_create | Creează 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_get | Obț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_code | Obț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_instructions | Obține toate instrucțiunile de bază pentru un chatbot. | chatbots:read |
chatbot_improve_instructions | Rescrie textul unei instrucțiuni de bază cu ajutorul AI-ului platformei (la fel ca 'Improve with AI' din dashboard). | chatbots:write |
chatbot_learning_phase_get | Obț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_update | Setează 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_list | Listează toate chatbot-urile la care utilizatorul are acces, cu statistici sumare. | chatbots:read |
chatbot_reorder_instructions | Setează ordinea instrucțiunilor de bază ale unui chatbot. | chatbots:write |
chatbot_templates_list | Listează 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_active | Activează sau dezactivează un chatbot. | chatbots:write |
chatbot_toggle_learning | Încheie (false) sau reactivează (true) faza de învățare a unui chatbot. | chatbots:write |
chatbot_update | Actualizează 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_instruction | Actualizează o instrucțiune de bază existentă (content, isActive, channel, sortOrder). | chatbots:write |
chatbot_update_personality | Actualizează 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_get | Obț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_update | Actualizează widget-ul de chat al unui chatbot: poziție (incl. | chatbots:write |
widget_translations_get | Obține traducerile widget-ului per limbă pentru un chatbot: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }. | chatbots:read |
widget_translations_update | Setează traducerile widget-ului per limbă. | chatbots:write |
Baza de cunoștințe
| Tool | Description | Scope |
|---|---|---|
crawler_job_cancel | Anulează un job de crawl aflat în starea PENDING sau RUNNING; paginile rămase sunt omise. | knowledge:write |
crawler_job_get | Obține starea unui job de crawl, progresul (pagesCrawled/pagesFound, tokensUsed) și starea fiecărei pagini. | knowledge:read |
crawler_jobs_list | Listează job-urile de crawl ale unui chatbot (cele mai noi primele) cu starea și progresul. | knowledge:read |
crawler_limits | Obț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_scan | Scanează un site și listează paginile care pot fi crawl-uite (url, title, isRecommended) fără a importa nimic. | knowledge:write |
crawler_start | Porneș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_url | Descarcă 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_text | Adaugă 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_get | Obț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_list | Listează 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_add | Crawl-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_get | Obț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_recrawl | Repreia 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_list | Listează 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_stats | Prezentare 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_recrawl | Re-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_cancel | Anulează un re-crawl în curs pentru un site: paginile în coadă (PENDING) ale domeniului revin la starea lor indexată anterioară. | knowledge:write |
knowledge_websites_list | Listează 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.
| Tool | Description | Scope |
|---|---|---|
price_list | Parcurge head-urile de preț și eligibilitatea versiunii aprobate separat. | prices:read |
price_get | Citește starea completă a unui item și reviziunile. | prices:read |
price_detail | Citește detaliul itemului cu istoric de revizuiri paginat. | prices:read |
price_suggestions_list | Parcurge sugestiile de preț. | prices:read |
price_create | Creează un draft cu un ID de item generat de server. | prices:write |
price_edit | Creează un nou draft dintr-o versiune de item explicit așteptată. | prices:write |
price_import_csv | Importă drafturi cu un format explicit și un import ID stabil pentru retry-uri sigure. | prices:write |
price_suggestion_apply | Aplică candidatul de sugestie selectat ca draft. | prices:write |
price_approve | Aprobă o versiune de item explicit așteptată. | prices:approve |
price_approve_many | Aprobă atomic o selecție explicită ID/versiune; orice versiune învechită respinge întreaga selecție. | prices:approve |
price_archive | Arhivează 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
| Tool | Description | Scope |
|---|---|---|
faq_cache_purge | Curăță datele cache ale widget-ului FAQ pe toate site-urile CMS conectate (plugin WordPress). | faqs:write |
faq_categories_list | Listează categoriile FAQ ale unui chatbot cu numărul de FAQ-uri, slug-uri, modul de sortare și traducerile. | faqs:read |
faq_categories_reorder | Setează ordinea categoriilor FAQ în widget: poziția în categoryIds devine sortOrder. | faqs:write |
faq_category_create | Creează 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_update | Redenumește o categorie FAQ sau schimbă descrierea, iconița sau modul de sortare. | faqs:write |
faq_create | Creează 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_get | Obț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_get | Obț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_list | Listează FAQ-urile unui chatbot (folosiți chatbot_list pentru a găsi chatbotId). | faqs:read |
faq_reorder | Setează ordinea de afișare a FAQ-urilor în widget. | faqs:write |
faq_suggestion_approve | Aprobă 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_get | Obține detaliile complete ale unei sugestii FAQ (răspuns complet, raționament AI, categorie sugerată, stare de revizuire). | faqs:read |
faq_suggestion_reject | Respingere o sugestie FAQ în PENDING cu un motiv opțional. | faqs:write |
faq_suggestions_generate | Permite 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_list | Listează sugestiile FAQ generate de AI ale unui chatbot (din conversații de chat sau faq_suggestions_generate). | faqs:read |
faq_translate | Traduce 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_update | Salvează traducerile unui FAQ per limbă, de ex. | faqs:write |
faq_update | Actualizează întrebarea, răspunsul, categoria, starea de publicare sau ordinea manuală a unui FAQ. | faqs:write |
faq_widget_settings_get | Obț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_update | Actualizează 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
| Tool | Description | Scope |
|---|---|---|
chat_feedback_dismiss | Marchează 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_get | Obț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_list | Listează revizuirile de chat (rânduri de feedback) ale unui chatbot cu filtrare pe stare și contorizări. | chats:read |
chat_feedback_set_severity | Suprascrie 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_stats | Contoare 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_submit | Evaluează o sesiune de chat ca Good (isPositive=true) sau Needs Work (isPositive=false). | chats:write |
chat_session_get | Obț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_search | Caută sesiuni de chat ale unui chatbot după conținutul mesajelor și/sau emailul vizitatorului. | chats:read |
chat_session_set_category | Atribuie 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_list | Listează 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
| Tool | Description | Scope |
|---|---|---|
confidence_categories_list | Listează categoriile de încredere ale unui chatbot cu scor pe categorie, număr de revizuiri și frecvența emailurilor de revizuire. | chats:read |
confidence_category_create | Creează o categorie de încredere pentru un chatbot. | chatbots:write |
confidence_category_delete | Șterge o categorie de încredere. | chatbots:write |
confidence_category_merge | Uneș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_update | Redenumeș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_get | Starea 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_approve | Aprobă 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_reject | Respinge o propunere de îmbunătățire aflată în PENDING. | chatbots:write |
improvement_proposal_simulate | Simulează cum ar răspunde chatbot-ul la mesajul problematic cu o propunere aplicată (original vs. | chatbots:write |
improvement_proposals_pending | Listează propunerile de îmbunătățire care așteaptă revizuirea (status PENDING) la nivelul companiei sau pentru un chatbot. | chatbots:read |
improvement_session_complete | Marchează o sesiune de îmbunătățire ca COMPLETED (chat-ul este atunci contabilizat ca Improved în coada de revizuire). | chatbots:write |
improvement_session_create | Deschide Improvement Agent pentru un chat evaluat Needs Work. | chatbots:write |
improvement_session_get | Obț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_reset | Reporneș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_message | Trimite 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_list | Listează 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_assess | Evaluează 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
| Tool | Description | Scope |
|---|---|---|
live_chat_agents_available | Obț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_heartbeat | Reî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_send | Trimite un mesaj vizitatorului ca agentul atribuit. | chats:write |
live_chat_queue | Obține coada live chat: sesiunile care așteaptă un agent, cele mai vechi primele (FIFO). | chats:read |
live_chat_session_assign | Preia 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_get | Obține o sesiune live chat cu info vizitator, agent atribuit, toate mesajele și convorbirea anterioară a botului (contextul handoff). | chats:read |
live_chat_sessions_list | Listează 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_availability | Comută switch-ul 'Available for Live Chat' al utilizatorului curent pentru o companie. | chats:write |
Lead-uri
| Tool | Description | Scope |
|---|---|---|
lead_assign | Atribuie un lead unui membru al companiei sau îl dezatribue (assignedToId: null). | leads:write |
lead_bulk_update_status | Setează starea mai multor lead-uri (max 100) simultan. | leads:write |
lead_categories_list | Listează categoriile de lead ale unui chatbot cu numărul de lead-uri și membrii echipei notificați per categorie. | leads:read |
lead_category_assign_user | Adaugă un membru al companiei la lista de notificare a unei categorii de lead (sau actualizează flag-urile lor de notificare). | leads:write |
lead_category_create | Creează o categorie de lead pentru un chatbot. | leads:write |
lead_category_delete | Șterge o categorie de lead. | leads:write |
lead_category_remove_user | Elimină un membru al companiei din lista de notificare a unei categorii de lead. | leads:write |
lead_category_update | Actualizează numele, descrierea și/sau culoarea unei categorii de lead. | leads:write |
lead_create | Creează manual un lead (de ex. | leads:write |
lead_delete | Șterge un lead permanent. | leads:write |
lead_field_config_get | Obț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_update | Actualizează configurația de captare a lead-urilor a unui chatbot. | leads:write |
lead_get | Obț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_list | Listează 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_stats | Obț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_update | Actualizează starea, categoria, notițele, datele captate și/sau assignee-ul unui lead. | leads:write |
Formulare
| Tool | Description | Scope |
|---|---|---|
form_create | Creează 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_get | Obț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_list | Listează formularele de contact ale unui chatbot cu numărul de câmpuri, contorul trimitere și coduri de embed. | forms:read |
form_stats | Contoare 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_get | Obț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_status | Revizuieș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_list | Listează 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_update | Actualizează 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
| Tool | Description | Scope |
|---|---|---|
email_activity_list | Listează 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_list | Listează categoriile de email ale unei conexiuni mailbox (ordonate după sortOrder). | email:read |
email_category_create | Creează 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_update | Actualizează o categorie de email (parțial: doar câmpurile date se schimbă). | email:write |
email_connection_disconnect | Deconectează definitiv un mailbox. | email:write |
email_connection_get | Obține o conexiune mailbox incl. | email:read |
email_connection_update | Actualizează 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_list | Listează 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_get | Obț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_update | Actualizează un contact de email învățat. | email:write |
email_contacts_list | Listează 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_create | Creează 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_list | Listează 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_list | Listează 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ă
| Tool | Description | Scope |
|---|---|---|
analytics_chat_volume | Volumul 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_stats | Performanț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_forms | Statistici 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_leads | Funnel 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_overview | Prezentare 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_activity | Ce 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:
- Folosi
improvement_proposals_pendingpentru a prelua propunerile - Analiza și rezuma fiecare sugestie
- Aprobă sau respinge în numele dumneavoastră cu
improvement_proposal_approvesauimprovement_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ă
- Verificați că cheia API este corectă
- Verificați că cheia nu a fost revocată
- Asigurați-vă că planul dumneavoastră include accesul API
- 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 →