Strona głównaDokumentacja

MCP Server Integration

ChatReact implementuje Model Context Protocol (MCP), co pozwala połączyć konto ChatReact z asystentami AI takimi jak Claude Desktop, Cursor oraz innymi narzędziami zgodnymi z MCP.

Czym jest MCP?

Model Context Protocol to otwarty standard umożliwiający asystentom AI interakcję z zewnętrznymi usługami i źródłami danych. Dzięki integracji MCP w ChatReact można:

  • Zarządzać chatbotami — tworzyć, konfigurować (persona, języki, widget, zachowanie, ograniczenia), osadzać i usuwać chatboty
  • Budować bazę wiedzy — dodawać dokumenty, indeksować witryny, zarządzać zaindeksowanymi stronami i głównymi instrukcjami
  • Zarządzać FAQ — FAQ, kategorie, sugestie, tłumaczenia i widget FAQ
  • Przeglądać rozmowy — oceniać konwersacje, przypisywać kategorie zaufania, uruchamiać Improvement Agent
  • Pracować z leadami i formularzami — leady, kategorie leadów, ustawienia capture, formularze kontaktowe i zgłoszenia
  • Działać jako agent czatu na żywo — ustawiać dostępność, przejmować oczekujące czaty, odpowiadać i zamykać sesje
  • Administrować firmą — profil, kolory marki, członkowie zespołu i zaproszenia
  • Korzystać z Email Assistant — połączenia skrzynek, kategorie, kontakty i aktywność
  • Odczytywać analitykę i powiadomienia

Wszystko, co jest możliwe w panelu, jest dostępne przez MCP (i REST API); jedynie akcje wymagające przeglądarki, takie jak płatności, OAuth skrzynek, passkeys, usuwanie konta oraz zarządzanie kluczami API pozostają w panelu.

Rozpoczęcie

1. Wygeneruj klucz API

  1. Przejdź do swojego Panel → Firma → API zakładki
  2. Kliknij Utwórz klucz API
  3. Nadaj kluczowi opisową nazwę (np. "Claude Desktop") i wybierz przynajmniej jedno uprawnienie
  4. Skopiuj wygenerowany klucz (zaczyna się od cr_)

Klucze API są dostępne w planach płatnych — zobacz naszą stronę Pricing.

Przechowuj klucz API w bezpiecznym miejscu. Nie można go odzyskać po utworzeniu.

2. Skonfiguruj klienta MCP

Serwer MCP ChatReact jest hostowany pod https://www.chatreact.ai/api/mcp i komunikuje się przez HTTP (JSON-RPC). Uwierzytelniaj się nagłówkiem Authorization: Bearer — akceptowany jest także nagłówek X-API-Key z tym samym kluczem.

Cursor IDE

Cursor obsługuje zdalne serwery MCP bezpośrednio. Dodaj do ustawień MCP w Cursorze:

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

Claude Desktop

Plik konfiguracyjny Claude Desktop obsługuje serwery oparte na poleceniach, dlatego użyj standardowego mostka mcp-remote, aby połączyć się z hostowanym endpointem:

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

Ta konfiguracja wymaga zainstalowanego Node.js. Przykład używa nagłówka X-API-Key, ponieważ niektóre klienty nie obsługują spacji w argumentach w sposób niezawodny.

3. Uruchom ponownie asystenta AI

Po zapisaniu konfiguracji zrestartuj Claude Desktop lub Cursor, aby nawiązać połączenie.

Dostępne narzędzia

ChatReact MCP udostępnia poniższe narzędzia pogrupowane według obszaru. Kolumna Scope pokazuje, które uprawnienie klucza API jest wymagane przez dane narzędzie (any = każdy ważny klucz). Narzędzia działają z tymi samymi właściwymi uprawnieniami, limitami planu i efektami ubocznymi, jakie występują w operacjach panelu. Workflowy związane z płatnościami, autoryzacją skrzynek, passkeys, usuwaniem konta i zarządzaniem kluczami pozostają w panelu.

Narzędzia destrukcyjne (usuń, zresetuj, zamknij, scal) wymagają potwierdzenia w Dashboard Assistant. Przy wywołaniach z klucza API wykonują się natychmiast.

Konto

ToolDescriptionScope
account_usage_getPobierz aktualny plan (tier, status), liczniki użycia za bieżący okres rozliczeniowy (companies, chatbots, team members, chats, tokens) oraz limity planu, a także efektywne limity i flagi funkcji firmy, do której odnosi się wywołanie.any
user_companiesWypisz wszystkie firmy, do których obecny użytkownik ma dostęp, wraz z rolą użytkownika w każdej z nich.any
user_notification_mark_readOznacz jedno z powiadomień obecnego użytkownika jako przeczytane.any
user_notification_preferences_getPobierz preferencje powiadomień obecnego użytkownika: globalne przełączniki email/push, częstotliwość/pora/dzień tygodnia/strefa czasowa digestu, "quiet hours" oraz ustawienia kanałów per typ.any
user_notification_preferences_updateZaktualizuj globalne preferencje powiadomień obecnego użytkownika (przełączniki email/push, harmonogram digestu, quiet hours).any
user_notification_type_setting_updateWłącz lub wyłącz dostarczanie email / in-app dla pojedynczego typu powiadomień obecnego użytkownika (np.any
user_notification_types_listWypisz wszystkie typy powiadomień pogrupowane według kategorii (chatbot, leads, live chat, knowledge, team, billing).any
user_notification_unread_countPobierz liczbę nieprzeczytanych powiadomień obecnego użytkownika.any
user_notificationsWypisz powiadomienia obecnego użytkownika, najnowsze pierwsze, z paginacją kursora.any
user_notifications_delete_oldPorządkowanie: trwale usuń powiadomienia obecnego użytkownika, które są już przeczytane i starsze niż 30 dni.any
user_notifications_mark_all_readOznacz wszystkie powiadomienia obecnego użytkownika jako przeczytane.any
user_profilePobierz profil obecnego użytkownika (id, name, email, role, subscription tier).any

Firma i zespół

ToolDescriptionScope
company_chatbots_listWypisz wszystkie chatboty dla określonej firmy z podsumowującymi statystykami.chatbots:read
company_getPobierz szczegółowe informacje o firmie: profil, owner, ustawienia marki (kolory, email powiadomień) i liczniki.any
company_invite_cancelAnuluj (usuń) zaproszenie do zespołu, aby link przestał działać.company:write
company_invite_resendPonownie wyślij oczekujące zaproszenie do zespołu: wydaje nowy token, przedłuża wygasanie o 7 dni i wysyła email ponownie.company:write
company_invites_listWypisz zaproszenia do zespołu w firmie (domyślnie pending; ustaw includeExpired, aby również zwrócić wygasłe).company:read
company_listWypisz wszystkie firmy, do których użytkownik ma dostęp (klucze API i Dashboard Assistant widzą tylko swoją firmę).any
company_logo_removeUsuń logo firmy (usuwa przechowywany obraz i czyści URL logo).company:write
company_member_inviteZaproś członka zespołu przez email z rolą (ADMIN, MANAGER, AGENT lub VIEWER).company:write
company_member_removeUsuń członka zespołu z firmy.company:write
company_member_update_roleZmień rolę członka zespołu (ADMIN, MANAGER, AGENT lub VIEWER).company:write
company_members_listWypisz członków firmy z ich rolami (OWNER, ADMIN, MANAGER, AGENT, VIEWER).any
company_settings_updateZaktualizuj ustawienia marki firmy: primaryColor / secondaryColor (#RRGGBB) oraz notificationEmail dla przeglądu rozmów.company:write
company_updateZaktualizuj profil firmy: name (2-100 znaków), description (max 1000 znaków) lub website (https:// jest dodawane automatycznie; przekaż pusty łańcuch, aby wyczyścić website/description).company:write

Zarządzanie chatbotem

ToolDescriptionScope
chatbot_add_instructionDodaj nową główną instrukcję do chatbota (1-5000 znaków).chatbots:write
chatbot_confirm_embedOznacz chatbota jako osadzonego na stronie (ukrywa przypomnienie o konfiguracji w panelu).chatbots:write
chatbot_createUtwórz nowego chatbota (tak jak kreator w panelu).chatbots:write
chatbot_deleteTrwale usuń chatbota wraz ze wszystkimi FAQ, dokumentami, rozmowami, leadami i formularzami (nieodwracalne).chatbots:write
chatbot_delete_instructionUsuń główną instrukcję z chatbota.chatbots:write
chatbot_getPobierz szczegółowe informacje o chatbocie: ustawienia ogólne, osobowość (persona, tonality, languages, restrictions), ustawienia widgetu, live chat, learning phase, status embed i liczniki.chatbots:read
chatbot_get_embed_codePobierz fragment HTML do instalacji chatbota na stronie (URL skryptu + <script> tag) oraz informację, czy osadzenie zostało potwierdzone.chatbots:read
chatbot_get_instructionsPobierz wszystkie główne instrukcje dla chatbota.chatbots:read
chatbot_improve_instructionsPrzepisz tekst głównej instrukcji za pomocą AI platformy (tak jak opcja 'Improve with AI' w panelu).chatbots:write
chatbot_learning_phase_getPobierz ustawienia fazy uczenia chatbota: preset zachowania (CAUTIOUS, BALANCED, CONFIDENT), niestandardowy prompt i czy bot nadal jest w fazie uczenia.chatbots:read
chatbot_learning_phase_updateUstaw preset zachowania fazy uczenia (CAUTIOUS = odwołuj do człowieka, gdy niepewny; BALANCED, CONFIDENT) i/lub niestandardowy prompt fazy uczenia.chatbots:write
chatbot_listWypisz wszystkie chatboty, do których użytkownik ma dostęp, z podsumowującymi statystykami.chatbots:read
chatbot_reorder_instructionsUstaw kolejność głównych instrukcji chatbota.chatbots:write
chatbot_templates_listWypisz szablony chatbotów (presety dla persona, tonality, messages i zachowania widgetu), które można przekazać jako templateId do chatbot_create, oraz informację, czy plan firmy może ich użyć.chatbots:read
chatbot_toggle_activeAktywuj lub dezaktywuj chatbota.chatbots:write
chatbot_toggle_learningZakończ (false) lub ponownie włącz (true) fazę uczenia chatbota.chatbots:write
chatbot_updateZaktualizuj ustawienia ogólne chatbota: name, description, isActive, live chat (liveChatEnabled/liveChatMode, funkcja planu), showBranding (plany white-label), emaile do przeglądu rozmów, automatyczne generowanie FAQ, legacy coreInstructions text, faza uczenia (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt).chatbots:write
chatbot_update_instructionZaktualizuj istniejącą główną instrukcję (content, isActive, channel, sortOrder).chatbots:write
chatbot_update_personalityZaktualizuj osobowość chatbota: persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), suwaki tonality 1-5, języki (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), wiadomości (welcomeMessage, fallbackMessage, proactive greeting) oraz ograniczenia (blacklistTopics, complianceRules, maxResponseLength, human handoff).chatbots:write
widget_settings_getPobierz aktualne ustawienia widgetu dla chatbota (wszystkie wygląd, branding, zachowanie i pola formularza przedczatowego).chatbots:read
widget_settings_updateZaktualizuj widget czatu chatbota: pozycja (w tymchatbots:write
widget_translations_getPobierz tłumaczenia widgetu per język dla chatbota: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }.chatbots:read
widget_translations_updateUstaw tłumaczenia widgetu per język.chatbots:write

Baza wiedzy

ToolDescriptionScope
crawler_job_cancelAnuluj zlecenie crawla o statusie PENDING lub RUNNING; pozostałe strony zostaną pominięte.knowledge:write
crawler_job_getPobierz status zadania crawla, postęp (pagesCrawled/pagesFound, tokensUsed) oraz status każdej strony.knowledge:read
crawler_jobs_listWypisz zadania crawla chatbota (najnowsze pierwsze) z statusem i postępem.knowledge:read
crawler_limitsPobierz limity crawla dla planu chatbota (max stron na crawl, tokeny na stronę, crawle na miesiąc) i czy można uruchomić nowy crawl w tym miesiącu.knowledge:read
crawler_preview_scanSkanuj witrynę i wypisz jej strony możliwe do crawlowania (url, title, isRecommended) bez importowania czegokolwiek.knowledge:write
crawler_startRozpocznij zadanie crawla, które importuje wybrane URL-e do bazy wiedzy chatbota (przetwarzane w tle; sondować crawler_job_get).knowledge:write
knowledge_document_add_from_urlPobierz dokument (PDF, TXT, MD, CSV, JSON, DOCX; max 10 MB) z publicznego URL http(s) i dodaj go do bazy wiedzy chatbota.knowledge:write
knowledge_document_add_textDodaj dokument tekstowy lub markdown do bazy wiedzy chatbota z zawartości inline (max 10 MB).knowledge:write
knowledge_document_deleteUsuń przesłany dokument z bazy wiedzy.knowledge:write
knowledge_document_getPobierz szczegóły przesłanego dokumentu, w tym status przetwarzania, komunikat o błędzie oraz krótkotrwały URL do pobrania.knowledge:read
knowledge_documents_listWypisz przesłane dokumenty (PDF, TXT, MD, CSV, JSON, DOCX) w bazie wiedzy chatbota z ich statusem i rozmiarem.knowledge:read
knowledge_page_addPrzeskanuj pojedynczy URL i dodaj go do bazy wiedzy chatbota (zwraca CONFLICT gdy URL jest już zindeksowany, FORBIDDEN gdy osiągnięto limit tokenów).knowledge:write
knowledge_page_deleteUsuń zaindeksowaną stronę z bazy wiedzy (usuwa jej plik vector-store).knowledge:write
knowledge_page_getPobierz zaindeksowaną stronę wraz z zawartością markdown, która została zindeksowana dla chatbota (przydatne do weryfikacji, co bot wie o stronie).knowledge:read
knowledge_page_recrawlPonownie pobierz zaindeksowaną stronę i zastąp jej zindeksowaną zawartość (np.knowledge:write
knowledge_pages_deleteUsuń kilka zaindeksowanych stron chatbota naraz.knowledge:write
knowledge_pages_listWypisz zaindeksowane strony w bazie wiedzy chatbota, opcjonalnie filtrowane po domenie, statusie lub wyszukiwanym terminie (URL/title).knowledge:read
knowledge_statsPrzegląd bazy wiedzy chatbota: dokumenty (wg statusu, rozmiaru), zaindeksowane strony i witryny (wg statusu), zadania crawla, główne instrukcje rozdzielone wg źródła (manual vs improvement agent), FAQ, status/rozmiar vector store i zużycie przestrzeni vs.knowledge:read
knowledge_website_deleteUsuń wszystkie zaindeksowane strony danej witryny (domeny) z bazy wiedzy chatbota.knowledge:write
knowledge_website_recrawlPonownie przeskanuj wszystkie strony witryny (domeny) w bazie wiedzy chatbota, aby odświeżyć jej zawartość.knowledge:write
knowledge_website_recrawl_cancelAnuluj trwający re-crawl witryny: strony w kolejce (PENDING) dla domeny zostaną przywrócone do poprzedniego zindeksowanego stanu.knowledge:write
knowledge_websites_listWypisz witryny (domeny), których strony znajdują się w bazie wiedzy chatbota, z liczbą stron wg statusu i sumami tokenów.knowledge:read

Zarządzanie cenami

Te narzędzia zarządzają ustrukturyzowanymi szkicami cen i jawnych zatwierdzeń. Zapisanie szkicu jest oddzielne od zatwierdzenia konkretnej wersji; uprawnienia zależą także od statusu i ważności. Istniejące klucze API nie otrzymują automatycznie uprawnień do cen. Tylko owner firmy może nadawać prices:write lub prices:approve. Wywołania z klucza API wykonują się natychmiast, więc przed wywołaniem mutacji sprawdź dokładnie przekazywane dane. Zobacz Prices & services dla workflow klienta.

ToolDescriptionScope
price_listStronicowanie nagłówków cen i oddzielna weryfikacja uprawnień zatwierdzonej wersji.prices:read
price_getOdczyt pełnego stanu pozycji i rewizji.prices:read
price_detailOdczyt szczegółów pozycji z paginowaną historią rewizji.prices:read
price_suggestions_listStronicowanie sugestii cen.prices:read
price_createUtwórz szkic z serwerowo wygenerowanym ID pozycji.prices:write
price_editUtwórz nowy szkic z wyraźnie oczekiwaną wersją pozycji.prices:write
price_import_csvImportuj szkice z określonym formatem i stabilnym import ID dla bezpiecznych ponowień.prices:write
price_suggestion_applyZastosuj wybranego kandydata sugestii jako szkic.prices:write
price_approveZatwierdź jedną wyraźnie oczekiwaną wersję pozycji.prices:approve
price_approve_manyAtomowe zatwierdzenie wyboru ID/wersji; każda przeterminowana wersja odrzuca cały wybór.prices:approve
price_archiveZarchiwizuj pozycję w jej wyraźnie oczekiwanej wersji.prices:approve

Edycje szkiców zachowują poprzednią zatwierdzoną rewizję. Format CSV i separator dziesiętny muszą być jawne; zmieniona zawartość CSV wymaga nowego import ID. Wszystkie operacje są powiązane z firmą klucza API i wskazanym chatbotem.

Zarządzanie FAQ

ToolDescriptionScope
faq_cache_purgeWyczyść pamięć podręczną danych widgetu FAQ na wszystkich powiązanych witrynach CMS (wtyczka WordPress).faqs:write
faq_categories_listWypisz kategorie FAQ chatbota z liczbą FAQ, slugami, trybem sortowania i tłumaczeniami.faqs:read
faq_categories_reorderUstaw kolejność kategorii FAQ w widgetcie: pozycja w categoryIds staje się sortOrder.faqs:write
faq_category_createUtwórz kategorię FAQ dla chatbota (slug generowany z nazwy).faqs:write
faq_category_deleteUsuń kategorię FAQ.faqs:write
faq_category_translations_updateZastąp tłumaczenia kategorii FAQ, np.faqs:write
faq_category_updateZmień nazwę kategorii FAQ lub opisu, ikony albo trybu sortowania.faqs:write
faq_createUtwórz FAQ dla chatbota.faqs:write
faq_deleteTrwale usuń FAQ (również usuwa je z bazy wiedzy chatbota i czyści pamięć podręczną widgetu CMS).faqs:write
faq_embed_code_getPobierz fragmenty do osadzenia widgetu FAQ: tag skryptu, shortcode WordPress i snippet Shopify Liquid, oraz warianty per kategoria (użyj categorySlug z faq_categories_list, aby osadzić tylko jedną kategorię).chatbots:read
faq_getPobierz pełne szczegóły FAQ: pytanie, odpowiedź, kategoria, status publikacji, sort order, tłumaczenia, pola SEO i statystyki feedbacku.faqs:read
faq_listWypisz FAQ chatbota (użyj chatbot_list, aby znaleźć chatbotId).faqs:read
faq_reorderUstaw kolejność wyświetlania FAQ w widgetcie.faqs:write
faq_suggestion_approveZatwierdź SUGGESTED FAQ o statusie PENDING: tworzy opublikowane FAQ (opcjonalnie z edytowanym pytaniem/odpowiedzią/kategorią) i oznacza sugestię jako APPROVED.faqs:write
faq_suggestion_getPobierz pełne szczegóły sugestii FAQ (pełna odpowiedź, AI reasoning, sugerowana kategoria, stan przeglądu).faqs:read
faq_suggestion_rejectOdrzuć sugestię FAQ o statusie PENDING z opcjonalnym powodem.faqs:write
faq_suggestions_generatePozwól AI zaproponować nowe FAQ z bazy wiedzy chatbota (zaindeksowane strony / przesłane dokumenty), opcjonalnie dla jednej kategorii.faqs:write
faq_suggestions_listWypisz sugestie FAQ wygenerowane przez AI dla chatbota (z rozmów lub faq_suggestions_generate).faqs:read
faq_translatePrzetłumacz pytanie i odpowiedź FAQ za pomocą AI na inne wspierane języki chatbota (lub na podane targetLanguages) i zapisz wynik.faqs:write
faq_translations_updateZapisz tłumaczenia FAQ per język, np.faqs:write
faq_updateZaktualizuj pytanie, odpowiedź, kategorię, status publikacji lub ręczny sort order FAQ.faqs:write
faq_widget_settings_getPobierz ustawienia wyglądu i zachowania osadzanego widgetu FAQ (kolory, border radius, tytuł, odstępy, max width, allowMultipleOpen, autoOpenFirst, sort mode, tłumaczenia tytułu).chatbots:read
faq_widget_settings_updateZaktualizuj ustawienia widgetu FAQ: kolory (hex), borderRadius 0-32, tytuł (max 100) + showTitle, spacing compact|normal|relaxed, maxWidth 0-2000 (0 = pełna szerokość), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name oraz tłumaczenia tytułu per język.chatbots:write

Historia czatów i feedback

ToolDescriptionScope
chat_feedback_dismissOznacz rozmowę jako przejrzaną bez oceniania jej (usuwa z kolejki pending, nie zmienia confidence score).chats:write
chat_feedback_getPobierz jedno review czatu (feedback) z analizą AI, severity, kategorią zaufania, zmianą score i powiązaną sesją improvement.chats:read
chat_feedback_listWypisz recenzje czatów (wiersze feedbacku) chatbota z filtrem statusu i licznikami.chats:read
chat_feedback_set_severityNadpisz klasyfikację severity (MINOR|MODERATE|MAJOR|CRITICAL) przejrzanej negatywnej rozmowy; severity wpływa na wagę spadku confidence-score.chats:write
chat_feedback_statsLiczniki sesji per bucket recenzji dla chatbota (total, none, pending, positive, negative, reviewed, improved) — karty statystyk strony chats w panelu.chats:read
chat_feedback_submitOceń sesję czatu jako Good (isPositive=true) lub Needs Work (isPositive=false).chats:write
chat_session_getPobierz sesję czatu z pełnym transkryptem (per-message token/model/latency/pageUrl), danymi odwiedzającego, URL-em strony startowej, kategorią zaufania, feedbackiem (severity, analiza AI, powiązana sesja improvement) i tagami.chats:read
chat_session_searchPrzeszukaj sesje czatu chatbota po treści wiadomości i/lub emailu odwiedzającego.chats:read
chat_session_set_categoryPrzypisz lub zmień kategorię zaufania sesji czatu (koryguje klasyfikację AI; per-kategoria confidence jest przeliczane, gdy rozmowa była review'owana).chats:write
chat_sessions_listWypisz sesje czatu chatbota, najnowsze pierwsze, z tymi samymi filtrami kolejki przeglądu co strona chats w panelu.chats:read

Improvement Agent

ToolDescriptionScope
confidence_categories_listWypisz kategorie zaufania chatbota z per-kategorią confidence score, liczbą recenzji i częstotliwością emaili przeglądowych.chats:read
confidence_category_createUtwórz kategorię zaufania dla chatbota.chatbots:write
confidence_category_deleteUsuń kategorię zaufania.chatbots:write
confidence_category_mergeScal jedną kategorię zaufania do innej w tym samym chatbocie: wszystkie rozmowy/recenzje przenoszą się do celu, źródło jest usuwane, a wyniki są przeliczane.chatbots:write
confidence_category_updateZmień nazwę kategorii zaufania i/lub ustaw częstotliwość emaili przeglądowych (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1-24 tylko dla HOURLY).chatbots:write
confidence_status_getStatus zaufania chatbota: score, próg graduacji, flaga fazy uczenia, zachowanie fazy uczenia (CAUTIOUS|BALANCED|CONFIDENT) i niestandardowy prompt, liczniki recenzji i per-kategorię confidence scores.analytics:read
improvement_proposal_approveZatwierdź sugestię improvement o statusie PENDING i zastosuj zmianę w chatbotcie (dodanie/aktualizacja core instruction, utworzenie/aktualizacja FAQ lub aktualizacja persony) — ta sama logika i limity planu co w panelu.chatbots:write
improvement_proposal_rejectOdrzuć sugestię improvement o statusie PENDING.chatbots:write
improvement_proposal_simulateZasimuluj, jak chatbot odpowiedziałby na problematyczną wiadomość po zastosowaniu propozycji (oryginalnie vs.chatbots:write
improvement_proposals_pendingWypisz propozycje improvement oczekujące na przegląd (status PENDING) w całej firmie lub dla jednego chatbota.chatbots:read
improvement_session_completeOznacz sesję improvement jako COMPLETED (rozmowa wtedy liczy się jako Improved w kolejce przeglądu).chatbots:write
improvement_session_createOtwórz Improvement Agent dla rozmowy ocenionej jako Needs Work.chatbots:write
improvement_session_getPobierz sesję improvement z oryginalną rozmową (wiadomości mają indeks 1-based użyteczny jako targetMessageIndex), konwersacją agenta, wszystkimi propozycjami (z ich najnowszą symulacją) i symulacjami.chatbots:read
improvement_session_resetRestartuj sesję improvement: usuwa wszystkie wiadomości agenta, symulacje i propozycje o statusie PENDING/REJECTED (zastosowane propozycje pozostają) i rozpoczyna nową konwersację.chatbots:write
improvement_session_send_messageWyślij wiadomość do Improvement Agent (opisz, co było nie tak z odpowiedzią bota; opcjonalnie targetMessageIndex = indeks 1-based wiadomości bota w originalChat.messages).chatbots:write
improvement_sessions_listWypisz sesje improvement (konwersacje Improvement Agent rozpoczęte z negatywnych recenzji czatów) dla chatbota lub całej firmy, najnowsze pierwsze, z liczbą propozycji.chatbots:read
improvement_simulation_assessOceń wynik symulacji: isApproved=true gdy symulowana odpowiedź jest dobra (propozycję można wtedy zastosować), false gdy wymaga dalszej pracy (komentarz 'almost' = prawie dobrze).chatbots:write

Live Chat

ToolDescriptionScope
live_chat_agents_availablePobierz własną dostępność do live chat użytkownika, agentów aktualnie dostępnych do live chat (świeży heartbeat, ten sam sygnał, którego używa widget) oraz informację, czy plan firmy obejmuje live chat.chats:read
live_chat_heartbeatOdśwież heartbeat obecnego użytkownika dla obecności live chat (tylko gdy oznaczony jako dostępny poprzez live_chat_set_availability).chats:write
live_chat_message_sendWyślij wiadomość do odwiedzającego jako przypisany agent.chats:write
live_chat_queuePobierz kolejkę live chat: sesje czekające na agenta, najstarsze pierwsze (FIFO).chats:read
live_chat_session_assignPrzejmij sesję live chat o statusie WAITING z kolejki: przypisuje ją do obecnego użytkownika (owner firmy dla kluczy API) i powiadamia odwiedzającego, że agent dołączył.chats:write
live_chat_session_closeZakończ sesję live chat jako agent (każdy członek firmy nie będący VIEWEREM).chats:write
live_chat_session_getPobierz sesję live chat z informacjami odwiedzającego, przypisanym agentem, wszystkimi wiadomościami i wcześniejszą rozmową bota (handoff context).chats:read
live_chat_sessions_listWypisz sesje live chat (najnowsze pierwsze; sesje WAITING najstarsze pierwsze) z opcjonalnymi filtrami po chatbocie, statusie i przypisanym agencie.chats:read
live_chat_set_availabilityPrzełącz własny przełącznik 'Available for Live Chat' obecnego użytkownika dla firmy.chats:write

Leady

ToolDescriptionScope
lead_assignPrzypisz lead do członka firmy lub usuń przypisanie (assignedToId: null).leads:write
lead_bulk_update_statusUstaw status kilku leadów jednocześnie (max 100).leads:write
lead_categories_listWypisz kategorie leadów chatbota z liczbami leadów i członkami zespołu powiadamianymi per kategoria.leads:read
lead_category_assign_userDodaj członka firmy do listy powiadomień kategorii leadów (lub zaktualizuj jego flagi powiadomień).leads:write
lead_category_createUtwórz kategorię leadów dla chatbota.leads:write
lead_category_deleteUsuń kategorię leadów.leads:write
lead_category_remove_userUsuń członka firmy z listy powiadomień kategorii leadów.leads:write
lead_category_updateZaktualizuj nazwę, opis i/lub kolor kategorii leadów.leads:write
lead_createUtwórz lead ręcznie (np.leads:write
lead_deleteTrwale usuń lead.leads:write
lead_field_config_getPobierz konfigurację capture leadów dla chatbota: pola (ids mapują się do kluczy w lead.data), komunikat potwierdzający, tłumaczenia pól/UI i ustawienia rozpoznawania AI.leads:read
lead_field_config_updateZaktualizuj konfigurację capture leadów chatbota.leads:write
lead_getPobierz pełne szczegóły leada, w tym przypisanego, kategorię i źródłowy transkrypt rozmowy (paginowany z messageOffset/messageLimit, domyślnie pierwsze 20 wiadomości).leads:read
lead_listWypisz leady chatbota (najnowsze pierwsze) z opcjonalnymi filtrami po statusie, kategorii, przypisanym i wyszukiwaniu tekstowym (name/email/company).leads:read
lead_statsPobierz statystyki leadów dla chatbota: liczby wg statusu, leady z ostatnich 7 dni i wskaźnik konwersji (procent).leads:read
lead_updateZaktualizuj status, kategorię, notatki, przechwycone dane i/lub przypisanego leada.leads:write

Formularze

ToolDescriptionScope
form_createUtwórz formularz kontaktowy dla chatbota (podstawy, pola, wygląd i ustawienia antyspamowe w jednym wywołaniu).forms:write
form_deleteTrwale usuń formularz kontaktowy i WSZYSTKIE jego zgłoszenia (kaskadowo).forms:write
form_getPobierz formularz kontaktowy w całości: pola, tłumaczenia, styl, ustawienia antyspamowe, stan aktywny, liczba zgłoszeń oraz embed script tag (embedCode).forms:read
form_listWypisz formularze kontaktowe chatbota z liczbą pól, liczbą zgłoszeń i embed code'ami.forms:read
form_statsLiczniki zgłoszeń formularza kontaktowego: total, pending, approved, spam i rejected.forms:read
form_submission_deleteTrwale usuń zgłoszenie formularza kontaktowego (np.forms:write
form_submission_getPobierz zgłoszenie formularza kontaktowego w całości: przesłane dane pól, spam score i analiza antyspam AI, metadata IP/user agent/referrer oraz informacje o przeglądzie.forms:read
form_submission_update_statusPrzejrzyj zgłoszenie formularza kontaktowego: ustaw jego status na APPROVED, SPAM lub REJECTED z opcjonalną notatką recenzji.forms:write
form_submissions_listWypisz zgłoszenia formularza kontaktowego, najnowsze pierwsze, opcjonalnie filtrowane po statusie (PENDING, APPROVED, SPAM, REJECTED) i dacie utworzenia.forms:read
form_updateZaktualizuj formularz kontaktowy: name, description, stan aktywny (isActive kontroluje, czy embed się renderuje), pola (pełna zamiana), wygląd (kolory, tekst przycisku, komunikat sukcesu) i ustawienia antyspamowe (spamThreshold, autoRejectSpam, notificationEmail).forms:write
form_update_translationsZastąp tłumaczenia pól i/lub UI formularza kontaktowego.forms:write

Email Assistant

ToolDescriptionScope
email_activity_listWypisz dziennik aktywności przetwarzanych emaili połączenia skrzynki (najnowsze pierwsze): nadawca, temat, przypisana kategoria, wynik (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) oraz outcomeDetail.email:read
email_categories_listWypisz kategorie emaili połączenia skrzynki (posortowane wg sortOrder).email:read
email_category_createUtwórz kategorię email dla połączenia skrzynki (max 20 na połączenie).email:write
email_category_deleteUsuń kategorię email.email:write
email_category_updateZaktualizuj kategorię email (częściowo: zmieniają się tylko podane pola).email:write
email_connection_disconnectTrwale rozłącz skrzynkę.email:write
email_connection_getPobierz połączenie skrzynki incl.email:read
email_connection_updateZaktualizuj połączenie skrzynki: wstrzymaj/wznów synchronizację (paused true/false; tylko przełącza ACTIVE<->DISABLED, nigdy nie nadpisuje TOKEN_EXPIRED/ERROR), przełącz draftowanie odpowiedzi (draftingEnabled) i kategoryzowanie/organizowanie (organizingEnabled), zmień napędzającego chatbota (chatbotId z tej samej firmy) lub ustaw HTML sygnatury odpowiedzi (signatureHtml, max 20000 znaków; pusty łańcuch czyści ją).email:write
email_connections_listWypisz połączenia skrzynek Email Assistant firmy (address, status ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, last sync, last error, przełączniki drafting/organizing, powering chatbot, draftReadyCategoryCount = kategorie mogące wygenerować szkice, baseRuleCount = reguły "Chat + Email" stosowane do każdego szkicu) wraz z limitami planu (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth).email:read
email_contact_deleteUsuń zapamiętany kontakt email (zapomnij profil nadawcy, np.email:write
email_contact_getPobierz zapamiętany kontakt email ze wszystkimi zapamiętanymi faktami, notatkami wewnętrznymi, relacją, ustawieniem formy zwracania się formal/informal i statystykami email.email:read
email_contact_updateZaktualizuj zapamiętany kontakt email.email:write
email_contacts_listWypisz zapamiętane kontakty email firmy (najnowsze emaile pierwsze) z relacją, formal/informal address (formalAddress: true = formalne 'Sie', false = nieformalne 'Du', null = automatyczne), liczbą faktów i podglądem notatek.email:read
email_folder_createUtwórz folder pocztowy pod inboxem (zwraca istniejący, jeśli nazwa jest zajęta) do użycia jako cel przenoszenia kategorii.email:write
email_folders_listWypisz foldery, do których może przenosić kategoria email (na żywo z skrzynki): podfoldery inbox, niestandardowe foldery najwyższego poziomu, archive, junk i trash (id 'deleteditems').email:read
email_general_rules_listWypisz reguły obowiązujące dla każdego szkicu odpowiedzi skrzynki: aktywne core instructions z kanałem BOTH ("Chat + Email"), plus legacy email-only jeszcze nie zmigrowane do kategorii.email:read

Analityka

ToolDescriptionScope
analytics_chat_volumeWolumen czatów (uruchomione sesje) w czasie do wykresów i trendów: okres week/month/quarter/year, granularność hour/day/week/month, opcjonalnie dla jednego chatbota.analytics:read
analytics_chatbot_statsWydajność per chatbot firmy w jednym wywołaniu (tabela wydajności chatbotów w panelu): id, name, slug, isActive, sessions, messages, FAQs i leads per chatbot, posortowane wg sessions.analytics:read
analytics_formsStatystyki zgłoszeń formularzy kontaktowych dla firmy lub jednego chatbota (widget analityczny panelu): zgłoszenia wg statusu (pending/approved/rejected/spam), liczba formularzy, total, spam rate w procentach i seria submissions-per-day z ostatnich 7 dni.analytics:read
analytics_leadsLejek leadów dla firmy lub jednego chatbota (widget analityczny panelu): leady wg statusu (new/contacted/qualified/converted/lost), total, wskaźnik konwersji w procentach i seria leads-per-day z ostatnich 7 dni.analytics:read
analytics_overviewPrzegląd analityki dla firmy lub jednego chatbota: rozmowy, wiadomości, wskaźnik satysfakcji i top pytania dla okresu ruchomego (day/week/month/year), plus widget przeglądu panelu (total chatbots/published FAQs/leads, sessions today/this week/this month, leads today/this week, form submissions total/today/pending).analytics:read
dashboard_activityCo wymaga obecnie uwagi (widok główny panelu): per firma, chatboty z nowymi leadami dzisiaj, pending FAQ suggestions, pending form submissions, oczekujące/aktywne live chats lub trwająca faza uczenia.any

Przykładowe workflowy

Dodawanie głównej instrukcji

Poproś asystenta AI:

"Add a core instruction to my 'Support Bot' chatbot: we offer free shipping on orders over €50"

Asystent użyje chatbot_add_instruction z odpowiednimi parametrami.

Przeglądanie sugestii improvement

"Show me all pending improvement proposals for my chatbot and explain what changes they suggest"

Asystent:

  1. Użyje improvement_proposals_pending, aby pobrać propozycje
  2. Przeanalizuje i podsumuje każdą sugestię
  3. Zatwierdzi lub odrzuci je w Państwa imieniu przy pomocy improvement_proposal_approve lub improvement_proposal_reject

Analiza wydajności czatu

"Give me a weekly report of chat volume and customer satisfaction for my chatbot"

Asystent użyje analytics_overview i analytics_chat_volume, aby przygotować kompleksowy raport.

Importowanie witryny

"Scan https://example.com, import the product and pricing pages into my 'Support Bot' and tell me when the crawl is done"

Asystent wywoła crawler_preview_scan, wybierze odpowiednie strony, rozpocznie import za pomocą crawler_start i będzie sondować crawler_job_get aż zadanie się zakończy.

Przegląd leadów i zgłoszeń formularzy

"Show me the new leads from this week, assign the qualified ones to Anna and approve the pending contact form submissions"

Asystent łączy lead_list, lead_assign, form_submissions_list i form_submission_update_status.

Przejęcie live chatu

"Set me available for live chat and take the oldest waiting conversation"

Asystent użyje live_chat_set_availability, live_chat_queue i live_chat_session_assign; odpowiedzi przechodzą przez live_chat_message_send.

Bezpieczeństwo

  • Klucze API są ograniczone do Państwa firmy oraz zakresów uprawnień, które wybierzecie podczas ich tworzenia (zobacz kolumnę Scope powyżej)
  • Klucze wykonują się z uprawnieniami ownera firmy; limity planu i bramki funkcji obowiązują dokładnie tak samo jak w panelu
  • Klucze można unieważnić w dowolnym momencie z poziomu panelu
  • Dostęp API jest dostępny w planach płatnych — zobacz naszą stronę Pricing

Rozwiązywanie problemów

Połączenie nie powiodło się

  1. Sprawdź, czy Twój klucz API jest poprawny
  2. Upewnij się, że klucz nie został unieważniony
  3. Sprawdź, czy Państwa plan obejmuje dostęp do API
  4. Zrestartuj klienta MCP

Narzędzie nie znalezione

Zrestartuj klienta MCP po zmianie konfiguracji, aby przeładował dostępne narzędzia. Nazwy narzędzi są pisane małymi literami z podkreśleniami (np., faq_list).


Potrzebujecie pomocy? Skontaktuj się z naszym zespołem wsparcia →