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 ключ
- Отидете в Табло → Компания → API таба
- Кликнете Създай API ключ
- Дайте на ключа описателно име (напр., "Claude Desktop") и изберете поне едно разрешение
- Копирайте генерирания ключ (започва с
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
| Tool | Description | Scope |
|---|---|---|
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
| Tool | Description | Scope |
|---|---|---|
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
| Tool | Description | Scope |
|---|---|---|
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
| Tool | Description | Scope |
|---|---|---|
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 за клиентския работен поток.
| Tool | Description | Scope |
|---|---|---|
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
| Tool | Description | Scope |
|---|---|---|
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
| Tool | Description | Scope |
|---|---|---|
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
| Tool | Description | Scope |
|---|---|---|
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_get | Confidence статус на чатбот: 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
| Tool | Description | Scope |
|---|---|---|
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
| Tool | Description | Scope |
|---|---|---|
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
| Tool | Description | Scope |
|---|---|---|
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
| Tool | Description | Scope |
|---|---|---|
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
| Tool | Description | Scope |
|---|---|---|
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 с подходящите параметри.
Преглед на предложения за подобрение
"Покажи ми всички чакащи предложения за подобрение за моя чатбот и обясни какви промени предлагат"
Асистентът ще:
- Използва
improvement_proposals_pendingза извличане на предложения - Анализира и обобщи всяко предложение
- Одобри или отхвърли от тях от Ваше име с
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 е наличен в платени планове — вижте нашата страница с цени
Отстраняване на проблеми
Връзката не се осъществява
- Проверете дали API ключът е правилен
- Уверете се, че ключът не е оттеглен
- Уверете се, че планът Ви включва достъп до API
- Рестартирайте Вашия MCP клиент
Инструментът не е намерен
Рестартирайте Вашия MCP клиент след промяна на конфигурацията, за да презареди наличните инструменти. Имената на инструментите са с малки букви и долни черти (напр., faq_list).
Нуждаете се от помощ? Свържете се с нашия екип за поддръжка →