HemDokumentation

MCP Serverintegration

ChatReact implementerar Model Context Protocol (MCP), vilket låter er koppla ert ChatReact-konto till AI-assistenter som Claude Desktop, Cursor och andra MCP-kompatibla verktyg.

Vad är MCP?

Model Context Protocol är en öppen standard som möjliggör för AI-assistenter att interagera med externa tjänster och datakällor. Med ChatReacts MCP-integration kan ni:

  • Hantera chatbots — skapa, konfigurera (persona, språk, widget, beteende, begränsningar), bädda in och radera chatbots
  • Bygga kunskapsbasen — lägga till dokument, genomsöka webbplatser, hantera genomsökta sidor och kärninstruktioner
  • Hantera FAQ — FAQ, kategorier, förslag, översättningar och FAQ-widgeten
  • Granska konversationer — betygsätt samtal, tilldela förtroendekategorier, kör Improvement Agent
  • Arbeta med leads och formulär — leads, leadkategorier, fångstinställningar, kontaktformulär och inskick
  • Agera som livechatsagent — ställ in er tillgänglighet, ta över väntande chattar, svara och stänga sessioner
  • Administrera ert företag — profil, varumärkesfärger, teammedlemmar och inbjudningar
  • Använda E-postassistenten — brevlådeanslutningar, kategorier, kontakter och aktivitet
  • Läsa analyser och notiser

Allt ni kan göra i instrumentpanelen finns tillgängligt via MCP (och REST API); endast åtgärder som är bundna till webbläsaren såsom betalningar, brevlåde-OAuth, passkeys, kontoradering och hantering av API-nycklar förblir i instrumentpanelen.

Komma igång

1. Generera en API-nyckel

  1. Navigera till er Översikt → Företag → API-flik
  2. Klicka Skapa API-nyckel
  3. Ge nyckeln ett beskrivande namn (t.ex. "Claude Desktop") och välj minst en behörighet
  4. Kopiera den genererade nyckeln (börjar med cr_)

API-nycklar finns på betalda planer — se vår Pricing page.

Spara din API-nyckel på ett säkert sätt. Den kan inte hämtas igen efter skapandet.

2. Konfigurera er MCP-klient

ChatReact MCP-servern är hostad på https://www.chatreact.ai/api/mcp och kommunicerar över HTTP (JSON-RPC). Autentisera med en Authorization: Bearer-header — en X-API-Key-header med samma nyckel accepteras också.

Cursor IDE

Cursor stöder fjärr-MCP-servrar direkt. Lägg till i era Cursor MCP-inställningar:

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

Claude Desktop

Claude Desktops konfigurationsfil stödjer kommandobaserade servrar, så använd den standardiserade mcp-remote-bron för att koppla till den hostade endpoints:

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

Denna uppsättning kräver att Node.js är installerat. Exemplet använder X-API-Key-headern eftersom vissa klienter inte hanterar blanksteg i argument tillförlitligt.

3. Starta om er AI-assistent

Efter att ha sparat konfigurationen, starta om Claude Desktop eller Cursor för att upprätta anslutningen.

Tillgängliga verktyg

ChatReact MCP exponerar nedanstående verktyg, grupperade per område. Kolumnen Scope visar vilken API-nyckelsbehörighet ett verktyg kräver (any = varje giltig nyckel). Verktygen körs med samma tillämpliga behörigheter, planbegränsningar och sidoeffekter som motsvarande operationer i instrumentpanelen. Webbläsarbundna betalnings-, brevlådeautentiserings-, passkey-, kontoraderings- och nyckelhanteringsflöden förblir i instrumentpanelen.

Destruktiva verktyg (radera, återställ, stäng, slå ihop) begär bekräftelse när de används via Dashboard Assistant. Via API-nyckel utförs de omedelbart.

Konto

ToolDescriptionScope
account_usage_getHämta aktuell plan (nivå, status), användarräknare för den pågående faktureringsperioden (företag, chatbots, teammedlemmar, chattar, tokens) samt planens gränser, plus effektiva gränser och funktionsflaggor för det företag som anropet är scope:at till.any
user_companiesLista alla företag som den aktuella användaren har åtkomst till, med användarens roll i respektive.any
user_notification_mark_readMarkera en av den aktuella användarens notiser som läst.any
user_notification_preferences_getHämta den aktuella användarens notisinställningar: globala e-post/push-växlar, digest-frekvens/tid/veckodag/tidszon, tysta timmar och kanalinställningar per typ.any
user_notification_preferences_updateUppdatera den aktuella användarens globala notisinställningar (e-post/push-växlar, digest-schema, tysta timmar).any
user_notification_type_setting_updateAktivera eller inaktivera e-post-/in-app-leverans för en enskild notistyp för den aktuella användaren (t.ex.any
user_notification_types_listLista alla notistyper grupperade per kategori (chatbot, leads, live chat, knowledge, team, billing).any
user_notification_unread_countHämta antal olästa notiser för den aktuella användaren.any
user_notificationsLista den aktuella användarens notiser, nyast först, med cursor-paginering.any
user_notifications_delete_oldUnderhåll: ta bort permanent den aktuella användarens notiser som redan är lästa och äldre än 30 dagar.any
user_notifications_mark_all_readMarkera alla den aktuella användarens notiser som lästa.any
user_profileHämta den aktuella användarens profil (id, namn, e-post, roll, prenumerationsnivå).any

Företag & Team

ToolDescriptionScope
company_chatbots_listLista alla chatbots för ett specifikt företag med sammanfattande statistik.chatbots:read
company_getHämta detaljerad information om ett företag: profil, ägare, varumärkesinställningar (färger, notis-e-post) och räkneverk.any
company_invite_cancelAvbryt (radera) en teaminbjudan så att länken upphör att fungera.company:write
company_invite_resendSkicka om en väntande teaminbjudan: skapar en ny token, förlänger utgångstiden med 7 dagar och skickar inbjudningsmejlet igen.company:write
company_invites_listLista teaminbjudningar för ett företag (väntande som standard; sätt includeExpired för att även returnera utgångna).company:read
company_listLista alla företag som användaren har åtkomst till (API-nycklar och Dashboard Assistant ser bara sitt eget företag).any
company_logo_removeTa bort företagslogotypen (raderar den lagrade bilden och rensar logotyp-URL).company:write
company_member_inviteBjud in en teammedlem via e-post med en roll (ADMIN, MANAGER, AGENT eller VIEWER).company:write
company_member_removeTa bort en teammedlem från företaget.company:write
company_member_update_roleÄndra en teammedlems roll (ADMIN, MANAGER, AGENT eller VIEWER).company:write
company_members_listLista medlemmarna i ett företag med deras roller (OWNER, ADMIN, MANAGER, AGENT, VIEWER).any
company_settings_updateUppdatera företagets varumärkesinställningar: primaryColor / secondaryColor (#RRGGBB) och notificationEmail för chattgranskningar.company:write
company_updateUppdatera företagsprofilen: namn (2–100 tecken), beskrivning (max 1000 tecken) eller webbplats (https:// läggs till automatiskt; skicka en tom sträng för att rensa webbplats/beskrivning).company:write

Chatbot-hantering

ToolDescriptionScope
chatbot_add_instructionLägg till en ny kärninstruktion till en chatbot (1–5000 tecken).chatbots:write
chatbot_confirm_embedMarkera en chatbot som inbäddad på webbplatsen (gömmer uppsättningspåminnelsen i instrumentpanelen).chatbots:write
chatbot_createSkapa en ny chatbot (samma som guiden i instrumentpanelen).chatbots:write
chatbot_deleteRadera permanent en chatbot med alla dess FAQ, dokument, chattar, leads och formulär (kan inte ångras).chatbots:write
chatbot_delete_instructionRadera en kärninstruktion från en chatbot.chatbots:write
chatbot_getHämta detaljerad information om en chatbot: allmänna inställningar, personlighet (persona, ton, språk, begränsningar), widgetinställningar, live chat, inlärningsfas, inbäddningsstatus och räkneverk.chatbots:read
chatbot_get_embed_codeHämta HTML-snippet för att installera en chatbot på en webbplats (skript-URL + <script>-tagg) och huruvida inbäddningen har bekräftats.chatbots:read
chatbot_get_instructionsHämta alla kärninstruktioner för en chatbot.chatbots:read
chatbot_improve_instructionsSkriv om kärninstruktionstext med plattformens AI-improver (samma som instrumentpanelens 'Improve with AI').chatbots:write
chatbot_learning_phase_getHämta inlärningsfasens inställningar för en chatbot: beteendepreset (CAUTIOUS, BALANCED, CONFIDENT), anpassad prompt och huruvida boten fortfarande är i inlärningsfasen.chatbots:read
chatbot_learning_phase_updateSätt beteendepreset för inlärningsfasen (CAUTIOUS = hänvisa till människa vid osäkerhet, BALANCED, CONFIDENT) och/eller en anpassad inlärningsprompt.chatbots:write
chatbot_listLista alla chatbots som användaren har åtkomst till, med sammanfattande statistik.chatbots:read
chatbot_reorder_instructionsSätt ordningen på en chatbots kärninstruktioner.chatbots:write
chatbot_templates_listLista chatbot-mallar (presets för persona, ton, meddelanden och widgetbeteende) som kan skickas som templateId till chatbot_create, och om företagets plan får använda dem.chatbots:read
chatbot_toggle_activeAktivera eller inaktivera en chatbot.chatbots:write
chatbot_toggle_learningAvsluta (false) eller återaktivera (true) en chatbots inlärningsfas.chatbots:write
chatbot_updateUppdatera en chatbots allmänna inställningar: namn, beskrivning, isActive, live chat (liveChatEnabled/liveChatMode, planfunktion), showBranding (white-label-planer), chattgransknings-e-post, automatisk FAQ-generering, legacy coreInstructions-text, inlärningsfas (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt).chatbots:write
chatbot_update_instructionUppdatera en befintlig kärninstruktion (content, isActive, channel, sortOrder).chatbots:write
chatbot_update_personalityUppdatera en chatbots personlighet: persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), tonalskjutreglage 1–5, språk (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), meddelanden (welcomeMessage, fallbackMessage, proactive greeting) och begränsningar (blacklistTopics, complianceRules, maxResponseLength, human handoff).chatbots:write
widget_settings_getHämta en chatbots nuvarande widgetinställningar (alla utseende-, varumärkes-, beteende- och förformulärfält).chatbots:read
widget_settings_updateUppdatera en chatbots chattwidget: position (inkl.chatbots:write
widget_translations_getHämta per-språk widgetöversättningar för en chatbot: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }.chatbots:read
widget_translations_updateSätt per-språkiga widgetöversättningar.chatbots:write

Kunskapsbas

ToolDescriptionScope
crawler_job_cancelAvbryt ett PENDING- eller RUNNING-crawljobb; återstående sidor hoppas över.knowledge:write
crawler_job_getHämta status för ett crawljobb, framsteg (pagesCrawled/pagesFound, tokensUsed) och status för varje sida.knowledge:read
crawler_jobs_listLista en chatbots crawljobb (nyast först) med status och framsteg.knowledge:read
crawler_limitsHämta planens crawlgränser för en chatbot (max sidor per crawl, tokens per sida, crawls per månad) och om en ny crawl kan startas denna månad.knowledge:read
crawler_preview_scanSkanna en webbplats och lista dess genomsökningsbara sidor (url, titel, isRecommended) utan att importera något.knowledge:write
crawler_startStarta ett crawljobb som importerar de valda URL:erna till chatbots kunskapsbas (bearbetas i bakgrunden; poll crawler_job_get).knowledge:write
knowledge_document_add_from_urlHämta ett dokument (PDF, TXT, MD, CSV, JSON, DOCX; max 10 MB) från en offentlig http(s)-URL och lägg till det i en chatbots kunskapsbas.knowledge:write
knowledge_document_add_textLägg till ett text- eller markdown-dokument i en chatbots kunskapsbas från inline-innehåll (max 10 MB).knowledge:write
knowledge_document_deleteRadera ett uppladdat dokument från kunskapsbasen.knowledge:write
knowledge_document_getHämta detaljer om ett uppladdat dokument inklusive bearbetningsstatus, felmeddelande och en kortlivad nedladdnings-URL.knowledge:read
knowledge_documents_listLista uppladdade dokument (PDF, TXT, MD, CSV, JSON, DOCX) i en chatbots kunskapsbas med status och storlek.knowledge:read
knowledge_page_addCrawla en enskild URL och lägg till den i chatbots kunskapsbas (misslyckas med CONFLICT när URL:en redan är indexerad, FORBIDDEN när token-gränsen är nådd).knowledge:write
knowledge_page_deleteTa bort en genomsökt sida från kunskapsbasen (tar bort dess vektorlagringsfil).knowledge:write
knowledge_page_getHämta en genomsökt sida inklusive markdown-innehållet som indexerades för chatbottan (nyttigt för att verifiera vad boten vet om en sida).knowledge:read
knowledge_page_recrawlHämta en genomsökt sida igen och ersätt dess indexerade innehåll (t.ex.knowledge:write
knowledge_pages_deleteRadera flera genomsökta sidor för en chatbot på en gång.knowledge:write
knowledge_pages_listLista genomsökta sidor i en chatbots kunskapsbas, eventuellt filtrerat efter domän, status eller sökterm (URL/titel).knowledge:read
knowledge_statsÖversikt över en chatbots kunskapsbas: dokument (per status, storlek), genomsökta sidor och webbplatser (per status), crawljobb, kärninstruktioner uppdelade efter källa (manuellt vs improvement agent), FAQ, vektorstore-status/storlek och lagringsanvändning vs.knowledge:read
knowledge_website_deleteRadera alla genomsökta sidor för en webbplats (domän) från chatbots kunskapsbas.knowledge:write
knowledge_website_recrawlÅtercrawla alla sidor för en webbplats (domän) i chatbots kunskapsbas för att uppdatera dess innehåll.knowledge:write
knowledge_website_recrawl_cancelAvbryt en pågående webbplats-återcrawling: köade (PENDING) sidor för domänen återställs till deras tidigare indexerade tillstånd.knowledge:write
knowledge_websites_listLista webbplatserna (domäner) vars sidor finns i en chatbots kunskapsbas, med sidantal per status och token-totalsummor.knowledge:read

Pris-hantering

Dessa verktyg hanterar strukturerade prisutkast och uttryckliga godkännanden. Att spara ett utkast är separat från att godkänna exakt version; behörighet beror också på status och giltighet. Befintliga API-nycklar får inte prisbehörigheter automatiskt. Endast företagsägaren kan bevilja prices:write eller prices:approve. API-nyckelsanrop körs direkt, så granska exakt input innan ni anropar en mutation. Se Prices & services för kundflödet.

ToolDescriptionScope
price_listSidor genom prisrubriker och separat godkänd versions-eligibilitet.prices:read
price_getLäs komplett objekttillstånd och revisioner.prices:read
price_detailLäs objektdetalj med paginerad revisionshistorik.prices:read
price_suggestions_listSidor genom pristips.prices:read
price_createSkapa ett utkast med ett servergenererat item ID.prices:write
price_editSkapa ett nytt utkast från en uttryckligen förväntad item-version.prices:write
price_import_csvImportera utkast med ett explicit format och stabilt import-ID för säkra retry.prices:write
price_suggestion_applyApplicera det valda förslagets kandidat som ett utkast.prices:write
price_approveGodkänn en uttryckligen förväntad item-version.prices:approve
price_approve_manyGodkänn ett explicit ID/version-val atomärt; varje föråldrad version avvisar hela valet.prices:approve
price_archiveArkivera ett objekt vid dess uttryckligen förväntade version.prices:approve

Redigeringar av utkast bevarar föregående godkända revision. CSV-format och decimalavgränsare måste vara explicita; ändrat CSV-innehåll kräver ett nytt import-ID. Alla operationer är bundna till API-nyckelns företag och den angivna chatboten.

FAQ-hantering

ToolDescriptionScope
faq_cache_purgeRensa cache för FAQ-widgetdata på alla anslutna CMS-sajter (WordPress-plugin).faqs:write
faq_categories_listLista en chatbots FAQ-kategorier med deras FAQ-antal, sluggar, sortläge och översättningar.faqs:read
faq_categories_reorderAnge ordningen för FAQ-kategorier i widgeten: position i categoryIds blir sortOrder.faqs:write
faq_category_createSkapa en FAQ-kategori för en chatbot (slug genereras från namnet).faqs:write
faq_category_deleteRadera en FAQ-kategori.faqs:write
faq_category_translations_updateErsätt översättningar för en FAQ-kategori, t.ex.faqs:write
faq_category_updateByt namn på en FAQ-kategori eller ändra dess beskrivning, ikon eller sortläge.faqs:write
faq_createSkapa en FAQ för en chatbot.faqs:write
faq_deleteRadera permanent en FAQ (tar även bort den från chatbottens kunskapsbas och rensar CMS-widgetcachar).faqs:write
faq_embed_code_getHämta embed-snippets för FAQ-widgeten: skript-tag, WordPress-shortcode och Shopify Liquid-snippet, plus per-kategori-varianter (använd categorySlug från faq_categories_list för att bara bädda in en kategori).chatbots:read
faq_getHämta fullständiga detaljer om en FAQ: fråga, svar, kategori, publiceringsstatus, sortordning, översättningar, SEO-fält och feedbackstatistik.faqs:read
faq_listLista FAQs för en chatbot (använd chatbot_list för att hitta chatbotId).faqs:read
faq_reorderSätt visningsordningen för FAQs i widgeten.faqs:write
faq_suggestion_approveGodkänn ett PENDING FAQ-förslag: skapar en publicerad FAQ (valfritt med redigerad fråga/svar/kategori) och markerar förslaget som APPROVED.faqs:write
faq_suggestion_getHämta fullständiga detaljer om ett FAQ-förslag (komplett svar, AI-resonemang, föreslagen kategori, granskningsstatus).faqs:read
faq_suggestion_rejectAvvisa ett PENDING FAQ-förslag med en valfri anledning.faqs:write
faq_suggestions_generateLåt AI föreslå nya FAQs från chatbottens kunskapsbas (genomsökta sidor / uppladdade dokument), valfritt för en kategori.faqs:write
faq_suggestions_listLista AI-genererade FAQ-förslag för en chatbot (från chattkonversationer eller faq_suggestions_generate).faqs:read
faq_translateÖversätt en FAQs fråga och svar med AI till chatbottens andra stödda språk (eller angivna targetLanguages) och spara resultatet.faqs:write
faq_translations_updateSpara översättningar av en FAQ per språk, t.ex.faqs:write
faq_updateUppdatera en FAQs fråga, svar, kategori, publiceringsstatus eller manuella sortordning.faqs:write
faq_widget_settings_getHämta utseende- och beteendeinställningar för den inbäddningsbara FAQ-widgeten (färger, border radius, titel, spacing, max width, allowMultipleOpen, autoOpenFirst, sort mode, titelöversättningar).chatbots:read
faq_widget_settings_updateUppdatera FAQ-widgetinställningarna: färger (hex), borderRadius 0–32, titel (max 100) + showTitle, spacing compact|normal|relaxed, maxWidth 0–2000 (0 = full bredd), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name och title-översättningar per språk.chatbots:write

Chatt-historik & feedback

ToolDescriptionScope
chat_feedback_dismissMarkera en chatt som granskad utan att betygsätta den (tar bort den från väntkön, ändrar inte förtroendescore).chats:write
chat_feedback_getHämta en chattgranskning (feedback) med AI-analys, allvarlighetsgrad, förtroendekategori, poängändring och länkat förbättringssession.chats:read
chat_feedback_listLista chattgranskningar (feedback-rader) för en chatbot med statusfilter och räkneverk.chats:read
chat_feedback_set_severityÅsidosätt klassificeringen av allvarlighetsgrad (MINOR|MODERATE|MAJOR|CRITICAL) för en granskad negativ chatt; allvarlighet viktar förtroendepoängens minskning.chats:write
chat_feedback_statsSessionsräkningar per granskningsbucket för en chatbot (total, none, pending, positive, negative, reviewed, improved) — statistik-korten på instrumentpanelens chatt-sida.chats:read
chat_feedback_submitBetygsätt en chattsession som Good (isPositive=true) eller Needs Work (isPositive=false).chats:write
chat_session_getHämta en chattsession med full transkription (per-meddelande token/model/latency/pageUrl), besöksdetaljer, startad sid-URL, förtroendekategori, feedback (severity, AI analysis, länkat förbättringssession) och taggar.chats:read
chat_session_searchSök i chattsessioner för en chatbot efter meddelandeinnehåll och/eller besökarens e-post.chats:read
chat_session_set_categoryTilldela eller ändra förtroendekategori för en chattsession (korrigerar AI-kategoriseringen; per-kategori förtroende räknas om när chatten granskats).chats:write
chat_sessions_listLista chattsessioner för en chatbot, nyast först, med samma granskningsköfilter som instrumentpanelens chatt-sida.chats:read

Improvement Agent

ToolDescriptionScope
confidence_categories_listLista en chatbots förtroendekategorier med per-kategori förtroendepoäng, granskningsantal och e-postfrekvens för granskning.chats:read
confidence_category_createSkapa en förtroendekategori för en chatbot.chatbots:write
confidence_category_deleteRadera en förtroendekategori.chatbots:write
confidence_category_mergeSlå ihop en förtroendekategori in i en annan i samma chatbot: alla chattar/granskningar flyttas till målet, källan raderas och poäng räknas om.chatbots:write
confidence_category_updateByt namn på en förtroendekategori och/eller sätt dess review-email-frekvens (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1–24 endast för HOURLY).chatbots:write
confidence_status_getFörtroendestatus för en chatbot: poäng, examenströskel, inlärningsfas-flagga, inlärningsfasbeteende (CAUTIOUS|BALANCED|CONFIDENT) och anpassad prompt, granskningsräkningar och per-kategori förtroendepoäng.analytics:read
improvement_proposal_approveGodkänn ett PENDING förbättringsförslag och tillämpa ändringen på chatboten (kärninstruktion add/update, FAQ create/update eller persona update) — samma logik och planbegränsningar som i instrumentpanelen.chatbots:write
improvement_proposal_rejectAvvisa ett PENDING förbättringsförslag.chatbots:write
improvement_proposal_simulateSimulera hur chatboten skulle svara på det problematiska meddelandet med ett föreslaget förslag tillämpat (original vs.chatbots:write
improvement_proposals_pendingLista förbättringsförslag som väntar på granskning (status PENDING) över företaget eller för en specifik chatbot.chatbots:read
improvement_session_completeMarkera en förbättringssession som COMPLETED (chatten räknas då som Improved i granskningskön).chatbots:write
improvement_session_createÖppna Improvement Agent för en chatt som bedömts Needs Work.chatbots:write
improvement_session_getHämta en förbättringssession med originalchatten (meddelanden har ett 1-baserat index användbart som targetMessageIndex), agentkonversationen, alla förslag (med deras senaste simulering) och simuleringar.chatbots:read
improvement_session_resetStarta om en förbättringssession: raderar alla agentmeddelanden, simuleringar och PENDING/REJECTED-förslag (tillämpade förblir) och startar en ny konversation.chatbots:write
improvement_session_send_messageSkicka ett meddelande till Improvement Agent (beskriv vad som var fel med botens svar; valfritt targetMessageIndex = det 1-baserade indexet för botmeddelandet i originalChat.messages).chatbots:write
improvement_sessions_listLista förbättringssessioner (Improvement Agent-konversationer startade från negativa chattgranskningar) för en chatbot eller hela företaget, nyast först, med förslagsantal.chatbots:read
improvement_simulation_assessBetygsätt ett simuleringsresultat: isApproved=true när det simulerade svaret är bra (förslaget kan då tillämpas), false när det behöver mer arbete (kommentar 'almost' = nästan rätt).chatbots:write

Live Chat

ToolDescriptionScope
live_chat_agents_availableHämta den aktuella användarens egna livechat-tillgänglighet, de agenter som för närvarande är tillgängliga för live chat (färskt heartbeat, samma signal som widgeten använder) och om företagets plan inkluderar live chat.chats:read
live_chat_heartbeatUppdatera den aktuella användarens livechat-presence heartbeat (endast medan markerad som tillgänglig via live_chat_set_availability).chats:write
live_chat_message_sendSkicka ett meddelande till besökaren som den tilldelade agenten.chats:write
live_chat_queueHämta livechat-kön: sessioner som väntar på agent, äldst först (FIFO).chats:read
live_chat_session_assignTa en WAITING livechat-session från kön: tilldelar den till aktuell användare (företagsägare för API-nycklar) och meddelar besökaren att agenten anslutit.chats:write
live_chat_session_closeAvsluta en livechat-session som agent (any non-VIEWER medlem i företaget).chats:write
live_chat_session_getHämta en livechat-session med besökarinfo, tilldelad agent, alla meddelanden och föregående botkonversation (handoff-context).chats:read
live_chat_sessions_listLista livechat-sessioner (nyast först; WAITING-sessioner äldst först) med valfria filter per chatbot, status och tilldelad agent.chats:read
live_chat_set_availabilityVäxla den aktuella användarens 'Available for Live Chat'-omkopplare för ett företag.chats:write

Leads

ToolDescriptionScope
lead_assignTilldela ett lead till en företagsmedlem eller avskriv det (assignedToId: null).leads:write
lead_bulk_update_statusSätt status för flera leads (max 100) samtidigt.leads:write
lead_categories_listLista leadkategorier för en chatbot med leadantal och teammedlemmar som notifieras per kategori.leads:read
lead_category_assign_userLägg till en företagsmedlem i en leadkategoris notifieringslista (eller uppdatera deras notifieringsflaggor).leads:write
lead_category_createSkapa en leadkategori för en chatbot.leads:write
lead_category_deleteRadera en leadkategori.leads:write
lead_category_remove_userTa bort en företagsmedlem från en leadkategoris notifieringslista.leads:write
lead_category_updateUppdatera en leadkategoris namn, beskrivning och/eller färg.leads:write
lead_createSkapa ett lead manuellt (t.ex.leads:write
lead_deleteRadera ett lead permanent.leads:write
lead_field_config_getHämta lead capture-konfigurationen för en chatbot: fält (ids mappar till nycklar i lead.data), bekräftelsemeddelande, fält-/UI-översättningar och AI-igenkänningsinställningar.leads:read
lead_field_config_updateUppdatera lead capture-konfigurationen för en chatbot.leads:write
lead_getHämta fullständiga detaljer för ett lead inklusive ansvarig, kategori och källans chatttranskript (paginerat med messageOffset/messageLimit, standard första 20 meddelanden).leads:read
lead_listLista leads för en chatbot (nyast först) med valfria filter per status, kategori, ansvarig och fritextsök (namn/e-post/företag).leads:read
lead_statsHämta leadstatistik för en chatbot: räkningar per status, leads de senaste 7 dagarna och konverteringsgrad (procent).leads:read
lead_updateUppdatera ett leads status, kategori, anteckningar, fångade data och/eller ansvarig.leads:write

Formulär

ToolDescriptionScope
form_createSkapa ett kontaktformulär för en chatbot (grundläggande, fält, design och spam-inställningar i ett anrop).forms:write
form_deleteRadera permanent ett kontaktformulär och ALLA dess inskick (kaskad).forms:write
form_getHämta ett kontaktformulär i sin helhet: fält, översättningar, styling, spam-inställningar, aktivt tillstånd, inskicksräknare och embed-skriptet (embedCode).forms:read
form_listLista kontaktformulär för en chatbot med fältantal, inskicksräkningar och embed-koder.forms:read
form_statsInskicksräkningar för ett kontaktformulär: totalt, pending, approved, spam och rejected.forms:read
form_submission_deleteRadera permanent ett inskick av ett kontaktformulär (t.ex.forms:write
form_submission_getHämta ett kontaktformulärinskick i sin helhet: inlämnad fältdatat, spam-score och AI-spamanalys, IP/user agent/referrer-metadata och granskningsinformation.forms:read
form_submission_update_statusGranska ett kontaktformulärinskick: sätt dess status till APPROVED, SPAM eller REJECTED med en valfri granskningsanteckning.forms:write
form_submissions_listLista inskick för ett kontaktformulär, nyast först, eventuellt filtrerat efter status (PENDING, APPROVED, SPAM, REJECTED) och skapelsedatum.forms:read
form_updateUppdatera ett kontaktformulär: namn, beskrivning, aktivt tillstånd (isActive styr om embed renderas), fält (full ersättning), design (färger, knapptext, framgångsmeddelande) och spam-inställningar (spamThreshold, autoRejectSpam, notificationEmail).forms:write
form_update_translationsErsätt fält- och/eller UI-översättningar för ett kontaktformulär.forms:write

E-postassistent

ToolDescriptionScope
email_activity_listLista aktivitetsloggen för bearbetade e-postmeddelanden för en brevlådeanslutning (nyast först): avsändare, ämne, tilldelad kategori, utfall (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) och outcomeDetail.email:read
email_categories_listLista e-postkategorier för en brevlådeanslutning (sorterade efter sortOrder).email:read
email_category_createSkapa en e-postkategori för en brevlådeanslutning (max 20 per anslutning).email:write
email_category_deleteRadera en e-postkategori.email:write
email_category_updateUppdatera en e-postkategori (partiell: endast angivna fält ändras).email:write
email_connection_disconnectKoppla bort en brevlåda permanent.email:write
email_connection_getHämta en brevlådeanslutning inkl.email:read
email_connection_updateUppdatera en brevlådeanslutning: pausa/återuppta synkroniseringen (paused true/false; växlar endast ACTIVE<->DISABLED, skriver aldrig över TOKEN_EXPIRED/ERROR), växla svarsdraftrutiner (draftingEnabled) och kategorisering/organisering (organizingEnabled), peka om drivande chatbot (chatbotId i samma företag) eller sätta HTML-svars-signatur (signatureHtml, max 20000 tecken; tom sträng rensar den).email:write
email_connections_listLista företagets Email Assistant-brevlådeanslutningar (adress, status ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, sista synk, sista fel, drafting/organizing-växlar, drivande chatbot, draftReadyCategoryCount = kategorier som kan ge utkast, baseRuleCount = chatbot-omfattande 'Chat + Email'-regler som tillämpas på varje utkast) tillsammans med planbegränsningar (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth).email:read
email_contact_deleteRadera en inlärd e-postkontakt (glöm avsändarprofilen, t.ex.email:write
email_contact_getHämta en inlärd e-postkontakt med alla inlärda fakta, interna anteckningar, relation, formal/informal address-inställning och e-poststatistik.email:read
email_contact_updateUppdatera en inlärd e-postkontakt.email:write
email_contacts_listLista företagets inlärda e-postkontakter (senaste e-post först) med relation, formal/informal address (formalAddress: true = formell 'Sie', false = informell 'Du', null = automatisk), faktantal och en anteckningsförhandsvisning.email:read
email_folder_createSkapa en mailmapp under inkorgen (returnerar den befintliga om namnet är taget) att använda som mål för kategoriförflyttning.email:write
email_folders_listLista mappar som en e-postkategori kan flytta mejl till, live från brevlådan: inkorgens undermappar, anpassade top-level-mappar, arkiv, skräppost och papperskorgen (id 'deleteditems').email:read
email_general_rules_listLista chatbot-omfattande regler som gäller för varje svarsdraft i en brevlåda: aktiva kärninstruktioner med channel BOTH ("Chat + Email"), plus legacy e-post-enda regler som ännu inte migrerats in i en kategori.email:read

Analys

ToolDescriptionScope
analytics_chat_volumeChattvolym (sessioner startade) över tid för diagram och trender: period week/month/quarter/year, granularitet hour/day/week/month, valfritt för en chatbot.analytics:read
analytics_chatbot_statsPer-chatbot prestanda för ett företag i ett anrop (instrumentpanelens chatbotperformance-tabell): id, namn, slug, isActive, sessions, messages, FAQs och leads per chatbot, sorterat efter sessions.analytics:read
analytics_formsKontaktformulärsinskick-statistik för ett företag eller en chatbot (instrumentpannels widget): inskick per status (pending/approved/rejected/spam), antal formulär, totalt, spam-rate i procent och inskick-per-dag-serien för de senaste 7 dagarna.analytics:read
analytics_leadsLead-funnel för ett företag eller en chatbot (instrumentpanelens widget): leads per status (new/contacted/qualified/converted/lost), totalt, konverteringsgrad i procent och leads-per-dag-serien för de senaste 7 dagarna.analytics:read
analytics_overviewAnalysöversikt för ett företag eller en chatbot: chattar, meddelanden, tillfredsställelsegrad och toppfrågor för en rullande period (day/week/month/year), plus instrumentpanelens översiktswidget (totala chatbots/publicerade FAQs/leads, sessioner idag/denna vecka/denna månad, leads idag/denna vecka, formulärinskick totalt/idag/pending).analytics:read
dashboard_activityVad som för närvarande behöver uppmärksamhet (instrumentpanelens startsida): per företag, de chatbots som har nya leads idag, väntande FAQ-förslag, väntande formulärinskick, väntande/aktiva livechattar eller en pågående inlärningsfas.any

Exempelarbetsflöden

Lägga till en kärninstruktion

Be er AI-assistent:

"Lägg till en kärninstruktion i min 'Support Bot' chatbot: vi erbjuder fri frakt på beställningar över €50"

Assistenten kommer att använda chatbot_add_instruction med lämpliga parametrar.

Granska förbättringsförslag

"Visa alla väntande förbättringsförslag för min chatbot och förklara vilka ändringar de föreslår"

Assistenten kommer att:

  1. Använda improvement_proposals_pending för att hämta förslag
  2. Analysera och sammanfatta varje förslag
  3. Godkänna eller avvisa dem å era vägnar med improvement_proposal_approve eller improvement_proposal_reject

Analysera chattprestanda

"Ge mig en veckorapport över chattvolym och kundtillfredsställelse för min chatbot"

Assistenten kommer att använda analytics_overview och analytics_chat_volume för att sammanställa en omfattande rapport.

Importera en webbplats

"Skanna https://example.com, importera produktsidorna och pris-sidor till min 'Support Bot' och meddela mig när crawl är klar"

Assistenten kommer att anropa crawler_preview_scan, välja relevanta sidor, starta importen med crawler_start och poll:a crawler_job_get tills jobbet är klart.

Granska leads och formulärinskick

"Visa mig nya leads från den här veckan, tilldela de kvalificerade till Anna och godkänn de väntande kontaktformulärsinskicken"

Assistenten kombinerar lead_list, lead_assign, form_submissions_list och form_submission_update_status.

Ta över en livechatt

"Sätt mig som tillgänglig för live chat och ta det äldsta väntande samtalet"

Assistenten använder live_chat_set_availability, live_chat_queue och live_chat_session_assign; svar går via live_chat_message_send.

Säkerhet

  • API-nycklar är scope:ade till ert företag och till de behörigheter ni väljer när ni skapar dem (se kolumnen Scope ovan)
  • Nycklar körs med företagsägarens behörigheter; planbegränsningar och funktionsgrindar gäller exakt som i instrumentpanelen
  • Nycklar kan återkallas när som helst från instrumentpanelen
  • API-åtkomst finns på betalda planer — se vår Pricing page

Felsökning

Anslutningen misslyckades

  1. Verifiera att er API-nyckel är korrekt
  2. Kontrollera att nyckeln inte har återkallats
  3. Säkerställ att er plan inkluderar API-åtkomst
  4. Starta om er MCP-klient

Verktyg hittades inte

Starta om er MCP-klient efter att ha ändrat konfigurationen så att den laddar om tillgängliga verktyg. Verktygsnamn är gemener med understreck (t.ex. faq_list).


Behöver ni hjälp? Kontakta vårt supportteam →