НачалоДокументация

MCP Server Integration

ChatReact реализира Model Context Protocol (MCP), позволявайки Ви да свържете Вашия ChatReact акаунт с AI асистенти като Claude Desktop, Cursor и други инструменти съвместими с MCP.

Какво е MCP?

Model Context Protocol е отворен стандарт, който позволява на AI асистенти да взаимодействат с външни услуги и източници на данни. С MCP интеграцията на ChatReact можете да:

  • Управлявате чатботове — създавате, конфигурирате (персона, езици, widget, поведение, ограничения), вграждате и изтривате чатботове
  • Създавате база знания — добавяте документи, обхождате уебсайтове, управлявате обходени страници и основни инструкции
  • Управлявате ЧЗВ — ЧЗВ, категории, предложения, преводи и ЧЗВ widget
  • Преглеждате чатове — оценявате разговори, задавате категории доверие, пускате Improvement Agent
  • Работите с лийдове и формуляри — лийдове, категории лийдове, настройки за улавяне, контактни форми и подавания
  • Действате като агент в жив чат — задавате наличността си, поемате чакащи чатове, отговаряте и приключвате сесии
  • Администрирате фирмата си — профил, цветове на бранда, членове на екипа и покани
  • Използвате Email Assistant — връзки на пощенски кутии, категории, контакти и активност
  • Четете аналитика и уведомления

Всичко, което можете да направите в таблото, е достъпно чрез MCP (и REST API); само действия, зависещи от браузъра като плащания, mailbox OAuth, passkeys, изтриване на акаунт и управление на API ключове остават в таблото.

Започване

1. Генерирайте API ключ

  1. Отидете в Табло → Компания → API таба
  2. Кликнете Създай API ключ
  3. Дайте на ключа описателно име (напр., "Claude Desktop") и изберете поне едно разрешение
  4. Копирайте генерирания ключ (започва с cr_)

API ключове са налични в платени планове — вижте нашата страница с цени.

Съхранявайте API ключа си сигурно. Той не може да бъде възстановен след създаване.

2. Конфигурирайте Вашия MCP клиент

MCP сървърът на ChatReact е хостиран на https://www.chatreact.ai/api/mcp и комуникира по HTTP (JSON-RPC). Автентикирайте с Authorization: Bearer хедър — X-API-Key хедър със същия ключ също се приема.

Cursor IDE

Cursor поддържа отдалечени MCP сървъри директно. Добавете в Cursor MCP настройките:

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

Claude Desktop

Конфигурационният файл на Claude Desktop поддържа command-based сървъри, затова използвайте стандартния mcp-remote мост за връзка към хостнатия крайпункт:

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

Тази настройка изисква инсталиран Node.js. Примерът използва X-API-Key хедъра, защото някои клиенти не обработват интервали в аргументите надеждно.

3. Рестартирайте Вашия AI асистент

След запазване на конфигурацията, рестартирайте Claude Desktop или Cursor, за да установите връзката.

Налични инструменти

ChatReact MCP излага посочените по-долу инструменти, групирани по области. Колоната Scope показва разрешението на API ключа, което инструментът изисква (any = всеки валиден ключ). Инструментите се изпълняват с едни и същи приложими разрешения, лимити по план и странични ефекти, както поддържаните операции в таблото. Браузър-зависимите работни потоци за плащане, упълномощаване на пощенски кутии, passkey, изтриване на акаунт и управление на ключове остават в таблото.

Деструктивните инструменти (изтриване, нулиране, приключване, сливане) изискват потвърждение при използване през Dashboard Assistant. Чрез API ключ те се изпълняват незабавно.

Account

ToolDescriptionScope
account_usage_getПолучаване на текущия план (tier, status), броячи на използването за текущия период (companies, chatbots, team members, chats, tokens) и лимитите на плана, плюс ефективните лимити и флагове за функции на компанията, в която е обхванo повикването.any
user_companiesСписък на всички компании, до които текущият потребител има достъп, с ролята на потребителя във всяка.any
user_notification_mark_readМаркиране на едно от уведомленията на текущия потребител като прочетено.any
user_notification_preferences_getПолучаване на предпочитанията за уведомления на текущия потребител: глобални превключватели email/push, честота/време/ден за дайджест, часовете за тишина и настройки на канали по тип.any
user_notification_preferences_updateАктуализиране на глобалните предпочитания за уведомления на текущия потребител (email/push превключватели, график на дайджест, часовe за тишина).any
user_notification_type_setting_updateАктивиране или деактивиране на доставка по имейл / в приложението за един тип уведомление на текущия потребител (напр.any
user_notification_types_listСписък на всички типове уведомления групирани по категория (chatbot, leads, live chat, knowledge, team, billing).any
user_notification_unread_countПолучаване на броя непрочетени уведомления на текущия потребител.any
user_notificationsСписък с уведомленията на текущия потребител, най-новите първо, с курсорна пагинация.any
user_notifications_delete_oldПоддръжка: постоянно изтриване на вече прочетените уведомления на текущия потребител, по-стари от 30 дни.any
user_notifications_mark_all_readМаркиране на всички уведомления на текущия потребител като прочетени.any
user_profileПолучаване на профила на текущия потребител (id, name, email, role, subscription tier).any

Company & Team

ToolDescriptionScope
company_chatbots_listСписък на всички чатботове за конкретна компания с обзорни статистики.chatbots:read
company_getПолучаване на подробна информация за компания: профил, собственик, настройки на бранда (цветове, notification email) и броячи.any
company_invite_cancelОтмяна (изтриване) на покана за екип, така че линкът да спре да работи.company:write
company_invite_resendПрепращане на изчакваща покана за екип: издава нов токен, удължава срока с 7 дни и изпраща имейла за покана отново.company:write
company_invites_listСписък на поканите за екип на компания (по подразбиране pending; задайте includeExpired за връщане и на изтекли покани).company:read
company_listСписък на всички компании, до които потребителят има достъп (API ключовете и Dashboard Assistant виждат само собствената си компания).any
company_logo_removeПремахване на логото на компанията (изтрива съхраненото изображение и изчиства logo URL).company:write
company_member_inviteПоканване на член на екипа по имейл с роля (ADMIN, MANAGER, AGENT или VIEWER).company:write
company_member_removeПремахване на член на екипа от компанията.company:write
company_member_update_roleСмяна на ролята на член на екипа (ADMIN, MANAGER, AGENT или VIEWER).company:write
company_members_listСписък на членовете на компанията с техните роли (OWNER, ADMIN, MANAGER, AGENT, VIEWER).any
company_settings_updateАктуализиране на настройките на бранда на компанията: primaryColor / secondaryColor (#RRGGBB) и notificationEmail за ревюта на чатове.company:write
company_updateАктуализиране на профила на компанията: name (2-100 chars), description (макс 1000 chars) или website (https:// се добавя автоматично; подайте празен стринг за изчистване на website/description).company:write

Chatbot Management

ToolDescriptionScope
chatbot_add_instructionДобавяне на нова основна инструкция (core instruction) към чатбот (1-5000 chars).chatbots:write
chatbot_confirm_embedМаркиране на чатбот като вграден в сайта (скрива напомнянето за настройка в таблото).chatbots:write
chatbot_createСъздаване на нов чатбот (същото като wizard-а в таблото).chatbots:write
chatbot_deleteПермантентно изтриване на чатбот с всички негови ЧЗВ, документи, чатове, лийдове и формуляри (не може да бъде върнато).chatbots:write
chatbot_delete_instructionИзтриване на основна инструкция от чатбот.chatbots:write
chatbot_getПолучаване на подробна информация за чатбот: общи настройки, личност (persona, tonality, languages, restrictions), настройки на widget-а, live chat, learning phase, статус на вграждане и броячи.chatbots:read
chatbot_get_embed_codeПолучаване на HTML фрагмент за инсталиране на чатбот в уебсайт (script URL + <script> таг) и дали вграждането е потвърдено.chatbots:read
chatbot_get_instructionsПолучаване на всички основни инструкции за чатбот.chatbots:read
chatbot_improve_instructionsПренаписване на текст на основна инструкция с подобрителя на платформата (същото като 'Improve with AI' в таблото).chatbots:write
chatbot_learning_phase_getПолучаване на настройките за learning-phase на чатбот: preset на поведението (CAUTIOUS, BALANCED, CONFIDENT), персонализиран prompt и дали ботът все още е в learning phase.chatbots:read
chatbot_learning_phase_updateЗадаване на preset на поведението в learning-phase (CAUTIOUS = препраща към човек при несигурност, BALANCED, CONFIDENT) и/или персонализиран learning-phase prompt.chatbots:write
chatbot_listСписък на всички чатботове, до които потребителят има достъп, с обзорни статистики.chatbots:read
chatbot_reorder_instructionsЗадаване на реда на основните инструкции на чатбот.chatbots:write
chatbot_templates_listСписък на шаблоните за чатботове (preset-и за persona, tonality, messages и поведение на widget), които могат да се подадат като templateId към chatbot_create, и дали планът на компанията позволява тяхната употреба.chatbots:read
chatbot_toggle_activeАктивиране или деактивиране на чатбот.chatbots:write
chatbot_toggle_learningПриключване (false) или повторно разрешаване (true) на learning phase на чатбот.chatbots:write
chatbot_updateАктуализиране на общите настройки на чатбот: name, description, isActive, live chat (liveChatEnabled/liveChatMode, feature по план), showBranding (white-label планове), chat-review имейли, FAQ auto-generation, legacy coreInstructions текст, learning phase (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt).chatbots:write
chatbot_update_instructionАктуализиране на съществуваща основна инструкция (content, isActive, channel, sortOrder).chatbots:write
chatbot_update_personalityАктуализиране на личността на чатбот: persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), tonality плъзгачи 1-5, езици (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), съобщения (welcomeMessage, fallbackMessage, proactive greeting) и ограничения (blacklistTopics, complianceRules, maxResponseLength, human handoff).chatbots:write
widget_settings_getПолучаване на текущите настройки на widget-а за чатбот (всички appearance, branding, behaviour и полета на pre-chat формата).chatbots:read
widget_settings_updateАктуализиране на chat widget на чатбот: позиция (вкл.chatbots:write
widget_translations_getПолучаване на преводите на widget-а по езици за чатбот: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }.chatbots:read
widget_translations_updateЗадаване на преводи на widget-а по езици.chatbots:write

Knowledge Base

ToolDescriptionScope
crawler_job_cancelОтмяна на PENDING или RUNNING crawl job; останалите страници се пропускат.knowledge:write
crawler_job_getПолучаване на статус на crawl job, прогрес (pagesCrawled/pagesFound, tokensUsed) и статуса на всяка страница.knowledge:read
crawler_jobs_listСписък на crawl job-овете на чатбота (най-новите първо) със статус и прогрес.knowledge:read
crawler_limitsПолучаване на лимитите за crawl на плана за чатбот (макс страници на crawl, токени на страница, crawls на месец) и дали може да се стартира нов crawl този месец.knowledge:read
crawler_preview_scanСканиране на уебсайт и изброяване на неговите обхождаеми страници (url, title, isRecommended) без импортиране.knowledge:write
crawler_startСтартиране на crawl job, който импортира селектираните URL в базата знания на чатбота (обработва се в бекграунд; poll crawler_job_get).knowledge:write
knowledge_document_add_from_urlИзтегляне на документ (PDF, TXT, MD, CSV, JSON, DOCX; макс 10 MB) от публичен http(s) URL и добавяне към базата знания на чатбота.knowledge:write
knowledge_document_add_textДобавяне на текстов или markdown документ в базата знания на чатбота от inline съдържание (макс 10 MB).knowledge:write
knowledge_document_deleteИзтриване на качен документ от базата знания.knowledge:write
knowledge_document_getПолучаване на детайли за качен документ включително статус на обработка, съобщение за грешка и кратък временен download URL.knowledge:read
knowledge_documents_listСписък на качените документи (PDF, TXT, MD, CSV, JSON, DOCX) в базата знания на чатбота със статус и размер.knowledge:read
knowledge_page_addОбхождане на един URL и добавянето му към базата знания на чатбота (неуспех с CONFLICT когато URL вече е индексиран, FORBIDDEN когато е достигнат токен лимит).knowledge:write
knowledge_page_deleteИзтриване на обходена страница от базата знания (премахва vector-store файла ѝ).knowledge:write
knowledge_page_getПолучаване на обходена страница включително markdown съдържанието, което е било индексирано за чатбота (полезно за проверка какво ботът знае за страницата).knowledge:read
knowledge_page_recrawlПовторно извличане на обходена страница и заместване на индексираното ѝ съдържание (напр.knowledge:write
knowledge_pages_deleteИзтриване на няколко обходени страници на чатбот наведнъж.knowledge:write
knowledge_pages_listСписък на обходените страници в базата знания на чатбота, опционално филтрирани по домейн, статус или термин за търсене (URL/title).knowledge:read
knowledge_statsОбзор на базата знания на чатбота: документи (по статус, размер), обходени страници и уебсайтове (по статус), crawl job-ове, основни инструкции разделени по източник (ръчно vs improvement agent), ЧЗВ, статус/размер на vector store и използване на съхранение vs.knowledge:read
knowledge_website_deleteИзтриване на всички обходени страници на уебсайт (домейн) от базата знания на чатбота.knowledge:write
knowledge_website_recrawlПовторно обхождане на всички страници на уебсайт (домейн) в базата знания на чатбота за обновяване на съдържанието им.knowledge:write
knowledge_website_recrawl_cancelОтмяна на в процес на изпълнение повторно обхождане на уебсайт: чакащите (PENDING) страници на домейна се възстановяват до предишното си индексирано състояние.knowledge:write
knowledge_websites_listСписък на уебсайтовете (домейни), чиито страници са в базата знания на чатбота, с брой страници по статус и тотали токени.knowledge:read

Price Management

Тези инструменти управляват структурирани чернови за цени и явни одобрения. Записването на чернова е отделно от одобрението на точната версия; допустимостта зависи и от статуса и валидността. Съществуващите API ключове не получават автоматично права за управление на цени. Само собственикът на компанията може да даде prices:write или prices:approve. Повикванията с API ключ се изпълняват директно, затова прегледайте точно входните данни преди да извикате мутация. Вижте Prices & services за клиентския работен поток.

ToolDescriptionScope
price_listПагинация през price heads и отделяне на допустимост за одобрената версия.prices:read
price_getЧетене на пълното състояние на артикул и ревизии.prices:read
price_detailЧетене на детайлите на артикул с пагинирана история на ревизиите.prices:read
price_suggestions_listПагинация през price suggestions.prices:read
price_createСъздаване на чернова с генериран сървърно item ID.prices:write
price_editСъздаване на нова чернова от изрично очаквана версия на артикул.prices:write
price_import_csvИмпортиране на чернови с изричен формат и стабилен import ID за безопасни опити.prices:write
price_suggestion_applyПрилагане на избрания suggestion candidate като чернова.prices:write
price_approveОдобряване на една изрично очаквана версия на артикул.prices:approve
price_approve_manyОдобряване на изрично избрана ID/version атомарно; всяка остаряла версия отхвърля цялото избиране.prices:approve
price_archiveАрхивиране на артикул при неговата изрично очаквана версия.prices:approve

Редакциите на чернови запазват предишната одобрена ревизия. CSV форматът и десетичният разделител трябва да са изрични; променено CSV съдържание изисква нов import ID. Всички операции са обвързани с компанията на API ключа и посочения чатбот.

FAQ Management

ToolDescriptionScope
faq_cache_purgeИзчистване на кешираните данни на FAQ widget на всички свързани CMS сайтове (WordPress плъгин).faqs:write
faq_categories_listСписък на категориите ЧЗВ на чатбот с броячи на ЧЗВ, slug-ове, sort mode и преводи.faqs:read
faq_categories_reorderЗадаване на реда на категориите ЧЗВ в widget-а: позицията в categoryIds става sortOrder.faqs:write
faq_category_createСъздаване на категория ЧЗВ за чатбот (slug се генерира от името).faqs:write
faq_category_deleteИзтриване на категория ЧЗВ.faqs:write
faq_category_translations_updateЗаместване на преводите на категория ЧЗВ, напр.faqs:write
faq_category_updateПреименуване на категория ЧЗВ или промяна на нейното описание, икона или режим на сортиране.faqs:write
faq_createСъздаване на ЧЗВ за чатбот.faqs:write
faq_deleteПермантентно изтриване на ЧЗВ (също го премахва от базата знания на чатбота и изчиства кешовете на CMS widget).faqs:write
faq_embed_code_getПолучаване на embed снипетите за FAQ widget: script tag, WordPress shortcode и Shopify Liquid снипет, плюс варианти по категория (използвайте categorySlug от faq_categories_list за вграждане само на една категория).chatbots:read
faq_getПолучаване на пълните детайли на ЧЗВ: въпрос, отговор, категория, state на публикуване, sort order, преводи, SEO полета и статистики за обратна връзка.faqs:read
faq_listСписък на ЧЗВ на чатбот (използвайте chatbot_list за намиране на chatbotId).faqs:read
faq_reorderЗадаване на реда за показване на ЧЗВ в widget-а.faqs:write
faq_suggestion_approveОдобряване на PENDING предложение за ЧЗВ: създава публикувано ЧЗВ (опционално с редактиран въпрос/отговор/категория) и маркира предложението като APPROVED.faqs:write
faq_suggestion_getПолучаване на пълните детайли на предложение за ЧЗВ (пълен отговор, AI reasoning, предложена категория, review state).faqs:read
faq_suggestion_rejectОтхвърляне на PENDING предложение за ЧЗВ с опционална причина.faqs:write
faq_suggestions_generateПозволяване на AI да предложи нови ЧЗВ от базата знания на чатбота (обходени страници / качени документи), опционално за една категория.faqs:write
faq_suggestions_listСписък на AI-генерирани предложения за ЧЗВ на чатбот (от чат разговори или faq_suggestions_generate).faqs:read
faq_translateПревеждане на въпрос и отговор на ЧЗВ с AI на другите поддържани езици на чатбота (или зададените targetLanguages) и записване на резултата.faqs:write
faq_translations_updateЗаписване на преводи на ЧЗВ по езици, напр.faqs:write
faq_updateАктуализиране на въпроса, отговора, категорията, publish state или ръчния sort order на ЧЗВ.faqs:write
faq_widget_settings_getПолучаване на appearance и behaviour настройките на вграден FAQ widget (цветове, border radius, title, spacing, max width, allowMultipleOpen, autoOpenFirst, sort mode, преводи на заглавия).chatbots:read
faq_widget_settings_updateАктуализиране на настройките на FAQ widget: цветове (hex), borderRadius 0-32, title (макс 100) + showTitle, spacing compact|normal|relaxed, maxWidth 0-2000 (0 = full width), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name и title преводи по езици.chatbots:write

Chat History & Feedback

ToolDescriptionScope
chat_feedback_dismissМаркиране на чат като прегледан без оценка (премахва го от опашката за преглед, не променя confidence score).chats:write
chat_feedback_getПолучаване на едно ревю на чат (feedback) с AI анализ, severity, confidence category, промяна на скора и свързаната improvement session.chats:read
chat_feedback_listСписък на ревюта на чатове (feedback редове) на чатбот с филтър по статус и броячи.chats:read
chat_feedback_set_severityПрезаписване на класификацията на severity (MINOR|MODERATE|MAJOR|CRITICAL) на прегледан негативен чат; severity влияе на намалението на confidence score.chats:write
chat_feedback_statsБрой сесии по review bucket за чатбот (общо, none, pending, positive, negative, reviewed, improved) — статистическите карти на страницата chats в таблото.chats:read
chat_feedback_submitОценяване на чат сесия като Good (isPositive=true) или Needs Work (isPositive=false).chats:write
chat_session_getПолучаване на чат сесия с пълен транскрипт (по-съобщение token/model/latency/pageUrl), детайли за посетителя, започнатата страница URL, confidence category, feedback (severity, AI анализ, свързана improvement session) и тагове.chats:read
chat_session_searchТърсене в чат сесии на чатбот по съдържание на съобщения и/или имейл на посетителя.chats:read
chat_session_set_categoryЗадаване или промяна на confidence category на чат сесия (коригира AI категоризацията; per-category confidence се преразчислява когато чатът е бил прегледан).chats:write
chat_sessions_listСписък на чат сесии на чатбот, най-новите първо, със същите филтри за опашката за преглед както на страницата chats в таблото.chats:read

Improvement Agent

ToolDescriptionScope
confidence_categories_listСписък на confidence категориите на чатбот с per-category confidence score, брой ревюта и честота на review имейли.chats:read
confidence_category_createСъздаване на confidence категория за чатбот.chatbots:write
confidence_category_deleteИзтриване на confidence категория.chatbots:write
confidence_category_mergeСливане на една confidence категория в друга на същия чатбот: всички чатове/ревюта се преместват в целевата, източникът се изтрива и скоровете се преразчисляват.chatbots:write
confidence_category_updateПреименуване на confidence категория и/или задаване на честота за review имейли (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1-24 само за HOURLY).chatbots:write
confidence_status_getConfidence статус на чатбот: score, graduation threshold, learning phase флаг, learning-phase поведение (CAUTIOUS|BALANCED|CONFIDENT) и персонализиран prompt, брой ревюта и per-category confidence скорове.analytics:read
improvement_proposal_approveОдобряване на PENDING improvement proposal и прилагане на промяната към чатбота (добавяне/актуализация на core instruction, създаване/актуализация на ЧЗВ или актуализация на persona) — същата логика и лимити по план като в таблото.chatbots:write
improvement_proposal_rejectОтхвърляне на PENDING improvement proposal.chatbots:write
improvement_proposal_simulateСимулиране как чатботът ще отговори на проблемното съобщение с приложената предложена промяна (оригинал vs.chatbots:write
improvement_proposals_pendingСписък на improvement proposals, чакащи преглед (статус PENDING) за компанията или за един чатбот.chatbots:read
improvement_session_completeМаркиране на improvement session като COMPLETED (тогава чатът се брои като Improved в опашката за преглед).chatbots:write
improvement_session_createОтваряне на Improvement Agent за чат оценен като Needs Work.chatbots:write
improvement_session_getПолучаване на improvement session с оригиналния чат (съобщенията имат 1-базиран индекс, използваем като targetMessageIndex), agent конверсцията, всички предложения (с техните последни симулации) и симулации.chatbots:read
improvement_session_resetРестартиране на improvement session: изтрива всички agent съобщения, симулации и PENDING/REJECTED предложения (приложените се запазват) и започва нова конверсация.chatbots:write
improvement_session_send_messageИзпращане на съобщение до Improvement Agent (опишете какво е било грешно в отговора на бота; опционално targetMessageIndex = 1-базиран индекс на бот съобщението в originalChat.messages).chatbots:write
improvement_sessions_listСписък на improvement sessions (Improvement Agent разговори, стартирани от негативни ревюта на чатове) за чатбот или цялата компания, най-новите първо, с брой предложения.chatbots:read
improvement_simulation_assessОценяване на резултат от симулация: isApproved=true когато симулираният отговор е добър (предложението може да бъде приложено), false когато се нуждае от доработка (коментар 'almost' = почти правилно).chatbots:write

Live Chat

ToolDescriptionScope
live_chat_agents_availableПолучаване на собствената наличност на текущия потребител за live chat, агентите, които в момента са налични за live chat (fresh heartbeat, същият сигнал, който widget използва) и дали планът на компанията включва live chat.chats:read
live_chat_heartbeatОсвежаване на live chat heartbeat на текущия потребител (само докато е маркиран като available чрез live_chat_set_availability).chats:write
live_chat_message_sendИзпращане на съобщение на посетителя като назначения агент.chats:write
live_chat_queueПолучаване на live chat опашката: сесии, чакащи агент, най-стари първо (FIFO).chats:read
live_chat_session_assignПоемане на WAITING live chat сесия от опашката: назначава я на текущия потребител (company owner за API ключове) и уведомява посетителя, че агентът се е присъединил.chats:write
live_chat_session_closeПриключване на live chat сесия като агент (всеки член на компанията, който не е VIEWER).chats:write
live_chat_session_getПолучаване на live chat сесия с информация за посетителя, назначен агент, всички съобщения и предходния бот разговор (handoff context).chats:read
live_chat_sessions_listСписък на live chat сесии (най-новите първо; WAITING сесиите най-стари първо) с опционални филтри по чатбот, статус и назначен агент.chats:read
live_chat_set_availabilityПревключване на превключвателя 'Available for Live Chat' на текущия потребител за компания.chats:write

Leads

ToolDescriptionScope
lead_assignЗадаване на лийд към член на компания или премахване на назначението му (assignedToId: null).leads:write
lead_bulk_update_statusЗадаване на статуса на няколко лийда (макс 100) наведнъж.leads:write
lead_categories_listСписък на категориите лийдове на чатбот с брой лийдове и членове на екипа, уведомявани за всяка категория.leads:read
lead_category_assign_userДобавяне на член на компания към нотификационния списък на категория лийд (или актуализиране на неговите нотификационни флагове).leads:write
lead_category_createСъздаване на категория лийд за чатбот.leads:write
lead_category_deleteИзтриване на категория лийд.leads:write
lead_category_remove_userПремахване на член на компания от нотификационния списък на категория лийд.leads:write
lead_category_updateАктуализиране на име, описание и/или цвят на категория лийд.leads:write
lead_createСъздаване на лийд ръчно (напр.leads:write
lead_deleteПермантентно изтриване на лийд.leads:write
lead_field_config_getПолучаване на конфигурацията за улавяне на лийдове на чатбот: полета (ids съответстват на ключове в lead.data), confirmation message, преводи на полета/UI и AI recognition настройки.leads:read
lead_field_config_updateАктуализиране на конфигурацията за улавяне на лийдове на чатбот.leads:write
lead_getПолучаване на пълни детайли за лийд включително assignee, category и сорс чат транскрипта (пагинирано с messageOffset/messageLimit, по подразбиране първите 20 съобщения).leads:read
lead_listСписък на лийдове на чатбот (най-новите първо) с опционални филтри по статус, категория, assignee и свободен текстовo търсене (name/email/company).leads:read
lead_statsПолучаване на статистики за лийдове за чатбот: брой по статус, лийдове за последните 7 дни и конверсионен процент (процент).leads:read
lead_updateАктуализиране на статуса, категорията, бележките, улавяните данни и/или assignee на лийд.leads:write

Forms

ToolDescriptionScope
form_createСъздаване на контактна форма за чатбот (основни, полета, дизайн и спам настройки в едно повикване).forms:write
form_deleteПермантентно изтриване на контактна форма и ВСИЧКИ нейни подавания (cascade).forms:write
form_getПолучаване на контактна форма в пълен вид: полета, преводи, стилизиране, спам настройки, активно състояние, брой подавания и embed script tag (embedCode).forms:read
form_listСписък на контактните форми на чатбот с брой полета, брой подавания и embed кодове.forms:read
form_statsБроячи на подавания на контактна форма: total, pending, approved, spam и rejected.forms:read
form_submission_deleteПермантентно изтриване на подаване на контактна форма (напр.forms:write
form_submission_getПолучаване на подаване на контактна форма в пълен вид: подадени полета, spam score и AI spam анализ, IP/user agent/referrer метаданни и информация за преглед.forms:read
form_submission_update_statusПреглед на подаване на контактна форма: задаване на статус APPROVED, SPAM или REJECTED с опционална бележка за преглед.forms:write
form_submissions_listСписък на подавания на контактна форма, най-новите първо, опционално филтрирани по статус (PENDING, APPROVED, SPAM, REJECTED) и дата на създаване.forms:read
form_updateАктуализиране на контактна форма: name, description, активно състояние (isActive контролира дали embed се показва), полета (пълна замяна), дизайн (цветове, бутон текст, success message) и спам настройки (spamThreshold, autoRejectSpam, notificationEmail).forms:write
form_update_translationsЗамяна на преводите на полета и/или UI на контактна форма.forms:write

Email Assistant

ToolDescriptionScope
email_activity_listСписък на лог-а с обработена имейл активност на връзка на пощенска кутия (най-новите първо): подател, subject, назначена категория, резултат (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) и outcomeDetail.email:read
email_categories_listСписък на имейл категориите на връзка на пощенска кутия (подредени по sortOrder).email:read
email_category_createСъздаване на имейл категория за връзка на пощенска кутия (макс 20 на връзка).email:write
email_category_deleteИзтриване на имейл категория.email:write
email_category_updateАктуализиране на имейл категория (частично: само подадените полета се променят).email:write
email_connection_disconnectПостоянно прекъсване на връзката на пощенска кутия.email:write
email_connection_getПолучаване на връзка на пощенска кутия включителноemail:read
email_connection_updateАктуализиране на връзка на пощенска кутия: пауза/възобновяване на синхронизацията (paused true/false; само превключва ACTIVE<->DISABLED, никога не презаписва TOKEN_EXPIRED/ERROR), превключване на draft-ването на отговори (draftingEnabled) и категоризиране/организиране (organizingEnabled), пренасочване към захранващия чатбот (chatbotId от същата компания) или задаване на HTML подпис за отговор (signatureHtml, макс 20000 chars; празен стринг го изчиства).email:write
email_connections_listСписък на връзките на Email Assistant по компания (адрес, статус ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, last sync, last error, drafting/organizing превключватели, powering chatbot, draftReadyCategoryCount = категории, които могат да генерират draft-ове, baseRuleCount = chatbot-широки 'Chat + Email' правила приложени за всеки draft) заедно с лимитите по плана (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth).email:read
email_contact_deleteИзтриване на научен имейл контакт (забравяне на профила на подателя, напр.email:write
email_contact_getПолучаване на научен имейл контакт с всички научени факти, вътрешни бележки, връзка, настройка за формално/неформално обръщение и имейл статистики.email:read
email_contact_updateАктуализиране на научен имейл контакт.email:write
email_contacts_listСписък на научените имейл контакти на компанията (най-скорошен имейл първо) с връзка, настройка за формално/неформално обръщение (formalAddress: true = формално 'Sie', false = неформално 'Du', null = автоматично), брой факти и преглед на бележки.email:read
email_folder_createСъздаване на mail папка под inbox (връща съществуващата ако името е заето) за използване като цел за преместване по категория.email:write
email_folders_listСписък на папките, в които имейл категория може да мести писма, в реално време от пощенската кутия: подпапки на inbox, персонални топ-ниво папки, archive, junk и trash (id 'deleteditems').email:read
email_general_rules_listСписък на chatbot-широките правила, които се прилагат за всеки reply draft на пощенска кутия: активни core instructions с channel BOTH ("Chat + Email"), плюс legacy email-only такива, все още неизместени в категория.email:read

Analytics

ToolDescriptionScope
analytics_chat_volumeОбем чатове (започнати сесии) във времето за диаграми и тенденции: период week/month/quarter/year, грануларност hour/day/week/month, опционално за един чатбот.analytics:read
analytics_chatbot_statsПроизводителност на компанията по чатбот в едно повикване (таблицата с performance по чатбот в таблото): id, name, slug, isActive, sessions, messages, ЧЗВ и лийдове на чатбот, сортирани по sessions.analytics:read
analytics_formsСтатистики за подавания на контактни форми за компания или един чатбот (widget от аналитиката в таблото): подавания по статус (pending/approved/rejected/spam), брой форми, total, spam rate в проценти и серията submissions-per-day за последните 7 дни.analytics:read
analytics_leadsФуния за лийдове за компания или един чатбот (widget от аналитиката в таблото): лийдове по статус (new/contacted/qualified/converted/lost), total, conversion rate в проценти и серията leads-per-day за последните 7 дни.analytics:read
analytics_overviewАналитичен обзор за компания или един чатбот: чатове, съобщения, satisfaction rate и топ въпроси за плъзгащ период (day/week/month/year), плюс overview widget на таблото (total chatbots/published FAQs/leads, sessions today/this week/this month, leads today/this week, form submissions total/today/pending).analytics:read
dashboard_activityКакво в момента изисква внимание (home view на таблото): по компания, чатботовете с нови лийдове днес, pending FAQ предложения, pending form submissions, waiting/active live chats или текуща learning phase.any

Примерни работни потоци

Добавяне на основна инструкция

Попитайте Вашия AI асистент:

"Добави основна инструкция към моя чатбот 'Support Bot': предлагаме безплатна доставка за поръчки над €50"

Асистентът ще използва chatbot_add_instruction с подходящите параметри.

Преглед на предложения за подобрение

"Покажи ми всички чакащи предложения за подобрение за моя чатбот и обясни какви промени предлагат"

Асистентът ще:

  1. Използва improvement_proposals_pending за извличане на предложения
  2. Анализира и обобщи всяко предложение
  3. Одобри или отхвърли от тях от Ваше име с improvement_proposal_approve или improvement_proposal_reject

Анализ на представянето на чат

"Дай ми седмичен отчет за обема чатове и удовлетворението на клиентите за моя чатбот"

Асистентът ще използва analytics_overview и analytics_chat_volume за съставяне на подробен отчет.

Импортиране на уебсайт

"Сканирай https://example.com, импортирай страниците за продукти и ценообразуване в моя 'Support Bot' и ми кажи когато обходът приключи"

Асистентът ще извика crawler_preview_scan, ще избере релевантните страници, ще стартира импорта с crawler_start и ще полира crawler_job_get докато задачата не завърши.

Преглед на лийдове и подавания на формуляри

"Покажи ми новите лийдове от тази седмица, назначи квалифицираните на Anna и одобри чакащите подавания на контактните формуляри"

Асистентът комбинира lead_list, lead_assign, form_submissions_list и form_submission_update_status.

Поемане на жив чат

"Маркирай ме като наличен за live chat и поеми най-стария чакащ разговор"

Асистентът използва live_chat_set_availability, live_chat_queue и live_chat_session_assign; отговорите минават през live_chat_message_send.

Сигурност

  • API ключовете са обвързани с Вашата компания и с permission scope-овете, които избирате при създаването им (вижте колоната Scope по-горе)
  • Ключовете се изпълняват с разрешенията на собственика на компанията; лимитите по план и feature gate-овете се прилагат точно както в таблото
  • Ключовете могат да бъдат оттеглени по всяко време от таблото
  • Достъп до API е наличен в платени планове — вижте нашата страница с цени

Отстраняване на проблеми

Връзката не се осъществява

  1. Проверете дали API ключът е правилен
  2. Уверете се, че ключът не е оттеглен
  3. Уверете се, че планът Ви включва достъп до API
  4. Рестартирайте Вашия MCP клиент

Инструментът не е намерен

Рестартирайте Вашия MCP клиент след промяна на конфигурацията, за да презареди наличните инструменти. Имената на инструментите са с малки букви и долни черти (напр., faq_list).


Нуждаете се от помощ? Свържете се с нашия екип за поддръжка →