PočetnaDokumentacija

MCP Server Integration

ChatReact implementira Model Context Protocol (MCP), što vam omogućuje povezivanje vašeg ChatReact računa s AI asistentima poput Claude Desktop, Cursor i drugim alatima kompatibilnim s MCP-om.

Što je MCP?

Model Context Protocol je otvoreni standard koji omogućuje AI asistentima interakciju s vanjskim uslugama i izvorima podataka. Uz ChatReact-ovu MCP integraciju, možete:

  • Upravljati chatbotovima — kreirati, konfigurirati (persona, jezici, widget, ponašanje, ograničenja), ugraditi i brisati chatbotove
  • Graditi bazu znanja — dodavati dokumente, pretraživati web-stranice, upravljati indeksiranim stranicama i osnovnim uputama
  • Upravljati FAQ-ovima — FAQ-ovi, kategorije, prijedlozi, prijevodi i FAQ widget
  • Pregledavati razgovore — ocijeniti konverzacije, dodijeliti kategorije povjerenja, pokrenuti Improvement Agent
  • Raditi s leadovima i obrascima — leadovi, kategorije leadova, postavke hvatanja, kontakt obrasci i prijave
  • Djelovati kao agent za live chat — postaviti dostupnost, preuzeti čekajuće razgovore, odgovarati i zatvarati sesije
  • Administrirati vašu tvrtku — profil, boje brenda, članovi tima i pozivnice
  • Koristiti Email Assistant — povezivanja poštanskih sandučića, kategorije, kontakti i aktivnost
  • Čitati analitiku i obavijesti

Sve što možete učiniti na nadzornoj ploči dostupno je putem MCP-a (i REST API); samo radnje vezane uz preglednik poput plaćanja, mailbox OAuth, passkey-ja, brisanja računa i upravljanja API ključevima ostaju na nadzornoj ploči.

Početak rada

1. Generirajte API ključ

  1. Idite na vaš Nadzorna ploča → Tvrtka → API karticu
  2. Kliknite Stvori API ključ
  3. Dajte ključu opisni naziv (npr. "Claude Desktop") i odaberite barem jednu dozvolu
  4. Kopirajte generirani ključ (počinje s cr_)

API ključevi dostupni su na plaćenim planovima — pogledajte našu Pricing page.

Čuvajte svoj API ključ sigurno. Ne može se dohvatiti nakon stvaranja.

2. Konfigurirajte svog MCP klijenta

ChatReact MCP poslužitelj je hostan na https://www.chatreact.ai/api/mcp i komunicira preko HTTP-a (JSON-RPC). Autentificirajte se zaglavljem Authorization: Bearer — prihvaća se i X-API-Key zaglavlje sa istim ključem.

Cursor IDE

Cursor podržava udaljene MCP poslužitelje izravno. Dodajte u vaše Cursor MCP postavke:

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

Claude Desktop

Konfiguracijska datoteka Claude Desktop-a podržava serverske konfiguracije temeljene na naredbama, zato upotrijebite standardni mcp-remote bridge za povezivanje s hostanim endpointom:

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

Ova postavka zahtijeva instaliran Node.js. Primjer koristi zaglavlje X-API-Key jer neki klijenti ne rukuju pouzdano razmacima u argumentima.

3. Ponovno pokrenite svog AI asistenta

Nakon spremanja konfiguracije, ponovno pokrenite Claude Desktop ili Cursor kako biste uspostavili vezu.

Dostupni alati

ChatReact MCP izlaže dolje navedene alate, grupirane po područjima. Stupac Scope pokazuje dopuštenje API ključa koje alat zahtijeva (any = svaki valjani ključ). Alati se izvršavaju s istim primjenjivim dopuštenjima, ograničenjima plana i nuspojavama kao i operacije podržane na nadzornoj ploči. Radni tokovi vezani uz preglednik za plaćanje, autorizaciju mailbox-a, passkey, brisanje računa i upravljanje ključevima ostaju na nadzornoj ploči.

Destruktivni alati (brisanje, resetiranje, zatvaranje, spajanje) traže potvrdu kada se koriste kroz Dashboard Assistant. Putem API ključa izvršavaju se odmah.

Account

ToolDescriptionScope
account_usage_getDohvati trenutni plan (tier, status), brojnike korištenja za tekuće obračunsko razdoblje (companies, chatbots, team members, chats, tokens) i limite plana, plus efektivne limite i značajke tvrtke na koju se poziv odnosi.any
user_companiesIspiši sve tvrtke kojima trenutni korisnik ima pristup, s korisnikovom ulogom u svakoj od njih.any
user_notification_mark_readOznači jednu od trenutnim korisnikovih obavijesti kao pročitanu.any
user_notification_preferences_getDohvati preferencije obavijesti trenutnog korisnika: globalni email/push prekidači, učestalost/dan/vrijeme digest-a, quiet hours i postavke kanala po tipu.any
user_notification_preferences_updateAžuriraj globalne preferencije obavijesti trenutnog korisnika (email/push prekidači, raspored digest-a, quiet hours).any
user_notification_type_setting_updateOmogući ili onemogući dostavu emailom / u aplikaciji za jedan tip obavijesti trenutnog korisnika (npr.any
user_notification_types_listNabroji sve tipove obavijesti grupirane po kategoriji (chatbot, leads, live chat, knowledge, team, billing).any
user_notification_unread_countDohvati broj nepročitanih obavijesti trenutnog korisnika.any
user_notificationsIspiši obavijesti trenutnog korisnika, najnovije prvo, s cursor paginacijom.any
user_notifications_delete_oldOdržavanje: trajno obriši obavijesti trenutnog korisnika koje su već pročitane i starije od 30 dana.any
user_notifications_mark_all_readOznači sve obavijesti trenutnog korisnika kao pročitane.any
user_profileDohvati profil trenutnog korisnika (id, name, email, role, subscription tier).any

Company & Team

ToolDescriptionScope
company_chatbots_listIspiši sve chatbotove za određenu tvrtku sa sažetim statistikama.chatbots:read
company_getDohvati detaljne informacije o tvrtki: profil, owner, postavke brenda (boje, notification email) i brojeve.any
company_invite_cancelOtkazati (izbrisati) pozivnicu za tim kako veza više ne bi radila.company:write
company_invite_resendPonovno pošalji čekajuću pozivnicu za tim: izdaje novi token, produljuje isteka za 7 dana i ponovno šalje email s pozivnicom.company:write
company_invites_listIspiši pozivnice za tim tvrtke (po defaultu PENDING; postavi includeExpired da vrati i isteknute).company:read
company_listIspiši sve tvrtke kojima korisnik ima pristup (API ključevi i Dashboard Assistant vide samo svoju tvrtku).any
company_logo_removeUkloni logo tvrtke (briše pohranjenu sliku i briše URL logotipa).company:write
company_member_invitePozovi člana tima putem emaila s ulogom (ADMIN, MANAGER, AGENT ili VIEWER).company:write
company_member_removeUkloni člana tima iz tvrtke.company:write
company_member_update_rolePromijeni ulogu člana tima (ADMIN, MANAGER, AGENT ili VIEWER).company:write
company_members_listIspiši članove tvrtke s njihovim ulogama (OWNER, ADMIN, MANAGER, AGENT, VIEWER).any
company_settings_updateAžuriraj postavke brenda tvrtke: primaryColor / secondaryColor (#RRGGBB) i notificationEmail za pregled razgovora.company:write
company_updateAžuriraj profil tvrtke: name (2-100 znakova), description (maks. 1000 znakova) ili website (https:// se dodaje automatski; proslijedite prazan string za brisanje website/description).company:write

Chatbot Management

ToolDescriptionScope
chatbot_add_instructionDodaj novu core instruction chatbotu (1-5000 znakova).chatbots:write
chatbot_confirm_embedOznači chatbot kao ugrađen na web-stranici (skriva podsjetnik za postavljanje na nadzornoj ploči).chatbots:write
chatbot_createKreiraj novog chatbota (isto kao čarobnjak na nadzornoj ploči).chatbots:write
chatbot_deleteTrajno izbriši chatbota sa svim njegovim FAQ-ovima, dokumentima, razgovorima, leadovima i obrascima (ne može se poništiti).chatbots:write
chatbot_delete_instructionObriši core instruction iz chatbota.chatbots:write
chatbot_getDohvati detaljne informacije o chatbotu: opće postavke, osobnost (persona, tonality, jezici, ograničenja), postavke widgeta, live chat, learning phase, status ugradnje i brojeve.chatbots:read
chatbot_get_embed_codeDohvati HTML snippet za instalaciju chatbota na web-stranicu (script URL + <script> tag) i informaciju je li embed potvrđen.chatbots:read
chatbot_get_instructionsDohvati sve core instructions za chatbota.chatbots:read
chatbot_improve_instructionsPrepiši tekst core-instruction koristeći AI poboljšivač platforme (isto kao 'Improve with AI' na nadzornoj ploči).chatbots:write
chatbot_learning_phase_getDohvati postavke learning-phase chatbota: behaviour preset (CAUTIOUS, BALANCED, CONFIDENT), custom prompt i je li bot još uvijek u learning phaseu.chatbots:read
chatbot_learning_phase_updatePostavi learning-phase behaviour preset (CAUTIOUS = preusmjeri na čovjeka kada nije siguran, BALANCED, CONFIDENT) i/ili custom learning-phase prompt.chatbots:write
chatbot_listIspiši sve chatbote kojima korisnik ima pristup, sa sažetim statistikama.chatbots:read
chatbot_reorder_instructionsPostavi redoslijed core instructions chatbota.chatbots:write
chatbot_templates_listIspiši template chatbota (preseti za persona, tonality, poruke i ponašanje widgeta) koje se mogu proslijediti kao templateId u chatbot_create, i informaciju može li ih plan tvrtke koristiti.chatbots:read
chatbot_toggle_activeAktiviraj ili deaktiviraj chatbota.chatbots:write
chatbot_toggle_learningZavrši (false) ili ponovno omogući (true) learning phase chatbota.chatbots:write
chatbot_updateAžuriraj opće postavke chatbota: name, description, isActive, live chat (liveChatEnabled/liveChatMode, značajka plana), showBranding (white-label planovi), chat-review emails, FAQ auto-generation, legacy coreInstructions tekst, learning phase (isInLearningPhase, learningPhaseBehavior, learningPhaseCustomPrompt).chatbots:write
chatbot_update_instructionAžuriraj postojeću core instruction (content, isActive, channel, sortOrder).chatbots:write
chatbot_update_personalityAžuriraj osobnost chatbota: persona (usePersonaName, personaName, personaRole, personaBackground, communicationStyle), tonality klizači 1-5, jezici (primaryLanguage, supportedLanguages, technicalLevel, timezone, formalAddress, speakAsCompany), poruke (welcomeMessage, fallbackMessage, proactive greeting) i ograničenja (blacklistTopics, complianceRules, maxResponseLength, human handoff).chatbots:write
widget_settings_getDohvati trenutne postavke widgeta za chatbota (svi izgled, branding, ponašanje i polja pre-chat formulara).chatbots:read
widget_settings_updateAžuriraj chat widget chatbota: position (uključujućichatbots:write
widget_translations_getDohvati prijevode widgeta po jeziku za chatbota: { '<lang>': { welcomeMessage, fallbackMessage, headerTitle, headerSubtitle, bubbleText } }.chatbots:read
widget_translations_updatePostavi prijevode widgeta po jeziku.chatbots:write

Knowledge Base

ToolDescriptionScope
crawler_job_cancelOtkaži PENDING ili RUNNING crawl job; preostale stranice se preskaču.knowledge:write
crawler_job_getDohvati status crawl joba, napredak (pagesCrawled/pagesFound, tokensUsed) i status svake stranice.knowledge:read
crawler_jobs_listIspiši crawl jobove chatbota (najnoviji prvi) sa statusom i napretkom.knowledge:read
crawler_limitsDohvati limite crawlanja za plan chatbota (max pages per crawl, tokens per page, crawls per month) i može li se započeti novi crawl ovaj mjesec.knowledge:read
crawler_preview_scanSkeniraj web-stranicu i nabroj indeksabilne stranice (url, title, isRecommended) bez uvoza ičega.knowledge:write
crawler_startPokreni crawl job koji uvozi odabrane URL-ove u bazu znanja chatbota (obrađuje se u pozadini; poll crawler_job_get).knowledge:write
knowledge_document_add_from_urlPreuzmi dokument (PDF, TXT, MD, CSV, JSON, DOCX; max 10 MB) s javnog http(s) URL-a i dodaj ga u bazu znanja chatbota.knowledge:write
knowledge_document_add_textDodaj tekstualni ili markdown dokument u bazu znanja chatbota iz inline sadržaja (max 10 MB).knowledge:write
knowledge_document_deleteObriši učitani dokument iz baze znanja.knowledge:write
knowledge_document_getDohvati detalje učitanog dokumenta uključujući status obrade, poruku o pogrešci i kratkotrajni URL za preuzimanje.knowledge:read
knowledge_documents_listIspiši učitane dokumente (PDF, TXT, MD, CSV, JSON, DOCX) u bazi znanja chatbota sa statusom i veličinom.knowledge:read
knowledge_page_addCrawljaj jedan URL i dodaj ga u bazu znanja chatbota (baca CONFLICT ako je URL već indeksiran, FORBIDDEN kada je dosegnut limit tokena).knowledge:write
knowledge_page_deleteObriši indeksiranu stranicu iz baze znanja (uklanja datoteku vektorskog spremišta).knowledge:write
knowledge_page_getDohvati indeksiranu stranicu uključujući markdown sadržaj koji je indeksiran za chatbota (korisno za provjeru što bot zna o stranici).knowledge:read
knowledge_page_recrawlPonovno dohvatiti indeksiranu stranicu i zamijeniti njen indeksirani sadržaj (npr.knowledge:write
knowledge_pages_deleteObriši više indeksiranih stranica chatbota odjednom.knowledge:write
knowledge_pages_listIspiši indeksirane stranice u bazi znanja chatbota, opcionalno filtrirane po domenu, statusu ili pretraživanom termu (URL/title).knowledge:read
knowledge_statsPregled baze znanja chatbota: dokumenti (po statusu, veličini), indeksirane stranice i web-stranice (po statusu), crawl jobovi, core instructions razdvojeni po izvoru (manual vs improvement agent), FAQ-ovi, status/veličina vektorskog spremišta i korištenje pohrane vs.knowledge:read
knowledge_website_deleteObriši sve indeksirane stranice web-stranice (domene) iz baze znanja chatbota.knowledge:write
knowledge_website_recrawlPonovno crawljaj svaku stranicu web-stranice (domene) u bazi znanja chatbota kako biste osvježili sadržaj.knowledge:write
knowledge_website_recrawl_cancelOtkaži u tijeku re-crawl web-stranice: redom (PENDING) stavljene stranice domene vraćaju se na prethodno indeksirano stanje.knowledge:write
knowledge_websites_listIspiši web-stranice (domene) čije su stranice u bazi znanja chatbota, s brojevima stranica po statusu i zbrojem tokena.knowledge:read

Price Management

Ovi alati upravljaju strukturiranim nacrtima cijena i eksplicitnim odobrenjima. Spremanje nacrta je odvojeno od odobravanja točne verzije; prihvatljivost također ovisi o statusu i valjanosti. Postojeći API ključevi ne dobivaju automatski dozvole za cijene. Samo vlasnik tvrtke može dodijeliti prices:write ili prices:approve. Pozivi s API ključem izvršavaju se odmah, stoga provjerite točan unos prije poziva mutacije. Pogledajte Prices & services za korisnički radni tok.

ToolDescriptionScope
price_listPaginirajte kroz price heads i odvojeno provjerite prihvatljivost odobrene verzije.prices:read
price_getPročitaj kompletno stanje stavke i revizije.prices:read
price_detailPročitaj detalje stavke s paginiranom poviješću revizija.prices:read
price_suggestions_listPaginirajte kroz sugestije za cijene.prices:read
price_createKreiraj nacrt s ID-jem stavke generiranim na poslužitelju.prices:write
price_editKreiraj novi nacrt iz eksplicitno očekivane verzije stavke.prices:write
price_import_csvUvezi nacrte s eksplicitnim formatom i stabilnim import ID-jem za sigurne ponovne pokušaje.prices:write
price_suggestion_applyPrimijeni odabrani kandidat sugestije kao nacrt.prices:write
price_approveOdobri jednu eksplicitno očekivanu verziju stavke.prices:approve
price_approve_manyAtomски odobri odabir eksplicitnog ID-ja/verzije; svaka zastarjela verzija odbija cijeli odabir.prices:approve
price_archiveArhiviraj stavku na njezinoj eksplicitno očekivanoj verziji.prices:approve

Uređivanja nacrta čuvaju prethodnu odobrenu reviziju. CSV format i decimalni separator moraju biti eksplicitni; promjena CSV sadržaja zahtijeva novi import ID. Sve operacije su vezane uz tvrtku API ključa i specificirani chatbot.

FAQ Management

ToolDescriptionScope
faq_cache_purgeOčisti keširane podatke FAQ widgeta na svim povezanima CMS stranicama (WordPress plugin).faqs:write
faq_categories_listIspiši FAQ kategorije chatbota s brojem FAQ-ova, slugovima, načinom sortiranja i prijevodima.faqs:read
faq_categories_reorderPostavi redoslijed FAQ kategorija u widgetu: pozicija u categoryIds postaje sortOrder.faqs:write
faq_category_createKreiraj FAQ kategoriju za chatbota (slug se generira iz imena).faqs:write
faq_category_deleteObriši FAQ kategoriju.faqs:write
faq_category_translations_updateZamijeni prijevode FAQ kategorije, npr.faqs:write
faq_category_updatePreimenuj FAQ kategoriju ili promijeni njen opis, ikonu ili način sortiranja.faqs:write
faq_createKreiraj FAQ za chatbota.faqs:write
faq_deleteTrajno izbriši FAQ (također ga uklanja iz baze znanja chatbota i čisti CMS cache widgeta).faqs:write
faq_embed_code_getDohvati embed snippete za FAQ widget: script tag, WordPress shortcode i Shopify Liquid snippet, plus varijante po kategoriji (koristite categorySlug iz faq_categories_list za ugradnju samo jedne kategorije).chatbots:read
faq_getDohvati pune detalje FAQ-a: pitanje, odgovor, kategorija, publish state, sort order, prijevodi, SEO polja i statistiku povratnih informacija.faqs:read
faq_listIspiši FAQ-ove chatbota (koristite chatbot_list da pronađete chatbotId).faqs:read
faq_reorderPostavi redoslijed prikaza FAQ-ova u widgetu.faqs:write
faq_suggestion_approveOdobri PENDING FAQ sugestiju: kreira objavljen FAQ (opcionalno s izmijenjenim pitanjem/odgovorom/kategorijom) i označava sugestiju kao APPROVED.faqs:write
faq_suggestion_getDohvati pune detalje FAQ sugestije (kompletan odgovor, AI objašnjenje, sugerirana kategorija, stanje pregleda).faqs:read
faq_suggestion_rejectOdbaci PENDING FAQ sugestiju s opcionalnim razlogom.faqs:write
faq_suggestions_generateNeka AI predloži nove FAQ-ove iz baze znanja chatbota (indeksirane stranice / učitani dokumenti), opcionalno za jednu kategoriju.faqs:write
faq_suggestions_listIspiši AI-generirane FAQ sugestije chatbota (iz razgovora ili faq_suggestions_generate).faqs:read
faq_translatePrevedi pitanje i odgovor FAQ-a pomoću AI u ostale podržane jezike chatbota (ili u zadane targetLanguages) i spremi rezultat.faqs:write
faq_translations_updateSpremi prijevode FAQ-a po jeziku, npr.faqs:write
faq_updateAžuriraj pitanje, odgovor, kategoriju, publish state ili ručni sort order FAQ-a.faqs:write
faq_widget_settings_getDohvati postavke izgleda i ponašanja ugrađivog FAQ widgeta (boje, border radius, naslov, razmaci, max width, allowMultipleOpen, autoOpenFirst, način sortiranja, prijevodi naslova).chatbots:read
faq_widget_settings_updateAžuriraj postavke FAQ widgeta: boje (hex), borderRadius 0-32, title (maks 100) + showTitle, spacing compact|normal|relaxed, maxWidth 0-2000 (0 = puna širina), allowMultipleOpen, autoOpenFirst, sortMode custom|date|name i prijevode naslova po jeziku.chatbots:write

Chat History & Feedback

ToolDescriptionScope
chat_feedback_dismissOznači razgovor kao pregledan bez ocjene (uklanja ga iz redova na čekanju, ne mijenja confidence score).chats:write
chat_feedback_getDohvati jedan pregled razgovora (feedback) s AI analizom, težinom, kategorijom povjerenja, promjenom rezultata i povezanim improvement sessionom.chats:read
chat_feedback_listIspiši preglede razgovora (redovi povratnih informacija) chatbota s filterom statusa i brojevima.chats:read
chat_feedback_set_severityPrepiši klasifikaciju težine (MINOR|MODERATE|MAJOR|CRITICAL) pregledanog negativnog razgovora; težina utječe na pad confidence scorea.chats:write
chat_feedback_statsBrojevi sesija po review bucketu za chatbota (total, none, pending, positive, negative, reviewed, improved) — kartice statistike na stranici razgovora nadzorne ploče.chats:read
chat_feedback_submitOcijeni chat sesiju kao Good (isPositive=true) ili Needs Work (isPositive=false).chats:write
chat_session_getDohvati chat sesiju s kompletnim transkriptom (po-poruka token/model/latency/pageUrl), podacima o posjetitelju, URL-om početne stranice, kategorijom povjerenja, feedbackom (severity, AI analiza, povezani improvement session) i tagovima.chats:read
chat_session_searchPretraži chat sesije chatbota po sadržaju poruke i/ili emailu posjetitelja.chats:read
chat_session_set_categoryDodijeli ili promijeni kategoriju povjerenja chat sesije (ispravlja AI kategorizaciju; per-kategorijska povjerenja se ponovno izračunavaju kada je razgovor pregledan).chats:write
chat_sessions_listIspiši chat sesije chatbota, najnovije prvo, s istim filterima reda pregleda kao na stranici razgovora nadzorne ploče.chats:read

Improvement Agent

ToolDescriptionScope
confidence_categories_listIspiši kategorije povjerenja chatbota s per-kategorijskim confidence scoreom, brojem pregleda i učestalošću emailova za pregled.chats:read
confidence_category_createKreiraj kategoriju povjerenja za chatbota.chatbots:write
confidence_category_deleteObriši kategoriju povjerenja.chatbots:write
confidence_category_mergeSpoji jednu kategoriju povjerenja u drugu isteg chatbota: svi razgovori/pregledi prelaze u ciljnu, izvorna se briše i rezultati se ponovno izračunavaju.chatbots:write
confidence_category_updatePreimenuj kategoriju povjerenja i/ili postavi učestalost emailova za pregled (EVERY|HOURLY|DAILY|WEEKLY|NEVER; emailFrequencyHours 1-24 samo za HOURLY).chatbots:write
confidence_status_getStatus povjerenja chatbota: score, graduation threshold, learning phase flag, learning-phase behaviour (CAUTIOUS|BALANCED|CONFIDENT) i custom prompt, brojevi pregleda i per-kategorijski confidence scoreovi.analytics:read
improvement_proposal_approveOdobri PENDING improvement prijedlog i primijeni promjenu na chatbota (dodavanje/azuriranje core instruction, kreiranje/azuriranje FAQ-a ili ažuriranje persone) — ista logika i limitiranja plana kao na nadzornoj ploči.chatbots:write
improvement_proposal_rejectOdbaci PENDING improvement prijedlog.chatbots:write
improvement_proposal_simulateSimuliraj kako bi chatbot odgovorio na problematičnu poruku s primijenjenim prijedlogom (original vs.chatbots:write
improvement_proposals_pendingIspiši prijedloge za poboljšanje koji očekuju pregled (status PENDING) za tvrtku ili za jednog chatbota.chatbots:read
improvement_session_completeOznači improvement session kao COMPLETED (razgovor se tada broji kao Improved u redu pregleda).chatbots:write
improvement_session_createOtvori Improvement Agent za razgovor ocijenjen kao Needs Work.chatbots:write
improvement_session_getDohvati improvement session s originalnim razgovorom (poruke imaju 1-bazirani indeks koji se može koristiti kao targetMessageIndex), agentovim razgovorom, svim prijedlozima (s njihovom najnovijom simulacijom) i simulacijama.chatbots:read
improvement_session_resetPonovno pokreni improvement session: briše sve agentove poruke, simulacije i PENDING/REJECTED prijedloge (primijenjeni se čuvaju) i započinje svježi razgovor.chatbots:write
improvement_session_send_messagePošalji poruku Improvement Agentu (opisi što je bilo loše u botovom odgovoru; opcionalno targetMessageIndex = 1-bazirani indeks botove poruke u originalChat.messages).chatbots:write
improvement_sessions_listIspiši improvement sessione (Improvement Agent razgovori pokrenuti iz negativnih pregleda) za chatbota ili cijelu tvrtku, najnovije prvi, s brojem prijedloga.chatbots:read
improvement_simulation_assessOcijeni rezultat simulacije: isApproved=true kada je simulirani odgovor dobar (prijedlog se tada može primijeniti), false kada zahtijeva doradu (komentar 'almost' = skoro točno).chatbots:write

Live Chat

ToolDescriptionScope
live_chat_agents_availableDohvati vlastitu dostupnost za live chat trenutnog korisnika, agente koji su trenutno dostupni za live chat (svježi heartbeat, isti signal koji widget koristi) i informaciju uključuje li plan tvrtke live chat.chats:read
live_chat_heartbeatOsvježi heartbeat prisutnosti trenutnog korisnika za live chat (samo dok ste označeni dostupnima putem live_chat_set_availability).chats:write
live_chat_message_sendPošalji poruku posjetitelju kao dodijeljeni agent.chats:write
live_chat_queueDohvati red za live chat: sesije koje čekaju agenta, najstarije prve (FIFO).chats:read
live_chat_session_assignPreuzmi WAITING live chat sesiju iz reda: dodjeljuje je trenutnom korisniku (vlasnik tvrtke za API ključeve) i obavještava posjetitelja da se agent pridružio.chats:write
live_chat_session_closeZavrši live chat sesiju kao agent (bilo koji član tvrtke osim VIEWER-a).chats:write
live_chat_session_getDohvati live chat sesiju s informacijama o posjetitelju, dodijeljenom agentu, svim porukama i prethodnim bot razgovorom (handoff context).chats:read
live_chat_sessions_listIspiši live chat sesije (najnovije prve; WAITING sesije najstarije prve) s opcionalnim filtrima po chatbotu, statusu i dodijeljenom agentu.chats:read
live_chat_set_availabilityPrebaci prekidač trenutnog korisnika 'Available for Live Chat' za tvrtku.chats:write

Leads

ToolDescriptionScope
lead_assignDodijeli lead članu tvrtke ili ga oddodijeli (assignedToId: null).leads:write
lead_bulk_update_statusPostavi status više leadova (max 100) odjednom.leads:write
lead_categories_listIspiši kategorije leadova chatbota s brojevima leadova i članovima tima obaviještenim po kategoriji.leads:read
lead_category_assign_userDodaj člana tvrtke na listu obavijesti lead kategorije (ili ažuriraj njihove notification flags).leads:write
lead_category_createKreiraj kategoriju leadova za chatbota.leads:write
lead_category_deleteObriši kategoriju leadova.leads:write
lead_category_remove_userUkloni člana tvrtke s liste obavijesti kategorije leadova.leads:write
lead_category_updateAžuriraj ime, opis i/ili boju kategorije leadova.leads:write
lead_createRučno kreiraj lead (npr.leads:write
lead_deleteTrajno izbriši lead.leads:write
lead_field_config_getDohvati konfiguraciju hvatanja leadova chatbota: polja (ids mapiraju na ključeve u lead.data), poruku potvrde, prijevode polja/UI i AI postavke prepoznavanja.leads:read
lead_field_config_updateAžuriraj konfiguraciju hvatanja leadova chatbota.leads:write
lead_getDohvati pune detalje leada uključujući dodijeljenog, kategoriju i izvorni transkript razgovora (paginirano s messageOffset/messageLimit, zadano prve 20 poruka).leads:read
lead_listIspiši leadove chatbota (najnoviji prvi) s opcionalnim filtrima po statusu, kategoriji, assignee i pretraživanjem slobodnim tekstom (ime/email/tvrtka).leads:read
lead_statsDohvati statistiku leadova za chatbota: brojeve po statusu, leadove zadnjih 7 dana i stopu konverzije (postotak).leads:read
lead_updateAžuriraj status, kategoriju, bilješke, uhvaćene podatke i/ili dodijeljenog leada.leads:write

Forms

ToolDescriptionScope
form_createKreiraj kontakt obrazac za chatbota (osnovno, polja, dizajn i postavke za spam u jednom pozivu).forms:write
form_deleteTrajno izbriši kontakt obrazac i SVE njegove prijave (cascade).forms:write
form_getDohvati kontakt obrazac u cijelosti: polja, prijevodi, stilizaciju, postavke protiv spama, aktivno stanje, broj prijava i embed script tag (embedCode).forms:read
form_listIspiši kontakt obrasce chatbota s brojem polja, brojem prijava i embed kodovima.forms:read
form_statsBrojevi prijava kontakt obrasca: total, pending, approved, spam i rejected.forms:read
form_submission_deleteTrajno izbriši prijavu kontakt obrasca (npr.forms:write
form_submission_getDohvati prijavu kontakt obrasca u cijelosti: poslane podatke polja, spam score i AI spam analizu, IP/user agent/referrer metapodatke i informacije o pregledu.forms:read
form_submission_update_statusPregledaj prijavu kontakt obrasca: postavi njezin status na APPROVED, SPAM ili REJECTED s opcionalnom bilješkom.forms:write
form_submissions_listIspiši prijave kontakt obrasca, najnovije prve, opcionalno filtrirano po statusu (PENDING, APPROVED, SPAM, REJECTED) i datumu kreiranja.forms:read
form_updateAžuriraj kontakt obrazac: ime, opis, aktivno stanje (isActive kontrolira renderiranje embed-a), polja (potpuna zamjena), dizajn (boje, tekst gumba, poruka o uspjehu) i postavke protiv spama (spamThreshold, autoRejectSpam, notificationEmail).forms:write
form_update_translationsZamijeni prijevode polja i/ili UI kontakt obrasca.forms:write

Email Assistant

ToolDescriptionScope
email_activity_listIspiši zapisnik aktivnosti obrađenih emailova povezivanja poštanskog sandučića (najnoviji prvi): pošiljatelj, subject, dodijeljena kategorija, ishod (CATEGORIZED, DRAFT_CREATED, SKIPPED_NO_RULE, SKIPPED_NO_KNOWLEDGE, SKIPPED_BY_TRIAGE, SKIPPED_QUOTA, ERROR) i outcomeDetail.email:read
email_categories_listIspiši email kategorije povezivanja poštanskog sandučića (poredano po sortOrder).email:read
email_category_createKreiraj email kategoriju za povezivanje poštanskog sandučića (maks 20 po konekciji).email:write
email_category_deleteObriši email kategoriju.email:write
email_category_updateAžuriraj email kategoriju (djelomično: mijenjaju se samo navedena polja).email:write
email_connection_disconnectTrajno odspoji mailbox.email:write
email_connection_getDohvati povezivanje mailboxa uključujućiemail:read
email_connection_updateAžuriraj povezivanje mailboxa: pauziraj/nastavi sinkronizaciju (paused true/false; samo prebacuje ACTIVE<->DISABLED, nikada ne nadjačava TOKEN_EXPIRED/ERROR), uključi/isključi draftanje odgovora (draftingEnabled) i kategorizaciju/organiziranje (organizingEnabled), preusmjeri napajajući chatbot (chatbotId iste tvrtke) ili postavi HTML potpis odgovora (signatureHtml, maks 20000 znakova; prazan string ga briše).email:write
email_connections_listIspiši povezivanja Email Assistant mailboxa tvrtke (adresa, status ACTIVE/DISABLED/TOKEN_EXPIRED/ERROR, zadnja sinkronizacija, zadnja greška, draftanje/organiziranje prekidači, powering chatbot, draftReadyCategoryCount = kategorije koje mogu generirati nacrte, baseRuleCount = širokoplanne 'Chat + Email' rules primijenjene na svaki nacrt) zajedno s limitima plana (emailAssistantEnabled, maxMailboxConnections, emailDraftsPerMonth).email:read
email_contact_deleteObriši naučeni email kontakt (zaboravi profil pošiljatelja, npr.email:write
email_contact_getDohvati naučeni email kontakt sa svim naučenim činjenicama, internim bilješkama, odnosom, formal/informal postavkom adrese i statistikama emailova.email:read
email_contact_updateAžuriraj naučeni email kontakt.email:write
email_contacts_listIspiši naučene email kontakte tvrtke (zadnji email prvi) s odnosom, formal/informal adresom (formalAddress: true = formalno 'Sie', false = neformalno 'Du', null = automatski), brojem činjenica i pregledom bilješki.email:read
email_folder_createKreiraj mail folder ispod inboxa (vraća postojeći ako je ime zauzeto) da služi kao cilj za pomicanje kategorije.email:write
email_folders_listIspiši foldere u koje email kategorija može premještati mailove uživo iz mailboxa: inbox podmape, prilagođene top-level foldere, archive, junk i trash (id 'deleteditems').email:read
email_general_rules_listIspiši pravila koja se primjenjuju na svaki nacrt odgovora mailboxa: aktivne core instructions s channel BOTH ("Chat + Email"), plus legacy email-only koja još nisu migrirana u kategoriju.email:read

Analytics

ToolDescriptionScope
analytics_chat_volumeVolumen razgovora (pokrenute sesije) kroz vrijeme za grafikone i trendove: period week/month/quarter/year, granularnost hour/day/week/month, opcionalno za jednog chatbota.analytics:read
analytics_chatbot_statsPerformanse po chatbota za tvrtku u jednom pozivu (tablica performansi chatbota na nadzornoj ploči): id, name, slug, isActive, sessions, messages, FAQs i leads po chatbota, sortirano po sessions.analytics:read
analytics_formsStatistika prijava kontakt obrasca za tvrtku ili jednog chatbota (widget analitike): prijave po statusu (pending/approved/rejected/spam), broj obrazaca, total, spam rate u postocima i serija prijava po danu za zadnjih 7 dana.analytics:read
analytics_leadsLead funnel za tvrtku ili jednog chatbota (widget analitike): leadovi po statusu (new/contacted/qualified/converted/lost), ukupno, stopa konverzije u postocima i serija leadova po danu za zadnjih 7 dana.analytics:read
analytics_overviewAnalitički pregled za tvrtku ili jednog chatbota: razgovori, poruke, stopa zadovoljstva i top pitanja za pomični period (day/week/month/year), plus widget pregleda nadzorne ploče (total chatbots/published FAQs/leads, sessions danas/ovaj tjedan/ovaj mjesec, leads danas/ovaj tjedan, form submissions total/danas/pending).analytics:read
dashboard_activityŠto trenutno zahtijeva pažnju (home view nadzorne ploče): po tvrtki, chatboti s novim leadovima danas, pending FAQ sugestijama, pending prijavama obrazaca, čekajućim/aktivnim live chatovima ili trenutnom learning phaseu.any

Primjeri radnih tijekova

Dodavanje core instruction

Pitajte svog AI asistenta:

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

Asistent će upotrijebiti chatbot_add_instruction s odgovarajućim parametrima.

Pregled prijedloga za poboljšanje

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

Asistent će:

  1. Koristiti improvement_proposals_pending za dohvat prijedloga
  2. Analizirati i sažeti svaki prijedlog
  3. Odobriti ili odbiti u vaše ime pomoću improvement_proposal_approve ili improvement_proposal_reject

Analiza performansi razgovora

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

Asistent će koristiti analytics_overview i analytics_chat_volume za sastavljanje sveobuhvatnog izvještaja.

Uvoz web-stranice

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

Asistent će pozvati crawler_preview_scan, odabrati relevantne stranice, započeti uvoz s crawler_start i pollati crawler_job_get dok posao ne završi.

Pregled leadova i prijava obrazaca

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

Asistent kombinira lead_list, lead_assign, form_submissions_list i form_submission_update_status.

Preuzimanje live chata

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

Asistent koristi live_chat_set_availability, live_chat_queue i live_chat_session_assign; odgovori prolaze kroz live_chat_message_send.

Sigurnost

  • API ključevi su ograničeni na vašu tvrtku i na dozvole koje odaberete pri njihovom stvaranju (pogledajte stupac Scope gore)
  • Ključevi se izvršavaju s dopuštenjima vlasnika tvrtke; limiti plana i feature gate-ovi primjenjuju se jednako kao na nadzornoj ploči
  • Ključevi se mogu opozvati u bilo kojem trenutku s nadzorne ploče
  • API pristup dostupan je na plaćenim planovima — pogledajte našu Pricing page

Rješavanje problema

Veza nije uspjela

  1. Provjerite je li vaš API ključ ispravan
  2. Provjerite nije li ključ opozvan
  3. Provjerite uključuje li vaš plan API pristup
  4. Ponovno pokrenite svog MCP klijenta

Alat nije pronađen

Ponovno pokrenite svog MCP klijenta nakon promjene konfiguracije kako bi ponovno učitao dostupne alate. Imenu alata su mala slova s donjim crticama (npr. faq_list).


Trebate pomoć? Contact our support team →