EtusivuDokumentaatio

MCP Server Integration

ChatReact toteuttaa Model Context Protocol (MCP) -protokollan, jonka avulla voit yhdistää ChatReact-tilisi AI-avustimiin kuten Claude Desktop, Cursor ja muihin MCP-yhteensopiviin työkaluihin.

Mikä on MCP?

Model Context Protocol on avoin standardi, joka mahdollistaa AI-avustimien vuorovaikutuksen ulkoisten palveluiden ja tietolähteiden kanssa. ChatReactin MCP-integraation avulla voit:

  • Hallinnoida chatboteja — luoda, konfiguroida (persoonallisuus, kielet, widget, käyttäytyminen, rajoitukset), upottaa ja poistaa chatboteja
  • Rakentaa tietopohjaa — lisätä dokumentteja, indeksoida verkkosivuja, hallita indeksoituja sivuja ja core-instruktioita
  • Hallinnoida UKK:ia — usein kysytyt kysymykset, kategoriat, ehdotukset, käännökset ja FAQ-widget
  • Arvioida keskusteluja — arvioida keskusteluja, asettaa luottamusluokkia, ajaa Improvement Agent -toimintoa
  • Käsitellä liidejä ja lomakkeita — liidit, liidikategoriat, kaappaussäädöt, yhteydenottolomakkeet ja lähetykset
  • Toimia live-chat-agenttina — asettaa saatavuus, ottaa odottavia keskusteluja haltuun, vastata ja sulkea sessioita
  • Hallinnoida yritystäsi — profiili, brändivärit, tiimin jäsenet ja kutsut
  • Käyttää Email Assistantia — postilaatikon yhteydet, kategoriat, kontaktit ja aktiviteetti
  • Lukea analytiikkaa ja ilmoituksia

Kaiken, mitä voit tehdä hallintapaneelissa, on saatavilla MCP:n kautta (ja REST API:n); vain selaimeen sidotut toiminnot kuten maksut, postilaatikon OAuth, passkeys, tilin poisto ja API-avainten hallinta pysyvät hallintapaneelissa.

Aloittaminen

1. Generoi API-avain

  1. Siirry Kojelauta → Yritys → API -välilehdelle
  2. Klikkaa Luo API-avain
  3. Anna avaimellesi kuvaava nimi (esim. "Claude Desktop") ja valitse vähintään yksi oikeus
  4. Kopioi luotu avain (alkaa cr_)

API-avaimet ovat saatavilla maksullisilla suunnitelmilla — katso Pricing page.

Säilytä API-avaimesi turvallisesti. Sitä ei voi noutaa luomisen jälkeen.

2. Konfiguroi MCP-asiakasohjelmasi

ChatReactin MCP-palvelin isännöidään osoitteessa https://www.chatreact.ai/api/mcp ja se kommunikoi HTTP:n (JSON-RPC) yli. Todennus tapahtuu Authorization: Bearer-otsakkeella — myös X-API-Key-otsake, jossa on sama avain, hyväksytään.

Cursor IDE

Cursor tukee etä-MCP-palvelimia suoraan. Lisää seuraavat asetukset Cursorin MCP-asetuksiin:

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

Claude Desktop

Claude Desktopin konfiguraatiotiedosto tukee komentopohjaisia palvelimia, joten käytä vakiobridgenä mcp-remote yhdistääksesi isännöidylle päätepisteelle:

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

Tämä asennus edellyttää Node.js:n asentamista. Esimerkissä käytetään X-API-Key-otsaketta, koska jotkin asiakkaat eivät käsittele välilyöntejä argumenteissa luotettavasti.

3. Käynnistä AI-avustimesi uudelleen

Konfiguraation tallentamisen jälkeen käynnistä Claude Desktop tai Cursor uudelleen yhteyden muodostamiseksi.

Saatavilla olevat työkalut

ChatReact MCP paljastaa alla olevat työkalut, ryhmiteltyinä alueittain. Scope-sarakkeessa näytetään API-avaimen vaatima oikeus (any = jokainen kelvollinen avain). Työkalut suoritetaan samoilla sovellettavilla oikeuksilla, suunnitelmarajoilla ja sivuvaikutuksilla kuin hallintapaneelin toiminnot. Selaimeen sidotut maksuihin, postilaatikon valtuutukseen, passkeyeihin, tilin poistoon ja avainten hallintaan liittyvät työnkulut pysyvät hallintapaneelissa.

Tuhoavat toiminnot (poista, nollaa, sulje, yhdistä) pyytävät vahvistusta käytettäessä Dashboard Assistantin kautta. API-avaimella ne suoritetaan välittömästi.

Account

ToolDescriptionScope
account_usage_getHanki nykyinen suunnitelma (tasoluokka, tila), kuluvan laskutuskauden käyttömittarit (yritykset, chatbotit, tiimin jäsenet, keskustelut, tokenit) ja suunnitelmarajat sekä kutsutun yrityksen tehokkaat rajat ja ominaisuusliput.any
user_companiesListaa kaikki yritykset, joihin nykyisellä käyttäjällä on pääsy, mukaan lukien käyttäjän rooli kussakin.any
user_notification_mark_readMerkitse yksi nykyisen käyttäjän ilmoituksista luetuksi.any
user_notification_preferences_getHanki nykyisen käyttäjän ilmoitusasetukset: globaalit sähköposti/push-kytkimet, digestin tiheys/aika/viikonpäivä/aikavyöhyke, hiljaiset tunnit ja per-tyyppi-kanava-asetukset.any
user_notification_preferences_updatePäivitä nykyisen käyttäjän globaalit ilmoitusasetukset (sähköposti/push-kytkimet, digest-aikataulu, hiljaiset tunnit).any
user_notification_type_setting_updateOta käyttöön tai poista käytöstä sähköposti / sovelluksen sisäinen toimitus yhden ilmoitustyypin osalta nykyiselle käyttäjälle (esim.any
user_notification_types_listListaa kaikki ilmoitustyypit ryhmiteltynä kategoriassa (chatbot, liidit, live chat, knowledge, tiimi, laskutus).any
user_notification_unread_countHanki nykyisen käyttäjän lukemattomien ilmoitusten määrä.any
user_notificationsListaa nykyisen käyttäjän ilmoitukset uusimmasta vanhimpaan, käyttämällä cursor-paginointia.any
user_notifications_delete_oldTaloushallinto: poista pysyvästi nykyisen käyttäjän jo luetut ja yli 30 päivää vanhat ilmoitukset.any
user_notifications_mark_all_readMerkitse kaikki nykyisen käyttäjän ilmoitukset luetuiksi.any
user_profileHanki nykyisen käyttäjän profiili (id, nimi, sähköposti, rooli, tilausvaihe).any

Company & Team

ToolDescriptionScope
company_chatbots_listListaa kaikki tietyn yrityksen chatbotit yhteenvedon kanssa.chatbots:read
company_getHanki yksityiskohtaista tietoa yrityksestä: profiili, omistaja, brändiasetukset (värit, ilmoitussähköposti) ja laskurit.any
company_invite_cancelPeruuta (poista) tiimikutsu, jotta linkki ei enää toimi.company:write
company_invite_resendLähetä odottava tiimikutsu uudelleen: luo uusi token, jatkaa vanhenemista 7 päivällä ja lähettää kutsun sähköpostilla uudelleen.company:write
company_invites_listListaa yrityksen tiimikutsut (oletuksena odottavat; aseta includeExpired myös vanhentuneiden palauttamiseksi).company:read
company_listListaa kaikki yritykset, joihin käyttäjällä on pääsy (API-avaimet ja Dashboard Assistant näkevät vain oman yrityksensä).any
company_logo_removePoista yrityksen logo (poistaa tallennetun kuvan ja tyhjentää logo-URLin).company:write
company_member_inviteKutsu tiimin jäsen sähköpostilla roolilla (ADMIN, MANAGER, AGENT tai VIEWER).company:write
company_member_removePoista tiimin jäsen yrityksestä.company:write
company_member_update_roleVaihda tiimin jäsenen rooli (ADMIN, MANAGER, AGENT tai VIEWER).company:write
company_members_listListaa yrityksen jäsenet rooleineen (OWNER, ADMIN, MANAGER, AGENT, VIEWER).any
company_settings_updatePäivitä yrityksen brändiasetuksia: primaryColor / secondaryColor (#RRGGBB) ja ilmoitussähköposti chat-arvioille.company:write
company_updatePäivitä yrityksen profiili: nimi (2–100 merkkiä), kuvaus (max 1000 merkkiä) tai verkkosivusto (https:// lisätään automaattisesti; lähetä tyhjä merkkijono tyhjentääksesi sivuston/kuvauksen).company:write

Chatbot Management

ToolDescriptionScope
chatbot_add_instructionLisää uusi core-instructio chatbotille (1–5000 merkkiä).chatbots:write
chatbot_confirm_embedMerkitse chatbot upotetuksi verkkosivustolle (piilottaa asennusmuistutuksen hallintapaneelissa).chatbots:write
chatbot_createLuo uusi chatbot (sama kuin hallintapaneelin ohjattu asennus).chatbots:write
chatbot_deletePoista chatbot pysyvästi kaikilla sen UKK:illa, dokumenteilla, keskusteluilla, liideillä ja lomakkeilla (ei voi peruuttaa).chatbots:write
chatbot_delete_instructionPoista core-instructio chatbotista.chatbots:write
chatbot_getHanki yksityiskohtaista tietoa chatbotista: yleisasetukset, persoonallisuus (persona, sävy, kielet, rajoitukset), widget-asetukset, live chat, oppimisvaihe, upotustila ja laskurit.chatbots:read
chatbot_get_embed_codeHanki HTML-koodinpätkä chatbotin asentamiseksi verkkosivulle (script-URL + <script> tag) ja tieto siitä, onko upotus vahvistettu.chatbots:read
chatbot_get_instructionsHanki kaikki core-instruktiot chatbotille.chatbots:read
chatbot_improve_instructionsKirjoita core-instruction uudelleen alustan AI:n avulla (sama kuin hallintapaneelin 'Improve with AI').chatbots:write
chatbot_learning_phase_getHanki chatbotin oppimisvaiheen asetukset: käyttäytymispresetti (CAUTIOUS, BALANCED, CONFIDENT), mukautettu kehotte ja tieto siitä, onko botti vielä oppimisvaiheessa.chatbots:read
chatbot_learning_phase_updateAseta oppimisvaiheen käyttäytymispresetti (CAUTIOUS = ohjaa ihmisen puoleen epävarmoissa tapauksissa, BALANCED, CONFIDENT) ja/tai mukautettu oppimisvaiheen kehotte.chatbots:write
chatbot_listListaa kaikki chatbotit, joihin käyttäjällä on pääsy, yhteenvedon kanssa.chatbots:read
chatbot_reorder_instructionsAseta chatbotin core-instruktioiden järjestys.chatbots:write
chatbot_templates_listListaa chatbot-mallit (presetit persona, sävy, viestit ja widget-käyttäytyminen), jotka voidaan antaa templateId-parametrina chatbot_create-kutsulle, ja tieto siitä, voiko yrityksen suunnitelma käyttää niitä.chatbots:read
chatbot_toggle_activeAktivoi tai deaktivoi chatbot.chatbots:write
chatbot_toggle_learningLopeta (false) tai ota uudelleen käyttöön (true) chatbotin oppimisvaihe.chatbots:write
chatbot_updatePäivitä chatbotin yleisasetuksia: nimi, kuvaus, isActive, live chat (liveChatEnabled/liveChatMode, suunnitelman ominaisuus), showBranding (white-label-suunnitelmissa), chat-arvioiden sähköpostit, FAQ-automaattigenerointi, legacy coreInstructions -teksti, oppimisvaihe (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt).chatbots:write
chatbot_update_instructionPäivitä olemassa oleva core-instructio (content, isActive, channel, sortOrder).chatbots:write
chatbot_update_personalityPäivitä chatbotin persoonallisuus: persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), tonality-liukusäätimet 1–5, kielet (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), viestit (welcomeMessage, fallbackMessage, proactive greeting) ja rajoitukset (blacklistTopics, complianceRules, maxResponseLength, human handoff).chatbots:write
widget_settings_getHanki chatbotin nykyiset widget-asetukset (kaikki ulkoasu-, brändi-, käyttäytymis- ja pre-chat-lomakekentät).chatbots:read
widget_settings_updatePäivitä chatbotin chat-widget: position (ml.chatbots:write
widget_translations_getHanki chatbotin per-kieli widget-käännökset: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }.chatbots:read
widget_translations_updateAseta per-kieli widget-käännökset.chatbots:write

Knowledge Base

ToolDescriptionScope
crawler_job_cancelPeruuta PENDING- tai RUNNING-tilassa oleva indeksointityö; jäljellä olevat sivut jätetään väliin.knowledge:write
crawler_job_getHanki indeksointityön tila, eteneminen (pagesCrawled/pagesFound, tokensUsed) ja kunkin sivun tila.knowledge:read
crawler_jobs_listListaa chatbotin indeksointityöt (uusin ensin) tilan ja etenemisen kanssa.knowledge:read
crawler_limitsHanki suunnitelman indeksointirajoitukset chatbotille (maks. sivuja per indeksointi, tokenit per sivu, indeksoinnit per kuukausi) ja tieto siitä, voiko uusi indeksointi aloittaa tältä kuulta.knowledge:read
crawler_preview_scanSkannaa verkkosivu ja listaa indeksoitavat sivut (url, otsikko, isRecommended) ilman tuontia.knowledge:write
crawler_startAloita indeksointityö, joka tuo valitut URLit chatbotin tietopohjaan (käsitellään taustalla; pollaa crawler_job_get).knowledge:write
knowledge_document_add_from_urlLataa dokumentti (PDF, TXT, MD, CSV, JSON, DOCX; max 10 MB) julkisesta http(s)-URLista ja lisää se chatbotin tietopohjaan.knowledge:write
knowledge_document_add_textLisää tekstin tai markdownin sisältävä dokumentti chatbotin tietopohjaan inline-sisällöstä (max 10 MB).knowledge:write
knowledge_document_deletePoista ladattu dokumentti tietopohjasta.knowledge:write
knowledge_document_getHanki tiedot ladatusta dokumentista, mukaan lukien käsittelytila, virheviesti ja lyhytikäinen lataus-URL.knowledge:read
knowledge_documents_listListaa ladatut dokumentit (PDF, TXT, MD, CSV, JSON, DOCX) chatbotin tietopohjassa tilan ja koon kanssa.knowledge:read
knowledge_page_addIndeksoi yksittäinen URL ja lisää se chatbotin tietopohjaan (epäonnistuu CONFLICT-tilalla, jos URL on jo indeksoitu, FORBIDDEN-tilalla kun token-raja ylittyy).knowledge:write
knowledge_page_deletePoista indeksoitu sivu tietopohjasta (poistaa sen vektorivarastotiedoston).knowledge:write
knowledge_page_getHanki indeksoitu sivu mukaan lukien markdown-sisältö, joka indeksoitiin chatbotille (hyödyllinen varmistaessa, mitä botti tietää sivusta).knowledge:read
knowledge_page_recrawlHae indeksoitu sivu uudelleen ja korvaa sen indeksoitu sisältö (esim.knowledge:write
knowledge_pages_deletePoista useita indeksoituja sivuja chatbotilta kerralla.knowledge:write
knowledge_pages_listListaa indeksoidut sivut chatbotin tietopohjassa, valinnaisesti suodatettuna verkkotunnuksen, tilan tai hakusanan (URL/otsikko) mukaan.knowledge:read
knowledge_statsYleiskatsaus chatbotin tietopohjasta: dokumentit (tilan ja koon mukaan), indeksoidut sivut ja verkkosivustot (tilan mukaan), indeksointityöt, core-instruktiot jaoteltuna lähteen mukaan (manuaalinen vs. improvement agent), UKK:t, vektorivaraston tila/koko ja tallennuksen käyttö vs.knowledge:read
knowledge_website_deletePoista kaikki tietyn verkkotunnuksen indeksoidut sivut chatbotin tietopohjasta.knowledge:write
knowledge_website_recrawlIndeksoi uudelleen kaikki verkkotunnuksen sivut chatbotin tietopohjassa päivittääksesi niiden sisällön.knowledge:write
knowledge_website_recrawl_cancelPeruuta käynnissä oleva verkkotunnuksen uudelleenindeksointi: jonossa (PENDING) olevat sivut palautetaan aiempaan indeksoituun tilaan.knowledge:write
knowledge_websites_listListaa verkkosivustot (verkkotunnukset), joiden sivut ovat chatbotin tietopohjassa, sivumäärineen tilan mukaan ja token-yhteenvetoineen.knowledge:read

Price Management

Nämä työkalut hallinnoivat jäsenneltyjä hintaluonnoksia ja nimenomaisia hyväksyntöjä. Luonnoksen tallentaminen on erillinen toimenpide verrattuna tietyn version hyväksymiseen; kelpoisuus riippuu myös tilasta ja voimassaolosta. Nykyiset API-avaimet eivät automaattisesti saa hinta-oikeuksia. Vain yrityksen omistaja voi myöntää prices:write tai prices:approve. API-avaimen kutsut suoritetaan suoraan, joten tarkistakaa tarkka syöte ennen mutaation kutsumista. Katso Prices & services asiakasprosessia varten.

ToolDescriptionScope
price_listSivuta hintapääotsikoita ja erillinen hyväksytyn version kelpoisuus.prices:read
price_getLue kohteen täydellinen tila ja revisiot.prices:read
price_detailLue kohteen tiedot sivutetulla revisiohistorialla.prices:read
price_suggestions_listSivuta hintaehdotuksia.prices:read
price_createLuo luonnos palvelinluodulla item-id:llä.prices:write
price_editLuo uusi luonnos nimenomaisesti odotetusta item-versiosta.prices:write
price_import_csvTuo luonnoksia nimenomaisessa muodossa ja vakaalla import-id:llä turvallisia uudelleenyrittoyrityksiä varten.prices:write
price_suggestion_applyKäytä valittua ehdokasta luonnoksena.prices:write
price_approveHyväksy yksi nimenomaisesti odotettu item-versio.prices:approve
price_approve_manyHyväksy nimenomainen id/versiovalinta atomisesti; mikä tahansa vanhentunut versio hylkää koko valinnan.prices:approve
price_archiveArkistoi item nimenomaisessa odotetussa versiossaan.prices:approve

Luonnosmuutokset säilyttävät aiemman hyväksytyn revision. CSV-muoto ja desimaalierotin on ilmoitettava; muuttunut CSV-sisältö vaatii uuden import-id:n. Kaikki toiminnot sidotaan API-avaimen yritykseen ja määriteltyyn chatbottiin.

FAQ Management

ToolDescriptionScope
faq_cache_purgeTyhjennä välimuistissa oleva FAQ-widget-data kaikilla yhdistetyillä CMS-sivustoilla (WordPress-laajennus).faqs:write
faq_categories_listListaa chatbotin FAQ-kategoriat niiden FAQ-määrien, slugien, lajittelutilan ja käännösten kanssa.faqs:read
faq_categories_reorderAseta FAQ-kategorioiden järjestys widgetissä: position kategoriIds-listassa määrittää sortOrderin.faqs:write
faq_category_createLuo FAQ-kategoria chatbotille (slug generoidaan nimestä).faqs:write
faq_category_deletePoista FAQ-kategoria.faqs:write
faq_category_translations_updateKorvaa FAQ-kategorian käännökset, esim.faqs:write
faq_category_updateNimeä FAQ-kategoria uudelleen tai muuta sen kuvausta, ikonia tai lajittelutilaa.faqs:write
faq_createLuo FAQ chatbotille.faqs:write
faq_deletePoista FAQ pysyvästi (poistaa sen myös chatbotin tietopohjasta ja tyhjentää CMS-widget-välimuistit).faqs:write
faq_embed_code_getHanki upotuskoodit FAQ-widgetille: script-tag, WordPress-shortcode ja Shopify Liquid -snippet, sekä per-kategoria-variantit (käytä categorySlug-arvoa faq_categories_listista upottaaksesi vain yhden kategorian).chatbots:read
faq_getHanki FAQ:n täydet tiedot: kysymys, vastaus, kategoria, julkaisutila, lajittelujärjestys, käännökset, SEO-kentät ja palautetilastot.faqs:read
faq_listListaa chatbotin FAQ:t (käytä chatbot_list löytääksesi chatbotId:n).faqs:read
faq_reorderAseta FAQ:iden näyttöjärjestys widgetissä.faqs:write
faq_suggestion_approveHyväksy PENDING-tilassa oleva FAQ-ehdotus: luo julkaistu FAQ (valinnaisesti muokattu kysymys/vastaus/kategoria) ja merkitsee ehdotuksen APPROVED-tilaan.faqs:write
faq_suggestion_getHanki FAQ-ehdotuksen täydet tiedot (täydellinen vastaus, AI-perustelu, ehdotettu kategoria, tarkastustila).faqs:read
faq_suggestion_rejectHylkää PENDING-tilassa oleva FAQ-ehdotus valinnaisella syyllä.faqs:write
faq_suggestions_generateAnna AI:n ehdottaa uusia FAQeja chatbotin tietopohjasta (indeksoidut sivut / ladatut dokumentit), valinnaisesti yhden kategorian osalta.faqs:write
faq_suggestions_listListaa chatbotin AI-generoidut FAQ-ehdotukset (chat-keskusteluista tai faq_suggestions_generate-kutsusta).faqs:read
faq_translateKäännä FAQ:n kysymys ja vastaus AI:n avulla chatbotin muille tuetuille kielille (tai annettuihin targetLanguages) ja tallenna tulos.faqs:write
faq_translations_updateTallenna FAQ:n käännökset per kieli, esim.faqs:write
faq_updatePäivitä FAQ:n kysymys, vastaus, kategoria, julkaisutila tai manuaalinen lajittelujärjestys.faqs:write
faq_widget_settings_getHanki upotettavan FAQ-widgetin ulkoasu- ja käyttäytymisasetukset (värit, reunasäde, otsikko, välistys, maksimi leveys, allowMultipleOpen, autoOpenFirst, sort mode, otsikon käännökset).chatbots:read
faq_widget_settings_updatePäivitä FAQ-widgetin asetukset: värit (hex), borderRadius 0–32, otsikko (max 100) + showTitle, spacing compact|normal|relaxed, maxWidth 0–2000 (0 = koko leveys), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name ja otsikon käännökset per kieli.chatbots:write

Chat History & Feedback

ToolDescriptionScope
chat_feedback_dismissMerkitse keskustelu tarkastetuksi ilman arvostelua (poistaa sen odotusjonosta, ei muuta luottamuspisteitä).chats:write
chat_feedback_getHanki yksi keskusteluarviointi (palaute) AI-analyysin, vakavuuden, luottamusluokan, pistemuutoksen ja linkitetyn improvement-session kanssa.chats:read
chat_feedback_listListaa chatbotin keskusteluarvioinnit (palaute-rivit) tilasuodattimella ja laskureilla.chats:read
chat_feedback_set_severityYlikirjoita tarkastetun negatiivisen keskustelun vakavuusluokitus (MINOR|MODERATE|MAJOR|CRITICAL); vakavuus painottaa luottamuspisteen pudotusta.chats:write
chat_feedback_statsIstuntolaskurit arvion koreittain chatbotille (total, none, pending, positive, negative, reviewed, improved) — dashboardin chats-sivun tilakortit.chats:read
chat_feedback_submitArvioi keskustelusessio Good (isPositive=true) tai Needs Work (isPositive=false).chats:write
chat_session_getHanki keskustelusessio täydellä transkriptilla (viestikohtaiset token/model/latenssi/pageUrl), vierailijatiedot, aloitussivun URL, luottamusluokka, palaute (vakavuus, AI-analyysi, linkitetty improvement-session) ja tagit.chats:read
chat_session_searchEtsi chatbotin keskustelusessioita viestisisällön ja/tai vierailijan sähköpostin perusteella.chats:read
chat_session_set_categoryAseta tai muuta keskustelusession luottamusluokkaa (korjaa AI-luokitus; per-luokka-luottamus lasketaan uudelleen kun keskustelu on tarkastettu).chats:write
chat_sessions_listListaa chatbotin keskustelusessiot, uusimmasta vanhimpaan, samoilla tarkastusjonon suodattimilla kuin dashboardin chats-sivulla.chats:read

Improvement Agent

ToolDescriptionScope
confidence_categories_listListaa chatbotin luottamusluokat per-luokan luottamuspisteillä, arviointimäärillä ja arvio-sähköpostin tiheydellä.chats:read
confidence_category_createLuo luottamusluokka chatbotille.chatbots:write
confidence_category_deletePoista luottamusluokka.chatbots:write
confidence_category_mergeYhdistä yksi luottamusluokka toiseen saman chatbotin sisällä: kaikki keskustelut/arviot siirtyvät kohteeseen, lähde poistetaan ja pisteet lasketaan uudelleen.chatbots:write
confidence_category_updateNimeä luottamusluokka uudelleen ja/tai aseta sen arvio-sähköpostin tiheys (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1–24 vain HOURLYlle).chatbots:write
confidence_status_getChatbotin luottamustila: pistemäärä, valmistumiskynnys, oppimisvaihelippu, oppimisvaiheen käyttäytyminen (CAUTIOUS|BALANCED|CONFIDENT) ja mukautettu kehotte, arviointimäärät ja per-luokka luottamuspisteet.analytics:read
improvement_proposal_approveHyväksy PENDING-tilassa oleva parannusehdotus ja käytä muutosta chatbotille (core-instruction lisäys/päivitys, FAQ luonti/päivitys tai persona-päivitys) — sama logiikka ja suunnitelmarajat kuin hallintapaneelissa.chatbots:write
improvement_proposal_rejectHylkää PENDING-tilassa oleva parannusehdotus.chatbots:write
improvement_proposal_simulateSimuloi, kuinka chatbot vastaisi ongelmalliseen viestiin ehdotus sovellettuna (alkuperäinen vs.chatbots:write
improvement_proposals_pendingListaa parannusehdotukset, jotka odottavat tarkastusta (tila PENDING) yrityksen laajuisesti tai yhdelle chatbotille.chatbots:read
improvement_session_completeMerkitse improvement-session COMPLETEDiksi (keskustelu lasketaan sitten Improved-tilaan tarkastusjonossa).chatbots:write
improvement_session_createAvaa Improvement Agent keskustelulle, joka on arvioitu Needs Workiksi.chatbots:write
improvement_session_getHanki improvement-session tiedot alkuperäisen keskustelun kanssa (viesteillä on 1-pohjainen indeksi, jota voidaan käyttää targetMessageIndexina), agentin keskustelu, kaikki ehdotukset (niiden viimeisimmällä simuloinnilla) ja simulaatiot.chatbots:read
improvement_session_resetKäynnistä improvement-session uudelleen: poistaa kaikki agentin viestit, simulaatiot ja PENDING/REJECTED-ehdotukset (sovellettuja pidetään) ja aloittaa uuden keskustelun.chatbots:write
improvement_session_send_messageLähetä viesti Improvement Agentille (kuvaile mitä botin vastauksessa oli vialla; valinnaisesti targetMessageIndex = bot-viestin 1-pohjainen indeksi originalChat.messagesissa).chatbots:write
improvement_sessions_listListaa improvement-sessionit (Improvement Agent -keskustelut, jotka on aloitettu negatiivisista chat-arvioista) chatbotille tai koko yritykselle, uusimmasta vanhimpaan, ehdotusmäärien kanssa.chatbots:read
improvement_simulation_assessArvioi simulaation tulos: isApproved=true kun simuloitu vastaus on hyvä (ehdotuksen voi sitten soveltaa), false kun se tarvitsee lisää työtä (kommentti 'almost' = lähes oikein).chatbots:write

Live Chat

ToolDescriptionScope
live_chat_agents_availableHanki nykyisen käyttäjän live-chat-saatavuus, tällä hetkellä saatavilla olevat agentit live-chatiin (fresh heartbeat, sama signaali jota widget käyttää) ja tieto siitä, sisältyykö yrityksen suunnitelmaan live chat.chats:read
live_chat_heartbeatPäivitä nykyisen käyttäjän live-chat-läsnäolon heartbeat (vain kun merkitty saatavaksi live_chat_set_availabilityn kautta).chats:write
live_chat_message_sendLähetä viesti vierailijalle nimelläsi assigned agenttina.chats:write
live_chat_queueHanki live-chat-jonon: sessiot, jotka odottavat agenttia, vanhimmat ensin (FIFO).chats:read
live_chat_session_assignOta WAITING-tilassa oleva live-chat-sessio jonosta: nimeää sen nykyiselle käyttäjälle (yrityksen omistaja API-avaimilla) ja ilmoittaa vierailijalle, että agentti liittyi.chats:write
live_chat_session_closeLopeta live-chat-sessio agenttina (mikä tahansa ei-VIEWER jäsen yrityksestä).chats:write
live_chat_session_getHanki live-chat-sessio vierailijatiedoilla, nimetyn agentin tiedoilla, kaikilla viesteillä ja aiemmalla bot-keskustelulla (handoff-konteksti).chats:read
live_chat_sessions_listListaa live-chat-sessiot (uusin ensin; WAITING-sessiot vanhimmat ensin) valinnaisilla suodattimilla chatbotin, tilan ja nimetyn agentin mukaan.chats:read
live_chat_set_availabilityKytke nykyisen käyttäjän 'Available for Live Chat' -kytkin yritykselle päälle/pois.chats:write

Leads

ToolDescriptionScope
lead_assignAseta liidi yrityksen jäsenelle tai poista määritys (assignedToId: null).leads:write
lead_bulk_update_statusAseta useiden liidien tila kerralla (max 100).leads:write
lead_categories_listListaa chatbotin liidikategoriat liidimäärineen ja tiimin jäsenet, jotka saavat ilmoituksia per kategoria.leads:read
lead_category_assign_userLisää yrityksen jäsen liidikategorian ilmoituslistalle (tai päivitä heidän ilmoitusliput).leads:write
lead_category_createLuo liidikategoria chatbotille.leads:write
lead_category_deletePoista liidikategoria.leads:write
lead_category_remove_userPoista yrityksen jäsen liidikategorian ilmoituslistalta.leads:write
lead_category_updatePäivitä liidikategorian nimi, kuvaus ja/tai väri.leads:write
lead_createLuo liidi manuaalisesti (esim.leads:write
lead_deletePoista liidi pysyvästi.leads:write
lead_field_config_getHanki chatbotin liidikaappauskonfiguraatio: kentät (id:t kartoitettu lead.data-avaimiin), vahvistusviesti, kenttä/UI-käännökset ja AI-tunnistuksen asetukset.leads:read
lead_field_config_updatePäivitä chatbotin liidikaappauskonfiguraatio.leads:write
lead_getHanki liidin täydet tiedot mukaan lukien vastuuhenkilö, kategoria ja lähdekeskustelun transkriptio (sivutettu messageOffset/messageLimit, oletuksena ensimmäiset 20 viestiä).leads:read
lead_listListaa chatbotin liidit (uusin ensin) valinnaisilla suodattimilla tilan, kategorian, vastuuhenkilön ja vapaatekstihakun (nimi/sähköposti/yritys) mukaan.leads:read
lead_statsHanki liiditilastot chatbotille: määrät tiloittain, viimeisen 7 päivän liidit ja konversioprosentti.leads:read
lead_updatePäivitä liidin tila, kategoria, muistiinpanot, kaapattu data ja/tai vastuuhenkilö.leads:write

Forms

ToolDescriptionScope
form_createLuo yhteydenottolomake chatbotille (perusasetukset, kentät, ulkoasu ja roskapostiasetukset yhdessä kutsussa).forms:write
form_deletePoista pysyvästi yhteydenottolomake ja KAIKKI sen lähetykset (cascade).forms:write
form_getHanki yhteydenottolomake täysimittaisesti: kentät, käännökset, tyylit, roskapostiasetukset, aktiivinen tila, lähetyslukumäärä ja upotus script-tag (embedCode).forms:read
form_listListaa chatbotin yhteydenottolomakkeet kenttämäärin, lähetys määrin ja upotuskoodien kanssa.forms:read
form_statsYhteydenottolomakkeen lähetyslukumäärät: yhteensä, odottaa, hyväksytty, roskaposti ja hylätty.forms:read
form_submission_deletePoista pysyvästi yhteydenottolomakkeen lähetys (esim.forms:write
form_submission_getHanki yhteydenottolomakkeen lähetys täysimittaisesti: lähetetyt kenttäarvot, roskapistetiheys ja AI-roskaposti-analyysi, IP/user agent/referrer-metadata ja tarkastustiedot.forms:read
form_submission_update_statusTarkasta yhteydenottolomakkeen lähetys: aseta sen tila APPROVED, SPAM tai REJECTED valinnaisella tarkastusbemerkinnällä.forms:write
form_submissions_listListaa lomakkeen lähetykset, uusimmasta vanhimpaan, valinnaisesti suodatettuna tilan (PENDING, APPROVED, SPAM, REJECTED) ja luontipäivän mukaan.forms:read
form_updatePäivitä yhteydenottolomake: nimi, kuvaus, aktiivinen tila (isActive kontrolloi upotuksen renderöintiä), kentät (täydellinen korvaus), ulkoasu (värit, napin teksti, onnistumisviesti) ja roskapostiasetukset (spamThreshold, autoRejectSpam, notificationEmail).forms:write
form_update_translationsKorvaa lomakkeen kenttä- ja/tai UI-käännökset.forms:write

Email Assistant

ToolDescriptionScope
email_activity_listListaa postilaatikon käsitellyn sähköpostin aktiviteettiloki (uusin ensin): lähettäjä, aihe, asetettu kategoria, lopputulos (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) ja outcomeDetail.email:read
email_categories_listListaa postilaatikon sähköpostikategoriat (järjestetty sortOrderin mukaan).email:read
email_category_createLuo sähköpostikategoria postilaatikon liitokselle (max 20 per liitos).email:write
email_category_deletePoista sähköpostikategoria.email:write
email_category_updatePäivitä sähköpostikategoria (partiaali: vain annetut kentät muuttuvat).email:write
email_connection_disconnectIrrota postilaatikko pysyvästi.email:write
email_connection_getHanki postilaatikon liitos mukaan lukienemail:read
email_connection_updatePäivitä postilaatikon liitos: keskeytä/jatka synkronointi (paused true/false; vaihtaa vain ACTIVE<->DISABLED, ei koskaan korvaa TOKEN_EXPIRED/ERROR), kytke vastausluonnoksen luonnostelu (draftingEnabled) ja kategorisointi/organisointi (organizingEnabled), ohjaa voimatekijächatbot uudelleen (chatbotId samasta yrityksestä) tai aseta HTML-allekirjoitus vastauksille (signatureHtml, max 20000 merkkiä; tyhjä merkkijono poistaa sen).email:write
email_connections_listListaa yrityksen Email Assistant -postilaatikkoyhteydet (osoite, tila ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, viimeisin synkronointi, viimeisin virhe, luonnostelu/kategoria-kytkimet, voimatekijächatbot, draftReadyCategoryCount = kategoriat, jotka voivat tuottaa luonnoksia, baseRuleCount = chatbotin laajuiset 'Chat + Email' -säännöt) yhdessä suunnitelmarajojen kanssa (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth).email:read
email_contact_deletePoista opittu sähköpostikontakti (unohda lähettäjän profiili, esim.email:write
email_contact_getHanki opittu sähköpostikontakti kaikkine opittujen faktojen, sisäisten muistiinpanojen, suhteiden, muodollisen/epämuodollisen puhuttelun asetuksen ja sähköpostitilastojen kanssa.email:read
email_contact_updatePäivitä opittu sähköpostikontakti.email:write
email_contacts_listListaa yrityksen opitut sähköpostikontaktit (uusin sähköposti ensin) suhteineen, muodollinen/epämuodollinen puhuttelu (formalAddress: true = muodollinen 'Sie', false = epämuodollinen 'Du', null = automaattinen), faktamäärä ja muistiinpanon esikatselu.email:read
email_folder_createLuo mail-kansio inboxin alle (palauttaa olemassa olevan, jos nimi on varattu) käytettäväksi kategorian siirtokohteena.email:write
email_folders_listListaa kansiot, joihin sähköpostikategoria voi siirtää sähköpostia, suoraan postilaatikosta: inboxin alikansiot, mukautetut pääkansiot, arkisto, roskaposti ja roskakori (id 'deleteditems').email:read
email_general_rules_listListaa chatbotin laajuiset säännöt, jotka koskevat jokaista postilaatikon vastausluonnosta: aktiiviset core-instruktiot kanavalla BOTH ("Chat + Email"), sekä perinteiset vain-sähköposti-säännöt, joita ei ole vielä siirretty kategorioihin.email:read

Analytics

ToolDescriptionScope
analytics_chat_volumeKeskustelumäärä (aloitetut sessiot) ajan kuluessa kaavioita ja trendejä varten: period week/month/quarter/year, granularity hour/day/week/month, valinnaisesti yhdelle chatbotille.analytics:read
analytics_chatbot_statsYrityksen per-chatbot -suoritus yhdessä kutsussa (hallintapaneelin chatbot performance -taulukko): id, nimi, slug, isActive, sessions, messages, FAQs ja liidit per chatbot, järjestetty sessionsin mukaan.analytics:read
analytics_formsYhteydenottolomakkeen lähetysstatistiikat yritykselle tai yhdelle chatbotille (hallintapaneelin analytiikka-widget): lähetykset tiloittain (pending/approved/rejected/spam), lomakkeiden määrä, yhteensä, roskaprosentti ja viimeisten 7 päivän submissions-per-day -sarja.analytics:read
analytics_leadsLiidien suppilo yritykselle tai yhdelle chatbotille (hallintapaneelin analytiikka-widget): liidit tiloittain (new/contacted/qualified/converted/lost), yhteensä, konversioprosentti ja viimeisten 7 päivän leads-per-day -sarja.analytics:read
analytics_overviewAnalytiikan yleiskatsaus yritykselle tai yhdelle chatbotille: keskustelut, viestit, tyytyväisyysaste ja top-kysymykset liukuvalla ajanjaksolla (day/week/month/year), plus hallintapaneelin overview-widget (yhteensä chatbotit/published FAQs/liidit, sessiot tänään/tällä viikolla/tässä kuussa, liidit tänään/tällä viikolla, lomakelähetykset yhteensä/tänään/odottaa).analytics:read
dashboard_activityMitä tällä hetkellä vaatii huomiota (hallintapaneelin kotinäkymä): per yritys, chatbotit, joilla on uusia liidejä tänään, odottavat FAQ-ehdotukset, odottavat lomakelähetykset, odottavat/aktiiviset live-chatit tai käynnissä oleva oppimisvaihe.any

Esimerkkityönkulut

Core-instructionin lisääminen

Pyydä AI-avustinta:

"Lisää core-instruction 'Support Bot' -chatbotiini: tarjoamme ilmaisen toimituksen yli 50 € tilauksiin"

Avustaja käyttää chatbot_add_instruction sopivilla parametreilla.

Parannusehdotusten tarkastelu

"Näytä kaikki odottavat parannusehdotukset chatbotilleni ja selitä, mitä muutoksia ne ehdottavat"

Avustaja:

  1. Käyttää improvement_proposals_pending hakeakseen ehdotukset
  2. Analysoi ja tiivistää jokaisen ehdotuksen
  3. Hyväksyy tai hylkää ne puolestasi improvement_proposal_approve- tai improvement_proposal_reject-kutsuilla

Keskustelusuorituskyvyn analysointi

"Anna minulle viikoittainen raportti keskustelumäärästä ja asiakastyytyväisyydestä chatbotilleni"

Avustaja käyttää analytics_overview ja analytics_chat_volume kokoavan kattavan raportin.

Verkkosivun tuominen

"Skannaa https://example.com, tuo tuotet ja hinnastot sivut 'Support Bot' -chatbotiiniini ja ilmoita, kun indeksointi on valmis"

Avustaja kutsuu crawler_preview_scan, valitsee relevantit sivut, aloittaa tuonnin crawler_start:llä ja pollaa crawler_job_get kunnes työ on valmis.

Liidien ja lomakelähetysten tarkastelu

"Näytä tämän viikon uudet liidit, osoita kelvolliset Annalle ja hyväksy odottavat yhteydenottolomakkeen lähetykset"

Avustaja yhdistää lead_list, lead_assign, form_submissions_list ja form_submission_update_status.

Live-chatin ottaminen haltuun

"Aseta minut saataville live-chatiin ja ota vanhin odottava keskustelu"

Avustaja käyttää live_chat_set_availability, live_chat_queue ja live_chat_session_assign; vastaukset menevät live_chat_message_send kautta.

Security

  • API-avaimet sidotaan yritykseesi ja niihin oikeuksiin, jotka valitset niiden luomisessa (katso Scope -saraketta yllä)
  • Avaimet suorittavat yrityksen omistajan oikeuksilla; suunnitelmarajat ja ominaisuuksien lippujen rajoitukset pätevät täsmälleen kuten hallintapaneelissa
  • Avaimet voidaan peruuttaa milloin tahansa hallintapaneelista
  • API-käyttö on saatavilla maksullisilla suunnitelmilla — katso Pricing page

Troubleshooting

Yhteyden muodostaminen epäonnistui

  1. Varmista, että API-avaimesi on oikea
  2. Tarkista, ettei avain ole peruutettu
  3. Varmista, että suunnitelmasi sisältää API-pääsyn
  4. Käynnistä MCP-asiakas uudelleen

Työkalua ei löydy

Käynnistä MCP-asiakas uudelleen konfiguraation muuttamisen jälkeen, jotta saat ladattua saatavilla olevat työkalut uudelleen. Työkalujen nimet ovat pienaakkosilla ja alaviivoin (esim. faq_list).


Tarvitsetko apua? Ota yhteyttä tukitiimiimme →