Toto je kompletní dokumentace pro OpsIQ. Nastavit produkt, spustit podporu, konfigurovat AI, spravovat CRM, nainstalovat widget, budovat konektory, volat REST API, přijímat webháky, balíčky na trh aplikace, a provozovat self-hosted nasazení.
CtrlK
Vyhledávání všech témat OpsIQŽádná odpovídající sekce
Průvodce zákazníkemAdministrátorský průvodcePříručka pro vývojářeReferenční hodnota CRMPřipojení SDKREST APISelf- hostováno
Zjištěna cesta návštěvníka
Sledování, země, stránky, vedení, přeměny a podpora záměru v reálném čase.
Odpověď AI
OpsIQ může pomoci psát odpovědi na vstupenky, chatu odpovědi, shrnutí a zákaznické oznámení.
Webhook akce připravena
Připojte schválené akce platformy k zajištění spouštěčů s potvrzením a historii auditu.
Oblast působnosti
Oblast působnosti této příručky
Vše, co OpsIQ dělá, na jednom místě: jak funguje každá obrazovka, jak připojit své vlastní systémy, a jak stavět na něm. Začněte kdekoliv, sekce postupujte stejným pořadí jako admin sidebar.
Oblast působnostiPříručka je uspořádána kolem produktu OpsIQ podle stejného pořadí jako admin sidebar.
Průvodce terénem Portal Studio
Použijte vyhrazenou příručku pro správce a vývojáře Portálové architektury, stránky, komponenty, náhled, Centrum nápovědy, identity, SCIM, regulované verze, rozšíření, migrace a certifikace.
Každá obrazovka v admin: analytika, živý chat, lístky, CRM, znalostní základna, Zpravodajská služba, propagace a zákaznický portál. Co každá stránka dělá, co čísla znamenají, a co dělat, když vypadají špatně.
Připojte své systémy
Webové stránky widget, e-mailové schránky, přijíždějící a odchozí webháky, a konektorová knihovna pro platformy, jako je Shopify, WooCommerce, WHMCS, Zendesk, Stripe, Slack a Gmail.
Vytvořit si vlastní
Konstrukční zařízení konektorů pro no-code konektory, Akce & Triggery, pokud byste raději nepoužívali konektory vůbec, a REST API s každou akcí, rozsah a chybový kód.
Proveďte to.
Role a oprávnění, bezpečnost, cron, diagnostika, zálohy, a jak hostované a self-hostitelské nasazení.
Kde začít
1
Pokud provozujete OpsIQ den ode dne
Přečtěte si části obrazovky v pořadí postranní. Každý se otevře s tím, co stránka je pro, takže můžete zastavit, jakmile máte to, co potřebujete.
2
Pokud ji podáte
Přidat Nastavení, Bezpečnost, Diagnostika, Cron a Výroba. To jsou sekce, které rozhodnou, zda vše ostatní funguje.
3
Pokud budujete integraci
Začněte u Connectors, pak na Connector Builder, pak REST API a webháky. Přečtěte si, že v pořádku a budete viděli všechny způsoby OpsIQ může mluvit s jiným systémem.
💡
Dvě věci změnit to, co vidíte. Povolení skrýt stránky vaše role nemůže otevřít, takže část zde popsaná může chybět z vašeho postranního panelu. Požádejte správce zkontrolovat vaši roli. A konektory nesou značku splatnosti výroby, Beta, Náhled nebo šablona; běžící konstrukce a její konektor manifest jsou autoritou, na které máte, ne tuto stránku.
Začněte tady.
Co OpsIQ dělá pro vaše podnikání
OpsIQ je kompletní AI- první obchodní operační platforma. Nahrazuje vaši analytiku, živý chat, helpdesk, CRM, SEO toolkit, integrační middleware, a vývojová platforma s jednotným admin, kde každý nástroj sdílí stejný kontext zákazníka. 8-12 samostatné produkty SaaS, nainstalujete OpsIQ jednou a ovládej všechno z jedné obrazovky.
PlatformaOpsIQ je jedna platforma s jedním sdíleným kontextem zákazníka, každý nástroj kanály, a je poháněn, stejný mozek AI.
Vše, co OpsIQ dělá · v detailu
Analýza webových stránek a informace o návštěvnících
Sledování návštěvníků v reálném čase
Každá stránka zatížení, klepněte na tlačítko, posun, a navigační událost je zachycena v reálném čase. Podívejte se, kdo je na vašich stránkách právě teď, jaké stránky jsou prohlížení, jak dlouho tráví, a odkud pocházejí, všechny bez třetích stran cookies.
Záznamy návštěv a sezení
Plné historie každého návštěvníka se zařízením, prohlížečem, operačním systémem, zemí, městem, referentem, parametry UTM, přistávací stránkou a rozlišením identity. Sessions group page views into travels, takže můžete vidět celou cestu návštěvník trvá.
Přehrávání relací
Přehrávání zachycených návštěv ve stylu času. Podívejte se přesně, co uživatelé dělali: pohyby myší, kliknutí, svitky, přechody stránek a vzájemné interakce. Použijte ji k diagnostice problémů UX, pochopení odklonu bodů a ověření konverzních toků.
Živé krmivo
Reálný-time proud návštěvnosti aktivity, jak se to stane. Viz zobrazení stránky, chat začíná, formuláře podání, a intent signály aktualizace každých pár sekund. Filtrovat podle země, zařízení, nebo referent zaměřit na konkrétní segmenty dopravy.
Horní stránky
Stránky seřazené podle návštěv, čas zapojení, rychlost odrazu, konverzí a podpůrná činnost. Identifikujte svůj vysoce výkonný obsah a stránky, které potřebují zlepšení.
Geointeligence
Rozložení země, města a regionu s mapami. Rozdělení zařízení a prohlížečů, analýza dopravních zdrojů, sledování vyhledávače a náhledy na pronikání na trh.
Záměrná trychtýř
Sledovat návštěvníky záměry signály (cenová stránka návštěvy, opakované návratnosti, dokumentace prohlížení vzory, a podporovat interakce) identifikovat návštěvníky, kteří jsou pravděpodobně koupit, churn, nebo potřebují pomoc.
Experimenty A / B
Spustit split testy na vašich webových stránkách přímo z OpsIQ. Vytvořit varianty, nastavit rozdělení provozu, definovat cíle konverze, a měřit statistický význam.
JavaScript sledování chyb
Zachyťte automaticky chyby klientů z vašich webových stránek na straně JavaScript. Viz chybové zprávy, stohové stopy, postižené prohlížeče, počty frekvencí a které stránky je spouštějí. Debug frontend problémy bez samostatného monitorování chyb.
Záznam událostí
Každá sledovaná událost (zobrazení stránek, vlastní akce, chat interakce, formuláře podání, nákupy) v vyhledávatelné, filterovatelný log s plnými metadaty.
Prodej a přeměny
Traťová objednávka, příjmy, náhrady, obnova předplatného a přisuzování převedení do dopravních zdrojů, kampaně a cesty návštěvníků. Příjmy dashboardy s obdobím srovnání a analýza trendů.
Vodíky
Vysoce-záměr návštěvníků identifikovaných vzory chování. Skóre vede na základě návštěv stránek, čas na místě, návrat frekvence, podpora interakcí, a vlastní signály. Krmivo vede přímo do potrubí CRM.
Zpravodajská služba na místě (SEO a analýza obsahu)
Plazy
Automatické plazení celé webové stránky objevit stránky, odhalit rozbité odkazy, najít chybějící meta tagy, zkontrolovat obrázek alt text, validovat kanonické URLs, a map struktury stránek. Plán leze spustit denně, týdně, nebo na vyžádání.
Technický audit SEO
Komplexní technická analýza: skóre rychlosti stránky, mobilní citlivost, funkce Core Web Vitals, status certifikátu SSL, přesměrování řetězců, duplikát detekce obsahu, analýza hloubky plazení a validace strukturovaných dat.
Obsah auditu
Hodnotit každou stránku pro kvalitu obsahu, počet slov, čitelnost skóre, klíčové slovo hustota, struktura hlavičky, vnitřní / vnější poměr link, a svěžest. Identifikovat tenký obsah, duplikát stránky, a obsah mezery.
Vyhledávání na bázi AI- napájeno
Semantické vyhledávání po celém obsahu webu. Zeptejte se na přirozený jazyk otázky o vašem obsahu a získat AI- syntetizované odpovědi s referencemi zdrojové stránky.
Sledování pořadí SERP
Sledujte pořadí vyhledávačů pro cílová klíčová slova v rámci Google a dalších motorů. Poloha dráhy se mění v průběhu času, porovnávají s konkurenty a uvidíte, které stránky jsou hodnoceny podle podmínek.
Výzkumy klíčových slov
Objevte klíčové možnosti založené na Vašem obsahu, analýze konkurentů a údajích o objemu vyhledávání. Získejte návrhy na nová témata obsahu, varianty dlouhotrvající stránky a cíle optimalizace obsahu.
Analýza backlingu
Sledujte svůj příchozí profil. Podívejte se, které stránky s vámi souvisejí, sledovat nové a ztracené odkazy, analyzovat kódování textové distribuce a identifikovat možnosti budování link- building.
Místní síť SEO
Pro podniky s fyzickými lokalitami: vizualizovat svou místní vyhledávání viditelnost přes geografické mřížky. Podívejte se, jak se vaše žebříčky liší podle umístění, vzdálenosti od vašeho podnikání, a vyhledávací záměr.
Google Business Profile Synchronizace
Připojte svůj profil Google Business k OpsIQ. Synchronizace recenze, příspěvky, Q & A, fotografie, a obchodní informace. Správa vašeho seznamu GBP zevnitř OpsIQ. Reagovat na recenze, publikovat příspěvky, a sledovat poznatky.
Plánované zprávy
Automatické SEO a analytické zprávy generované na vašem programu (denní, týdenní, měsíční). Zprávy zahrnují změny pořadí, dopravní trendy, technické problémy nalezené, a obsah výkon. White- label výstup k dispozici pro agentury.
Podpora na vzduchový pohon
Zákaznický AI chat
AI odpovědi na dotazy zákazníků na vašich webových stránkách 24/7 pomocí vaší znalostní základny, připojených platforem data (objednávky, účty, předplatné), a vlastní školení podněcuje. Podporuje více AI poskytovatelů: Claude (Anthropic), GPT- 4o (OpenAI), Gemini (Google), a Grok (xAI).
Admin AI asistent
AI copilot uvnitř vašeho admin panelu, který vám pomůže psát odpovědi na vstupenky, návrh zákaznické komunikace, analyzovat trendy podpory, vyhledat data zákazníků přes připojené platformy, a provádět akce prostřednictvím konektoru systému.
Uzemnění znalostí AI
AI je zakotvena ve vašich znalostních základních článcích, FAQ zápisy, dokumentace produktu a připojených platform dat. Nehalucinuje. To odpovídá z Vašich skutečných obchodních informací nebo vystupňuje, když nejisté.
Automatické předání lidem
Když AI nemůže vyřešit otázku, detekuje frustraci, nebo zákazník žádá člověka, automaticky předá do svého týmu s plným kontextem konverzace. Konfigurovatelný pokles / timeout auto- returt zpět na AI.
Výcvik AI
Napište samostatné instrukce pro uživatelsky orientované AI a admin- facing AI. Ovládací tón, hranice, eskalační pravidla, zakázaná témata a obchodní chování. Podporována konfigurace per- workspace.
Historie a audit AI
Každá konverzace AI je zaznamenána s úplnými detaily požadavku / odpovědi, token použití, sledování nákladů, poskytovatel používá, a verze modelu. Přezkum konverzace k identifikaci mezery v tréninku a zlepšení přesnosti AI.
Náhled AI
Automatická analýza AI konverzních vzorců. Viz společné otázky, míry rozlišení, frekvence předání, spokojenost zákazníků podle témat a oblasti, kde AI potřebuje lepší školení.
Per- workspace AI config
Každý připojený web / pracovní prostor může využít svého vlastního poskytovatele AI, model, teplotu, token rozpočet a školení podněty. SaaS společnost může používat Claude pro hlavní produkt a GPT-4o pro sekundární značku.
Managed AI a BYOK
Dva režimy AI: Managed AI (součástí vašeho plánu, ne API klávesy potřebné) nebo přinést svůj vlastní klíč (použijte svůj vlastní OpenAI/Anthropic/ Google / xAI API klíč pro plnou kontrolu nad výběrem modelu a náklady). Oba jsou first-class, každá funkce pracuje s oběma režimy.
Významné rozpočty a kontroly nákladů AI
Nastavit měsíční token rozpočty, per- konverzace omezení, a low - balance upozornění. Track výdaje na poskytovatele, na pracovní prostor, a na konverzaci. Zabraňte útěku náklady s tvrdými stropy.
Vstupenky a helpdesk
Původní systém vstupenek
Kompletní helpdesk s odděleními, priority (nízká / střední / vysoká / urgentní), statusy, SLA sledování, interní poznámky, odpovědi zákazníků, soubory příloh a závitové konverzace.
AI triage a auto- odpověď
AI automaticky triages příchozí vstupenky podle oddělení a priority. Povolit automatickou odpověď pro bezpečné oddělení. AI návrhy a pošle odpověď po konfigurovatelné zpoždění (výchozí: 2 minuty), takže lidé mohou zasáhnout jako první.
Požití e-mailem
Připojte poštovní schránku (Gmail, IMAP, nebo provider- specific) k automatickému vytvoření tipů z příchozích e-mailů. Odpovězte na oznámení tipu e-maily aktualizovat vlákno tipu.
Vložený portál vstupenek
Na vaše webové stránky je upraven portál tiketů, který má na mysli zákazníka. Zákazníci mohou zaslat vstupenky, zobrazit jejich historii, odpovědět na otevřené jízdenky a zkontrolovat stav, všechny označené podle vašeho návrhu.
Spojení vstupenek
Sloučit duplikát tipů do jednoho vlákna. Sloučené tikety ukazují [Sloučeno] na předmět řádku. Všechny historie konverzace je zachován v přeživších tipu.
Návrat na AI
Poté, co člověk převezme lístek, použijte "Návrat do AI", aby se AI obnovit automatickou odpověď na tento tiket. Užitečné, když je vyřešena lidská-požadované části, ale zákazník má následné otázky, které AI zvládne.
Inbox druhého pilota
Správa letenek AI- asistovaná z pohledu na inbox. Kopilot navrhuje odpovědi, shrnuje historii konverzace, doporučuje prioritní / oddělení úkoly, a může provádět akce na připojených platformách.
Podpora chatu a reálného času
Zapisovač chatu
Real- time zákaznický chat řízený z jednotné schránky. Viz všechny aktivní konverzace, identity zákazníka, historie konverzace a AI návrhy. Více agentů může spolupracovat na konverzaci.
Proaktivní pravidla chatu
Spouštěcí chat zprávy založené na chování návštěvníků: čas na stránce, konkrétní URL navštívený, posun hloubky, počet návštěv zpět, úmysl výstupu, nebo vlastní události. Příklad: zobrazí nápovědu po 60 sekundy na cenovou stránku.
Widget pro chat
Přizpůsobitelný chat widget vložen na vašich webových stránkách. Podporuje AI chat, živý agent chat, odeslání vstupenky, vyhledávání znalostí základnou a identity návštěvníka. Responsive, přístupné a brangable.
Průzkumy CSAT
Sbírejte hodnocení spokojenosti zákazníků po chatu a interakcích tipů. Designové průzkumy s vlastními dotazy, ratingové stupnice a následná opatření podněcují. Výsledky jsou výsledkem výsledků do týmového výkonu a AI náhledu.
Post- chat emailový průzkum
Po skončení chatu mohou návštěvníci se známým emailem obdržet jednu znakovou poštu s AI souhrnem toho, co bylo zpracováno, a jedním kliknutím na tlačítko "Bylo to snadné?" Ano / Ne. Jednou za vlákno, podepsané jednoúčelové odkazy, každý odeslat přihlášené, a výsledek přistane na stránce Feedback jako svůj vlastní signál vedle in- chat hvězdy.
Zpětná vazba na identifikační smyčku
Každá položka zpětné vazby, která nese osobu, jim ukazuje: jméno, e-mail, kliknutí - přes jejich plnou cestu zákazníka a CRM kontakt, a one-click Email nebo AI- návrh odpovědi uzemněné ve své vlastní historii.
Psaní AI
Samostatný asistent pro psaní AI pro sestavování e-mailových návrhů, odpovědí na jízdenky, oznámení a zákaznické komunikace. Používá svůj vlastní příkaz (ne chatu mozek) pro profesionální obchodní psaní.
AI- První CRM
Řídící centrum CRM
Jedna obrazovka zobrazující celý váš stav CRM: hodnota potrubí, rychlost obchodu, nadcházející úkoly, a- rizikové obchody, aktivity agenta a AI doporučení. RPM domovská stránka je váš denní výchozí bod.
Kontakty a společnosti
Správa zákaznických kontaktů s plnými profily: jméno, e-mail, telefon, společnost, tagy, životní cyklus jeviště, historie konverzace, historie vstupenek, historie nákupu a vlastní pole. Odkaz kontakty na společnosti pro B2B vztahy řízení.
Obchody a potrubní desky
Visual Kanban- styl deal board s přizpůsobitelnými etapami. Přetáhněte nabídky mezi stupni, nastavené hodnoty, přiřaďte vlastníkům, uzavírejte data a v každé fázi uvidíte hodnotu potrubí. Podporováno více potrubí.
Ujednání o AI
AI analyzuje každou dohodu a poskytuje koučování: rizikové signály (odešel klid, konkurent zmínil, rozpočtové obavy), nextbest- action doporučení, vyhrát pravděpodobnost, a navrhl následující-up načasování.
Předpověď a zprávy
Předpověď příjmů na základě údajů o potrubí, historické úzké rychlosti a rychlosti obchodu. Zprávy zahrnují plynovod po etapě, vlastníkem, zdrojem, přepočítacími koeficienty, průměrnou velikost transakce a délku prodejních cyklů.
Prospekční činidlo (SDR)
AI- poháněné vyhledávání, které identifikuje potenciální zákazníky z vašich návštěvních dat, olověných signálů a připojených platforem aktivity. Navrhuje oslovit cíle, návrhy počáteční zprávy a skóre kvality vedení.
Postupné sekvence
Automatizované multikrokové sekvence: e-mail, čekání, e-mailová odpověď, kontrola, eskalovat. Definujte sekvence pro nové tipy, pozastavené obchody, post- nákup check-iny, a re- angažovací kampaně.
Životní cyklus a zachování
Sledovat fáze životnosti zákazníků (olovo, výhled, zákazník, churned) s automatickými přechody. Retenční činidlo monitoruje signály a navrhuje zásahy.
Správce údajů
AI agent, který neustále čistí a obohacuje vaše data CRM: deduplikuje kontakty, vyplní chybějící pole, validates e-maily, standardizuje jména společností a vlajky zatuchlé záznamy.
Vybudovat CRM
Konfigurace CRM v přírodním jazyce: řekněte AI, jak vypadá váš prodejní proces a staví vaše potrubní fáze, vlastní pole, šablony obchodů a pravidla automatizace.
Zdravotní kontrola CRM
Automatický audit kvality Vašich údajů CRM: duplikát kontaktů, obchody bez dalších kroků, zastaralé potrubí, chybějící kontaktní informace a datový záznam úplnosti.
Důvěřujte vytáčení
Kontrola autonomie na úrovni tří úrovní pro každý agent CRM AI: Autopilot (AI působí nezávisle), Copilot (AL navrhuje, člověk schvaluje), a manuál (Al sleduje pouze). Nastavte číselník na činidlo, na akční typ a na hodnotu deal práh.
Čtyři AI agenti
CRM provozuje čtyři specializované AI agenty: Steward (kvalita dat), SDR (vyhledávání), Retention (Churn Prevention), a Analyst (hlášení a poznatky). Každý agent má své vlastní nastavení Trust Dial.
Konektory a integrace
Kontejnery vyrobené z předčiněné oceli
Kontejnery pro opakované použití Shopify, WooCommerce, BigCommerce, Magento 2, PrestaShop, OpenCart, osCommerce, WordPress, WHMCS, Zendesk, Stripe, Amazon SES, Postmark, Resend, SendGrid, Mailgun, Gmail, IMAP, Slack, a Google Business Profile. Každý konektor přináší platform- specific AI akce, znalosti a synchronizace dat.
Tvorba konektorů
Vybudovat vlastní konektory pro jakoukoli platformu, bez kódu, AI- asistované, nebo plný kód. Stavebnice podporuje REST a GraphQL APIs, OAuth autorizační kód proudění, webhook auto- registrace s Stripe a jednoduché signature schémata, pagination (ofset, strana, kurzor, a link- header), seznam / chyby transformace, multiakční kontext, a tržiště balení.
Oprávnění konektoru asistovaného vůči AIR
ConnectorBuilderai vám pomůže budovat konektory: popište, co chcete a navrhne akce, napíše handlers žádostí a mapuje odpovědi API. Zařizuje autentizaci, paginaci a automatickou manipulaci s chybami.
Průtok OAuth pro jakýkoliv konektor
Generická in- app OAuth autorizační proudění, které pracuje s jakýmkoli konektorem. Podpora PKCE, řízení stavu se systémem site@-@ scoped, automatická obnova token.OAuth parametry a OpsIQ zvládá průtok.
Schopné autobusy (ploché rozšíření)
Connectors don't just add platform actions. They can power core features through capability "buses". A connector declares a capability (calendar, enrichment, esign in CRM; local_listing, rank_data in Site Intelligence; web_analytics in Analytics; payment_provider in Payments; email_sync in Mailbox; video_meeting in Comms) and implements its small method set; OpsIQ discovers it via CapabilityRegistry and wires it into the UI, the Customer 360 timeline, and the AI actions. Several connectors can offer the same capability with no lock-in. See connectors/PLATFORM_CONNECTORS.md.
Předinstalovaný vs tržní úroveň
Connectors live in one of two tiers. Pre-installed connectors (connectors/) are registry-active out of the box, kept lean to just the keyless reference and the most-used provider per capability (e.g. Google Calendar, Gmail, Google Business Profile). Marketplace connectors (marketplace_connectors/) are discoverable but inert until installed, e.g. Microsoft 365 Calendar, Outlook, DocuSign, Stripe, GA4, SerpApi, Zoom. Every bridge surfaces a marketplace list so the UI and the AI can prompt "install from the marketplace" (notify-to-install) when a capability has no ready provider, never a broken button.
Trh konektorů
Publish your connectors to the OpsIQ marketplace. Package connectors with profile.json, knowledge.json, workflow_recipes.json, and signed archives. Marketplace supports free and paid connectors with multi-source billing.
Podpis konektoru
All connectors are cryptographically signed for integrity verification. Signing is checked at install time. Use the resign_all_connectors tool to re-sign after updates.
Name
Deklarativní fuzzy-matching systém pro akce konektoru. Definovat vyhledávací pravidla a OpsIQ Příklad: find_country("germ") přiřadí Německo k entitám platformy pomocí algoritmů fuzzyScore a smartRank. 88.9% důvěra.
Akční smlouvy
Generální tajemník OpsIQ API zveřejňuje 1,312 Pojmenované akce, zatímco konektorové balíčky prohlašují své vlastní prodejní akce s parametry zadané, požadavky na autentizaci, pravidla paginace a reakce transformují prostřednictvím jednotného ActionExecutor.
Recepty pro konektory
Představené pracovní postupy, které kombinují více konektorových akcí do běžných pracovních toků podnikání. Příklad: "Když přijde nová objednávka na Shopify, vytvořit tiket, aktualizovat CRM, a poslat oznámení Slack".
Znalostní synchronizace
Konektory prohlašují znalostní témata, která se synchronizují s AI znalostní základnou. Návody pro nástavce, setup a kroky k řešení problémů jsou automaticky dostupné pro AI bez manuálního vstupu do znalostí.
Vývojářská platforma
REST API
Jméno JSON API zahrnuje každého registrovaného správce JSON provoz sAPI-key autentizace, izolace pracovního prostoru, skoky, omezení rychlosti, idempotent píše, OpenAPI, a generované Postman kolekce.
Webhooky
Odchozí webové háky pro všechny významné události: objednávky, faktury, předplatné, lístky, chaty, tipy, uživatelské registrace a opuštění košíku. Async dodávka přes frontu pracovních míst, exponenciální zpětná retry, SSRF ochrana, a auto-zakázat po 15 po sobě jdoucích selhání.
Podpis pomocí Webhooku
Every outbound webhook is signed with HMAC-SHA256. Verify signatures on your receiving end to ensure webhook authenticity. Stable event_id for idempotent processing.
Widget SDK
JavaScript SDK pro sledování widget s rozlišením identity, vlastní sledování událostí, programový chat ovládání, a page- specifické konfigurace. Instalovat recepty pro React, Vue, Next.js, WordPress, Shopify, a statický HTML.
Moduly a SDK
Serverside SDK a pluginy pro společné rámce. WordPress plugin, WHMCS modul a obecné integrační knihovny PHP / Node.js.
Události API
Vlastní události můžete z backendu odesílat do OpsIQ: nákupy, registrace, využití funkcí, chyby nebo jakékoli obchodní ukázky. Události se zobrazují na časové ose návštěvníka a jsou zařazovány do analytických dat a kontextu AI.
Kuchařská kuchařka Triggerů
Vytvořte automatické pracovní toky spuštěné událostmi: nový tip, chat začal, návštěvník identifikován, deal stage změnil, nebo na zakázku událost. Triggers provést konektory akce, odeslat webové háky, aktualizovat záznamy, nebo informovat svůj tým.
API stavitel
Vizuální API a webhook stavitel uvnitř admin. Nastavit koncové body, testovací požadavky, zkontrolovat odpovědi, a debug integrace bez odchodu OpsIQ.
Tým a správa
Kontrola přístupu na základě Rolexů
Tři role: Vlastník (plný přístup, fakturace, nebezpečné zóny), Full Admin (všechny operace kromě účtování a nebezpečného pásma), a Agent (pouze přiřazené oddělení, žádný přístup k nastavení). Všechny citlivé stránky jsou pevně vedeny rolí.
Přístrojová deska výkonnosti týmu
Vlastník a Full Administration-pouze palubní deska zobrazující časy rozlišení, distribuce pracovní zátěže, rukojeť hloubka, rozdělení kanálů, analýza trendů, SLA compliance, CSAT podle agenta, znovu otevřené sazby, tým rollups, a nejrušnější hodiny. Aktualizováno v reálném čase.
Administrátorská přítomnost a online sledování
Real- time who-is- online widget in the admin navigation.60- druhé ping, 300-druhé prodloužení, auto- prune po 120 dny). Podívejte se, kteří administrátoři jsou v současné době aktivní a na kterých stránkách.
Nastavení pracovní plochy
Každý připojený web (pracovní prostor) může mít vlastní konfiguraci AI, nastavení konektoru, oddělení tipu, značky a provozní pravidla. Globální defaultní kaskáda do pracovních prostorů, které je nepřeruší.
Správa vícestavových lokalit
Správa více webových stránek z jednoho OpsIQ admin. Každý web má svůj vlastní sledovací snippet, data návštěvníků, a konfigurace. Přepínejte mezi weby z navigaci admin
Systém e-mailové šablony
Registry- řízené e-mailové šablony pro všechny automatizované komunikace: oznámení tipu, přepisy chatu, uvítací e-maily, resety hesel a systémová upozornění. HTML šablony s živým náhledem, variabilní čipy ({{customer_name}}, {{ticket_id}}), a globální řízení rozložení.
Dovoz a vývoz
Importovat kontakty, vstupenky, a znalosti články z CSV/JSON. Exportovat data návštěvníků, analytické zprávy a CRM záznamy. Přenosnost dat pro migraci mezi systémy.
Bezpečnost, dodržování předpisů a operace
Podniky SSO
OIDC (OpenID Connect) single sign- on s plným runtime: objev, autorizace, call back, ověření podpisu JWKS, userinfo, domain allow- list, JIT supporting, a status guards. SAML podpora konfigurace.
GDPR a dodržování údajů
Stavební- in DSAR (žádost o přístup k datovému subjektu) manipulace: export a smazání dat zákazníků ve všech systémech. Kontact- level data vymazávání krytí sessions, vstupenky, chaty, CRM záznamy, a e-mailové protokoly. Souhlas řízení a retence politiky.
IP blokování a ochrana proti bruta- force
Specifický blok IPs nebo se pohybuje od přístupu na vaše stránky nebo admin. Automatické výluka po konfigurovatelných neúspěšných přihlašovacích pokusů. Selhání přihlášení log s IP, časové razítko, a uživatelský agent.
HSTS a bezpečnostní záhlaví
HTTP Strict Transport Security, Permissions-Policy headders, a zabezpečené nastavení cookie. Self- hostované depogace mohou přidat CSP hlavičky přes konfiguraci serveru.
Vytvrzování odchozích webháků
SSRF zabezpečení blokuje webháky na soukromá / metadata IP rozsah. Async dodávka zabraňuje pomalé koncové body od blokování vaší aplikace. Auto- zakázat po 15 po sobě jdoucí selhání zabraňují vzniku odpadu ze zdrojů na slepých koncích.
Izolace pracovního prostoru
Přísná izolace dat mezi pracovními prostory. Návštěvníci, vstupenky, chaty, CRM záznamy a AI konverzace jsou prozkoumány do jejich pracovního prostoru. Kros- workspace data úniky jsou zabráněny na dotaz vrstvy.
Řízení cyklu účtování
Podpora měsíčních, čtvrtletních, poloročních, ročních, dvouletých a celoživotních výkazních cyklů. Normalizace měny pro víceměnné brány. Převod FX na příjem plateb pro přesné vykazování příjmů.
Cron a plánovaná automatizace
Stavební- in cron systém pro plánované úkoly: generování zpráv, čištění dat, obnovování předplatného, aktualizace AI školení, konektorové syncs a retry webhooku. Zdravotní diagnostika s varovnými indikátory.
Zásady uchovávání údajů
Nastavit, jak dlouho jsou uchovávány návštěvní sezení, přepisy chatu, historie AI konverzace a záznamy událostí. Automatické čištění starých dat pro správu úložiště a dodržování retenčních zásad.
Diagnostika a zdraví
Systém zdraví palubní deska zobrazující cron status, připojení databáze, AI poskytovatele stavu, konektor zdraví, přenosová rychlost webhook a použití úložiště. Upozornění pro problémy konfigurace a výkonnostní nedostatky.
Pro koho je OpsIQ
Obchod s elektronickými technologiemi
Zásoby
Sledovat každého návštěvníka od přistání k nákupu. Nechte AI odpovědět "Kde je moje objednávka?" pomocí živé Shopify/WooCommerce/ BigCommerce data. Správa podpůrných vstupenek s AI automatickou odpovědí. Spustit deal ropovod pro velkoobchodní a B2B vede. Atribut příjmy na dopravní zdroje a kampaně. Monitor opuštění vozíku s obnovením pracovních toků.
SaaS a softwarové společnosti
SaaSCity in Saskatchewan Canada
Monitor zkušební signups a funkce přijetí s relace přehrávání. Track, které dokumentační stránky převést. Automatizovat podporu s AI uzemněné ve vašem API Dokumenty. Správa předplatného a expanze obchodů v CRM. Připojte svou platformu fakturace (Stripe, WHMCS) pro real-time MRR sledování. Použijte CRM životního cyklu agent odhalit a zabránit churn.
Agentury a nezávislí pracovníci
Agentura
Nabídněte klientům analýzu a podporu portálů pro bílé štítky. Track vede přes více klientských stránek z jednoho adminu. Pomocí potrubí CRM pro správu perspektiv a projektových vedení. Vytvořte vlastní konektory pro klientské platformy pomocí Connector Builder. Generovat značkové SEO zprávy s Site Intelligence. Resell Marketing konektory jako ceníku-add služby.
Hosting a infrastruktura
Hosting
Hluboký WHMCS integrace s 80+ AI akce pro vyhledávání objednávek, řízení služeb, DNS, a zálohování. Automaticky-odpověď na běžné hostingové otázky pomocí znalostí základních článků. Track server status stránka zapojení. Správa technické podpory vstupenky s AI triage. Použijte fakturační cyklus žebříčku pro měsíční přes celoživotní hosting plány.
Podpůrné podniky
Podpora
Deflect 40-70% Zbavte se opakujících se dotazů pomocí chatu s umělou inteligencí založeného na vaší znalostní bázi. Směrujte tikety správnému oddělení pomocí třídění pomocí umělé inteligence. Sledujte výkon týmu pomocí časů řešení, souladu se smlouvami SLA a CSAT podle agenta.
Marketingové a SEO týmy
Uvádění na trh
Full Site Intelligence suite: plazy, technické SEO audity, analýza obsahu, SERP sledování pořadí, klíčová slova výzkum, sledování backlink a místní SEO mřížky. Google Business Profile management. Naplánované zprávy o bílé značce pro klienty. A / B testování zabudované do sledovacího widget. Kampaň přiřazení přes všechny kanály.
Skládací a malé týmy
Startupy
Začněte jen sledovat a chatovat, zdarma přidat. Pak přidejte tipy, když dostanete podporu hlasitosti. Zapněte CRM, když začnete prodávat. Připojte platformy, jak je adoptujete. OpsIQ šupiny od jednoho člověka, který dělá všechno až po 50-osobní operační tým s RBAC, oddělení, a peragent sledování výkonu.
Podniky a multi- značka
Podnik
Podniky SSO s OIDC pro centralizovanou autentizaci. Multi- workspace izolation for separate brands or divisions. Per- working AI konfigurace s různými poskytovateli a modely. Vlastní vývoj konektoru s distribucí na trhu. Audit trasy, GDPR nástroje pro zajištění souladu a politiky uchovávání údajů.
Co nahrazuje OpsIQ
Google Analytics + Hotjar + Přípustné
Kompletní webové stránky analytika s návštěvníkem sledování, relace přehrávání, žebříčku stránek, geo inteligence, záměry nálevky, konverze přiřazení, události, A / B experimenty, a JS chybové sledování, všechny privacy-friendly, vše v jedné platformě.
Intercom + Drift + Tidio
AI- poháněný zákaznický chat s uzemněním znalostí, multi@-@ poskytovatel AI podpora, autohandoff na lidi, proaktivní chat pravidla, historie konverzace, CSAT průzkumy, a vytvoření vstupenek z chatu.
Zendesk + Freshdesk a pomocný skautský
Původní systém vstupenek s odděleními, priority, SLA, AI triage, automatická odpověď s konfigurovatelným zpožděním, e-mailové požití, vstupenky vkládané, sloučení jízdenky, inbox copilot, a vrátit se do AI schopnosti.
HubSpot + Pipedrive + Prodejní síla
AI- první CRM se čtyřmi specializovanými agenty AI (správce, SDR, Retention, Analyst), Trust Dial autonomie řízení, potrubí deska, deal koučování, prognózy, sekvence, životní cyklus řízení, a přírodní jazyk CRM konfigurace.
Ahefs + SEMrush + Moz
Zpravodajská služba se systémem automatických plazit, technické SEO audity, analýza obsahu, hledání AI, sledování řadových SERP, výzkum klíčových slov, analýzy backlink, lokální SEO mřížky a pravidelné zprávy o bílé značce.
Zapier + Make + vlastní middleware
Konektor SDK s 25+ představené konektory, Connector Builder (no-code / AI-assisted / full- code), OAuth flow, webhook auto- registrace, velký katalog konektorových definic akce, které se stanou spustitelné pouze tehdy, když je příslušný konektor nainstalován, povolen, konfigurován a validován, SmartLookup, tržiště, a podepsané balíčky.
Správce profilu Google Business
Full GBP konektor: Review management, post publishing, Q & A management. Uploadování fotografií, synchronizace obchodních informací, sledování náhledů a AI- poháněné recenze, vše zevnitř OpsIQ.
Samostatné nástroje pro šablonu e-mailu
Registry-řízené e-mailové šablony s vizuálním editorem, živý náhled, proměnné čipy, globální řízení rozložení a per- event přizpůsobení pro všechny automatizované komunikace.
Dashboardy pro správu týmu
Stavební- v týmovém výkonu: doba rozlišení, pracovní zátěž, SLA compliance, CSAT agent, znovuotevření sazeb, nejrušnější hodiny, real-time sledování přítomnosti a per- oddělení členění.
Nástroje pro přizpůsobení se GDPR
Původní DSAR manipulace, vymazání dat ve všech systémech, řízení souhlasu, retenční politiky a auditní cesty, zabudované do platformy, není přišroubován.
Dvě vydání
Zařazování hostitelů
OpsIQ běží na řízenou infrastrukturu. Provoz produktů je stejný; infrastruktura, aktualizace a zálohy jsou zpracovávány operátorem hosting. Tato příručka dokumentuje OpsIQ runtime spíše než marketing nebo obchodní účty toky.
Modul Self- hostovaný
Instalovat OpsIQ na vašem vlastním serveru pro plnou kontrolu nad daty, značkováním, aktualizacemi a integrací. Vyžaduje PHP 8.4+, MySQL 5.7+ nebo MariaDB 10.3+, HTTPS a OpsIQ sjednocené cron. Podporuje WHMCS Integrace jako addon modul, plná suverenita dat.
Doporučené pořadí čtení
1
Rychlý start
Následujte ípa 30-minutové nastavení průvodce pro sledování, chat a základní AI pracuje na vašich webových stránkách.
2
Přístrojová deska a analytika
Přečtěte si, jak číst data návštěvníků, nastavit relaci přehrávání, identifikovat vodítka a pochopit dopravní vzory.
3
Zpravodajská služba na místě
Spustit první SEO plazení, zkontrolovat své technické zdraví, a nastavit SERP hodnocení sledování pro vaše cílové klíčová slova.
4
Vstupenky a podpora
Nastavit oddělení, nastavit automatickou odpověď s AI, připojit e-mailové požití, a trénovat vaše AI zvládnout běžné otázky.
5
CRM
Organizovat kontakty, budovat plynovod, konfigurovat AI agenty, nastavit úroveň Trust Dial, a nechat AI trénovat vaše nabídky.
6
Konektory a vývojové nástroje
Připojte svou platformu pro ecommerce / fakturaci, vytvořte vlastní konektory, nastavte webové háky a integrujte se prostřednictvím REST API.
💡
Nové OpsIQ? Začněte s průvodcem Quick Start níže. Můžete mít sledování a základní AI chat běží v rámci 30 Minuty.
Začněte tady.
Rychlý start v 30 minutách
Postupujte podle těchto kroků, aby se OpsIQ běží. Každý krok staví na předchozí. Do konce budete mít návštěvník sledování, AI chat a základní podporu vstupenek.
NastaveníU 30-minutová cesta: nainstalovat widget, připojit platformu, trénovat AI, pozvat tým, pak jít živě.
U 30-minutové nastavení
1
Aktivujte licenci
Zadejte licenční klíč do adminu OpsIQ. Přejděte na Nastavení, zadejte licenční klíček dodávaný pro tuto instalaci a klikněte na Aktivujte. Měli byste vidět zelený odznak "Aktivní".
2
Nastavit svou obchodní identitu
Přejděte na Nastavení a vyplňte své obchodní jméno, průmysl, časové pásmo, výchozí měna a hodiny podpory. Tyto informace používá AI při odpovídání na dotazy zákazníků a analytiky pro zprávy o čase.
3
Vyberte poskytovatele AI
Přejděte na AI konfiguraci a vyberte svého poskytovatele. Možnosti: Claude (Anthropic), GPT- 4o (OpenAI), Gemini Zadejte svůj seznam API klíč, pokud používáte vlastní klíč, nebo použít Managed AI, pokud je k dispozici ve vašem plánu. Klikněte na "Zkušební připojení" pro ověření.
4
Nainstalovat widget pro sledování
Go to Connected Sites, copy the tracking snippet, and paste it before the closing </body> tag on your website. Visit your site in a private browser, then check the Live Feed in OpsIQ. You should see yourself as a visitor within 15 seconds.
5
Připojte platformu
Jestliže jste užil (a) Shopify, WooCommerce, WHMCS, nebo jinou podporovanou platformu, přejděte do Connectors, najít svou platformou, zadejte pověření a klepněte na tlačítko Test Connection. To dává AI přístup k objednávkovým datům, zákaznickým profilům a podpoře kontextu.
6
Pozvěte svůj tým
Přejděte do týmu, klepněte na tlačítko Pozvat, zadejte jejich e-mail a roli (Majitel, Full Admin, nebo Agent). Agenti mohou přístup pouze oddělení, kterým je přiřadíte. Majitelé a Full administrativa vidět všechno.
Nejrychlejší možná cesta (5 minuty)
Krok 1: Nainstalovat widget
Kopírujte odstřižek z připojených stránek a vložte jej na své webové stránky. To vám umožní okamžitě sledovat.
Krok 2: Povolit AI
Přejděte na AI Konfigurace, vyberte poskytovatele, zadejte svůj klíč, a uložit. AI chat je nyní aktivní na vašich webových stránkách.
Hotovo.
Nyní máte návštěvníky sledování a AI chat. Můžete přidat vstupenky, CRM a konektory později.
Den 2: Ať je to užitečné
Přidat znalosti
Přejděte na znalostní základnu a přidat 5-10 články o vašich nejčastějších otázek. AI používá tyto odpovědi zákazníkům přesně.
Vytvořit oddělení
Přejděte na vstupenky a vytvořit alespoň 2 oddělení (např. "Sales" a "Support"). Přiřaďte členy týmu pro každého.
Napište svůj AI příkaz
Přejděte na AI školení a napsat zákaznický AI příkaz, který popisuje vaše podnikání, tón a eskalační pravidla.
Otestujte rozhovor
Otevřete své webové stránky v soukromém prohlížeči a chatovat s AI jako zákazník. Zkontrolujte, zda odpovědi jsou přesné a tón je správný.
Týden 1: Budovat své operace
Připojit email
Vytvořte si poštovní schránku (Gmail, IMAP, nebo konektor poskytovatele), takže zákaznické e-maily automaticky vytvářet tipy.
Nastavit automatickou odpověď
Povolit automatické zodpovězení jízdenky pro bezpečné oddělení. Nastavte 2-minutové zpoždění, aby lidé mohli zasáhnout jako první.
Analytika přezkumu
Zkontrolujte Dashboard denně. Podívejte se na počet návštěvníků, rychlost odrazu, horní stránky, a prodeje, pokud je spojení sledování.
Spusťte CRM
Otevřete AI CRM a nechte OpsIQ importovat kontakty z připojených platforem.
Měsíc 1: Optimalizace
Přezkum historie AI
Zkontrolujte AI Historie týdně. Hledejte špatné odpovědi, nezvěstné otázky a možnosti přidat znalosti.
Přidat proaktivní pravidla
Vytvořte pravidlo: pokud je návštěvník na stránce cen pro 60+ sekund, zobrazí chatovací zprávu, která se ptá, zda potřebuje pomoc.
Vybudovat konektor
Pokud používáte platformu, která nemá vestavěný konektor, použijte Connector Builder a vytvořte jej.
Nastavit webové háčky
Připojte OpsIQ k vašim vnitřním nástrojům pomocí odchozích webháků pro vstupenky, chat a prodejní akce.
Můžu přeskočit AI a prostě použít sledování?+
Ano. Poskytovatel umělé inteligence je volitelný. OpsIQ funguje jako čistá platforma pro analýzu a vyřizování požadavků bez umělých inteligencí. Umělou inteligenci můžete povolit později, až budete připraveni.
Můžu přeskočit konektory a přidat je později?+
Ano. Konektory obohatí AI o platform- specific data, ale OpsIQ funguje bez nich. Začněte se sledováním a chatem, pak připojte platformy, když je potřeba.
Co když ještě nemám webovky?+
Stále můžete použít OpsIQ pro vstupenky, CRM a týmovou spolupráci. Sledovací widget je volitelný. Přidejte jej, když vaše webové stránky jsou připraveny.
Jak mám vědět, jestli je widget nainstalován správně?+
Navštivte své webové stránky v soukromém / inkognito prohlížeči. OpsIQ Živé krmivo. Měli byste vidět svou návštěvu objeví v 15 Pokud ne, zkontrolujte: (1) je odstřihovač správně vyražený, (2) je klíč k webu správně, (3) jsou reklamní blokátory nebo hlavičky CSP blokují skript.
Začněte tady.
Kompletní mapa produktů
OpsIQ není jedna funkce. Jedná se o operátor admin, widget webové stránky, AI podpěrná vrstva, tiket / helpdesk systém, plný CRM se čtyřmi agenty AI, Site Intelligence suite, konektorová platforma s tržištěm, a vývojářský povrch. Zde je každý komponent, který obsahuje.
Admin
Přístrojová deska, živé krmivo, záznam návštěvníků, sezení, replay session, top stránky, geo inteligence, intent funnel, záznamy událostí, A / B experimenty, JS chybové sledování, prodej a konverze, vede, AI CRM (velící centrum, kontakty, společnosti, obchody, ropovod, koučování, předpověď, vyhledávání, sekvence, životní cyklus, data steward, Build my CRM, CRM config, CRm health, CRMName API), vstupenky, chat inbox, proaktivní pravidla, CSAT průzkumy, e-mailové návrhy, poštovní schránky, konfigurace AI, AI školení, Al historie, AL poznatky, znalostní základny, konektory, Connector Builder, tržiště, připojené stránky, týmové řízení, týmový výkon, nastavení, diagnostika a licence.
Povrchy orientované na zakázku
Widget sledování webových stránek (analytics maják + chat + vstupenka vložena + znalosti základní vyhledávání), klient AI chat, portál pro předkládání vstupenek, návštěvník Token manipulace, nahrávání souborů, CSAT průzkum widget a uživatelsky orientované centrum nápovědy.
AI- První CRM
Velící centrum, kontakty, společnosti, obchody, pipeline board s drag-and-drop, AI koučování (signály rizika, další nejlepší akce, pravděpodobnost výhry), prognóza tržeb, agent pro vyhledávání (SDR), automatizované následné sekvence, řízení životního cyklu a uchovávání dat, správce dat (dedup, obohacení, ověření), vytvořit CRM (nastavení přirozeného jazyka), konfiguraci CRM, kontrolu stavu CRM, Trust Dial (Autopilot / Copilot / Manuál na agenta), čtyři specializované agenty (Steward, SDR, Retention, Analyst) a CRM API s webhooky.
Sídlo zpravodajské služby
Automatizované plazy, technický SEO audit (rychlost, mobilní, hlavní web Vitals, SSL, přesměrování, strukturovaná data), audit obsahu (počet slov, čitelnost, hustota klíčových slov, struktura kurzu), AI- poháněné sémantické vyhledávání, SERP hodnocení sledování napříč motory, klíčová slova výzkum s možností bodování, analýzy a monitorování backlink, místní SEO mřížka vizualizace, Google Business Profil synchronizace (recenze, příspěvky, Q & A, fotografie, pohledy), plánované zprávy (denní / týdenní / měsíční), a white- label PDF výstupy pro agentury.
AI a automatizace
Zákazník AI chat (multiposkytovatel: Claude, GPT-4o, Gemini, Grok), admin AI asistent, AI znalosti uzemnění, autohandoff s konfigurovatelným revert, per- workspace AI konfigurace, řízený AI a BYOK režimy, token rozpočty a kontroly nákladů, AI historie auditní stopa, AL analýzy náhledů, vstupenky AI triage, jízdenka autoodpověď s zpožděním, psaní AI (samostatný čas), a admin inbox copilot.
Konektory a integrace
25+ předkonstruované konektory (Shopify, WooCommerce, BigCommerce, Magento2, PrestaShop, OpenCart, osCommerce, WordPress, WHMCS, Zendesk, Stripe, Amazon SES, Postmark, Resend, SendGrid, Mailgun, Gmail, IMAP, Slack, Google Business Profile), Connector Builder (no-code / AI-assisted / full- code), generický OAuth tok s PKCE, konektorové tržiště s placenou distribucí, podepisování a ověřování konektorů, SmartLookup fuzzy odpovídající, velký katalog HTTP definice akcí, jehož dostupnost závisí na instalaci konektoru, enablement, konfiguraci a validaci, synchronizaci znalostí a receptů workflow.
Vývojářská platforma
RESTAPI(návštěvníci, akce, vstupenky, kontakty, nastavení, konektory), OpenAPI spec,API správa klíčů, odchozí webháky (async, signed, resoured, SSRF- hlídané, automatická), UdálostiAPI pro vlastní požití události, widget SDKs rozlišením identity, spouští kuchařku, akční smlouvy, konektor SDK, balení na trhu, serverside SDK (PHP, Node.js), WordPress plugin a WHMCS modul.
Nastavení a provoz
Obchodní identita, konfigurace AI na pracovní prostor, nastavení sledování, zabezpečení (HSTS, Povolení-Policy, IP blokování, brute- force ochrana), RBAC (Vlastník / Full Admin / Agent), řízení a pozvánky týmu, výkon týmu palubní deska, admin sledování, e-mailový šablona systém (registračním-řízený, vizuální editor, variabilní čipy), projektant průzkumu, doménové znalosti, vstupné vložené konfigurace, branding, politika uchovávání dat, správa účtovacího cyklu (měsíční přes celý život), normalizace měny, import / export, diagnostika, cron automatizace, a nebezpečné zóny.
Bezpečnost a dodržování předpisů
Podniky SSO (OIDC s ověřením JWKS, zajištění JIT), SAML konfigurace, GDPR/DSAR manipulace (export a mazání ve všech systémech), vymazání dat na kontaktní osobu, řízení souhlasu, izolace pracovního prostoru (přísné monitorování query- layer), auditní stopy, neúspěšné sledování přihlášení, IP blokování, odchozí webhook SSRF zabezpečení, a politika uchovávání dat.
Provider bridge
Spravoval AI proxied through OpsIQ Poskytovatel URL, Volání poskytovatele zpravodajských služeb na webových stránkách, potvrzení licence, zdravotní zprávy, PDF vykreslování a export dat, všechny směrované přes nakonfigurovaný cílový parametr poskytovatele, nikoli přímý prodejce API telefonáty z vašeho serveru.
Každá admin stránka
Přístrojová deska
hlavní
Denní řídící centrum: přehled provozu, počet návštěvníků, shrnutí prodeje, hloubka fronty podpory, upozornění na aktivitu AI a rychlé akce.
Živé krmivo
Analytika
Real- time návštěvník stream: zobrazení stránky, chat začíná, formuláře podání, a intent signály aktualizace každých pár sekund s filtry země, zařízení, a reference.
Deník návštěv
Analytika
Kompletní záznamy návštěv: zařízení, prohlížeč, OS, země, město, referent, UTM params, přistávací stránka, identita, a plné historie zobrazení.
Zasedání
Analytika
Cesta - skupinový pohled: stránka průtok, čas na stránce, posuvná hloubka, cesta k převedení a výstupní stránka pro každou návštěvu zasedání.
Přehrávání relací
Analytika
Časové přehrávání zachycených událostí: pohyb myši, kliknutí, svitky, přechody stránky a formy interakce pro diagnózu UX.
Horní stránky
Analytika
Hodnocení výsledků stránky: návštěvy, čas zapojení, rychlost odrazu, konverze, podpora interakcí a směr trendu.
Geointeligence
Analytika
Geografické zprávy: členění země / města s mapami, distribucí zařízení, sdílením prohlížeče, zdroji dopravy a proniknutím na trh.
Záměrná trychtýř
Analytika
Behaviorální sledování záměru: cenové návštěvy, frekvence návratnosti, procházení doc, podpora interakcí a vlastní signály s pravděpodobností konverze.
Záznam událostí
Analytika
Vyhledatelné historie událostí: zobrazení stránek, vlastní události, chaty, nákupy, formuláře podání s plnou metadata a filtrování.
Experimenty A / B
Analytika
Rozdělení testování: vytvořit varianty, alokovat provoz, definovat cíle, měřit význam, a prohlásit vítěze, vše zevnitř OpsIQ.
Chyby JS
Analytika
Zachycení chyb: zprávy, stohové stopy, postižené prohlížeče, frekvence, ovlivněné stránky a sledování trendů.
Prodej
Prodej
Příjmy: objednávky, obnova, náhrady, přidělení podle zdroje, výkon kampaně, srovnání období a analýza trendů.
Plné CRM: řídící centrum, kontakty, společnosti, obchody, potrubí, koučování, předpověď, vyhledávání, sekvence, životní cyklus, správce dat a zdraví.
Vstupenky
Podpora
Inbox podpory: oddělení, priority, sledování SLA, AI triage, automatická odpověď, interní poznámky, soubory příloh, sloučení a řízení stavu.
Zapisovač chatu
Podpora
Živé konverzace: AI a lidský chat, předání, spolupráce, historie konverzace, identity zákazníka, a CSAT kolekce.
Koncepty e-mailů
Podpora
Správa e-mailu: příchozí pošta k vstupním stránkám, složení odpovědí AI- asistované odpovědi, výběr šablon a konfigurace schránky.
Konfig AI
AI
Nastavení poskytovatele: vyberte Claude / GPT-4o /Gemini/ Grok, enter API klíčové nebo umožňují řízený AI, nastavit model, teplotu a symbolické rozpočty na pracovní prostor.
Audit konverzace: úplné žádosti / protokoly odpovědí, používání tokenu, náklady na rozhovor, poskytovatel, verze modelu a výsledek řešení.
Náhled AI
AI
Analýza vzorců: společné otázky, míra rozlišení, četnost předání, spokojenost podle témat a identifikace mezery v výcviku.
Znalostní základ
AI
Obsah AI školení: články, FAQ položky, produktové dokumenty, konektorové znalosti a vlastní vstupy. Semantické a klíčové slovo hledání AI uzemnění.
Konektory
Integrace
Integrační hub: instalované konektory, zdravotní stav, akční inventář, akreditační řízení, prohlížeč trhu a Connector Builder.
Připojená místa
Nastavení
Správa stránek: sledování odstřihovač, klávesa stránky, konfigurace widget, nastavení domény a izolace pracovní plochy na per- site.
Tým
Nastavení
Správa uživatelů: pozvi členy, přiřaď role (Vlastník / Full Admin / Agent), nastavte přístup oddělení a spravujte oprávnění.
Výkonnost týmu
Nastavení
Operační metrika: doba rozlišení, pracovní zatížení, SLA compliance, CSAT agent, znovu otevřené sazby, nejrušnější hodiny a analýza trendů.
Nastavení
Nastavení
Konfigurace: obchodní identita, nastavení AI, sledování, zabezpečení, značení, retence, e-mailové šablony, fakturace, import / export, diagnostika a nebezpečná zóna.
Licence
Nastavení
Řízení plánu: stav licence, funkce plánu, měřidla použití, datum obnovení a možnosti upgrade / snížení.
Začněte tady.
Vedení na palubě
Při nastupování se nová instalace změní v pracovní prostor OpsIQ a může být ponechána a obnovena bez ztráty pokroku.
Produktová obrazovkaNa palubě je zobrazeno každé nastavení oblasti, jeho současný stav a další akce k dokončení.
Doporučené pořadí
Licence: Potvrďte platnost licence a potvrďte, že pracovní prostor je aktivní.
Poskytovatel AI: vyberte poskytovatele / model, zadejte pověření a spusťte test připojení. AI lze přeskočit, pokud pracovní prostor bude zpočátku používat pouze analytiky a vstupenky.
Obchodní identita: nastavte název, průmysl, popis, tón a podrobnosti značky pro zákazníky používané widgetem a AI.
Konektor: umožní alespoň jednu vnější platformu, pokud OpsIQ potřebuje objednávky, zákazníky, vstupenky, e-mail nebo jiný kontext platformy.
Umístění a widget: vytvořit místo / pracovní prostor, zkopírovat klíč stránky a ověřit soukromou návštěvu prohlížeče v Live Feed.
Tým a směrování: pozvat administrátory / agenty, vytvořit oddělení, nastavit e-mailové směrování a potvrdit preference oznámení.
Živé kontroly: testovací chat, vstupenka, synchronizace konektoru, cron, externí e-mail, webháky a bezpečnostní záhlaví.
Cesta ukládá dokončení na pracovní prostor. Návrat na Onboarding by měl ukázat dokončené kroky, spíše než vynutit restart.
Začněte tady.
Administrátorská navigace a oprávnění
Firemní sidebar OpsIQ je si vědom povolení. Tato mapa vysvětluje, kde každá operační oblast žije a proč stránka nemusí být pro každého správce viditelná.
Produktová obrazovkaSkupiny sidebar OpsIQ podle oblasti práce; jednotlivé odkazy se objevují pouze tehdy, když je může využít aktuální role.
Podpora
Vstupenky, týmová e-mailová platforma, CSAT, Pomocné centrum a chatbot proudí.
CRM
Denní prodejní plochy: CRM Home, Command Center, kontakty, potrubí, předpověď, životní cyklus, vyhledávání, segmenty, žebříček, schválení, data steward, růstové nástroje a tok aktivity.
Automatizace
Pracovní toky, pravidla životního cyklu a cíle přeměny.
Report povrchy první - Analytics Hub, AI vhled, prodej, zákazníci, vedení, nádobky, A / B testy, replay relace, vlastní palubní desky a plánované zprávy - se syrovým návštěvníkem, sezení, strana, geografie a události protokoly v sekci Raw Data.
Samostatné stránky
Zpravodajská služba, Team Performance a Zpětná vazba sedí mimo skupiny jako přímé vstupy.
Integrace
Konektory, akce a spouštěče, poštovní schránky, návrhy, nastavení e-mailu, příchozí koncové body, odchozí webháky a API klíče.
Bezpečnost a soukromí
Přehled bezpečnosti, soukromí a dodržování předpisů, souhlas se soubory cookie, auditní činnost, neúspěšné přihlášení, blokovanéIPsaJavaScriptchyby.
Nastavení
Základy pracovního prostoru (obecné, týmy, místa, jazyky), pak skládací podsekce: AI Brain (pokyny, konfigurace, hodnocení, historie), CRM Setup (stavitel, zakázková pole, olovo bodování, zdraví), Data & Health (diagnostika, export) a Getting Started (on-boarding, pomoc).
Stránky, které role nemůže otevřít, jsou skryty z postranního panelu. Stránky současný plán nezahrnuje zůstat viditelný s Aktualizovat označte a otevřete obrazovku pro upgrade in- app.
Přímé trasy jsou stále kontrolovány serverside. Ukrytí postranní linky není hranice bezpečnosti: každá chráněná akce musí projít povolením a kontrolou pracovního prostoru.
Analytika
Analytický uzel
Uzel Analytics přináší podporu, chat, AI, návštěvníka a agenta hlásícího se do jednoho data-filtrovaného pracovního prostoru s exportovatelnými výsledky.
Produktová obrazovkaAnalytics Hub ukazuje datový rozsah, metrické karty a karty pro podporu, Chat, AI, Návštěvník a Agent výkon.
Filtry a ovládací prvky
Použít přednastavený nebo vlastní od / do rozsah, pak Refresh obnovit každou kartu a graf pro stejné období.
Export CSV vyváží aktivní analytický pohled spíše než snímek obrazovky.
Prohlížení pracovního prostoru je automatické; změna stránek mění základní datový soubor.
Co každá karta měří
Podpora: jízdenky vytvořené / uzavřené / neplánované, první odpověď, rozlišení, řešení prvního kontaktu, SLA a členění priority / oddělení / status.
Chat: začala sezení, AI rozlišení, eskalace, opuštění, čas na manipulaci, zprávy na sezení, a AI / člověk / vše CSAT.
AI: průměrná spolehlivost, nízká míra spolehlivosti, přesnost měření, zpětná vazba, odklon znalostí, používání token / cache a položky, které potřebují přezkoumání.
Návštěvník: trendy provozu a zapojení pro zvolené období.
Agent: opatření pro pracovní zatížení, rychlost, uzavření a spokojenost osob.
Použijte analytický hrnec pro cross-team recenzi; použijte vyhrazené stránky Návštěvníků, Vstupenky, CSAT, AI Historie a Team Performance, když potřebujete record- level šetření.
Analytika
Přístrojová deska
Dashboard je vaše denní řídící centrum. Zobrazuje provoz, prodej, podporu zatížení, AI aktivity a konverzní ukazatele v jednom pohledu. Otevřete ji každé ráno pochopit, co se stalo přes noc a co potřebuje pozornost dnes.
Přístrojová deskaSkutečný Přehled obrazovky: OpsIQ Inteligence panel nahoru (vyberte analýzu a to píše) nad KPI widgets si uspořádat sami.
Vysvětlené karty s přístrojovou deskou
Živí návštěvníci
Počet lidí na vašich webových stránkách právě teď. To aktualizuje každý 15 sekund (konfigurovatelné). Návštěvník je "aktivní", pokud načte stránku v rámci aktivního prahu (přednastaveno: 90 sekund).
Jedineční návštěvníci
Kolik různých lidí navštívilo vaše webové stránky ve zvoleném datovém rozmezí. OpsIQ identifikuje návštěvníky kombinací otisků prstů prohlížeče, cookies a (pokud je k dispozici) ověřené identity.
Nové vs vrací
Noví návštěvníci se na vaše stránky podívají poprvé. Vrací se návštěvníci byli již dříve viděni. Vysoký poměr návratů znamená, že váš obsah lidi vrací zpět. Velmi nízký poměr návratu může znamenat, že si nezachováváte zájem.
Rychlost srážky
Procento návštěvníků, kteří odešli po prohlížení pouze jedné stránky. Odrazová rychlost nad 70% na přistávacích stránkách obvykle znamená, že stránka nesplňuje očekávání návštěvníka, špatný obsah, pomalé zatížení nebo špatné mobilní zkušenosti.
Průměrný čas na stránce
Jak dlouho návštěvníci tráví na každé stránce v průměru. Velmi krátké časy (pod 10 sekund) na stránkách obsahu naznačují, že obsah není aktivní. Velmi dlouhé časy na stránkách checkout může naznačovat zmatek.
Hrozby zablokovány
IPadresa, která OpsIQ identifikován jako potenciálně škodlivý na základě hodnocení hrozeb, hrubou sílu pokusy, nebo ruční bloky. Klikněte pro zobrazení blokované IPs seznam.
Prodej dnes / tento týden / tento měsíc
Příjmy z připojených prodejních zdrojů (Shopify, WooCommerce, Stripe, atd.). Pokud prodej ukáže nulu, zkontrolujte, zda je váš platformní konektor připojen a synchronizován.
Trendový graf
Liniový graf zobrazující počet návštěvníků v zvoleném datovém rozmezí. Hledejte vzory: dopravní špičky (kampaně, tiskové zprávy), dipy (víkendy, svátky) a trvalé trendy.
Hlavní zdroje
Tam, odkud pocházejí vaši návštěvníci: přímé, Google, sociální média, e-mailové kampaně, referration stránky. Použijte to pochopit, které marketingové kanály fungují.
Vrchní prohlížeče
Chrome, Safari, Firefox, Edge a další. Pokud prohlížeč má neobvykle vysokou rychlost odrazu, můžete mít CSS nebo JavaScript problém slučitelnosti.
Hodinová heatmap
Síť ukazující aktivitu návštěvníků v hodině dne a den týdne. Použijte to k rozhodnutí, kdy naplánovat podpůrné směny, kdy poslat oznámení, a kdy spustit povýšení.
Nedávné návštěvníky
Posledních pár návštěvníků se zemí, stránkou, zařízením a zdrojem. Užitečné pro rychlé kontroly během kampaně.
Použití filtru datového rozsahu
Klikněte na datum picker v pravém horním rohu přístrojové desky. Přednastavuje: Dnes, Včera, Poslední 7 dny, poslední 30 dny, Tento měsíc, Minulý měsíc, Vlastní rozsah. Všechny karty palubní desky a grafy aktualizovat při změně rozsahu. Datový rozsah je v nastaveném časovém pásmu (nastaven v Nastavení).
Opracované příklady
Vyšetření s mírou bounce
Scénář:
Your bounce rate jumped from 45% to 78% this week. What happened?
Co dělat:
Kontrola: (1) Změnila se konkrétní přistávací stránka? Přejděte na Top Pages a třídit podle rychlosti odrazu. (2) Poslal kampaň provoz na špatnou stránku? Zkontrolujte Top Zdroje pro nové reference. (3) Rozbila se stránka na mobilu? Zkontrolujte rozpis prohlížeče pro mobilní rychlost odrazu. (4) Je to robotická doprava? Zkontrolujte počitadlo hrozeb a detaily návštěvníků pro podezřelé vzory.
Na palubní desce není nikdo.
Scénář:
The dashboard shows 0 live visitors even though your website is getting traffic.
Co dělat:
Kontrola: (1) Je nainstalován widget sledování? Podívejte se na svůj zdrojový kód webové stránky a vyhledejte OpsIQ Scénář.2) Je klíč k webu správný? Porovnejte klávesu data- site-ve skriptu s klíčem v připojených stránkách. (3) Slouží CDN nebo cache stalou stránku bez skriptu? Vymažte si svou CDN cache. (4) Je reklamní blokátor nebo hlavička CSP blokuje skript? Pro zablokované požadavky zkontrolujte konzoli prohlížeče.
Čtení hodinové heatmap
Scénář:
Your heatmap shows heavy activity between 10am-2pm on weekdays but nothing on weekends.
Co dělat:
Jedná se o dopravní model B2B. Vaši návštěvníci jsou pracovní profesionálové prohledávání během pracovní doby. Důsledky: (1) Naplánujte podpůrný personál pro pracovní dobu ve všední den. (2) Poslat e-mailové kampaně úterý-čtvrtek ráno. (3Víkendová údržba oken je bezpečná. (4) Zvažte nabídku živého chatu pouze v době špičky.
Dopravní špička z neznámého zdroje
Scénář:
You see a sudden spike of 500 visitors in one hour from an unknown referrer.
Co dělat:
Přejděte do Návštěvníků a filtrovejte pomocí časového okna. Zkontrolujte: (1) Jsou to skuteční návštěvníci nebo roboti? Podívejte se na délku relace, stránky zobrazené a rozmanitost prohlížeče. (2Pokud je to skutečné, na jaké stránce přistávají? (3) Zkontrolujte, kdo je referrer URL. Někdo mohl mít spojení s vámi z Reddit, Hacker News, nebo populární blog. (4) Pokud je to bot provoz, zkontrolujte hrozby a zvážit blokování IP dosah.
Proč se můj návštěvník liší od Google Analytics?+
OpsIQ Počítá návštěvníky jinak. Používá snímání otisků prstů a cookies v prohlížeči, zatímco GA používá jiný model cookie. Filtrace bot, sazby reklamních blokátorů a příkaz k načítání skriptů může také způsobit rozdíly. 10-20% Rozdíly jsou normální.
Můžu dát palubní desku do jiného nástroje?+
Přístrojová deska je určena pro: OpsIQ admin. Pro externí reporting použijte REST API Vytáhnout data z analýzy a zobrazit je ve svém vlastním přístrojové desce nebo BI nástroji.
Co znamená "výhružky"?+
To se počítá. IP adresa, která OpsIQ má označený nebo blokován na základě hodnocení hrozeb, opakované neúspěšné loginy, nebo manuální bloky. Klikněte na pult vidět detaily a spravovat bloky.
Analytika
Deník návštěv
Návštěvnický deník zobrazuje každou návštěvu vašich sledovaných webových stránek. Každý řádek je jedna stránka zatížení od jednoho návštěvníka. Použijte ji pro zkoumání chování jednotlivých návštěvníků, najít provoz kampaně a diagnostikovat problémy s monitorováním.
Deník návštěvSkutečný záznam návštěvníků: filtrujte podle data, vyhledávání a zařízení, pak si přečtěte každou návštěvu IP/ email, umístění, zdroj, zařízení a čas, hrozby označené červeně.
Co každý řádek ukazuje
IP adresa
Návštěva IP adresa. Anonymizované, pokud IP anonymizace je povolena v Nastavení. Klikněte pro zobrazení všech návštěv z tohoto IP.
Země a město
Detekované zIP adresa pomocí GeoIP dat. Vyžaduje databázi MaxMind GeoLite2 nebo Cloudflare geo hlavičky. Zobrazí "Unknown", pokud není GeoIP nakonfigurován.
Strana URL
Stránka, kterou návštěvník nahrál. Kliknutím se zobrazí celá URLDlouhý. URLs jsou zkráceny v zobrazení tabulky.
Referrer
Tam, odkud návštěvník přišel před přistáním na vašich stránkách. "Direct" znamená žádný referenr (záložky, zapsaný URLs, některé odkazy aplikací).
Zařízení a prohlížeč
Typ zařízení návštěvníka (desktop, mobile, tablet) a prohlížeč (Chrome, Safari, Firefox, atd.).
Datum a čas
Když byla stránka načtena, ve vašem nastaveném časovém pásmu.
Identifikace zákazníka
Pokud je návštěvník identifikován (pomocí znaku totožnosti nebo přihlášení), objeví se jeho jméno nebo e-mail. Jinak je uveden jako anonymní.
Filtry
Rozsah data
Filtr navštíví konkrétní časové období. Výchozí: poslední 7 dny.
Hledat
Hledat podle IP adresa, strana URL, referrer, country, nebo zákaznický e-mail.
Zdroj
Filtr podle zdroje dopravy: Přímý, Organický, Sociální, Referral, Placené, Email.
Zařízení
Filtrovat pomocí Desktop, Mobile nebo Tablet.
Pouze nové
Ukažte jen první návštěvníky, kteří ještě nikdy nebyli viděni.
Opracované příklady
Najděte návštěvníky z konkrétní kampaně
Scénář:
You launched a Google Ads campaign with UTM parameter utm_source=google&utm_medium=cpc&utm_campaign=summer-sale. How do you find those visitors?
Co dělat:
V záznamu návštěvníků použijte vyhledávací pole a zadejte "summer- sale".URLs a strana URLs, takže parametry UTM budou odpovídat. Můžete také filtrovat pomocí Source = Placené zúžit dále.
Najít zákazníka, který nahlásil problém
Scénář:
A customer emailed saying "your checkout page was broken yesterday around 3pm." How do you find their session?
Co dělat:
Hledat jejich e-mailovou adresu v záznamu návštěvníků. Pokud byly přihlášeny, jejich identita se objeví. Nastavte rozsah data na včerejšek. Podívejte se na návštěvy stránek Checkout kolem 3pm. Klikněte na jejich relaci vidět plný tok stránky a jakékoli JavaScript chyby.
Detekovat smyčku odpalovač nebo škrabač
Scénář:
You notice an IP address has 500+ visits in one hour, all to the same page.
Co dělat:
Toto je pravděpodobně robot, škrabadlo, nebo rozbitý skript. Přejděte do záznamu Návštěvníků a vyhledejte tím IP Kontrola: (1Jsou všechny návštěvy na stejné stránce? (2Je uživatelský agent známý jako robot?3) Je doba trvání zasedání vždy 0 Pokud je potvrzen jako robot, jděte do ochranky a zablokujte IP.
Návštěvníci log vs Sessions vs Živé krmivo
Deník návštěv
Syrové zatížení stránky. Jeden řádek na stránku pohledu. Nejlepší pro: zkoumání konkrétních stránek, hledání provozu ze specifických zdrojů, diagnostika problémů sledování.
Zasedání
Skupiny stránky zobrazení do cest. Jeden řádek za návštěvu relace. Nejlepší pro: porozumění toku uživatelů, měření trvání sezení, identifikace konverzních cest.
Živé krmivo
Real- time aktivity. Zobrazuje návštěvníky v současné době na vašich stránkách. Nejlepší pro: sledování kampaně v průběhu, pozorování high-intent návštěvníků, sledování možností podpory.
Proč vidím v deníku vlastní návštěvy?+
OpsIQ sledovat všechny návštěvy ve výchozím nastavení. Chcete-li vyloučit svůj vlastní provoz, přidat IPadresa vyloučeného IPs seznam v Nastavení > Sledování.
Proč návštěvník ukazuje "Neznámá" země?+
GeoIP vyhledávání vyžaduje buď Cloudflare geo záhlaví (automatické, pokud se používá Cloudflare) nebo soubor databáze MaxMind GeoLite2. Zkontrolujte Nastavení > GeoIP Path, aby byl soubor databáze čitelný a dostupný.
Jak dlouho jsou uchovávána data o návštěvách?+
Data návštěvníků jsou uchovávána pro retenční období nakonfigurované v Nastavení (výchozí: 90 dny). Poté jsou staré záznamy automaticky vyčištěny úlohou cron retence.
Analytika
Zasedání
Sessions skupina více zobrazení stránek od stejné osoby do jedné cesty. Zatímco záznam návštěvníků ukazuje jednotlivé stránky zatížení, Session vám ukázat, jak lidé pohybovat přes vaše webové stránky od přistání k východu.
ZasedáníReálný Session Log: každá návštěva jako řada (IP, země, zařízení, zdroj, trvání a stránky) s riskantní sezení označená červeně.
Jak to funguje.
Session začíná, když návštěvník načte první stránku. Pokračuje v navigaci na více stránek. Sezení končí, když je návštěvník neaktivní pro dobu trvání relace (výchozí: 30 minuty) nebo zavře svůj prohlížeč. Stejná osoba se vrací po timeout vytvoří nové session.
Co každé sezení ukazuje
První strana
Na přistávací stránce, kde návštěvník vstoupil na vaše stránky. To vám řekne, který obsah je přitahuje lidi.
Poslední strana
Výstupní stránka, kde návštěvník odešel. Pokud je výstupní stránka často cenovou stránkou, návštěvníci mohou být srovnání vás s konkurenty.
Počet stran
Kolik stránek návštěvník prohlížel v tomto zasedání. Více stránek obvykle znamená více angažovanosti, ale to může také znamenat, že návštěvník je ztracen.
Doba trvání
Celkový čas od první stránky zatížení do poslední aktivity. Sessions with 0 seconds are shopces (single page view, no further interaction).
Zdroj
Zdroj dopravy pro toto sezení (Direct, Google, sociální, referred, atd.).
Země
Zjištěná země z návštěvní adresy IP.
Bounce
Zda návštěvník odešel po prohlížení pouze jednu stránku. Odhozené sezení mají červený indikátor.
Převod
Zda návštěvník během této relace dokončil akci konverze tratě (nákup, signup, odeslání formuláře).
Filtry
Hledat
Hledat podle IP, e-mail, strana URL, nebo referent v rámci zasedání.
Typ
Filtrovat novými návštěvníky (první sezení vůbec) nebo Vrací návštěvníky.
Zdroj
Filtrujte pomocí dopravního zdroje.
Země
Filtrovat podle země, aby se na sezení z určité oblasti.
Hrozby / odhození
Filtr ukazuje pouze odhozené sezení nebo sezení označená jako hrozby.
Opracované příklady
Profil vysoce hodnotného zákazníka
Scénář:
A customer just made a large purchase. You want to understand their journey before buying.
Co dělat:
Hledat jejich e-mail v Sessions. Podívejte se na všechny jejich zasedání: (1) Kolikrát byli navštívit před nákupem? (2Na které stránky se podívali?3Použili chatování nebo si otevřeli lístek?4) Jaký byl celkový čas od první návštěvy k nákupu? To vám říká typickou nákupní cestu pro vysoce hodnotné zákazníky.
Zjistit přihlášení z nového místa
Scénář:
A customer usually logs in from Nigeria but you see a session from Russia.
Co dělat:
Hledat zákaznický e-mail v Sessions. Porovnejte zemi nedávných zasedání. Pokud se z neobvyklé země náhle objeví sezení, mohlo by to být legitimní cestování nebo poškozený účet. Zkontrolujte: (1) Byl neúspěšný pokus o přihlášení před úspěchem? (2) IP změna v rámci stejné relace? Označit ji k přezkoumání, pokud je podezřelé.
Jaký je rozdíl mezi sezením a návštěvou?+
Návštěva je osoba (nebo prohlížeč). Jedinou návštěvou je návštěva od této osoby. Stejný návštěvník může mít mnoho sezení v čase. Sessions končí po timeout období.
Jak OpsIQ identifikuje vracející se návštěvníky?+
OpsIQ používá kombinaci cookies, snímání otisků prstů v prohlížeči a ověřené identifikační tokeny. Pokud návštěvník své cooxy vymaže a není přihlášený, objeví se jako nový návštěvník.
Analytika
Živé krmivo
Živé krmivo ukazuje návštěvníkům, kteří jsou na vašich webových stránkách v reálném čase. Aktualizuje automaticky každou 15 sekundu (konfigurovatelné). Používejte ji během kampaní, spouštění produktů a nabitých období podpory, abyste viděli, co se právě děje.
Živé krmivoPodívejte se, kdo je na vašich stránkách v této sekundě a co dělají, osvěžující automaticky každé 15 sekundy.
Jak to funguje
V live Feed průzkumy váš server v nastaveném obnovovacím intervalu. Každý řádek ukazuje návštěvníka v současné době na vašich stránkách: jejich aktuální stránku, zemi, zařízení, zdroj, trvání relace a počet stránek. Zelená zvýrazňuje novou činnost od posledního obnovení. Klikněte na libovolný řádek návštěvníků vidět jejich úplné údaje o zasedání.
Nastavení
Obnovit interval
Jak často se aktualizuje živý přenos. Výchozí: 15 sekundy. Nižší hodnoty (5-10s) poskytovat rychlejší aktualizace, ale používat více serverových zdrojů. Vyšší hodnoty (30-60s) jsou jednodušší na serveru, ale méně reálného času.
Aktivní prahová hodnota
Jak dlouho je návštěvník považován za "aktivní" po zatížení poslední stránky. Výchozí: 90 sekund. Pokud návštěvník načte stránku a pak si ji přečte pro 2 minuty bez kliknutí, zmizí z živého krmiva po prahu.
Tlačítko Pauza
Klikněte na tlačítko Pauza zastavit automatickou refresh. Užitečné, když chcete číst podrobnosti bez aktualizace seznamu. Klikněte na Pokračovat pro obnovení.
Opracované příklady
Zaujměte horkou stopu během kampaně
Scénář:
You are running a product launch. A visitor just viewed your homepage, then features, then pricing, and is now on the checkout page.
Co dělat:
Toto je vysoce úmyslné chování. V živém krmivu: (1) Klikněte na návštěvníka, aby viděli jejich zasedání. (2) Pokud začnou chat, AI bude mít jejich plné kontext cesty. (3) Pokud odejdou bez nákupu, stanou se vodítkem na stránce Vedoucí. (4) Zvažte vytvoření proaktivního pravidla pro zobrazení chatovací zprávy, když návštěvníci dosáhnou Checkout.
Příliš mnoho návštěvníků ze stejného IP
Scénář:
You see 20 visitors from the same IP address, all on different pages.
Co dělat:
To by mohlo být: (1) Kancelář se sdíleným internetem. Zkontrolujte, zda návštěvy vypadají jako skuteční lidé (různé stránky, rozumné trvání sezení). (2) robot nebo škrabka. Zkontrolujte, zda jsou sezení velmi krátké (0-1nebo systematicky trefit stránky (3) Test zatížení. Pokud provádíte automatické testy, vyloučit IP ze sledování.
Proč je živý přenos zobrazen 0 návštěvníků, když moje stránky mají provoz?+
Kontrola: (1) Je widget skript nainstalován na vašich stránkách? (2) Je klíč k webu správný? (3Překročila aktivní práh?4Používají návštěvníci agresivní reklamní blokátory, které blokují sledovací skript?
Mohu filtrovat živý přenos podle země nebo zařízení?+
Živý kanál ukazuje všechny aktivní návštěvníky. Pro filtrované zobrazení použijte stránky Návštěvníků Log nebo Sessions s možností filtru. Živý zdroj je záměrně jednoduchý pro sledování reálného času.
Analytika
Horní stránky
Top Pages ukazuje, které stránky na vašich stránkách získat nejvíce provozu. To řadí stránky návštěvami, angažovanost, konverzí a podpůrnou činnost. Použijte ji k identifikaci svého nejlepšího obsahu, najít nedosahující stránky, a objevte stránky, které generují podpůrné otázky.
Horní stránkyVaše stránky seřazené podle provozu a zapojení, takže můžete vidět nejvyšší obsah a stránky, které generují podporu.
Co každá stránka ukazuje
Strana URL
Plné URL cesty. Podobné stránky (např. varianty produktů) jsou seskupeny, pokud je povolena jejich skupina.
Náhledy
Celkový počet případů, kdy byla tato stránka načtena ve zvoleném datovém rozsahu.
Jedineční návštěvníci
Kolik různých lidí se na tuto stránku dívá (osoba, která sleduje stejnou stránku dvakrát počítá jako 1 unikátního).
Rychlost srážky
Procento návštěvníků, kteří opustili vaše stránky po prohlížení pouze této stránky. Vysoký odraz na přistávacích stránkách = problém. Vysoké odrazit na "děkuji" stránek = normální.
Průměrná doba
Jak dlouho návštěvníci tráví na této stránce v průměru. Velmi krátké = nečtení. Velmi dlouhé na formulářové stránce = zmatek.
Začínáme.
Kolik chatu konverzace byly zahájeny z této stránky. Vysoká chat začíná na stránce produktu znamená, že popis produktu může být nejasný.
Návrhy
Kolik podpůrných vstupenek bylo vytvořeno návštěvníky, kteří byli na této stránce. Vysoký počet vstupeneK = potenciální UX nebo obsah problém.
Opracované příklady
Najít stránky, které řídí podpůrné otázky
Scénář:
Your support team keeps getting questions about shipping. Which page is failing?
Co dělat:
Třídit Top stránek "Podpůrné tipy" nebo "Chat začíná" sestupný. Podívejte se na produkt nebo zasílání stránky s vysokým počtem. Stránka s nejvíce podpůrných otázek má pravděpodobně nejasné informace. Opravit obsah stránky a sledovat, zda podpora otázky snížit.
Najít stránky s vysokou výstupní rychlostí
Scénář:
You want to know where people leave your site most often.
Co dělat:
Řadit podle rychlosti sestupného. Ignorovat stránky, které jsou přirozeně výstupní body (děkuji stránky, potvrzení stránky). Zaměřte se na stránky, který by měl udržet návštěvníky zapojeny: produktové stránky, ceny, funkce. Tyto potřebují lepší call-to- akce nebo jasnější obsah.
Proč stránka ukazuje 0 názory, i když vím, že to dostane provoz?+
Kontrola: (1) Je na této stránce nainstalován sledovací widget? Aplikace Single- page nemusí při změnách trasy vyvolávat zobrazení stránek. (2) Je stránka vyloučena v nastavení sledování? (3) Slouží CDN cached verzi bez sledovacího skriptu?
Analytika
Geointeligence
Geo Intelligence ukazuje, odkud vaši návštěvníci pocházejí podle země, města, zařízení a zdroje. Použijte ji k pochopení svých geografických trhů, rozhodnout o jazykové podpoře, plánovat regionální marketing, a odhalit podezřelé dopravní vzory.
Geo.Kde vaši návštěvníci přicházejí z (podle země, města a zařízení) na trhy velikosti a rozpoznat neobvyklý provoz.
Co vidíš
Mapa sloupců v nejlepších zemích
Nejlepší země seřazené podle počtu návštěvníků. Klikněte na zemi, aby vrtat až do městské úrovně dat.
Koláč
Vizuální rozpis dopravy podle zemí. Hover pro procenta.
Tabulka pro celou zemi
Každá země s návštěvníky ve zvoleném období, zobrazující počet návštěvníků, počet zasedání, rychlost odrazu a přepočítací koeficient.
Městský vrták - dolů
Klikněte na zemi, aby zjistili, která města v této zemi mají nejvíce návštěvníků.
Jak funguje detekce GeoIP
OpsIQ detekuje polohu návštěvníka dvěma způsoby: (1) Cloudflare geo hlavičky. Pokud vaše stránky je za Cloudflare, Detekce země je automatická a přesná. (2) Databáze MaxMind GeoLite2. Stáhněte si bezplatnou databázi a nastavte cestu v Nastavení. Detekce úrovně City- vyžaduje databázi GeoLeite2-City, nejen databázi Country.
VPN a proxy provoz
Zdá se, že návštěvníci používající VPN server pocházejí z umístění VPNU serveru, nikoli z jejich skutečné polohy. OpsIQ nemůžete a neměli byste se snažit obejít VPN. Pokud vidíte neobvyklé vzory země, zvažte, že 10-20% Návštěvníci mohou používat VPN.
Opracované příklady
Neočekávaný provoz v zemi
Scénář:
You run a US-only business but 30% of traffic is from India.
Co dělat:
Kontrola: (1) Jsou to skuteční návštěvníci? Podívejte se na dobu trvání relace a stránky zobrazeny. Velmi krátké sezení s vysokým odskokem = pravděpodobné boti. (2) Naleznou vás přes Google? Zkontrolujte, kdo je referrer. (3) Mohou být potenciálními zákazníky na novém trhu? Je-li doprava skutečná a angažovaná, zvažte přidání India- specifické ceny nebo obsah.
Rozhodování o jazykové podpoře
Scénář:
You want to know if you should translate your site into Spanish.
Co dělat:
Podívejte se na stránku Geo Inteligence. Pokud španělsky mluvící země (Španělsko, Mexiko, Kolumbie, Argentina atd.) společně představují více než 10% vašeho provozu s nízkou rychlostí odrazu, překlad stojí za zvážení. Zkontrolujte také: Převedou návštěvníci z těchto zemí za podobné ceny na váš primární trh?
Regionální plánování změn v podpoře
Scénář:
You need to decide support team hours for different time zones.
Co dělat:
Použijte hodinovou heatmap (na palubní desce) v kombinaci s Geo Intelligence. Pokud 40% Vaše doprava je z Evropy a 35% z USA, potřebujete pokrytí pro obě časové zóny. Heatmap ukazuje přesně, kdy každý region je nejvíce aktivní.
Země s návštěvami, ale bez objednávek
Scénář:
Germany shows 500 visitors this month but zero sales.
Co dělat:
Vyšetřování: (1) Jsou skákání na straně cen? Možná, že vaše cena není konkurenční pro tento trh. (2) Přepravujete do Německa? Zkontrolujte, zda vaše přepravní stránka zmiňuje Německo. (3) Je vaše pokladní k dispozici v EUR? Měna nesoulad způsobuje opuštěné pokladní. (4Jsou tito návštěvníci z jediného zdroje, který by mohl být nízkoúmyslný provoz?
Proč návštěvník ukazuje "Neznámá" země?+
GeoIP není konfigurován. Buď nastavte Cloudflare (který automaticky přidá hlavičky geo), nebo si stahujte databázi MaxMind GeoLite2 a nastavte cestu k souboru v Nastavení > GeoIPPath.
Mohu zablokovat dopravu ze určitých zemí?+
OpsIQ neblokuje podle země. Použijte svůj webový server nebo Cloudflare Firewall pravidla pro blokování na základě země.OpsIQ zaměřuje se na viditelnost, nikoli na kontrolu přístupu na úrovni sítě.
Analytika
Záměrná trychtýř
Záměr Funnel klasifikuje návštěvníky podle toho, co se snaží dělat: procházet, zkoumat, porovnat, koupit, získat podporu nebo odejít. Použijte to pochopit rovnováhu záměru na vašich stránkách a zjistit, kde návštěvníci pokles.
Záměrná trychtýřSessions klasifikovány podle záměru (procházet, výzkum, porovnat, koupit), takže můžete vidět přesně, kde lidé pokles.
Kategorie záměru
Prohlížení
Návštěvníci se náhodně rozhlížejí, krátké sezení, pár stránek, žádný konkrétní cíl nebyl zjištěn.
Výzkum
Návštěvníci čtení produktu / funkce stránky, dokumenty, nebo blog obsah. Delší čas na stránce, více stránek obsahu.
Srovnání
Návštěvníci prohlížení cen, porovnání plánů, nebo funkce tabulky. Často vrací návštěvníky.
Nákup
Návštěvníci na pokladně, košíku, nebo signup stránky. Vysoký záměr. To jsou vaše možnosti konverze.
Podpora hledání
Návštěvníci na stránkách nápovědy, kontaktních stránek, nebo zahájení chatu. Potřebují pomoc.
Vyhazování
Návštěvníci, kteří odešli po jedné stránce.
Jak číst trychtýř
Interpretace trychtýře
Scénář:
1,000 visitors viewed Pricing. 270 opened chat. 92 started checkout. 64 paid. 18 opened support tickets.
Co dělat:
Pricing page is strong enough to create intent. Chat is important in the buying path: 27% of pricing visitors engage with chat before buying. Support tickets after checkout may indicate activation or payment confusion. Action: (1) Ensure AI chat answers pricing questions well. (2) Investigate the 18 post-checkout support tickets for common issues.
Časové filtry
Pomocí filtru datového rozsahu porovnávejte vzory úmysl v průběhu období. Například, porovnat Černý pátek týden s normálním týdnem. Měli byste vidět špičku v "Nákup" záměru a možná "Podpora-vyhledávání", pokud vaše povýšení vytvořil zmatek.
Jak OpsIQ klasifikuje záměr?+
OpsIQ pohled na stránku URLs, chování relace, a časové vzory. Ceny stránky porovnání záměru. Prohlížet stránky signál nákup záměr. Nápověda / kontaktní stránky podpora podpory záměru. Klasifikace je heuristic-based, ne AI- poháněn.
Mohu upravit kategorie úmysl?+
V současné době ne. Kategorie jsou built- in na základě běžných webových vzorců chování. Vlastní klasifikace záměru je na cestovní mapě.
Analytika
Funnely, retence a cesty
Vybudovat vlastní cesty ze stránek nebo akcí kroky, měřit kohorta retence a objevovat cesty návštěvníků nejčastěji se přes stránky.
Produktová obrazovkaVlastní trychtýř zobrazuje každý krok stránky / události, zbývající návštěvníky a procento konverze.
Řapíkatá a stonková zelenina
Vytvořit název trychtýř s 2 do 8 stránka nebo event kroky. Nastavte okno pro přepočet v hodinách; návštěvník počítá pouze tehdy, když objednané kroky dojde uvnitř okna. Použijte pokles mezi kroky pro volbu, kde zkontrolovat přehrávání, chyby, rychlost stránky nebo zasílání zpráv.
Zadržení
Retence skupiny návštěvníků do týdenních kohort a ukazuje, kolik návratu. Vyberte si 6, 8 nebo 12 týden horizont. Udržujte kohortu definici stabilní při porovnávání úniků nebo kampaně.
Cesty
Cesty zobrazují nejčastější sekvence stránek. Vyberte si délku cesty z 2 do 5 Stránky, aby výsledek čitelný. Použijte ho k nalezení neočekávaných objížďky, společné východy a obsah, který opakovaně předchází konverzi.
Vlastní nálevky jsou analytické definice, nikoli automatizace. Chcete-li reagovat na dokončený krok, vytvořit cíl konverze, segment, spouštěč nebo pracovní tok.
Analytika
Přehrávání relací
Session Replay vám umožní sledovat časovou osu toho, co návštěvník udělal na vašich stránkách: které prvky klikli, jak se skal, kde vznášeli, a to, co oni zapisovali (s citlivými poli maskovány). Použijte to k diagnostice problémů UX, ověření chyb zprávy, a pochopit zmatek zákazníků.
Přehrávání relacíPřehrát přesně to, co návštěvník udělal: kliknutí, svitky, psaní (citlivá pole maskovaná), na časové smyčce.
Najít správné sezení
Ze stránky Sessions, podívejte se na sezení s hlášenými problémy, vysoká stránka počítá bez konverze, nebo zasedání od zákazníků, kteří vyplnili podpůrných tipů. Klikněte na ikonu replay pro otevření zobrazení časové osy.
Co se znovu ukazuje
Časová osa
Horizontální bar zobrazující události v průběhu času. Klikněte na libovolné místo na časové ose skočit do tohoto okamžiku.
Navigace stránky
Každá stránka se objeví jako segment na časové ose. Můžete vidět přesnou cestu návštěvník vzal.
Kliknutí
Klepněte na tlačítko události jsou zobrazeny jako tečky na časové ose a jako zvýraznění na stránce rekonstrukce.
Skrolování
Průhledná hloubka je sledována, takže můžete vidět, jak hluboko návštěvník číst.
Interakce ve formě
Zaznamenávají se události zaostření a psaní. Textový vstup v heslu a citlivých polích je ve výchozím nastavení maskován.
Ochrana soukromí a maskování
Session replay masky citlivé formy pole ve výchozím nastavení. Hesla, vstupy kreditní karty a pole označená data-opsiq-maska se nikdy nenahrávají. Můžete nastavit další maskovací pravidla v Nastavení > Sledování. Pokud to vyžaduje vaše politika dodržování předpisů, můžete zcela zakázat přehrávání.
Diagnosování rozbité pokladny
Scénář:
A customer says "I tried to buy but the button did nothing."
Co dělat:
Najděte jejich relaci na stránce Sessions (vyhledávání e-mailem). Otevřete REPLAY. Podívejte se na stránku Checkout segmentu. Podívejte: (1Zmáčkli správné tlačítko?2) JavaScript dojde k chybě? (Zkontrolujte, zda JS chybám v té době.) (3) Načíst stránku nebo zobrazit chybovou zprávu? (4Bylo požadované pole prázdné? Replay ukazuje, co přesně se stalo.
Kolik úložiště relace používá?+
Replay data roste s objemem provozu. Pomocí nastavení retence automaticky vyčistit staré replay data. Pro high-traffic stránky, zvažte kratší retenční období (např., 30 dnů) spravovat úložiště.
Mohou návštěvníci odstoupit od REPLAY?+
Pokud je v Nastavení zapnuto "Respekt Do 't Track", návštěvníci s hlavičkami DNT nejsou zaznamenáni. V nastavení sledování můžete také vyloučit konkrétní stránky z přehrávání.
Analytika
Záznam událostí
Záznamy událostí ukazují každou událost, která OpsIQ zaznamenala: zobrazení stránky, kliknutí, chat začíná, výtvory vstupenek, prodej a vlastní akce. Použijte ji k debugování integrace, ověření doručení webháku, a pochopit posloupnost akcí.
Záznam událostíČasová osa všeho OpsIQ záznamy (pageviews, chaty, prodeje, webháky, vlastní akce) pro ladění a audit.
Stavební- v akcích (automatická)
pageview
Vystřelen pokaždé, když se stránka načítá. Obsahuje URL, titul, referent, a časové razítko.
chat.started
Vystřelen, když návštěvník otevře widget chatu a pošle první zprávu.
chat.message
Vyhozen pro každou zprávu v chatu rozhovoru (jak návštěvník a AI / agent).
ticket.created
Vyhozen při vytvoření nové podpůrné jízdenky (z chatu, e-mailu, widget, nebo admin).
ticket.replied
Vyhozen, když je do vstupenky přidána odpověď.
order.completed
Vyhozen při dokončení nákupu přes připojenou platformu.
form.submitted
Vystřelen při předložení sledovaného formuláře (pokud je povoleno sledování formulářů).
identify
Vyhozen, když je návštěvník identifikován pomocí symbolu identity.
security.login_failed
Vystřelen, když se pokus o přihlášení nezdaří.
Vlastní akce
Můžete posílat vlastní akce z vašich webových stránek nebo serveru na OpsIQ. Vlastní události jsou užitečné pro sledování akcí specifických pro vaše podnikání: kliknutí na tlačítko, používání funkcí, přehrávání videa, stahování, atd.
JavaScript · vlastní akce z prohlížeče
// Send a custom event from the browser
window.OpsIQ = window.OpsIQ || [];
window.OpsIQ.push(["track", "plan_selected", {
plan: "pro",
billing: "annual",
value: 99
}]);
Filtrovat podle konkrétních jmen událostí: pageview, chat. started, ticket. created, atd.
Rozsah data
Zobrazovat události z určitého časového období.
Hledat
Data událostí vyhledávání pomocí klíčového slova (URL, e-mail, hodnoty vlastnosti události).
Jak dlouho se to bude konat?+
Události se řídí retenčními pravidly nastavenými v Nastavení. Výchozí: 90 dny. Vysoce hodnotové události (nákupy, bezpečnostní události) lze konfigurovat s delší retencí.
Mohu použít události v A / B experimentech?+
Ano. Při vytváření experimentu si zvolíte konverzní událost. Jako cíl konverze lze použít libovolnou built- in nebo na zakázku.
Analytika
Experimenty A / B
Experimenty vám umožní vyzkoušet dvě verze stránky nebo funkce a měřit, které z nich se provádí lépe. OpsIQ stopy dojmy, konverze a statistický význam.
Experimenty A / BSpustit dvě varianty, sledovat konverzi a statistický význam, a prohlásit vítěze.
Jak experimenty fungují
1
Vytvořit experiment
Dejte mu jméno, definujte primární metriku (událost konverze) a nastavte varianty (kontrola a zkouška).
2
Spusť to.
OpsIQ náhodně přiřazuje návštěvníkům varianty a sleduje jejich chování. Neměňte experiment, když běží.
3
Přečtěte si výsledky
95% úroveň spolehlivosti znamená, že si můžete být _95% jistí tím, že rozdíl je skutečný a ne náhodný.
Experimentální státy
Návrh
Vytvořeno, ale ještě není spuštěno. Stále můžete upravovat varianty a metriky.
Běžící
Aktivně přiřazovat návštěvníkům varianty. Neupravovat při běhu.
Dokončeno
Získaný statistický význam nebo byl ručně zastaven. Výsledky jsou konečné.
Archivováno
Výsledky byly přezkoumány a experiment již není v aktivním seznamu potřebný.
Osvědčené postupy
Definujte metriku před startem
Rozhodněte se, co změříte před startem. Volba metriky po vidět výsledky zavádí zaujatost.
Vyloučení vnitřního provozu
Přidejte adresy vašeho týmu IP do seznamu vyloučení, aby návštěvy zaměstnanců nevedly k výsledkům.
Utíkej dost dlouho.
Nepřerušujte experiment po návštěvách 100. Pro spolehlivé výsledky potřebujete stovky nebo tisíce návštěvníků na variantu.
Zkouška jedna změna najednou
Pokud změníte titulek a barvu tlačítka, nebudete vědět, která změna způsobila zlepšení.
Zaznamenejte své rozhodnutí
Po ukončení experimentu si všimněte, která varianta vyhrála a proč jste se rozhodli ji implementovat.
Kolik návštěv potřebuju pro platný experiment?+
Záleží na základním přepočítacím koeficientu a velikosti účinku, který chcete zjistit. 500 Návštěvníci na variantu pro 20% Pro menší efekty potřebujete tisíce.
Můžu provést několik experimentů najednou?+
Ano, ale buďte opatrní. Pokud dva pokusy ovlivňují stejnou stránku, jejich výsledky mohou interagovat. Je bezpečnější provádět experimenty na různých stránkách nebo funkce současně.
Analytika
JavaScript chyby
JavaScript Chyby shromažďuje chyby na straně klienta od návštěvníků webových stránek. Rozbité tlačítko, selhání API volání, nebo chybějící zdroj se objeví zde. Použijte ho k nalezení a opravu chyb, které ovlivňují skutečné zákazníky.
Chyby JSSkuteční návštěvníci se zde dotknou rozbitého povrchu kódu (zpráva, zdroj, prohlížeč a jak často), takže můžete opravit, na čem záleží.
Co každá chyba ukazuje
Chyba zprávy
Chybový text JavaScript (např. "TypeError: Nelze číst vlastnosti nedefinovaných").
Strana URL
Na které stránce došlo k chybě.
Prohlížeč a zařízení
Který typ prohlížeče a zařízení chybu viděl. Některé chyby jsou specifické pro prohlížeč.
Stopa stopky
Umístění kódu, kde došlo k chybě. Kliknutím rozšiřujete stopu celého zásobníku.
První spatřeno
Když se tato chyba poprvé objevila.
Naposledy viděn
Když se tato chyba naposledy stala.
Počet
Kolikrát byla tato chyba zaznamenána.
Postižená sezení
Kolik různých návštěv zažilo tuto chybu.
Priorizace chyb
Ne všechny. JavaScript chyby potřebují okamžitou pozornost. Priorizovat: (1) chyby na kritických stránkách (checkout, signup, přihlášení), (2) chyby s vysokými počty sezení, (3) chyby, které se objevily nedávno (možné regrese ze změny kódu), (4) chyby na vašem vlastním kódu (ne skripty třetích stran).
Oprava rozbitého tlačítka pro checkout
Scénář:
The JS Errors page shows "TypeError: Cannot read properties of undefined (reading submit)" on /checkout, affecting 45 sessions this week.
Co dělat:
To znamená 45 skuteční zákazníci nemohli dokončit checkout. Krok: (1) Otevřete stránku ve stejné kombinaci prohlížeč / zařízení. (2) Otevřít konzoli prohlížeče a reprodukovat chybu. (3) Zkontrolujte stopovací stopu najít přesný řádek kódu. (4) Opravit chybu, nasadit, a sledovat počet chyb jít na nulu.
Zachycuje OpsIQ chyby ze skriptů třetích stran?+
Ano. OpsIQ zachycuje všechny JavaScript chyby na stránce, včetně chyb z analytických skriptů, widgety chatu a ad skripty. Filtrovat podle URL v zásobníku stopy zaměřit na svůj vlastní kód.
Jak mohu vyloučit známé neškodné chyby?+
Nemůžete potlačit specifické chyby v OpsIQ, ale můžete filtrovat seznam po stránce URL nebo chybová zpráva. Oprava nebo ignorování chyb z rozšíření prohlížeče (často se zobrazují jako chyby z neznámých zdrojů).
Prodej
Prodej a přeměny
Prodejní sledování spojuje váš obchod nebo platformu pro fakturaci s OpsIQ, takže můžete vidět příjmy vedle návštěvníka chování. Každý nákup je připisován k cestě návštěvníků, takže víte, které stránky, kampaně a kanály pohánět příjmy.
ProdejSkutečný prodejní plátno, příjmy nahoru, pak Nedávné nákupy (datum, zákazník, platforma, částka), každý přičítaný ke svému zdroji dopravy.
Prodejní palubní deska
Dnešní prodej
Příjmy z objednávek dokončených dnes. Občerstvuje s každou novou objednávkovou událostí z vaší připojené platformy.
Tento týden / tento měsíc / celkem
Příjmy agregované v průběhu období. Náhrady se odečítají od těchto součtů.
Trendový graf
Liniový graf zobrazující denní příjmy v rámci zvoleného datového rozsahu. Hledejte hroty (propagační akce, kampaně) a dipy (emise, sezónní).
Nejlépe konvertující zdroje
Které dopravní zdroje vedou k většině nákupů. "Přímé" kupující často bookmark vaše stránky. "Google" kupujících vás našel prostřednictvím vyhledávání.
Nedávné nákupy
Nejnovější objednávky s emailem zákazníka, částka, měna a zakoupené položky.
Pokyny pro nastavení nástupiště
Shopify
Go to Connectors > Shopify. Create a custom app in your Shopify admin (Settings > Apps and sales channels > Develop apps). Grant scopes: read_orders, read_customers, read_products. Copy the Admin API access token. In OpsIQ, enter your store domain (e.g., your-store.myshopify.com) and the access token. Click Test Connection. If successful, enable webhook sync for real-time order notifications.
WooCommerce
Přejděte na konektory >WooCommerce Ve vaší WordPress Admin, jděte na WooCommerce> Nastavení > Pokročilé > Odpočinek API. Vytvořit klíč se svolením Read / Write. Kopírovat spotřebitelský klíč a tajemství spotřebitele. V OpsIQ, zadejte své stránky URL, spotřebitelský klíč, a tajemství spotřebitele. Klikněte na tlačítko Test Connection.
BigCommerce
Přejděte na konektory > BigCommerce. Ve svém Bigcommerce admin, přejděte na Advanced Settings >API Účty. Vytvořit V2 / V3 API Účet se čteným rozsahem pro objednávky, zákazníky a produkty. Kopírujte přístupový symbol, ID klienta a API stezka. Vstupte do nich OpsIQ a test.
Magento 2
Přejděte na konektory > Magento. Ve svém Magento admin, přejděte do systému > Integrace. Vytvořte novou integraci s API zdrojový přístup k Prodejce, Zákazníkům a Katalogu. Aktivujte integraci a zkopírujte přístupový token. Zadejte jej OpsIQ s vaší Magento základny URL.
PrestaShop
Přejděte na Connectors > PrestaShop. Ve Vašem adminu Prestashopu přejděte na Advanced Parameters > Webservice. Povolte webovou službu a vytvořte nový klíč. Poskytněte přístup k objednávkám, zákazníkům a produktům. Kopírujte klíč a zadejte jej OpsIQ s vaším obchodem URL.
OpenCart
Přejděte na konektory > OpenCart. Generovat API Přihlášení z vašeho panelu OpenCart admin. Zadejte API URL, uživatelské jméno, a klíč v OpsIQ. Konektor používá OpenCart 's REST API pro objednávky a údaje o zákaznících.
osCommerce
Přejděte na Connectors > osCommerce. Nastavit přístup do databáze nebo API Procesní integrace obvykle vyžaduje přímý přístup do databáze nebo na zakázku API modul.
Stripe
Přejděte na konektory > Stripe. Zkopírujte si svůj pruh omezen API klíč od přístrojové desky Stripe (vývojáři >API klávesy). Klíč potřebuje přečíst přístup k zákazníkům, poplatkům, fakturám a předplaceným. Zadejte jej OpsIQ. Nastavit koncový bod webhooku pro události v reálném čase.
Vlastní / jiné platformy
Použijte zbytek.API nebo webháky poslat prodejní akce z jakékoliv platformy. Odeslat order.complete události s emailem zákazníka, částka, měna a položky. Viz Události API oddíl pro formát užitečného zatížení.
Pochopení vašeho prodejního nálevku
Nejlépe konvertující zdroje
Ukazuje, které kanály přinášejí platící zákazníky. Pokud Google přináší 1000 návštěvníků a 50 prodej, to je5% Přepočítací koeficient. Pokud e-mail přináší 200 návštěvníků a 30 prodej, to znamená 15%. Email je účinnější na návštěvníka.
Výše náhrad
Refinancované objednávky jsou sledovány odděleně. Sníží vaše čisté příjmy celkové. Pokud sazby náhrad jsou vysoké z určitého zdroje, provoz může být nízká kvalita.
Nakládání s měnami
OpsIQ ukládá původní transakční měnu a částku. Multiměnové podniky vidí příjmy v každé měně. Normalizované vykazování používá nastavený směnný kurz.
Opracované příklady
100 návštěvníci, nulový prodej
Scénář:
Your pricing page gets 100 visitors per day but zero conversions.
Co dělat:
Vyšetřování: (1) Použít relace Replay na návštěvníky cenových stránek. Podívejte se, jak interagují s cenové tabulky. (2) Zkontrolujte Top Pages pro cenovou stránku odrazit sazby a time- on- page. (3) Zkontrolujte chat konverzace od návštěvníků cenových stránek. Jaké otázky se ptají? (4) Porovnejte svou cenovou stránku s konkurenty. (5) Zkuste A / B experiment s různými cenovými rozložení.
Přiznání za marketingovou kampaň
Scénář:
You sent an email campaign with UTM tags. How do you measure its revenue impact?
Co dělat:
Přejděte do sekce Prodeje a filtrujte podle zdroje. Vyhledejte parametr UTM kampaně, zobrazí se: (1) Kolik návštěvníků přišlo z emailu. (2) Kolik jich bylo převedeno na prodej. (3) Celkové tržby připsané kampani. (4) Srovnání se stejným obdobím před kampaní.
Proč prodej ukazuje nulu, i když můj obchod má rozkazy?+
Kontrola: (1) Je platformní konektor připojen a zdravý? Přejděte na konektory a zkontrolujte stav. (2) Je synchronizace webhook zapnuta? Pokud používáte hlasovací právo, je práce cron běží? (3) Má konektor právo API Strojky? Shopify Potřebuješ číst rozkazy.
Jak se OpsIQ připisuje prodeji návštěvníkovi?+
Když se objednávka dostane přes konektor, OpsIQ odpovídá zákazníkovi e-mailu s známým návštěvníkem. Pokud byl návštěvník sledován před nákupem, prodej je připisován k jejich cestě návštěvníka, včetně dopravního zdroje, přistávací stránky a historie sezení.
Mohu ručně přidat prodej?+
Prodejní akce můžete posílat přes REST API nebo webháky z libovolného systému. Formát událostí je zdokumentován v Událostech API sekce.
Prodej
Vodíky
Vedení jsou návštěvníci nebo zákazníci, kteří ukazují nákup nebo podporu záměr. OpsIQ automaticky detekuje vedení na základě chování: cenová stránka návštěvy, zpáteční návštěvy, chat interakce, Checkout začíná a vysoké zapojení. Použijte stránku Leads upřednostnit follow- up a krmit CRM potrubí.
VodíkySkutečná obrazovka vede, vysoce-intent návštěvníků jako prohledatelný stůl (IP/ email, umístění, zařízení, zdroj, čas na místě) s nejlepšími zdroji a zeměmi.
Co dělá stopu
Cenové návštěvy stránek
Návštěvníci, kteří se dívají na vaši cenovou nebo plánovací stránku, aktivně zvažují nákup.
Návratné návštěvy
Návštěvníci, kteří se vracejí několikrát jsou zapojeni, ale ještě nejsou převedeni.
Interakce s chatem
Návštěvníci, kteří začnou chat aktivně hledají pomoc, buď před nákupem nebo po nákupu.
Start checkout
Návštěvníci, kteří dosáhnou pokladny stránku, ale nedokončují nákup.
Podání formuláře
Návštěvníci, kteří zadávají kontaktní formulář, demo žádost nebo signalizační formulář.
Zapojování na vysoké straně
Návštěvníci, kteří se dívají na mnoho stránek s dlouhou dobou trvání sezení, jsou hluboce zkoumáni.
Olověný panel detail
Klikněte na jakoukoli stopu pro zobrazení jejich plného profilu:
Identita
Název, e-mail, společnost, pokud je známa. Anonymní vede ukazují IP a umístění.
Zasedání
Všechny sezení z tohoto vedení s průtokem stránky, trvání a zdroj.
Stránky zobrazené
Na každé stránce, kterou navštívili, si objednali recenzi.
Zdroj
Jak tě našli: organické, placené, sociální, doporučení, přímé.
Olověné skóre
A0-100 skóre založené na intenzitě chování, recidivitě a záměru stránky.
status CRM
Zda bylo toto vodítko přidáno do CRM jako kontakt nebo obchod.
Spropitné prodeje
AI- generovaný návrh, co dělat dál (např. "Návštěvníci cen 3 krát · zvážit aktivní informační").
Vysokohodnotný olověný odznak
Vede s skóre nad 80 získat "vysokou hodnotu" odznak. To jsou vaše nejžhavější vyhlídky. Priorizujte je pro dosah, proaktivní chat, nebo CRM vstupu potrubí.
Opracované příklady
- Dělám na horkém olovu.
Scénář:
A lead viewed your pricing page 3 times in 2 days, started a chat asking about enterprise plans, but has not purchased.
Co dělat:
Tohle je vysoce úmyslná stopa.1) Zkontrolujte jejich hlavní podrobnosti pro společnost a informace o úloze. (2) Recenze přepis chatu pro konkrétní potřeby a námitky. (3) Vytvořit dohodu v CRM se shromažďovanými informacemi. (4) Přiřadit následný úkol pro člena obchodního týmu. (5) Pokud se vrátí na cenovou stránku, proaktivní chat pravidlo může spustit personalizované zprávy.
Převod anonymních vede k CRM kontakty
Scénář:
You have 50 anonymous leads with high scores but no email addresses.
Co dělat:
Možnosti: (1) Vytvořit proaktivní pravidlo, které nabízí slevu nebo stažení zdrojů výměnou za e-mail na high-intent stránkách. (2) Pomocí widget chatu požádat o e-mail, když anonymní návštěvníci začnou konverzaci. (3) Přidejte na své přihlašovací / signalizační stránky symbol totožnosti, aby se automaticky identifikovali navrátilci.
Jak se počítá skóre olova?+
Skóre se zabývá: rekurencí návštěv (poslední = vyšší), frekvencí návštěvách (více = vyšší hodnota), stránkami zobrazenými (cena / odhlášení = vyšší cena), dobou trvání sezení (delší = vyšší míra), interakcí na chatu (angažovaná = vyšší úroveň) a návratovými návštěvami (vícenásobná vyšetření = vyšší sazba).
Můžu upravit pravidla bodování olova?+
Ano. V CRM Konfigurace, můžete přidat lead- bodování pravidla, která zvýší skóre na základě konkrétních klíčových slov, událostí, zdrojů, nebo vzory stránek.
CRM
CRM · začít zde
OpsIQ přepravuje plnou AI- první CRM, které zachycuje zákaznickou pravdu, čistí data, skóre vede, kouče obchody, prognózy příjmů a aktů, s webovou inteligencí, podporu, vstupenky, produkty a platby jako jeden živý graf. Každá akce AI je získána, vysvětlitelná, reverzibilní a schvalovatelný.
AI CRMPrvní CRM, které vedou čtyři specializovaní agenti a trust Dial, který rozhoduje, kolik toho dělají sami.
Přehled stránek CRM
AI CRM (velitelské centrum)
Začněte tady.
Vaše denní domácí obrazovka: příjem pulsu, co AI našel, co to udělal, schválení fronty, další pohyby, agent zdraví, a ROI.
Kontakty
hlavní
Lidé a firmy ve vašem CRM. Hledat, filtrovat, skóre a spravovat profily.
Potrubí
hlavní
Vizuální deal deska s drag- a - drop stadia, vyhrát pravděpodobnost, a AI koučování.
Předpověď a zprávy
hlavní
Předvídání třídy: pravděpodobně, v nejlepším případě s intervaly spolehlivosti a sledováním přesnosti.
Životní cyklus
hlavní
Pokud se každý zákazník nachází: aktivní, ohrožený, expanze připraven, obnovení splatnosti, nebo víření.
Vybudovat CRM
Nastavení
Popište své nastavení CRM v jednoduché angličtině. OpsIQ generuje reverzibilní plán a aplikuje jej na schválení.
CRM Zdraví
Operační
Self- check stránka: schéma, agenti, trasy, AI akce, a živé údaje počet.
Jak vás OpsIQ udržuje v bezpečí
Zeptejte se před jednáním
AI návrhy jdou do schvalovací fronty. Schválíte, editujete, nebo odmítnout každý z nich. Nic se nestane bez vašeho slova.
Nikdy nepřepisuj
Když AI navrhuje změnu, ukazuje současnou hodnotu a navrhovanou hodnotu. Údaje zadané člověkem mají ochranu provenience.
Všechno je vratné.
Každá akce AI je zaznamenána v deníku. Můžete vrátit všechny změny jedním kliknutím.
Prokazovatelné
Každé doporučení AI ukazuje své zdůvodnění a zdroje dat, které použil.
Zbrusu nový?
1
Otevřít CRM AI
Klikněte na AI CRM v levé navigaci. Velitelské centrum zobrazí váš současný stav.
2
Zkontrolovat zdravotní stav CRM
Otevřít CRM Health pro ověření schématu, agenti a trasy jsou připraveny.
3
Importovat kontakty
Pokud je konektor aktivní (Shopify, WHMCS, etc.), kontakty jsou importovány automaticky. Jinak importovat prostřednictvím CSV nebo vytvořit ručně.
4
Vytvořit potrubí
Přejděte do potrubí a vytvořit svůj první ropovod s etapami (např., Olovo, Kvalifikované, Návrh, vyjednávání, Won, Lost).
5
Přidat první nabídku
Vytvořte dohodu z kontaktu, nastavte částku a jeviště, a nechte se vést Deal Coach.
Musím použít CRM?+
Ne. CRM je volitelné. OpsIQ funguje perfektně jako sledování + podpora + AI platforma bez CRM. Povolit, když jste připraveni spravovat prodejní a zákaznické vztahy.
Může CRM fungovat bez konektorů?+
Ano. Kontakty a nabídky můžete vytvářet ručně. Připojení CRM obohatí o data platforem (objednávky, předplatné, vstupenky), ale nejsou vyžadována.
Co je to "Spořitelna"?+
Bezpečnostní systém, který řídí, co může AI dělat. Režim Copilot (výchozí): AI navrhuje, člověk schvaluje. Autopilot režim (opt- in): UI automaticky působí na nízké riziko, reverzibilní operace.
CRM
Domácí obrazovka AI CRM
Každé ráno otevřete centrálu, abyste viděli, co se stalo, co potřebuje pozornost a co dělat dál.
Řídící centrumSkutečné velitelské centrum: přepínání mezi prognózou, výherní rychlostí a Pipeline, a pracovat AI návrh fronty, schválit nebo zamítnout dohody, jevištní pohyby a úkoly, které navrhuje.
Co ukazuje velitelské centrum
Dnešní čísla
Hodnota potrubí, obchody won / lost, nové tipy, aktivní obchody, a trend příjmů, snímek vašeho současného stavu.
Co OpsIQ našel
Objevené poznatky: pozastavené obchody, rizikové účty, nové příležitosti, problémy s kvalitou údajů a tržní signály.
Co OpsIQ udělal
Akce, které AI přijala (v Autopilotu) nebo navrhla (v Copilot): postupné pokroky, aktualizace skóre, obohacení kontaktů a vytváření úkolů.
Potřebuje schválení
Fronta návrhů AI čeká na vaše rozhodnutí. Každý ukazuje navrhovanou akci, odůvodnění, a důkazy. Schválit, upravit, nebo odmítnout.
Další tahy
AI- zařadil seznam 10 nejdůležitější věci, které mají udělat dnes: sledovat na horké obchod, zkontrolovat na-riziko účtu, výzkum nové vedení, atd.
Stav pomocníka
Zdraví agentů AI: Capture, Data Steward, Deal Intelligence, Dead Coach, SDR, Retention. Green = běh, jantar = potřebuje pozornost, červená = chyba.
Výsledky
Sledování ROI: obchody ovlivněné AI, ušetřené čas, přesnost předpovědí a srovnání s manuální CRM prací.
Ranní briefing workflow
1
Přečtěte si dnešní čísla
Zkontrolujte vývoj zdraví a příjmů potrubí.
2
Vyčistit schvalovací frontu
Prohlédněte si každý návrh AI. Schválit bezpečné akce, upravit tam, kde je to potřeba, odmítnout špatné návrhy.
3
Zkontrolujte, co OpsIQ našel
Čtěte AI postřehy. Jsou nějaké obchody v ohrožení? Existují nové příležitosti?
4
Zapracovat na dalším seznamu pohybů
Začněte s nejvyšší prioritou. AI zařadil tyto podle naléhavosti a potenciálního dopadu.
Dostávají se po volnu
Scénář:
You were away for a week. What happened while you were gone?
Co dělat:
Otevřete velitelské centrum a zkontrolujte: (1) "Co OpsIQ Ukazuje všechny akce AI během vaší nepřítomnosti. (2) "Potřebuje souhlas" ukazuje návrhy, které čekají na váš přezkum. (3) "Co OpsIQ Nalezeno "zdůrazňuje naléhavé věci. (4) Nastavte datový rozsah přístrojové desky na dobu nepřítomnosti, abyste viděli trend.
CRM
Kontakty, společnosti a dohody
CRM organizuje vaše obchodní vztahy do čtyř objektů: Kontakty (lidé), Společnosti (organizace), nabídky (příležitosti k příjmu) a Úkoly (akce navazující na činnost).
Objekty CRMČtyři hlavní objekty (kontakty, firmy, obchody a úkoly) spojené do jednoho připojeného zákaznického grafu.
Kontakty
Co je to kontakt
Osoba ve vašem CRM. Mohou být zákazník, vyhlídka, partner, nebo vedení. Kontakty mají e-mail, jméno, společnost, tagy, životní cyklus a skóre.
Hledání kontaktů
Pomocí vyhledávacího panelu najít podle jména, e-mailu, společnosti, nebo tagy. Použijte filtry: životního cyklu fáze, olověné skóre, zdroj, země, poslední datum činnosti, přidělený vlastník.
Kontaktní profil
Klikněte na kontakt, aby viděli jejich celý profil: osobní informace, společnost, obchody, aktivity, vstupenky, chaty, návštěvy webových stránek, skóre a AI vhled.
Skóre horka
A0-100 skóre vypočteno z signálů chování: návštěvy webových stránek, e-mailové připojení, chat interakce, historie nákupu a recenze. Vyšší = teplejší.
Společnosti
... další lístky...
Spojení kontaktní společnosti
Kontakty jsou propojeny s firmami prostřednictvím e-mailové domény nebo manuálního přiřazení. Jedna společnost může mít mnoho kontaktů.
Nabídky
Co je dohoda?
Příležitost k získání příjmů. Nabídky mají titul, množství, potrubí, jeviště, pravděpodobnost vítězství, datum uzavření, přiděleného vlastníka, a související kontakty / společnost.
Pravděpodobnost výhry
Procentní šance na výhru. Nastavte ručně nebo spočítanou AI na základě vašich historických výherních dat. Řídí váženou předpověď.
Rozdat zdraví
Zelená (zdravá), oranžová (ohrožená), nebo červená (zastavena). Na základě aktivity regency, fáze trvání a signály zapojení.
Úkoly
Co je úkol
Následné akce přidělené osobě. Úkoly mají název, datum splatnosti, prioritu, typ (volání, e-mail, setkání, jiné) a související kontakt / obchod.
Úkoly vytvořené AI-
AI vytváří úkoly automaticky, když zjistí, že něco potřebuje pozornost: sledovat na pozastavené dohody, reagovat na účet na riziko, výzkum nové vodítko.
Hledání horkých stop
Scénář:
You want to see all high-score contacts in the UK who have not been contacted recently.
Co dělat:
Přejděte na Kontakty. Filtrujte podle: Olověné skóre > 80, Country = Spojené království, Poslední činnost > 7 dny před. Třídit podle olova skóre sestupný. Jedná se o vaše nejžhavější zanedbávané stopy, prioritizovat outtage.
Vytvoření dohody z kontaktu
Scénář:
A contact just expressed interest in your enterprise plan during a chat.
Co dělat:
Otevřete kontaktní profil. Klikněte na "Vytvořit dohodu". Zadejte název transakce (např. "Acme Corp - Enterprise Plan"), množství, potrubí a jeviště (např., "Kvalifikované"). Nastavte datum uzavření a přiřaďte si jej. Trenér Deal začne sledovat tuto příležitost.
CRM
Plynovod (vaše deal board)
Pipeline je vizuální deska, kde se obchody pohybují po etapách zleva doprava. Přetáhněte a kapku karty na předem nabídky. Každá karta ukazuje částku transakce, vyhrát pravděpodobnost, a zdravotní stav.
PotrubíSkutečná obrazovka potrubí: živé statistiky (otevřená hodnota, vážená prognóza), fronta AI Approst pro navrhované obchody a drag- and-drop board.
Použití potrubí desky
1
Zobrazit své nabídky
Plynovod ukazuje všechny aktivní obchody jako karty uspořádané ve sloupcích (etapách). Každý záhlaví sloupce ukazuje celkovou hodnotu obchodů v této fázi.
2
Přetáhněte k postupu
Přetáhněte kartu do další fáze. Výhra a okamžitě počítá s aktualizací. Pokud se pohyb nezdaří (chyba ověření), karta přeskočí zpět do původní polohy.
3
Štítky na kartě
Zelená značka = zdravá (nedávná aktivita, na trati). Amber = v nebezpečí (zpomalování, vyžaduje pozornost). Červená = zastavena (žádná činnost příliš dlouho).
4
Kliknutím na podrobnosti
Klikněte na kartu pro otevření panelu s detaily dohody s kontakty, aktivity, Deal Coach stručný a rychlé akce.
Schvalovací fronta
Návrhy AI se objevují ve schvalovací frontě na horní straně potrubí. Každý návrh ukazuje, co chce AI dělat, proč a důkazy. Můžete:
Schválení
Přijetí návrhu je. Akce probíhá přes Spořicí vrstvu a je zaznamenána v deníku.
Upravit
Před schválením návrhu změňte návrh. Například změňte navrhovanou fázi nebo upravte částku.
Odmítnout
Uzavírat návrh. AI se učí od odmítnutí, aby v budoucnu lépe navrhovala.
Vysvětlená pravděpodobnost výhry
Výherní pravděpodobnost lze nastavit ručně nebo vypočítat AI. Když AI vypočítá, použije model vyškolený na vlastní uzavřené obchody (vyhrál a ztratil). Pokud nemáte dostatek historických dat, AI používá fázi výchozí pravděpodobnosti. Pravděpodobnost pohání váženou předpověď: $10,000 obchod v 30% pravděpodobnost přispívá $3,000 k "pravděpodobné" prognóze.
Přesun dohody na Won.
Scénář:
A customer signed the contract and paid.
Co dělat:
Přetáhněte tu kartu do fáze "Won". OpsIQ (1) Označit dohodu jako uzavřený-won. (2) Aktualizovat předpověď. (3) Přidat "Won" činnost do časové osy. (4) Pokud je nakonfigurován, spustí se událost webhook (crm.deal.won). (5) Aktualizujte fázi životního cyklu na "Zákazník".
Zachycení uvízlých obchodů
Scénář:
You want to find deals that have been in the same stage for too long.
Co dělat:
Hledejte červené (stagled) odznaky na potrubí desky. Tyto obchody nemají činnost delší než nakonfigurované hnijící práh (nastaveno v CRM Konfigurace > Pipelines). Klikněte na každé zastavil dohodu vidět Deal Coach doporučení pro reaktivaci.
Můžu dostat několik potrubí?+
Ano. Přejděte na CRM Configuration > Pipelines vytvořit další potrubí. Společné případy použití: oddělené potrubí pro nové podnikání vs. obnovování, nebo pro různé produkty / služby.
Co se stane, když přetáhnu dohodu na "Ztracené"?+
Dohoda je označena jako uzavřený-ztratil. Budete požádáni z důvodu ztráty. Dohoda je odstraněna z aktivní desky, ale lze ji nalézt v uzavřeném filtru deals. Kontakt zůstává v CRM.
CRM
Ujednání koučování
Deal Coach analyzuje každou dohodu a dává vám stručný s zdravotním stavem, rizikové signály, klíčové lidi, kvalifikační kontrolní seznam, setkání přípravné, a navrhl další akce. Vše je získáno. Trenér ukazuje, které jízdenky, chat, nebo činnost každý nárok pochází z.
Dohodnuto, trenére.Trenér signalizuje, proč by dohoda mohla sklouznout (každý signál cituje jeho zdroj) a podává vám další krok k přijetí.
Co vám trenér říká
Zdravotní vysvětlení
Proč je dohoda zdravá, v ohrožení, nebo pozastavena. Specifické signály: dny ve fázi, poslední kontaktní datum, frekvence aktivit, konkurent zmiňuje, námitek vzory.
Signály
Zařazen do: námitky vzneseny, konkurent zmiňuje, cenových diskusí, podporu indikátorů rizik, obnovení / rozšíření signálů. Každý signál odkazy na jeho zdroj (chat přepis, jízdenka, e-mail, činnost).
Mapa šampionů a blokátorů
Kdo pomáhá dohodě (šampion) a kdo se brání (blokátor). Na základě interakční analýzy a kontaktní role.
Kontrolní seznam kvalifikací
MEDDIC nebo BANT kontrolní seznam (konfigurovatelný) ukazující, která kritéria kvalifikace jsou splněna a která chybí. Stupeň: A, B, C, D nebo F.
Příprava zasedání
Před plánovaným zasedáním vytvoří trenér stručný přehled: program, klíčové body k pokrytí, otázky, které je třeba položit, rizika, která se budou řešit, a materiály, které bude třeba připravit.
Přijímat a volat plány
Navrhl další zprávu nebo call skript založený na aktuálním stavu obchodu a nedávných interakcí.
Časová osa důkazů
Každé tvrzení, které trenér provede, odkazuje na zdroj: číslo tipu, ID přepisu chatu, datum činnosti nebo návštěva webových stránek.
Jak se používá trenér
1
Přečtěte si ten článek.
Otevřete jakýkoliv obchod a posuňte se do sekce Deal Coach. Přečtěte si zdravotní stav a klíčové signály.
2
Úzké mezery v kvalifikaci
Zkontrolujte seznam kvalifikačních požadavků. Pokud chybí "Ekonomický kupující", plánujte identifikovat a zapojit držitele rozpočtu.
3
Zákon o návrzích
Trenér navrhuje konkrétní další akce. Klikněte pro vytvoření úkolu, navrhnout e-mail, nebo naplánovat schůzku, všechny směrované přes schvalovací frontu.
Příprava na velkou schůzku
Scénář:
You have a meeting with a prospect tomorrow about a $50,000 deal.
Co dělat:
Otevřete dohodu a přečtěte si sekci Přednáška setkání. Zobrazuje: (1) Klíčové body jednání založené na nedávných interakcích. (2- Námitka, které vznesli minulý týden.3) Soutěžitel, o kterém se zmínili v podpůrných lístcích. (4Otázky, které se mají zeptat na jejich časovou osu. (5) Rizikové faktory k proaktivnímu řešení. Použijte tento stručný pro přípravu cílené, důkazní agenda.
Pochopení, proč je obchod ohrožen
Scénář:
The pipeline shows a red badge on a deal you thought was going well.
Co dělat:
Klikněte na dohodu a přečtěte si Deal Coach zdravotní vysvětlení. Mohlo by se říci: "Tato dohoda byla ve fázi návrhu pro 22 dny (práh: 14). Poslední kontakt 11 Před několika dny. Primární kontakt otevřel podpůrnou jízdenku o problematice migrace dat 5 Před dny (vstupenka # T-892). Návrhy: zabývat se migračním problémem a naplánovat následný hovor. "Nyní přesně víte, co opravit.
CRM
Předpověď a zprávy
Prognóza třídy Board- s obranným rozsahem, deal- úroveň vysvětlení a přesnost sledování, takže můžete prokázat a vysvětlit svá čísla.
PředpověďZavázat, best- case a potrubí na první pohled, AI- vážená dohodou zdraví, s přesností sledovat, takže můžete bránit.
Kategorie předpovědí
Zaslíbené
Vyjednává s 80% nebo vyšší pravděpodobnost výhry. Jedná se o vaše nejpravděpodobnější výhry, to by mělo být vaše minimální očekávané příjmy.
AI- vážená pravděpodobnost
Všechny otevřené nabídky vážené jejich AI- vypočtená pravděpodobnost výhry. To je nejrealističtější předpověď toho, co uzavřete.
Nejlepší případ
Všechny otevřené obchody v plné hodnotě. To je maximální možný příjem, pokud vše jde perfektně (to málokdy dělá).
Interval spolehlivosti
An 80% Pravděpodobnostní pásmo zobrazující realistický rozsah. Příklad: "Pravděpodobně uzavřete mezi $45,000 a $72,000 Tento čtvrťák. "
Co se změnilo a proč
Předpověď obsahuje přepočet na změnu za týden. Když vaše předpověď klesne o $15,000, zpráva vysvětluje přesně, které dohody způsobily změnu: "Dohoda A sklouzl do příštího čtvrtletí ($8,000), Deal B lost ($5,000), Deal C reduced in value ($2,000)."
Sledování přesnosti
Předpověď MAPE
Mean Absolute Percentage Error: how far off your forecasts have been historically. Lower is better. A MAPE of 15% means your forecasts are typically within 15% of actual results.
Kalibrace pravděpodobnosti výhry
Brier skóre měření, jak dobře vyhrát pravděpodobnosti shodují skutečné výsledky. Pokud se dohodne na 70% pravděpodobnost ve skutečnosti vyhrát 70% v době, kalibrace je dobrá.
Víkendové snímky
OpsIQ zachycuje snímek vaší předpovědi každý týden (přes cron). Časem můžete vidět, jak se vaše predikce zlepšuje.
Válečky a varování
Přepočet na perstage
Kolik obchodů se pohybuje z každé fáze do další. Pokud 80% Přechod z kvalifikované do návrhu, ale pouze 20% přejít od návrhu k vyjednávání, vaše návrhy by mohly potřebovat práci.
Výhra za zdroj per- source
Které hlavní zdroje produkují nejvíce výher. Investovat více do vysoce-win- rate zdrojů.
Výkonnost předvlastníka
Jak každý člen obchodního týmu provádí: výhry z obchodů, hodnota potrubí, průměrná velikost obchodu, výherní cena.
Your quarterly forecast dropped from $180,000 to $155,000 since last week.
Co dělat:
Otevřete stránku Předpovědi a zkontrolujte "Co se změnilo". Zpráva ukazuje: "Acme Corp deal (Acme) ($15,000) přesunuto do Lost, konkurent vybrán. Beta Inc deal ($8,000 Nová dohoda s Gamma LLC ($3,000) přidána tento týden. "Čistá změna je -$20,000 + $3,000 = -$17,000, Vysvětlující pokles z $180K na $163K (se zbývajícími $8K vysvětleny pravděpodobnostní úpravy na jiných obchodech).
CRM
Hledání nových obchodů
Prospecting Agent vám pomůže najít a výzkum potenciálních zákazníků. Popište svého ideálního zákazníka, přidat cílové společnosti, a nechat AI výzkum, skóre, a návrh první dotykový dosah.
VyhledáváníAgent SDR najde cílové společnosti, dá je do kondice a načrtne první kontakt na vaši recenzi.
Nastavení času
1
Popište svého ideálního zákazníka
Přejděte na CRM Configuration > Prospecting. Popište svůj ideální profil zákazníka (ICP): cílový průmysl, velikost firmy, názvy pracovních míst, geografické zaměření, podmínky utkání produktů a minimální skóre uložení. Příklad: "B2B SaaS společnosti s 50-500 zaměstnanci v USA / Velké Británii, kteří prodávají vývojové nástroje, s VP prodeje nebo vedoucí růstu jako primárním kontaktem. "
2
Přidat cílové společnosti
Zadejte domény společnosti nebo jména, které chcete prozkoumat. Můžete také nechat AI navrhnout společnosti na základě vašeho ICP.
3
Přezkum výsledků výzkumu
AI obohatí každou společnost dostupnými údaji: velikost, průmysl, technický stack, nedávné zprávy, a fit skóre s vysvětlením.
4
Schválit oslovení
Pro dobré-fit společnosti, AI navrhuje personalizované first-touch zprávu. Přezkum a schválit ve frontě.
Skóre
Každá vyhlídka dostane0-100 skóre five na základě pěti faktorů:
IKP fit
Jak dobře se společnost shoduje s vaším ideálním zákaznickým profilem (průmysl, velikost, umístění).
Nouzové signály
Je zde důkaz, že potřebují váš produkt nyní? Pracovní příspěvky, technické změny, stížnosti na konkurenty.
Proxy rozpočtu
Velikost společnosti, fáze financování a ukazatele příjmů naznačují dostupnost rozpočtu.
Shoda produktů
Jak důležitý je váš výrobek pro jejich podnikání založené na průmyslu a technologii.
Podpůrné vybavení
Zda můžete efektivně sloužit tomuto zákazníkovi (časové pásmo, jazyk, složitost).
Výzkum cílové společnosti
Scénář:
You want to evaluate whether acme.com is worth pursuing.
Co dělat:
Přidat acme.com AI se vrací: Fit skóre 78/100 (dobře se hodí). Důvody: B2B SaaS, 120 zaměstnanci na US- bázi, nedávno najal VP prodeje (naléhavý signál), používá konkurenta X (zápas výrobků). Nákupní signály: navštívil svou cenovou stránku dvakrát minulý měsíc (ze sledování webových stránek). Nejlepší kontakt: [email protected] (VP of Sales). Vypracovaný otvírák odkazuje na jejich nedávné nájemné a ceny stránky návštěvy.
CRM
Automatické sekvence sledování
Sekvence automatizovat multi- kroky follow- up: mix e-mailu, čekat, úkol, volání, a webhook kroky, které běží automaticky po schválení počáteční odeslání.
SekvenceAutomatizované multi- krok follow- up (email, čekat, e-mail, úkol), že jste schválit první a odpověď se automaticky zastaví.
Jak sekvence fungují
1
Vytvořit sekvenci
Definujte kroky: email, čekat 3 dny, e-mail, počkat 5 dny, úkol (pokud není odpověď), e-mail. Každý e-mailový krok má šablonu můžete přizpůsobit.
2
Zapsat kontakty
Přidejte kontakty do sekvence. AI může také navrhnout zápis z vyhledávání výsledků.
3
Automatické provedení
Kroky běží automaticky podle plánu. Pokud kontakt v kterémkoli bodě odpoví, sekvence se zastaví automaticky.
4
Výsledky dráhy
Viz otevřené kurzy, sazby odpovědí, přepočítací koeficienty, a odhlášení za krok. Použijte to pro optimalizaci své posloupnosti.
Odpovězte na otázku
Pokud kontaktní osoba odpoví, AI odpověď klasifikuje:
Pozitivní
Zájemci, chtějí si promluvit. Sekvence pauz, úkol vytvořen pro pokračování.
Námitka
Má obavy, ale ne odmítnout. Sekvence pauzy, úkol vytvořen s námitkami podrobnosti.
Odhlásit se
Chce přestat přijímat zprávy. Kontakt je trvale potlačen.
Teď ne.
Zaujalo mě načasování, ale není správné.
Špatná osoba.
Zastavit sekvence, kontakt označen jako kritický.
Podpora
Otázka podpory, ne prodejní odpověď. Sekvence pauz, vytvořené jízdenky.
Anti- spam ochrana
Opt- out manipulace
Žádosti o odhlášení jsou okamžitě vyslyšeny a kontakt je potlačen ze všech budoucích sekvencí.
Denní víko
Denní limit pracovní mezery (výchozí: 1,000 emaily). Zabraňuje hromadné odesílání, které spouštěcí filtr spamu.
Mezní hodnota pro per- kontakt
Maximální 1 zpráva na kontakt za den. Zabraňuje zdrcující individuální lidi.
Manipulace s překryvem
Kroky, které přesahují denní uzávěr, jsou odloženy na následující den. Nikdy se neklesnou nebo nepřeskočí.
Co se stane, když kontakt otevře podpůrnou jízdenku během sekvence?+
Sekvence automaticky zastaví. Podpora má přednost před dosažením informací. Po vyřešení problému podpory lze sekvenci obnovit ručně.
Mohu udělat kroky pro zkoušku A / B?+
Ne přímo v rámci sekvencí, ale můžete vytvořit dvě sekvence s různými zpráv a porovnat jejich výsledky.
CRM
Růstové nástroje
Jedna stránka pod CRM, která drží růstový motor: opakující se příjmy (MRR / ARR), katalog produktů, lead-capture formuláře, rezervační odkazy a vedení. Vše zde píše přímo do CRM. Takže formulář podání nebo rezervovaný hovor je kontakt s historií, ne řádek v tabulce.
Co žije na stránce
Nahrazující příjmy
Příjmy
MRR a ARR se promítají z vaší skutečné účetní knihy. Předplatné jsou seskupeny od plateb na platformu, fakturační cyklus je odvozen z platebních mezer a předplatné selže, když platba má zpoždění za 1.5 krát jeho cyklus. Zákazníci odkaz na CRM kontakty automaticky, když účetní kniha nese jejich e-mail.
Katalog produktů
Katalog
Jeden zdroj pravdy pro to, co prodáváte. Citace vytáhnout název a seznam ceny z katalogu, a přijaté citace se převalují do příjmů podle produktu. Archiv produktů, nikdy smazat.
Formuláře pro zachytávání vodítek
Zachycení
Každý formulář dostane hostovanou stránku plus iframe vložený kód pro vaše vlastní stránky. Odesílání se stanou kontakty, majitel dostane oznámení, a vaše pravidla směrování přiřadit vedení.
Odkazy na rezervace
Plánování
Sdílet odkaz, nechat vyhlídky vybrat volné slot. Slots respektovat pracovní dobu organizátora, časové pásmo a stávající setkání. Rezervace vytváří schůzku, e-mailem vyhlídku potvrzení a oznamuje pořadatele.
Směrování olova
Směrování
Územní pravidla běží první, pak pole pravidla (zápas pole, jako je země nebo zdroj), pak round-robin přes váš rep pool. To trains CONTTACTS AND DEALS stejně, bez ohledu na stav dohody: won deal stále potřebuje majitele pro commission aspartament, účet odpovědnost a controlling-up, a v režimu vlastník nebo tým Viditelnost Unowned záznam je neviditelný pro každého, ale manažer. Záznamy vytvořené automatizací (konektor prodej, chat, import) nenesou žádný interaktivní tvůrce, takže jsou směrovány stejnými pravidly na vytvoření spíše než vlevo vlastník. Cokoliv, co již má majitel je nikdy znovu podepsaný.
Vytvořte si první formulář
1
Otevřené růstové nástroje
Přejděte na CRM, pak růstové nástroje, pak Lead- zachycení formuláře sekce.
2
Pojmenujte to a vyberte pole
Zadejte název a seznam oddělených polí, například jméno, e-mail, telefon, zpráva. Email je vždy vyžadován.
3
Sdílet nebo vkládat
Kopírovat hostovaný odkaz sdílet kdekoli, nebo kopírovat vložený kód a vložit do jakékoli stránky na vašich webových stránkách.
4
Sledovat stopy přichází
Každé podání je CRM kontakt s formá. submitted činnost, oznámení vlastníka a automatické směrování.
💡
Veřejné zachytávací stránky používají vlastní adresu vašeho pracovního prostoru. Pracovní prostory Cloud využívají přiřazenou subdoménu (společnost.opsiq.help), takže odkaz vždy řeší správná data.
Budova - v ochraně
Boty vidí úspěch, nic nevidíte.
Skryté pole medu tiše zavrhne robotí podání.
Míra omezená
Deset podání za hodinu na IP adresu napříč formuláři a rezervacemi.
Souhlas zůstává upřímný.
Přidání formuláře neuděluje souhlas s uvedením na trh. Pouze explicitní kontrolní políčko souhlasu.
Žádná dvojitá rezervace
V okamžiku rezervace je znovu ověřen slot na základě nové kontroly dostupnosti.
Odkud se berou opakující se příjmy?+
Ze stejné obchodní knihy, kterou vaše prodejní stránka používá, napájená fakturačními konektory. Použijte Resynchronizaci z vyúčtování po připojení nové platformy.
Mohu použít formuláře bez webových stránek?+
Ano. Každý formulář má na vlastní adrese hostovanou stránku, která funguje samostatně, s nebo bez JavaScript.
CRM
Hub zpráv (SMS a WhatsApp)
Jeden konektor, až dvacet bran. Připojte SMS a WhatsApp poskytovatele, které ve skutečnosti používáte, označte jednu jako výchozí, a vyberte některý z nich při psaní kontaktu. Souhlas je kontrolován CRM před jakýmkoliv kontaktem brány.
Nastavit to
1
Povolit konektor
Na stránce Connectors otevřete Messaging Hub (SMS a WhatsApp) a zapněte to.
2
Přidat poskytovatele
Ve stejném šuplíku, nebo v CRM růstových nástrojích, vybrat bránu z dropdown (Twilio, Vonage, Termii, Meta WhatsApp Cloud, Infobip a další), vložit své API pověření a připojit. Můžete přidat několik, včetně stejné brány dvakrát s různými účty.
3
Propojit webháček
Každý vstup poskytovatele zobrazuje svůj vlastní webhook URL s kopírováním tlačítka. Vložte jej do zprávy o dodání brány a inunlimit- message nastavení, aby se stav doručení a odpovědi zpět do OpsIQ.
4
Odeslat z kontaktu
Otevřete kontakt a použijte tlačítko SMS nebo WhatsApp. Pokud kanál podporuje více než jeden poskytovatel, volič vám umožní vybrat, jinak je použit výchozí.
Souhlas je na prvním místě.
Pouze udělený souhlas
Neznámý souhlas není souhlas. Odeslat odmítne, pokud SMS souhlas není výslovně udělen. WhatsApp jezdí na stejném souhlasu.
Nekontaktuje vždy vyhraje
Nekontaktuj vlajku, která blokuje každý kanál, ať je nastaven cokoliv.
Pohrdání ctí
Kontakty na seznamu odrušení se nikdy neodesílají.
Přejmenovávají svůj důvod.
Blokovaný send vám řekne přesně proč, takže můžete opravit data místo hádat.
Pro vývojáře: Webhook kontrakt
Tvar URL
https://your-address/opsiq/cron/messaging_webhook.php?sk=SITE_KEY&e=ENTRY_ID&t=TOKEN. Při připojení poskytovatele je vyražen vstupní symbol a nikdy se neotáčí při editaci.
Formáty porozuměny
Twilio form posts (MessageStatus/MessageSid for delivery, Body/From for inbound), Meta WhatsApp Cloud JSON (statuses and messages, including the hub.challenge subscription handshake), and a generic JSON shape: {"type":"delivery","message_id":"...","status":"delivered"} or {"type":"inbound","from":"+234...","body":"..."}.
Účinky
Zprávy o dodání označují řádek informační knihy, který nese ID zprávy poskytovatele jako doručené nebo odkopnuté. Přichozí zprávy odpovídají kontaktu telefonním číslem uvnitř pracovního prostoru, zemi jako message. received činnost, a označit rozhovor odpověděl.
Režim selhání
Chybné nebo chybějící token odpovědi 403. Neznámé užitečné zatížení se počítá a ignoruje, nikdy fatální, takže špatně nastavená brána nemůže prolomit koncový bod.
Které brány jsou podporovány?+
Twilio, Vonage, Plivo, MessageBird, Sinch, Infobip, Telnyx, ClickSend, Termii, Africa Talking, BulkSMS, Textlocal, Meta WhatsApp Cloud, 360dialog, SMSAPI, Gupshop, Kaleyra, D7 Networks, Hubtel, a vlastní HTTPS webháček pro cokoliv jiného.
Jsou doklady v bezpečí?+
Záruky jsou uloženy v nastavení konektoru a nikdy se neopakují zpět do prohlížeče. Upravování položky s prázdným tajemstvím uchovává uložený.
Může AI poslat zprávy?+
Ano, prostřednictvím registrovaných akcí, které vyžadují potvrzení a spustit stejný souhlas brány. AI může také seznam připojených poskytovatelů vysvětlit, co je k dispozici.
CRM
Zachování a růst zákazníků
Řízení životního cyklu vám pomůže chránit stávající příjmy. Každý účet dostane Churn riziko skóre, zdravotní skóre, expanzi skóre, a doporučená úspěšnost playbook.
Životní cyklusZákazníci se pohybují přes nastupování, aktivní, at- riziko a obnovení, každý zaznamenal pro zdraví a rozšíření s příručkou.
Lifecycle board
Mapa jeviště
Vizuální deska ukazuje, kde každý účet stojí: Olovo, Prospect, Příležitost, Zákazník, Rozšíření, Obnova, V riziku, Koordinováno.
Účty s rizikovým rizikem
Účty označené vysokým rizikem vyvolání. Každý z nich ukazuje nejvyšší ovladač (podpůrný hřeb, nečinnost, platební selhání) a doporučenou hru na ukládání.
Rozšíření možností
Účty, které ukazují signály připravenosti k nákupu více: vysoké využití, funkce žádosti, plán šetření.
Splácení
Účty s nadcházejícími daty obnovení, členěné podle úrovně rizika a hodnoty příjmů.
Jak OpsIQ detekuje riziko churn
Riziko vyvolání selhání se vypočítá z více signálů spojených dohromady:
Otevřený počet lístků, zvýšení objemu lístku, negativní sentiment, eskalace.
Zapojování produktů
Frekvence přihlášení, používání funkcí, návštěvy stránek, API volání.
Signály pro vyúčtování
Neúspěšné platby, opožděné faktury, žádosti o snížení hodnoty, zrušení návštěvy stránek.
Příručky
Uložit hru
Pro rizikové účty: proaktivně se obraťte na obavy, nabídněte podporu, v případě potřeby vystupňovat.
Obnovitelná hra
Pro nadcházející obnovení: potvrďte spokojenost, přehodnoťte použití, současná hodnota, případně nabídněte pobídku.
Rozšiřující hra
Pro readytogrow účty: současné možnosti upgrade, sdílení úspěchů, demonstrujte ROI.
Adopční hra
Pro nedosahování účtů: nabízejí školení, sdílejí osvědčené postupy, umožňují funkce, které nepoužívají.
Zahlédnutí churn, než se to stane
Scénář:
A customer who normally logs in daily has not logged in for 2 weeks, and they opened 3 support tickets this month.
Co dělat:
Na palubě Lifecycle je tento účet označen jako "At Risk" s řidiči: nečinnost (14 dny od posledního přihlášení) a podpůrný hřeb (3x normální objem tipu). Doporučené hrát: proaktivní informační volání pochopit, co se děje. Je tam problém výrobku? Jsou hodnocení konkurentů? Časný zásah může uložit účet.
CRM
Udržujte si údaje čisté.
Agent správce dat automaticky najde a opraví problémy kvality údajů: duplikáty, chybějící pole, nesrovnalosti a zastaralé záznamy.
Správce údajůSprávce udržuje váš CRM čistý, hledá duplikáty, mezery, zatuchlé záznamy a špatné formáty, upevňuje na schválení.
Správce navrhuje sloučení: vést záznamy s větší aktivitou, sloučit další reporty a aktivity. Přehodnotit návrh, upravit přeživší název displeje v případě potřeby, a schválit. Historie záznamů je zachována ve spojení kontaktu.
CRM
Vybudovat CRM
Sestavte si můj CRM umožňuje popsat nastavení CRM v jednoduché angličtině. OpsIQ generuje validovaný, reverzibilní plán a aplikuje jej na schválení. Žádné kódování, žádné ruční konfigurační kliknutí.
Vybudovat CRMPopište své podnikání v angličtině; OpsIQ navrhuje celý CRM (stupně, pole, segmenty) a použije jej na schválení.
Jak to funguje
1
Popiš, co chceš.
Napište jednoduchý anglický popis nastavení CRM. Příklad: "Vytvořte si ropovod obnovení s etapami: Upcoming, Contacted, Vyjednávání, Obnovení, Lost. Skóre vede vyšší, když vidí ceny dvakrát".
2
Přezkum plánu
OpsIQ ukazuje náhled toho, co vytvoří: potrubí, fáze, pravděpodobnost, bodovací pravidla, životní cyklus pravidla. Přezkoumávat každý bod.
3
Aplikovat
Klikněte na tlačítko Aplikovat pro provedení plánu. Každá změna je zaznamenána jako svazek můžete vrátit v jednom kliknutí.
4
V případě potřeby se otočte.
Pokud něco není v pořádku, klikněte na tlačítko Oddo vrátit celý svazek. Váš CRM se vrátí do svého předchozího stavu.
Co můžeš postavit
Potrubí a etapy
Vytvořit pojmenované potrubí s vlastní fáze, výchozí pravděpodobnosti, a hnijící prahy.
Pravidla pro třídění
Zvýšení skóre na základě chování: "Skóre vyšší, když vidí ceny", "Sóre nižší, když navštíví kariéru stránku".
Pravidla životního cyklu
Automaticky postoupit do životního cyklu fáze: "Přesun na SQL, když žádají demo", "Přesunout se na zákazníka, když je dohoda vyhrána".
Vlastní pole
Přidat pole do kontaktů, obchodů, nebo společností: text, počet, datum, vybrat, checkbox, URL, e-mail.
Kontrolní seznam kvalifikací
Definujte seznam MEDDIC nebo BANT hodnocení Deal Coach proti.
Zavedení obnovovacího potrubí
Scénář:
You manage SaaS subscriptions and need a pipeline for renewals.
Co dělat:
Typ: "Vytvořte ropovod pro obnovu. 90 Dny pryč (10%), 60 Dny pryč (25%), Kontaktované (40%), vyjednávání (60%), Renewed (100%), Koordinované (0%). Nastavit hnijící práh na 14 dny. "OpsIQ generuje plán, přehodnotíte ho a klepněte na tlačítko Aplikovat. Plynovod se objeví na vaší stránce Pipeline okamžitě.
Co když popíšu něco, co není možné?+
Stavebnice generuje pouze akce, které umí validovat. Pokud si o něco požádáte mimo své schopnosti (např. "Integrovat s mým vlastním API"), zamítne žádost a vysvětlí, co může udělat místo ní.
Můžu vrátit změny?+
Ano. Každá akce Build My CRM je zachycena jako reverzibilní balík. Přejděte na CRM Health > Změnit historii vidět všechny balíky a odčinit některý z nich.
CRM
Nastavení CRM po vašem
Ruční konfigurace CRM pro týmy, které preferují kliknutí nad psaní. Všechna nastavení, která mohou vytvořit můj CRM, jsou také k dispozici jako tradiční pole formulářů.
Potrubí a etapy
Vytvořit, přejmenovat, přeobjednat a smazat potrubí a fáze. Nastavte výchozí pravděpodobnost výhry na etapu. Nastavit práh hnití (dny bez aktivity před tím, než je obchod označen "stagled").
Vlastní pole
Přidejte pole k deals, kontaktům, nebo firmám. Typy polí: text, počet, datum, vyberte (dropdown s předdefinovanými možnostmi), zaškrtávací políčko, URL, email. Vlastní pole se zobrazí na profilu objektu a v filtrech.
Kontrolní seznam kvalifikací
Definujte kontrolní seznam, který trenér Deal používá pro vyhodnocení obchodů. Vyberte MEDDIC, BANT, nebo vlastní sadu kritérií. Každá položka může být označena požadovanou nebo volitelnou.
Pravidla pro etapu životního cyklu
Definovat automatické přechody fáze: když kontakt splňuje podmínku (zobrazení cenových podmínek, předkládá formulář, provede nákup), jejich životní cyklus fázi automaticky postupuje.
Pravidla pro bodování v první řadě
Zvýšení nebo snížení olověných skóre na základě chování. Příklady: "Zobrazeno cenová stránka = +15 body "," Downloaded whitepaper = +10 body, "" Navštívená kariéra stránka = -5body. "Minimální počet lze nastavit (např.," musí zobrazit ceny alespoň 2 časy ").
Uložené pohledy
Vytvořte pojmenované kombinace filtru + třídit pro kontakty, obchody nebo firmy. Sdílejte názory s týmem. Nastavte výchozí pohled na typ objektu.
Přidání pravidla bodování olova
Scénář:
You want contacts who view your pricing page twice or more to get a higher score.
Co dělat:
Přejděte na konfiguraci CRM > Pravidla pro scoring olova. Klikněte na možnost Přidat pravidlo. Nastavit: Událost = "pageview", URL obsahuje = "/pricing", Minimální počet =2, Skóre boost = +20. Uložit. Příště, když střelec běží, kontakty odpovídající tomuto pravidlu dostane +20 Na jejich hlavní skóre.
CRM
CRM kontrola zdraví
CRM Health je self-diagnostická stránka, která ověřuje, že je váš CRM správně nastavený a běží hladce.
Kontrola stavuJednostránkový audit CRM: celkové skóre v oblasti zdraví plus kontrolní seznam toho, co je nastaveno správně a co stále ještě potřebuje pozornost.
Co to kontroluje
Schéma
Databázové tabulky existují a mají správné sloupce. Pokud migrace byla minula, CRM Health bude vlajka to.
AI činidla
Všichni agenti CRM (Capture, Data Steward, Deal Intelligence, atd.) jsou registrováni a zdraví. Zelená = běh, jantar = potřebuje pozornost, červená = chyba.
Trasy
Trasy CRM API a koncové body AJAX jsou registrovány a hodnotitelné.
Akce v oblasti AI
Akční katalog CRM je zapsán v akčním registru. Pokud chybí akce, CRM Health se sám léčí jejich opětovným registrací.
Počet živých dat
Celkové kontakty, firmy, obchody, úkoly, činnosti a události. Užitečné pro ověření dovozu a průběžné zachycování dat.
Po kontrole nastavení
Po prvním nastavení CRM otevřete CRM Health a ověřte, zda jsou všechny kontroly zelené. Pokud jsou nějaké oranžové nebo červené, klikněte na položku pro diagnostické vysvětlení a navrhl opravu.
Jak často mám kontrolovat CRM zdraví?+
Zkontrolujte po prvním nastavení, po hlavních aktualizacích, a kdykoli se chování CRM zdá být špatné. CRM Zdraví self-hojí mnoho problémů (jako chybějící registrace akce) jen otevřením stránky.
CRM
Připojení CRM pro vývojáře
CRM vystavuje kompletní veřejný REST API a odchozí webháky, takže se hodí do jakékoliv stack bez manuálního exportu.
Endpointy API
Ověření
API key (Authorization: Bearer opq_...) with scope crm.read or crm.write. POST to /api/v1.php with action and site_key.
Kontakty
crm. contacts. list (vyhledávání + filtr), crmm. contracts. detail (ID), Crm. contacts s. upsert (tvorba nebo aktualizace), CRm. Contact. save.
Vyhodili mě, když je dohoda uzavřena jako ztracená.
crm.task.created
Vystřelen při vytvoření nového úkolu (manuální nebo AI- generovaný).
crm.outreach.reply
Vyhozen, když se podívaná zodpovídá na sekvenční e-mail.
crm.agent.proposal_created
Vyhozen, když agent AI vytvoří návrh na schvalovací frontu.
All webhook events are HMAC-signed and retried on failure. Subscribe a URL in Settings > Webhooks, or poll crm.events.list with since_id for a durable change feed.
Synchronizace kontaktů CRM do Tabulek Google
Scénář:
You want every new CRM contact to appear in a Google Sheet for your marketing team.
Co dělat:
Nastavte předplatné webhooku pro crm. contact. created. Namiřte to na webovou aplikaci Google Apps Script nebo na webhook Zapier URL. Výplatní nálož obsahuje kontaktní jméno, e-mail, společnost, skóre vedení a zdroj. Váš skript přidává řádek ke listu Google pro každý nový kontakt.
CRM
Segmenty
Segmenty ukládají opakovaně použitelné kontaktní filtry pro zobrazení CRM, informační a propagační nástroje a další nástroje pro povědomí o posluchačích.
Produktová obrazovkaEditor Segmentu kombinuje podmínky, ukazuje počet živých zápasů a umožňuje operátorovi vybrat živý filtr nebo zapíchnutý snímek.
A živý segment přepočítává z aktuálních dat, kdykoli se používají. zaražený snímek zmrazit aktuální seznam členů, který je užitečný, pokud se po schválení nesmí změnit informační publikum.
Vyberte VŠECHNY pokud se musí každá podmínka shodovat nebo KAŽDÉ když jedna podmínka je dostačující. Překontrolujte živé počet před uložením. Systémové segmenty mohou být viditelné, ale chráněné před běžnou editací.
CRM
Bodování olova
Pravidla bodování vede k tomu, že chování a signály profilu přemění na konzistentní skóre, které mohou použít prodeje a automatizace.
Produktová obrazovkaOlověné bodování ukazuje aktivní pravidla, valivé okno a pozitivní nebo negativní skóre změna každé pravidlo platí.
Stavitel pravidel AI může změnit výuku prostého angličtiny na strukturované pravidlo. Každé pravidlo by mělo být ještě před aktivací přezkoumáno: potvrdit činnost nebo klíčové slovo, minimální počet, valivý okno a změna skóre.
Pozitivní a negativní pravidla mohou koexistovat. Resortní pracovní prostor po materiálních změnách pravidel, takže stávající kontakty jsou hodnoceny pod novým modelem. Výsledky mohou krmit segmenty, routing, vyhledávání a pracovní podmínky.
CRM
Prodejní žebříček
Vedení srovnává zástupce s využitím kvóty dosáhnout, získal příjmy, provize a otevřený plynovod pro vybraný měsíc.
Produktová obrazovkaMěsíční žebříček řadí obchodní zástupce a zároveň udržuje výherní příjmy, provize a otevřený plynovod viditelný.
Dosažení kvóty má význam pouze tehdy, když každý zástupce má stávající kvótu a dohody mají správný vlastník, množství, měna a blízký status. Použijte žebříček pro koučování a uznávání, ne jako jediné měřítko kvality; párovat s deal zdraví, činnost a prognózu přesnost.
CRM
Schválení k prodeji
Schválení k prodeji vyžaduje odpis správce, než lze vypsat nabídky nejvyšší hodnoty.
Produktová obrazovkaSchvalovací politika definuje dvě hodnotové prahy a fronta ukazuje dosud nepřipravená, schválená a zamítnutá rozhodnutí.
Povolit politiku a nastavit úroveň 1 a úroveň 2 prahové hodnoty. 0 Pokud se nemanažer pokusí vyhrát dohodu na prahu nebo nad ním, OpsIQ vytvoří žádost o schválení namísto tiché změny jeviště.
Manažeři a plné administrátoři nejsou blokovány pojistkou. Každé rozhodnutí by mělo zachovat požadavek, příjezd, čas a důvod pro auditivitu.
CRM
Pravidla životního cyklu
Pravidla životního cyklu automaticky přesouvají kontakty mezi etapami, kdy jejich aktuální data odpovídají uloženému stavu.
Produktová obrazovkaPravidla životního cyklu jsou hodnocena přednostně; první pravidlo shody mění fázi kontaktu.
Každé pravidlo má zdrojový stupeň, cílový stadium, aktivní vlajku, prioritní a segmentstyle filtr. Naplánované životní cyklus práce hodnotí vyšší priority nejprve a zastaví se po prvním utkání pro kontakt.
Pravidla by měla být vzájemně srozumitelná. Vyhněte se dvěma aktivním pravidlům, která mohou pohybovat stejným kontaktem v opačných směrech během stejného běhu. Před aktivací filtru zkontrolujte filtr proti segmentu.
CRM
Aktiva CRM proudění
Aktivita pracovního prostoru spojuje zákaznické a provozní akce, takže týmy mohou zkoumat, co se stalo, aniž by otevřely každý modul.
Produktová obrazovkaAktivita stream interliaves chat, vstupenky, e-mail, webhook, konverze a anomálie události s filtry a pagination.
Filtrovat podle typu události, data, kontaktní nebo zákaznický stav (včetně platících zákazníků). Krmivo je přečtený model zaznamenané aktivity; nenahrazuje zdrojový tip, rozhovor, deal nebo konektor záznam. Otevřete propojené záznamy před přijetím citlivých opatření.
CRM
Pracovní toky
Workflow reaguje na událost a provádí řádnou sérii akcí, včetně opožděných kroků obnovených cronem.
Produktová obrazovkaProvoz práce ukazuje spouštěč, dokončené akce, čekání zpoždění a další krok.
Vytvořte pracovní postup výběrem spouštěče, přidejte kroky v pořadí a umožněte. Zpoždění jsou uložena, nejsou držena žádostí prohlížeče; jednotný cron obnovuje řádné běh workflow.
Staveb- in starting šablon zahrnují vítání po signupu, post- nákup díku- a demo potvrzení. Klone šablony, nahradit příjemce / obsah, pak test s kontrolovaným záznamem před širokou aktivací.
Projekční akce, které mají být idempotentní. Retest nesmí posílat duplikát žádostí o pohyb peněz nebo vytvářet duplicitní záznamy.
Podpora
Vstupenky
Vstupenky jsou vaše formální podpůrný kanál. Mají oddělení, priority, SLA cíle, přílohy, vnitřní poznámky, a plné konverzace tweading. Vstupenky mohou přijít z OpsIQ admin, formulář vstupenky / vložka, e-mailové požití, chat eskalace, konektor, nebo API.
VstupenkyKaždý lístek nese svou prioritu, oddělení, SLA časovač a plné vlákno, a AI může vypracovat odpověď za vás.
Jak se lístek pohybuje
1
Lístek je tady.
Zákazník posílá zprávu e-mailem, eskalaci chatu, vloženou jízdenku nebo admin vytvoří. Tiket dostane unikátní ID (např. T-12345).
2
Tradice
AI čte předmět a tělo, přiřazuje priority (Nízká / Normální / Vysoká / Naléhavá), navrhuje oddělení, a detekuje sentiment. To se děje automaticky, pokud je povoleno třídění.
3
Odpověď
Agent otevře tiket, přečte kontext (profil zákazníka, platforma data z konektorů, předchozí tipy) a napíše odpověď. AI může vypsat odpověď a agent ji před odesláním upraví.
4
Zavřít
Když je problém vyřešen, agent uzavře jízdenku. Zákazník je informován. Pokud zákazník odpoví po uzavření, vstupenka se automaticky otevře.
Akce per- tipu
Změnit oddělení
Přesuňte jízdenku do jiného oddělení (např. z obecného na Billing). Užitečné, když se původní směrování mýlilo.
Přiřadit k agentovi
Přiřaďte letenku konkrétnímu členu týmu. Přidělený agent vidí jízdenku v jejich "Moje vstupenky" pohledu.
Přidat vnitřní poznámku
Napište poznámku viditelnou pouze pro zaměstnance. Použití pro: šetření zjištění, důvody vrácení, technické souvislosti, předchozí závazky. Interní poznámky se nikdy neobjeví pro zákazníky.
Skládací lístky
Kombinovat duplikát vstupenek od stejného zákazníka. Sloučený subjekt dostane [MERGED] značku. Všechny zprávy z obou vstupeneK jsou zachovány v přeživších tipu.
Kontejnery
Vložit předpsanou šablonu odpovědi. Proměnné jako {{customer_name}} a {{ticket_id}} jsou automaticky nahrazeny.
Přepsat AI
Nechť AI zlepšit svůj návrh odpovědi: upravit tón, zkrátit / prodloužit, opravit gramatiku, nebo přeložit. Přezkoumáte výsledek před odesláním.
Změnit prioritu
Nastavit na nízké, normální, vysoké, nebo Naléhavé. Priorita ovlivňuje SLA časovače a třídit pořadí.
Změnit stav
Nastavit na Open, Čekání na zákazníka, Vyřešeno, nebo Zavřeno.
Pracovní příklad: manipulace s nešťastným zákazníkem
Zákaznický email: "Dvakrát jsem byl účtován za předplatné"
Scénář:
Subject: Double charge on my account
Body: Hi, I just checked my bank statement and I see two charges of $49.99 from your company dated June 3. I only have one subscription. Can you please refund the duplicate charge? This is really frustrating.
Co dělat:
Step 1: AI triage assigns Priority: High, Department: Billing, Sentiment: Frustrated.
Step 2: Agent opens the ticket. The connector panel shows the customer's Stripe charges, confirmed two charges on June 3.
Step 3: Agent adds an internal note: "Confirmed duplicate charge in Stripe. Transaction IDs: ch_xxx and ch_yyy."
Step 4: Agent drafts a reply: "Hi [Name], I can see the duplicate charge and I'm processing a refund for the second transaction right now. You should see $49.99 back in your account within 3-5 business days. I'm sorry for the inconvenience."
Step 5: Agent triggers the refund action through the Stripe connector (with confirmation).
Step 6: Agent sends the reply and sets status to Resolved.
Odbory
Vytvořit oddělení v Nastavení > Vstupenky > Útvary. Společné oddělení: Obecné, Účtování, Technika, Prodej, Zneužití, Onboarding. Každé oddělení může mít různá pravidla autoodpovědí, AI znalosti a týmové úkoly.
Kontejnery
Vytvořte znovu použitelné šablony odpovědí v Nastavení > Vstupenky > Konzervované odpovědi. Dobré konzervované odpovědi zahrnují:
Příklad šablony odezvy v konzervách
Hi {{customer_name}},
Thanks for reaching out. I checked the details and here is what I found:
{{response_details}}
If you need anything else, just reply to this ticket and I will be happy to help.
Best regards,
{{agent_name}}
{{department_signature}}
Skládací lístky
Když zákazník pošle stejnou otázku vícekrát (přes e-mail a chat, nebo dva samostatné e-maily), můžete sloučit duplikáty. Přejděte na tip, klepněte na tlačítko Sloučení, vyberte druhý tip ke sloučení. Přeživší tiket dostane všechny zprávy z obou tipů. Subjekt složeného tipu získá [MERGED] značku, která ukazuje, že byl kombinován.
Priorita a SLA
Nízká
Non- urgentní otázky, požadavky na funkce, obecná zpětná vazba. Cílová první odpověď: 24 hodiny.
Normální
Standardní podpůrné otázky. Cílová první odpověď: 8 hodiny.
Vysoká
První reakce: 4 hodiny.
Naléhavé
První odpověď: 1 hodina.
SLA časovače začínají při vytvoření tipu a zastaví se, když je stav "Čekání na zákazníka". Pokud je cíl SLA vynechán, je tiket zvýrazněn a volitelně eskalován.
Mohou zákazníci vidět interní poznámky?+
Nikdy. Vnitřní poznámky jsou přísně personální-pouze. Neobjevují se v zákaznické vstupenky portálu, e-mailové oznámení, nebo jakékoli zákazníkovi-čelí povrchu.
Co se stane, když je na uzavřenou letenku zodpovězena?+
Jízdenka se automaticky otevře a vrátí do aktivní fronty. Tým je informován o nové odpovědi.
Mohu si zamknout lístek, abych zabránil dalším odpovědím?+
Ano. Použijte možnost Lock Thread, aby se zabránilo jak zákazník a AI od přidání nových odpovědí. Užitečné pro vyřešené spory nebo uzavřený vyšetřování.
Podpora
Service Studio: SLA, status flow a kvalita
Ovládací místnost pro to, jak se vaše podpůrná operace chová: SLA politiky s eskalační žebříky, business-hodiny kalendáře, vynucený status tok, CSAT nastavení a funkce podniku přepínače. Otevřete to ze stránky Vstupenky (Service Studio tlačítko v operačním baru).
Politika SLA
Každý nový tiket dostane první odpověď a termín řešení z nejkonkrétnějších aktivních politik: oddělení + priority je lepší než oddělení, přednostní, překoná výchozí. Termíny se automaticky zastaví, zatímco lístek sedí v Čekající nebo Pohotovostní.
Eskalační žebříky
Namísto jednoho porušení opatření může politika definovat až šest kroků: například upozorněte assignee na 75% z okna, varovné manažery na 100%, přeřazen na jmenovaného agenta v 150% Každý krok vystřelí přesně jednou za lístek.
Pracovní hodiny a kalendáře
S pracovní dobou běží hodiny SLA pouze během pracovní doby, takže jízdenka otevřená v pátek večer není porušena do soboty. Jmenované kalendáře (časové pásmo, dny, hodiny, svátky) lze připojit k jednotlivým politikám pro týmy v různých regionech.
Stavový tok
A od / do matice omezení, který status změny administrátoři mohou provést, s Zendesk-style preset. Automatizace, příchozí e-mail a zákazníkem-původem odpovědi na jízdenky jsou vždy osvobozeny, takže striktní matice nemůže nikdy rušivý potrubí. Volitelně vyžadují schválený sign- off před zavřením.
Schválení
Agenti žádají o odhlášení na jízdenku (vrácení přes práh, politické výjimky). Jmenovaný příchozí nebo kterýkoli úplný správce rozhodne s poznámkou; žadatelé nemohou nikdy schválit svou vlastní žádost. Do doby, než se schválení povrchu jako banner na schránce.
Vztahy mezi vstupenkami
Odkaz vstupenky jako související, duplicate, rodič / dítě nebo blokování; rozdělené odpovědi na novou propojenou jízdenku (reverzní sloučení, bez e-mailování zákazníka); sledovat tipy pro oznámení in- app a volitelně CC následovníka e-mailové adresy na outbound odpovědí.
Živá schránka a kolize
S real-time inbox povoleno, nové tipy a odpovědi se objeví pro agenty během několika sekund prostřednictvím stávajícího toku oznámení. Na vstupence, agenti vidět, kdo ještě je prohlížení a získat varovný banner, když spoluhráč už píše odpověď. Jednoklikové tlačítko Tvrzení přiřadí jízdenku pro sebe.
AI- aware routing
Pravidla směrování se mohou shodovat s AI triage signály: priorita, kategorie, sentiment a eskalační riziko, plus zadané hodnoty na míru z vašeho portálu poptávky formulář. Pravidla používající tyto podmínky zůstávají neaktivní, dokud funkce je povolena.
💡
Každý podnik přepíná lodě OFF. Zapnutí jednoho v servisním studiu → Kvalita & Automatizace je opt- in; vynechání je udržuje chování stejné jako před upgradem.
Proč může zákazník ještě otevřít uzavřenou jízdenku, když moje matrice zakazuje zavření → otevřené?+
Matrice řídí pouze akce ADMIN. Vlastní-původem odpovědi, e-mailové odpovědi a automatizace jsou záměrně osvobozeny, takže přísná politika nemůže nikdy zablokovat zákazníky ven nebo rozbít potrubí.
Nahrazují žebříky SLA staré porušení?+
Ne. Politiky uložené s jediným porušení akce stále fungují beze změny. Žebřík nahradí jedinou akci pouze na politiky, kde definujete kroky.
Podpora
Automatická odpověď a eskalace vstupenky
Automatická odpověď umožňuje AI reagovat na nové vstupenky automaticky. Eskalace přesune lístky do jiného oddělení, když AI zjistí specializované potřeby. Obě funkce pracují přes rodné vstupenky a email- vytvořil vstupenky.
Automatická odpověďNové vstupenky získat krátké zpoždění (takže lidé mohou skočit do), pak AI odpověď z vašich znalostí, poslal nebo fronta jako draft.
Jak funguje autoodpověď
1
Lístek se objeví
Z jakéhokoliv zdroje je vytvořena nová jízdenka (e-mail, chat, portál, API).
2
Odpověď na harmonogram
OpsIQ čeká na nastavené zpoždění (přednastaveno: 2 To dává lidským agentům možnost reagovat jako první.
3
První odpověď vyhrává.
Pokud lidský agent odpoví během zpoždění, automaticky se odpověď zruší. Pokud ne, AI odpověď vygeneruje.
4
Generovat a odeslat
Umělá inteligence přečte lístek, zkontroluje znalostní bázi, kontext konektoru a historii zákazníka a poté napíše odpověď, která je odeslána (nebo v závislosti na nastavení zařazena do fronty jako koncept ke kontrole).
Jak eskalace funguje
1
Nastavení oddělení
Nastavit, které oddělení mohou dostávat eskalace (např., Účet může být zefektivněn od General, Technika může být egradován od General).
2
Upřesněte jízdenku
Před automatickou odpovědí AI klasifikuje záměr letenky: fakturace, technika, vrácení, zneužití atd.
3
Přesunout, pokud je třeba
Pokud se záměr letenky shoduje s eskalací, jízdenka je přesunuta. Vnitřní poznámka vysvětluje proč.
4
Generovat v novém hlase
Odpověď je vytvořena pomocí znalostí a školení cílového oddělení a AI.
Odkaz na nastavení
Automaticky odpověď povolena
Master switch. Zapněte, aby bylo možné AI automaticky odpovědět na tipy.
Povolené útvary
Které oddělení může obdržet auto- odpovědi. Začněte s nízkorizikovými odděleními (General, Sales) před povolením fakturace.
Zpoždění
Jak dlouho čekat než AI odpoví (v sekundách). Výchozí: 120 sekund (2minuty). Nastavit na0pro okamžité odpovědi.
Prodleva
Volitelně nastavit různé zpoždění pro obchodní hodiny vs. po hodinách.
Zastavit na admin odpověď
Pokud lidský agent odpoví jako první, zrušit auto- odpověď. Výchozí: zapnuto.
Eskalace povolena
Povolit automatické směrování oddělení na základě úmyslu jízdenky.
Oddělení pro eskalaci
Ke kterým místům se mohou lístky stupňovat.
Eskalační stav
Jaký stav nastavit při eskalování (např., Open, Waiting).
Eskalační poznámka
Zda přidat interní poznámku vysvětlující důvod eskalace.
Email- created tips
Vstupenky vytvořené z e-mailu (přes poštovní schránka nebo MX-piped dodání) podle stejných pravidel autoodpovědí a eskalace. Odpověď AI je zaslána jako odpověď na e-mail pro zákazníka. Emailové návrhy jdou do fronty návrhů pro přezkoumání, pokud je nakonfigurován.
Odpoví AI automaticky na fakturační otázky?+
Pouze pokud povolíte automatickou odpověď pro oddělení účtování. Doporučujeme začít s automatickou odpovědí na fakturaci a umožnit ji až poté, co jste vyškolili AI s komplexními informačními znalostmi a důkladně testovali.
Co když AI dá špatnou odpověď?+
Pokud zákazník odpoví, že odpověď byla špatná, lidský agent by měl zasáhnout. Přezkum AI Historie pochopit, proč AI dal špatnou odpověď, pak aktualizovat znalostní základnu nebo AI školení, aby se zabránilo tomu, že se to znovu stane.
Mohu si prohlédnout odpovědi na automobil, než je pošlu?+
Ano. Nastavte režim dodání na "Návrh" místo "Auto- send". Auto- odpověď návrhy se objeví ve frontě Kreslení pro lidskou recenzi před odesláním.
Podpora
Vložený portál vstupenek
Portál vstupenek vkládaný umožňuje přidat rozhraní pro správu jízdenek na jakékoli webové stránky. Zákazníci si mohou prohlédnout své lístky, vytvořit nové a odpověď, vše bez vstupu do OpsIQ admin.
Jak to fungujeVložený portál vstupenek
Tři vmíchané chutě
Inline insted
Pronajímá portál vstupenek uvnitř div na vaší stránce. Portál bere celou šířku kontejneru.
Plovoucí widget
Zobrazí plovoucí tlačítko, které otevře portál vstupenek v panelu. Podobně jako widget chatu.
Ověřené
Vyžaduje podepsanou identitu. Zákazníci vidí pouze své vlastní vstupenky.
Pro ověřený režim musí váš server generovat podepsaný symbol identity. Tento symbol říká OpsIQ, kdo je zákazník, aby viděli pouze své vlastní vstupenky.
Vyhledatelný, statusfiltrovaný seznam. "Čekání na vás" zvýrazňuje vlajky vstupenky tým odpověděl.
Konverzace se závitem
Kompletní pohled na rozhovor s bohatým textem, přílohami a časovými razítky.
Návrh na automatické úspory
Návrhy zákazníků odpovědi jsou automaticky uloženy, takže neztratí práci, pokud se odorientují.
Živé volby
Šíření průzkumů pro nové odpovědi každých ~12 sekund.
Rozřešit / znovu otevřít
Zákazníci mohou vyřešit nebo znovu otevřít své vlastní vstupenky jedním kliknutím.
✅
Poznámky zaměstnanců nejsou zákazníkům v vstupence zobrazeny. Jedná se o pevný bezpečnostní hranice.
Podpora
Zapisovač chatu
Chat Inbox je místo, kde váš tým řídí živé zákaznické konverzace. To ukazuje aktivní chaty, přiřazené rozhovory, AI- řízené chaty a archivované historie.
Zapisovač chatuJeden tip pro každý živý chat, seznam konverzací, vlákno s AI draftem na klepnutí a plný kontext návštěvníka + CRM.
Řízení rozhovorů
Aktivní rozhovory
Rozhovory v současné době probíhají. Zelená tečka = zákazník je psaní nebo nedávno aktivní.
AI- manipulováno
Rozhovory, kde AI reaguje. Můžete převzít kdykoliv kliknutím na "Připojit".
Přidělený mně.
Rozhovory, které jsou vám určeny.
Čekání
Rozhovory, kde zákazník čeká na odpověď.
Archiv
Dokončené konverzace. Hledat podle klíčového slova, datum a zákazník.
Přechod z AI na člověka
Když převezmete rozhovor z AI, řiďte se těmito třemi pravidly:
1
Pozdravte osobně.
"Ahoj, tady Sarah z podpůrného týmu."
2
Referenční kontext
"Vidím, že jste se ptal na stav objednávky."
3
Nastavit očekávání
Řekněte zákazníkovi, co se stane dál. "Teď to prošetřuji a za pár minut vám dám odpověď."
Přepínání AI na jeden rozhovor
Použijte AI přepínání na vrcholu každé konverzace. Když je AI zapnuto, AI generuje odpovědi. Když vypne, pouze lidské agenty mohou odpovědět. AI si pamatuje kontext konverzace i když se vypnout a znovu zapnout.
Režim / mimo hodiny
Nastavit pracovní hodiny v Nastavení. Mimo pracovní hodiny, může AI: (1) Pokračovat v reakci na zákazníky, (2) Zobrazit zprávu "pryč" a vytvořit tiket pro follow- up, nebo (3) Zakázat chat úplně a ukázat tiket formulář. Vyberte si chování, které vyhovuje vašemu modelu podpory.
Řešit těžké konverzace
1
Zůstaň v klidu.
Neodpovídají emoční intenzitě zákazníka. Potvrďte jejich frustraci, aniž by se bránila.
2
Sbírat fakta
Před odpovědí shromážděte příslušné informace: podrobnosti objednávky, stav účtu, předchozí vstupenky.
3
Eskalujte brzy.
Pokud se situace týká náhrad, právních hrozeb, zneužívání nebo bezpečnosti, eskaluje se na vyššího člena týmu, spíše než aby se snažil zvládnout sám.
Můžu si s vámi promluvit?+
Ano. Pomocí interních poznámek v rámci konverzace komunikovat s ostatními agenty. Tyto poznámky nejsou nikdy viditelné pro zákazníka.
Co se stane, když uzavřu rozhovor?+
Konverzace se přesune do archivu. Pokud zákazník pošle novou zprávu později, vznikne nová konverzace.
Podpora
Zprávy
Connect WhatsApp, Facebook Messenger, Instagram DM, Telegram a LINE tak zprávy zákazníci již dorazí ve stejné schránce jako vaše webové stránky chat, odpověděl stejný AI asistent.
Každý kanál se chová stejně, jakmile je připojen: zákaznická zpráva se stane konverzací v Chat Inbox, Váš asistent AI na něj odpoví pomocí stejných znalostí a pokynů jako váš webový chat, a každý agent může převzít. Nic o vašem AI potřebuje konfiguraci na jeden kanál.
Jak vypadá spojení?
Facebook Messenger & Instagram
Jedno kliknutí. Otevřené konektory → Facebook Messenger & Instagram DM, klepněte na tlačítko Connect, přihlaste se k účtu na Facebooku, který spravuje vaši stránku, a vyberte stránku. Instagram přichází s ním, když vaše stránka má instagram profesionální účet připojen.
WhatsApp
Jedno kliknutí, kde váš poskytovatel nabízí: otevřete konektor Messaging Hub a použijte Connect WhatsApp, pak sledovat Meta je naváděný sign- up vybrat nebo vytvořit své WhatssApp Business číslo. Jinak vložte pověřovací listiny z kterékoli brány 20.
Telegram
Zpráva @ BotFather v Telegramu, odeslat/newbot,vyberte jméno a uživatelské jméno končící v "bot", a vložit token vám dává do konektoru Telegram.OpsIQregistruje webhák pro vás.
LINE
Create a Messaging API channel at developers.line.biz, paste the Channel secret and access token, then copy the webhook URL shown in OpsIQ into LINE and switch its own auto-replies off.
SMS
Přidat poskytovatele (Twilio, Vonage, Termii a další) v Messaging Hub s jeho pověřovací listiny a číslo odesílatele.
✅
Každý konektor zobrazí své vlastní step-by- krok pokyny uvnitř zásuvky, včetně přesně toho, co kopírovat a kde. Nikdy nepotřebujete vývojářské pověření pro volby one-click.
Zapnutí kanálu
Připojení kanálu není spuštěn. Přejít na Settings → Client Chat → Advanced → Messaging Channels, zapněte hlavní přepínač a pak individuální kanál. Každý kanál má svůj vlastní AI auto- odpov-ní spínač, takže můžete pilot na jednom před otevřením zbytku.
1
Připojte kanál
V konektorech, pomocí návodu v zásuvce toho konektoru.
2
Otestujte spojení
Klepněte na tlačítko Test. To dělá skutečný hovor na poskytovatele a řekne vám, co je špatně, pokud něco je.
3
Povolit kanály pro zasílání zpráv
Nastavení→Klientský chat→Zapněte hlavní vypínač a pak kanál.
4
Pošli si zprávu.
Z jiného účtu, pošlete zprávu na stránku, číslo nebo bot. Mělo by se to objevit v Chat Inbox během několika sekund a získat odpověď AI.
Odpovědět na okna
Zprávy platformy omezit, jak dlouho může podnik odpovědět po zákazníkovi píše. OpsIQ ukazuje zbývající čas na každé konverzaci a prosazuje pravidlo pro vás.
WhatsApp
24 hodiny od poslední zprávy zákazníka. Poté můžete zaslat pouze schválenou šablonu, kterou nastavíte ve stejné záložce Advanced.
Messenger & Instagram
24hodiny pro běžné odpovědi; agenti mohou odpovídat až7O pár dní později pod Metiným příspěvkem pro lidské činitele.
Telegram, LINE, SMS
Žádné okno s platformami.
⚠️
Pokud odpověď selže, protože okno zavřelo, konverzace ukazuje proč. Toto je pravidlo platformy, ne limit OpsIQ.
Společné otázky
- Vidíte, že to bere AI?+
Pouze pokud jim to řeknete. Odpověď pochází z vaší stránky, číslo nebo bot přesně jako lidská odpověď by. Vaše AI instrukce ovládat tón a zda se identifikuje.
Může agent převzít prostředníhovor.?+
Ano. Otevřete rozhovor v Chat Inbox a klepněte na tlačítko Připojit. AI zastaví, napíšete, a zákazník vidí souvislou nit na jejich straně.
Co když odpojím kanál?+
Používejte odpojení na konektoru. Historie zpráv je zachována, nové zprávy jednoduše zastaví příjezd a platforma se řekne, aby je přestala posílat.
Mohou dvě pracovní prostory použít stejnou stránku na Facebooku?+
Ne. Stránka patří k jednomu pracovnímu prostoru najednou. Spojení někam jinam ji přesune, a první pracovní prostor přestane přijímat zprávy, takže se odpojí záměrně, než aby se znovu připojili jinde.
Podpora
Opravdové konverzace na chatu
Tyto příklady ukazují, jak dobře vyškolený zákazník AI by měl zacházet s běžnými scénáři. Použijte je k testování vašeho výcviku AI a identifikovat mezery.
Příklady konverzace 10
1. Vrací se zákazník a ptá se na objednávku
Scénář:
Customer: Hi, I placed an order 3 days ago and haven't received any shipping notification yet. Order #ORD-5523.
Co dělat:
AI by měla: (1) Vyhledej si pořadí # ORD -5523 přes konektor. (2) Uveďte aktuální stav a informace o sledování, jsou-li k dispozici. (3) Je-li objednávka odložena, potvrďte zpoždění a uveďte odhadovanou časovou osu. (4) NEVYŽÍVEJTE stav přepravy, pokud konektor žádný nemá.
2. Prospect dotazu na ceny
Scénář:
Customer: How much does your Pro plan cost? Do you offer annual billing?
Co dělat:
AI by měla: (1) Odpověď ze znalostní základny s aktuální ceny. (2) Vysvětlete rozdíl mezi měsíčním a ročním vyúčtování. (3) Není-li odpověď v znalostní základně, řekněte to a nabídněte, že je spojíte s prodejem. (4) NENÍ VYJÁDŘOVAT ceny, které nejsou ve znalostní základně.
3. Rozzlobený zákazník požadující vrácení peněz
Scénář:
Customer: This is ridiculous! Your product does not work and I want my money back NOW.
Co dělat:
AI by měla: (1) Znepokojivě se ztotožněte s frustrací (2) Zeptejte se na číslo objednávky nebo e-mail účtu. (3) Vysvětlete proces vrácení. (4) Vytvořit podpůrnou jízdenku nebo eskalovat na lidský agent. (5) NESlibujte vrácení peněz, které vyžaduje lidské schválení.
4. Dvojité fakturační hrany
Scénář:
Customer: I was charged twice this month. My bank shows two charges of $29.99.
Co dělat:
AI by měla: (1) Potvrďte znepokojení. (2) Shromažďovat příslušné údaje (e-mail, data poplatků). (3) Vysvětlete, že fakturační otázky vyžadují lidskou kontrolu. (4) Vytvořte si jízdenku oddělení účtování s podrobnostmi. (5) Nastavte prioritu na High.
5. Vícejazyčný zákazník
Scénář:
Customer: Bonjour, je voudrais savoir si vous livrez en France?
Co dělat:
AI by měla: (1) Odpovězte v jazyce zákazníka, pokud je tento jazyk podporován. (2) Odpovězte na otázku týkající se dodání do Francie ze znalostní základny. (3) Pokud jazyk není podporován, odpovězte ve výchozím jazyce a uveďte, které jazyky jsou k dispozici.
6. Po-hodiny konverzace
Scénář:
Customer: Hello, is anyone there? I need help with my account.
Co dělat:
AI by měla: (1) Je-li nakonfigurován pro after- hours AI, odpovězte a pomozte. (2) Pokud po hodinách vytvoří vstupenky, řekněte: "Náš tým je momentálně offline. Vytvořil jsem pro vás podpůrnou jízdenku a někdo to bude během pracovní doby sledovat." (3) Uveďte číslo jízdenky.
7. Srovnání přednákupů
Scénář:
Customer: How does your product compare to [Competitor X]?
Co dělat:
AI by měla: (1) Popište své silné stránky produktu věcně. (2) NENÍ pomlouvat konkurenta. (3) Je-li stránka srovnání v znalostní bázi, odkaz na ni. (4) Pokud se zákazník zeptá na funkce, které nemáte, buďte upřímní.
8. Zákazník chce doporučení
Scénář:
Customer: I run a small online store with about 100 orders per month. Which plan is right for me?
Co dělat:
AI by měla: (1) V případě potřeby se zeptejte na objasnění (např. jaké rysy mají největší význam). (2) Doporučit plán založený na znalostní základně. (3Vysvětli jim, proč ten plán vyhovuje jejich potřebám.4) Zmínit, že mohou začít s menším plánem a upgrade později.
9. Zákazník se snaží získat neautorizovanou slevu
Scénář:
Customer: I saw online that you give 50% discounts. Can I have one?
Co dělat:
AI by měla: (1) Slušně vysvětlit aktuální povýšení, pokud existují. (2) NENÍ vytvářet nebo slibovat slevy, které nejsou ve znalostní základně. (3) Pokud zákazník trvá, nabídněte jim spojení s prodejním týmem.
10. Zákazník potřebuje pomoc s funkcí
Scénář:
Customer: How do I export my data? I can't find the export button.
Co dělat:
AI by měla: (1) Poskytněte pokyny pro jednotlivé kroky ze znalostní základny. (2) Zahrňte přesnou cestu stránky a umístění tlačítka. (3) Pokud funkce vyžaduje konkrétní plán, uveďte, že. (4) Pokud funkce neexistuje, být upřímný a navrhnout alternativy.
Podpora
Převod chatu a eskalace
Když živý chat potřebuje skutečnou osobu, AI odpoví na dvě otázky: který tým vlastní tento rozhovor a kdo by měl být informován. Oba jsou nakonfigurovány v Nastavení, Klient Chat, Podpora Flow, pod AI routing oddělení.
Výběr, které útvary může AI použít
Dvě krabice na tomto panelu jsou bělicí list. Departmenty přesunuty do prava jsou jediné, které AI může trasu nebo otevřít vstupenky dovnitř. Cokoliv vlevo je neviditelné, i když oddělení existuje a je personálem. Začněte úzký a přidat oddělení, jak jste je zaměstnance.
💡
Pokud není žádné oddělení povoleno, OpsIQ se vrací k odkazu routing přes každé oddělení, které může najít. Zacházejte s tím jako s bezpečnostní sítí, ne jako volbou konfigurace.
Kdo dostane eskalaci
To je ta část, kterou většina lidí očekává, že konfigurovat a nemusí. Když AI eskaluje chat, OpsIQ e-mailem lidi připojených k tomuto oddělení. Řídíte tento seznam jednou, na stránce týmu a oddělení, a jak eskalace vstupenek a chat eskalaci sledovat.
Členové týmu oddělení
Každý aktivní admin připojený k oddělení obdrží vlastní kopii. Zaručené a bezbariérové účty jsou přeskočeny.
Primární admin
Používá se, když nejsou členové týmu připojeni, takže eskalace stále někoho zasáhne.
Nikdo není přivázaný.
Dodávka není možná. Směrovací panel značí, že oddělení v červené a AI neříkají návštěvníkovi člověka byl oznámen.
⚠️
Vlastní e-mailová adresa oddělení je záměrně nikdy používán jako příjemce. Tato adresa je přicházející poštovní schránka oddělení, jeden příchozí pošta je srovnáván s otevřenými vstupenky. Eskalace poslal tam by být vrácena jako nový lístek, spíše než dosáhnout člověka.
Chytač - celé oddělení
Přesně jedno oddělení nese chytlavý cíl. To přijímá chaty AI nemohl sebevědomě místo, a to je poslední možnost spíše než normální cestu.
1
Vyhrajte jasné signály
Vyúčtování se provádí u účtárny, hosting a chybová formulace u technické, nákup znění k prodeji.
2
AI klasifikátor se snaží další
Pokud jsou klíčová slova neprůkazná, model čte rozhovor a vybírá z povolených oddělení.
3
Pak chytač... všechno.
Jen když oba vyjdou prázdné, tak se na to celé oddělení dostane.
4
Prodejní stráž
Pokud je catch-all prodejní oddělení a návštěvník nevykazoval žádný nákupní signál, OpsIQ hledá podporu nebo technické oddělení místo toho, takže běžné podpůrné otázky se nehromadí v Sales.
Co se říká návštěvníkovi
Pokud eskalační email vyjde, AI říká návštěvníkovi, že tým byl oznámen. Pokud nemůže jít ven, AL říká něco upřímného a vyzývá je, aby zanechat zprávu v chatu místo. Nebude tvrdit, člověk byl upozorněn, když žádný e-mail nebyl zaslán.
V panelu stojí "Nikdo to nesmí oznámit" pro oddělení+
K němu není nikdo připojen. Otevřený tým a oddělení, připojit alespoň jeden aktivní admin, pak znovu načíst stránku nastavení. Obraz čte živě.
Může se vystupňování chatu dostat někam jinam než do týmu?+
Ano. Adresa, kterou dříve uložili pro oddělení, stále překrývá seznam týmů. Nová oddělení by měla místo toho přikládat lidi k oddělení, takže je zde jediné místo, kde se udržet.
Proč jsem se nechal chytit?+
Zkontrolujte, zda se jedná o prodejní oddělení. Pokud je, a návštěvník nevykazoval žádný nákupní signál, OpsIQ trasy na podporu nebo technické oddělení na základě účelu.
Podpora
E-mailové schránky a nákresy
OpsIQ se může připojit k e-mailovým schránkám, aby automaticky vytvořil tipy z příchozího emailu a odeslal odpovědi jako email. Poskytuje také AI- draftované odpovědi pro lidské přezkoumání.
E-mailVytáhněte email přes IMAP (nebo přesměrování), přepněte každý do závitu tiketu, a nechte AI návrh odpovědi na přezkum.
Připojení poštovní schránky
Protokol
IMAP (většina poskytovatelů), Gmail API (Google Workspace), nebo Microsoft Graph (Outlook 365).
V cPanel > Emailové účty, klepněte na váš e-mailový účet pro IMAP nastavení.
2
Zadejte v OpsIQ
Hostitel: obvykle mail.yourdomain.com nebo váš server hostitelské jméno, port: 993 (SSL) nebo 143 (STARTTLS), uživatelské jméno: plná e-mailová adresa.
AI e-mailové návrhy
Když je nastavena autoodpověď na režim "Draft", AI generuje návrhy odpovědí, které se objeví ve frontě na výkresy. Můžete:
Přezkum
Přečtěte si návrh a zkontrolujte přesnost.
Upravit
Před odesláním změňte text, tón nebo obsah.
Odeslat
Schválit návrh a poslat jej jako e-mailovou odpověď.
Zlikvidujte
Pokud to není vhodné, návrh smažte.
Automaticky odeslat
Pokud je důvěra dostatečně vysoká a zapnuto autosend, jsou návrhy odesílány automaticky po konfigurovatelném zpoždění.
Proč nejsou emaily převáděny na lístky?+
Kontrola: (1) Je poštovní schránka připojena a zdravá? Podívejte se na zelený stav v e-mailu > Mailboxes. (2) Je cron práce běží? Email hlasování vyžaduje cron. (3) Je e-mail filtrován nebo přesunut do jiné složky, než je INBOX?
CSAT měří spokojenost vstupenek a chatu, povrchy nešťastné odpovědi a porovnává AI a lidské výsledky.
Produktová obrazovkaCSAT stránka kombinuje skóre karty, detraktor follow- up, komentáře, oddělení a agent členění, a zpětná vazba na chat.
Průzkumy vstupenek jsou naplánovány po uzavření (obvykle 24 o několik hodin později). Pozitivní odpověď je skóre4nebo 5. Použijte detraktor fronty pro skóre 1 nebo2a přečtěte si jízdenku / rozhovor před kontaktováním zákazníka.
Zpětná vazba chatu je uvedena samostatně pro AI- resoluted a lidsky-manipulované konverzace. Nízké velikosti vzorku by neměly být použity k zařazení agentů nebo modelů.
Podpora
Týmová emailová vysílání
Stránka Email Platform umožňuje autorizovanému operátorovi poslat jednotime zprávu všem aktivním agentům, vybraným agentům nebo oddělení a přezkoumat historii odeslání.
Produktová obrazovkaTým e-mailový skladatel ukazuje publikum, předmět, zprávu a historii doručení v minulosti.
Tato stránka je pro interní operační zprávy, ne zákaznický marketing. Vyberte si nejmenší správné publikum, jména a adresy náhledu, pak odeslat. Dodávka používá nakonfigurovanou cestu emailu a zaznamenává výsledek.
Podpora
Poštovní schránky, doručovací a příchozí e-mail
Nastavit, jak OpsIQ posílá email, přepne zprávy do tipů a prokáže, že je doména odeslání připravena.
Produktová obrazovkaNastavení e-mailu kombinuje routing, From identity, požití poštovní schránky, kontroly dostupnosti a testovací email.
Odeslaný e-mail
Full administrátoři si mohou vybrat preferovaný e-mailový konektor; OpsIQ vrátí zpět do konfigurovaného SMTP/ Odesílání pošty v případě potřeby. Nastavte rozpoznatelné jméno / adresu, odešlete test a zkontrolujte 24-Hodinové měření úspěšnosti / selhání.
Poštovní schránky
PSČ IMAP potřebuje jméno, e-mailovou adresu, cílové oddělení, hostitel, port, bezpečnostní režim, uživatelské jméno, heslo, adresář, stav hlasování a volbu validace. Teď Poll. ověřit požití před čekáním na cron.
Spustit potrubí
Na stejném serveru může poštovní trubka předat syrovou zprávu RFC822 přímo. Vzdálený mail server může POST syrové zprávy do chráněného příchozího cílového parametru pomocí svého tokenu. Obě cesty vstupují do stejného potrubí s duplicitou, závitem a ticket- routingem.
Schopnost dodávat
Kontrola SPF / DKIM / DMARC je poradenským důkazem pro konfiguraci Z domény. Zelená kontrola nezaručuje umístění v schránce, ale před odesláním produkčních zpráv by měla být stanovena chyba.
Podpora
Podpora Portálového studia
Podpora Portal Studio navrhuje a zveřejňuje zkušenosti s podporou, které čelí zákazníkovi, aniž by vyžadovala externí obrazová aktiva.
Produktová obrazovkaPortálové studio ukazuje odpovídající náhled vedle tématu, navigace, znalosti, vstupenky, asistent, formulář, footer a CSS ovládání.
Použijte šablonu jako výchozí bod, pak nastavte téma, rozložení, navigaci, vyhledávání znalostí, formulář tipu, asistent, footer, značka, chování tipu a vlastní CSS a obecné nastavení. Prohlédněte si plochu, tablet a mobilní před publikováním.
Podpora
Znalostní nedostatky
Výška znalostí-mezera shromažďuje dotazy zákazníků, na které AI nemůže odpovědět s jistotou, takže tým může zlepšit pokrytí.
Produktová obrazovkaVýstražná fronta řadí chybějící nebo nízké-důvěra otázky a stopy, zda tým vyřešil je.
Otevřete mezeru pro čtení původní otázky a blízkého rozhovoru, pak zvolte správnou opravu: aktualizovat existující článek, vytvořit nový znalostní článek, přidat obchodní fakt, správné konektory data nebo změnit eskalační pokyny. Označte to vyřešeno pouze po vyhodnocení nebo skutečný test vrátí přijatelnou odpověď.
Podpora
Správa stavové stránky
Stránka správy stavu komunikuje se zdravím a incidenty služeb pomocí komponent, aktuálních stavů a aktualizací.
Produktová obrazovkaSpráva stavu uvádí komponenty a incidenty, takže operátoři mohou zveřejnit jasné, časově označené informace o službě.
Používejte stavy komponentů konzistentně. Pokud incident postihne zákazníky, zveřejní počáteční oznámení, přidají aktualizace s časovým razítkem jako změnu faktů a zavřou se stručným shrnutím rozlišení. Nepoužívejte stránku stavu jako interní záznam ladění; citlivá diagnostika patří do OpsIQ a serverových protokolů.
AI
Nastavit si AI
AI Konfigurace je místo, kde si vyberete svého poskytovatele, model a řízení nákladů. OpsIQ podporuje více poskytovatelů: Claude (Anthropic), GPT- 4o (OpenAI), Gemini (Google), a Grok (xAI). Můžete použít vlastní API klíč (BYOK) nebo Managed AI, je-li k dispozici na vašem plánu.
Nastavit AIVyberte si Managed AI nebo svůj vlastní klíč, vyberte model pro rychlost vs hloubka, a uzávěrka měsíční výdaje s token rozpočtu.
Výběr poskytovatele
Claude (Anthropic)
Silné uvažování, opatrnost s fakty, dobré v následujících komplexních pokynů. Modely: claude- sonnet-4-20250514 Klaude...3.5-sonet. Nejlepší pro: podpora konverzace, technické otázky, podrobná analýza.
GPT- 4o (OpenAI)
Rychlé, kreativní, dobré obecné znalosti. Modely: gpt-4o, gpt- 4o-mini. Nejlepší pro: rychlé reakce, kreativní psaní, široké znalostní otázky.
Gemini (Google)
Dobrý ve faktických otázkách, vícejazyčná podpora.gemini-2.0-Blesk,gemini-1.5 Nejlepší pro: vícejazyčná podpora, faktické vyhledávání.
Poskytujete svůj vlastní API klíč od poskytovatele. Platíte poskytovatele přímo. Plnou kontrolu nad výběrem a použitím modelu.
Spravovaná AI
AI je poskytována jako součást OpsIQ plán. API Klíč je potřeba. Použití je měřeno podle vašeho plánu AI kreditní bilance.
Nastavení kroku-by- step
1
Přejít na konfiguraci AI
V adminu OpsIQ přejděte na Nastavení > AI Konfigurace.
2
Vybrat poskytovatele
Vyberte si svého poskytovatele AI z dropdown.
3
Zadejte API klíč
Při použití BYOK, enter your API klíč. Pro Managed AI, to je řešeno automaticky.
4
Vyberte model
Vyberte konkrétní model, který budete používat. Menší modely jsou rychlejší a levnější. Větší modely poskytují lepší kvalitu odpovědí.
5
Zkušební spojení
Kliknutím na tlačítko "Zkušební spojení" ověřte, zda funguje klávesa API. Zelená znaménko znamená úspěch.
6
Uložit
Kliknutím na Uložit aktivujete konfiguraci AI.
Kontrola nákladů
Měsíční rozpočet
Nastavte maximální měsíční výdaje na AI tokeny. Když je dosaženo rozpočtu, AI vykazuje elegantně degradovat (kratší odpovědi, žádná auto- odpověď) spíše než zastavit úplně.
Per- conversation token limit
Maximální žetony na jeden rozhovor. Zabraňuje rozbíjení konverzace od konzumace nadměrných kreditů.
Upozornění na nízkou rovnováhu
Když váš kreditní zůstatek AI klesne pod práh (výchozí hodnota: 50,000 tokeny), objeví se v admin. Nastavte toto v AI konfiguraci.
Per- workspace konfigurace
Konfigurace AI je per- workspace. Pokud spravujete více stránek, každý pracovní prostor může používat jiného poskytovatele, model a rozpočet. Pracovní prostor zdědí globální chyby, pokud není převrácen. Chcete-li konfigurovat na pracovní prostor: přepnout na pracovní místo, pak přejděte na AI Konfiguraci a uložit nastavení tam.
Získání kláves API
Anthropic (Claude)
Jdi do console.anthropic.com > API Klíče > Vytvořit klíč. Zkopírujte klávesu začínající "sk-ant-".
OpenAI (GPT)
Jdi do platform.openai.com > API Klíče > Vytvořit nový tajný klíč. Kopírovat klíč počínaje "sk-".
Google (Gemini)
Jdi do aistudio.google.com > Získat API Klíč. Vytvořte klíč pro váš projekt. Kopírujte klíč.
xAI (Řecko)
Jdi do console.x.ai > API Klíče. Vytvořte a zkopírujte svůj klíč.
Testování nastavení AI
Scénář:
After entering your API key, click "Test connection." You should see a green checkmark and a sample response from the AI.
Co dělat:
Pokud zkouška selže: (1) Zkontrolujte, zda API klíč je správný (žádné další mezery). (2) Zkontrolujte, zda je váš účet u poskytovatele. (3) Zkontrolujte, zda je platný název modelu. (4) Pokud používáte Managed AI, ověřte si, zda je vaše licence aktivní.
Který poskytovatel je nejlepší?+
Není tu žádný jediný nejlepší poskytovatel. Claude je vynikající pro podporu konverzace. GPT-4o je rychlý a univerzální. Gemini zpracovává více jazyků dobře. Zkuste každý z nich a uvidíte, které produkuje nejlepší výsledky pro vaše specifické použití případu.
Mohu si později vyměnit poskytovatele?+
Ano. Změňte poskytovatele a API klíč kdykoliv. Stávající historie konverzace je zachována. AI bude používat nového poskytovatele pro všechny budoucí rozhovory.
Co se stane, když mi dojdou kredity?+
AI gradivně degraduje: reakce se zkrátí, auto- odpověď pauzy, a admin ukazuje nízké-vyvážení varování. Core sledování, vstupenky, a CRM pokračovat v práci bez AI.
AI
Chytřejší a levnější pokec se zákazníky
Sada opt- in ovládacích prvků, které činí váš zákazník chatu buď chytřejší (to důvody přes zákaznický účet jako lidský agent) nebo levnější (posílá AI méně, nebo odpovědi v méně krocích). Každý ovladač je vypnut ve výchozím a nezávislé, zapnutí nikdy nemění žádné jiné chování. Většina žít pod Nastavení > Klient Chat > Behaviour; několik jsou na Nastavit si AI a Train vaše AI.
Chytřejší odpovědi (režim agenta)
Normální chatbot zodpoví jednu otázku z jednoho pohledu. Režim agenta na, asistent může provést několik read- pouze kontroly účtu v jednom pořadí a křížově je reference, např. "mám otevřené vstupenky, a je můj zůstatek dost pro mou další obnovení?" je zodpovězena v jedné odpovědi s matematikou udělal. To se zabývá pouze ověřených zákazníků na účet nebo vrácení otázek; vše ostatní běží normální jednoodpovědní cestu.
Režim agenta
Až do několika read- pouze vyhledávání na otočku, křížově-odkazoval před odpovědí. Zapněte, když máte připojenou platformu (WHMCS, Shopify, Stripe, Zendesk, atd.). Off = dnešní single-lookup chování, beze změny.
Myšlení hloubky pro odpovědi agenta
Jak těžké je pro model v komplexních závitech (nízká / střední / vysoká). Začněte na nízká; většina podpůrných otázek je zde dobře řešena.
Model agenta
Přišije silnější model jen pro komplexní agent otáčky, takže každodenní chat zůstane na světle, levné modelu a pouze tvrdé zatáčky platit za hloubku. Prázdný = váš normální zákazník- chatu model.
Plánujte dopředu · odpovědi na jeden průchod (beta)
Malý plánovací krok rozhodne, které vyhledávací zařízení vytáhnout a zda je třeba znalostní základny, pak odpoví v jednom hlavním volání místo několika kroků. Sub- přepínač v režimu Agent. To nemůže být povoleno, pokud je zapnutý režim Agent. Stejná kvalita odpovědí, méně hovorů na multipart otázky.
Rozhovor a porozumění
Paměť dlouhotrvající konverzace (beta)
Udržuje krátký přehled starších zpráv (jména, čísla vstupenek / faktur, částky, rozhodnutí), takže asistent zůstane konzistentní přes velmi dlouhé chaty bez dalšího přepisu. Nejlepší pro support- těžké, dlouhé závity; páry s Agent módu.
Tolerance typu po
Čte malé chyby ("moje otevřené tikety", "nezaplacené faktury") jako zamýšlená slova, takže správné informace jsou nalezeny místo zmeškaných. Pracuje s každou připojenou platformou. Vypnuto ve výchozím nastavení; užitečné pro mobilní-těžký chat.
Kontext vázaného účtu
Pouze připojuje zákaznický účet snímek, když je otázka vlastně o jejich účtu (zůstatek, faktury, vstupenky, služby), přeskakování na obecné otázky. Řezy náklady bez ztráty kvality. Asistent může stále vyzvednout účet živě, když zatáčka potřebuje.
Úspora nákladů
Přeskočit vyhledávání znalostí pro pozdravy (beta)
"Ahoj," "díky" a "ok" nespouštějí vyhledávání znalostí-base, tyto odpovědi nikdy použít. Jakákoliv zpráva s reálným obsahem stále hledá jako normální.
Nejdelší povolená odpověď (žetony)
Délka odpovědi je nejdražší část hovoru, takže rozumný limit (kolem 500 pro podporu) je nejúčinnějším způsobem kontroly nákladů na chat. Snižuje pouze váš globální limit, nikdy ho nezvyšuje.
Nastavit si AI
Hloubka myšlení (zákaznický a admin chat)
Jak moc model myslí před odpovědí (minimální až vysoká). Udržujte zákaznický chat na minimální / nízké rychlosti; rezervujte si vyšší nastavení pro analýzu a admin copilot.
Model Per- AI (na jednu práci)
Každý AI povrch (živý chat, návrhy vstupenek, shrnutí, analýza, admin copilot, propagace, Site Intelligence a další) může běžet na svém vlastním modelu. Světlo, kde rychlost záleží, silné, kde kvalita záleží. Prázdný na povrchu = poskytovatel výchozí pro tuto práci.
Admin chat kontrola nákladů
Admin copilot může mít ohraničenou pracovní paměť a načíst pouze nástroje, které otázka potřebuje (štíhlé nástroje) místo každého nástroje na každém kroku.
Na Train your AI
Návod k tlakovému zařízení
Vaše instrukce jsou zaslány na každém kole, takže jejich délka je opakující se náklady. Tlačítko Compress přepíše slot říci totéž méně slovy. Odmítá přepsat, pokud by to upustil jakýkoliv {variable} nebo pravidlo, a hlásí, co chránila, takže to nikdy tiše mění význam.
"Co je už v mozku" (?)
Zobrazuje, co OpsIQ již ví o vašem podnikání na slotu, takže můžete smazat vše, co jste opakovali ve svých vlastních pokynech.
💡
Kde jdou peníze? Pro krátkou podporu chatu vstup (instrukce + data účtu + historie, odeslané každý obrat) obvykle stojí více než krátké odpovědi, caching a štíhlé kontext pomoci tam. Pro dlouho generovaný obsah dominuje výstup. Replika-délka uzávěrka a nižší hloubka myšlení vyplatí tam. Viz Nastavit si AI pro udržení rychlé cache na, což dělá velkou opakovanou část každého odbočení levné.
Mění to, jak už se na ten chat odpovídá?+
Ne. Každá kontrola je ve výchozím nastavení a nezávislá. Zapnutí jednoho na jednom jen přidává své chování; vypnutí vrací chat přesně tak, jak předtím fungoval.
Jaký rozkaz mám zapnout?+
Běh každodenní chat na světle modelu a pin silnější model agenta. Pak, pokud máte připojenou platformu, povolit Agent režim, pak plán dopředu, pak Long- konverzace paměti. Pak štíhlý kontext, skip- KB-for-pozdravy, a odpověď uzávěrka. Konečně stlačte své pokyny. Podívejte se na několik skutečných chatů po každé změně.
Admin Agent kit: vyhledávání na webu, runbooks, misie, přenos souborů
Admin AI chat je pracovní inženýr, nejen na otázku box. To může výzkum opravy na webu, udržet knihovnu vašich operačních postupů, sledovat servery na harmonogramu, a přesunout soubory. Většina z toho je poháněna tím, že žádá o to v chatu; jednu věc si konfigurovat dopředu je, který poskytovatel vyhledávání webové stránky používá, na Nastavit stránku AI.
Hledání na webu
Zabudované
Agent vyhledává na webu dokumenty, chybové zprávy a aktuální informace, zatímco to funguje. Z pole toto používá DuckDuckGo, který nepotřebuje žádný klíč a žádné nastavení.
Runy
V chatu
Uložená knihovna vašich postupů ("jak se nám daří X zde"). Agent zapíše jeden dolů po přibití složité práce a následuje ji příště, takže know-how přežije konec chatu.
Mise
Plánované
Každé ráno zkontrolujte prostor disku a chybové záznamy a řekněte mi to. "Nálezy přicházejí na váš admin zvonek.
Přenos souborů
V chatu
Zeptejte se na soubor záznamu a získejte soukromý odkaz ke stažení, nebo si jeden soubor zkopírujte z jednoho připojeného serveru do druhého. Oba jsou omezeny na 5 MB.
Admin Agent vyhledávání na webu (na Nastavit váš AI)
Poskytovatel vyhledávání
Co agent web vyhledávání používá. Výchozí je DuckDuckGo: bezklíčový, zdarma, pracuje na každé instalaci. Statečné Hledání, Tavily a Serper.dev (Výsledky Google) obvykle vrátí lepší výsledky, ale každý potřebuje API klíč od tohoto poskytovatele. Pokud keyed poskytovatel selže z jakéhokoliv důvodu (špatný klíč, kvóty využité, síťové potíže), toto vyhledávání se automaticky vrátí do DuckDuckGo, takže hledání nikdy nejde do tmy.
Hledat klávesu API
Klíč pro zvoleného poskytovatele, který je potřebný pouze pro Statečné, Tavily nebo Serper. Jakmile je uložen, je maskován a na stránce již není nikdy zobrazen; vložte nový, aby jej nahradil. Poskytovatel se stává aktivním pouze tehdy, když je uloženo jak poskytovatel, tak jeho klíč.
Runy
Když agent právě pracoval přes práci budete chtít udělat stejnou cestou znovu, řekněte "uložit, že jako runbook s názvem nightly- čištění." Od té doby na to vidí runbooku podle jména v každém zasedání, a když se zeptáte na práci jménem (nebo popsat), že táhne kroky a následuje je. Můžete požádat, aby seznam, aktualizovat nebo smazat runbook kdykoliv.
💡
Běžec je návod, ne volný průchod. Když agent následuje jeden, každý krok, který by změnit server stále prochází váš současný režim oprávnění a zobrazí obvyklé schvalovací karty. Běžková kniha nemůže nikdy obejít schválení.
Mise
Mise je opakující se práci agent běží sám o sobě: hodinově, denně v nastavené hodině, nebo týdně na stanovený den. Mise jsou read- pouze podle návrhu. Mohou číst servery, data a web, ale oni nikdy nic změnit, oni vyšetřují a hlásit. Když mise skončí, nálezy přistávají jako oznámení na váš admin zvonek. Řekni "spustit ranní hlídku teď" spouštět jeden na vyžádání, nebo požádat agenta, aby seznam, pauza nebo odstranění misí.
⚠️
Mise běží mimo OpsIQ cron, takže je třeba nastavit (viz Cron a automatizace). Jednorázové "spustit to teď" z chatu funguje i mezi cron běží na většině serverů.
Přesouvání souborů
Zeptejte se na soubor ("získat mi dnešní chybový záznam z webového serveru") a agent ji nastaví a odpoví soukromým stahovacím odkazem. Odkaz funguje pouze pro signed- in admins a vyprší po asi den. Soubory jsou omezeny na 5 MB; pro cokoliv většího, požádejte agenta, aby komprimoval nebo zkrátil na serveru první.
Agent může také kopírovat jeden soubor mezi dvěma připojenými servery, opět až do 5 MB. Zapsat na destinaci je zacházeno jako s jakoukoli jinou změnou, kterou provede: v režimu dotazu dostanete nejprve kartu schválení, existující soubor je zálohován a kopie je reverzibilní. Pro bezpečnost, obsah souboru je přečtena ze zdroje v okamžiku, kdy je použita kopie, není převzat z chatu.
AI
Trénuj svůj AI
AI školení je místo, kde se učí OpsIQ, jak se chovat. Píšete podněty, které definují osobnost, hranice, znalosti zaměření a eskalační pravidla. Představte si to jako psaní cvičné příručky pro novou podpůrnou agentku.
Vlak AITrénujte AI jako nový pronájem, Zákazník a Admin manuály napsané v jednoduché angličtině (tón, vždy, nikdy), uzemněné ve vašem KB.
Dvě oblasti odborné přípravy
Poptávka zákazníka AI
Ovládá, jak AI mluví s vašimi zákazníky v widget chatu. To je nejdůležitější výzva k dosažení správné.
Admin AI výzva
Ovládá, jak AI pomáhá vašemu admin týmu v palubní desce operátora. To řeší interní dotazy a akční provedení.
Psaní skvělé zákaznice AI point
Váš zákazník AI by měl tyto oblasti:
1
Identita
Kdo je AI? Dejte mu jméno, roli a osobnost. Příklad: "Jste Luna, přátelský a znalý asistent zákaznické podpory pro Acme Store."
2
Tone a styl
Jak by to komunikovat? Příklad: "Buďte profesionální, ale teplé. Použijte jednoduchý jazyk. Vyhněte se žargon. Udržujte odpovědi stručné (2-3 odstavce max). "
3
Hranice znalostí
Co by měl vědět a nevědět? Příklad: "Víte o našich produktech, cenách, lodní dopravy a návratové politiky. NEvíte o konkurenčních produktech nebo interních podnikových rozhodnutí."
4
Pravidla pro eskalaci
Kdy by se mělo předat člověku? Příklad: "Vyzkoušejte člověka, když: zákazník žádá o vrácení peněz, zmiňuje právní opatření, podává zprávy o bezpečnostní otázce, nebo klade stejnou otázku třikrát."
5
Věci, které nikdy nedělají.
Tvrdé hranice. Příklad: "Nikdy neslibujte náhrady. Nikdy nesdílejte interní cenové vzorce. Nikdy nevymýšlejte vlastnosti produktů, které neexistují. Nikdy nedávejte lékařské, právní nebo finanční rady."
Příklad podnětů
Příklad zákazníka AI equipt · online obchod
You are Aria, a friendly customer support assistant for TechGear.
PERSONALITY:
- Warm and professional
- Concise (2-3 paragraphs max per response)
- Use simple language, no jargon
- If unsure, say so honestly
KNOWLEDGE:
- Our products: laptops, accessories, software subscriptions
- Pricing: as listed in the knowledge base
- Shipping: free over $50, 3-5 business days standard, 1-2 days express ($12)
- Returns: 30-day money-back guarantee, must be in original condition
ESCALATION (hand off to human):
- Refund requests over $100
- Account security concerns
- Legal threats or complaints
- Customer explicitly asks for a human
NEVER DO:
- Promise specific delivery dates (say "estimated")
- Share discount codes not in the knowledge base
- Make up product specifications
- Give financial or legal advice
Příklad zákazníka AI equipt · hostující společnost
You are Atlas, an AI assistant for CloudHost web hosting.
TONE: Technical but accessible. Assume the customer has basic web knowledge.
KNOWLEDGE:
- Shared hosting, VPS, dedicated servers
- cPanel, DNS, SSL, email configuration
- WordPress, Joomla, Drupal installation
- Common error codes and troubleshooting
ESCALATION:
- Server outages affecting multiple customers
- Data loss or security breach reports
- Billing disputes over $50
- Complex migration requests
BOUNDARIES:
- Do NOT access customer servers or databases
- Do NOT change DNS records or passwords
- Always recommend the customer makes changes themselves
- For code issues, suggest steps but clarify you cannot debug their application
Refinování vašeho času
1
Spustit se základy
Začněte s identitou, tónem a klíčovými hranicemi. Nesnažte se pokrýt všechno první den.
2
Recenze AI Historie týdně
Čtěte rozhovory, kde AI dal špatné nebo suboptimální odpovědi.
3
Aktualizovat výzvu
Přidejte konkrétní pravidla pro opakující se problémy. Příklad: pokud AI bude pokračovat v slibných náhradách, přidejte "Nikdy neslibujte vrácení. Řekněte, že budete eskalovat do fakturačního týmu".
4
Přidat znalosti
Pokud AI nemůže odpovědět na otázku, přidejte odpověď na Znalostní základnu, spíše než se snaží vhodně vše do rychlosti.
⚠️
Držte svůj příkaz pod 2,000 slov. Příliš dlouhé výzvy mohou zmást AI a zvýšit tokenové náklady. Dejte podrobné informace do znalostní základny místo.
Jaký je rozdíl mezi rychlým a znalostním základem?+
Rychlá definice osobnosti, hranic a pravidel. Znalostní základ poskytuje faktické informace (údaje o produktu, ceny, politiky). AI čte obojí, ale rychlé tvarů chování, zatímco KB poskytuje odpovědi.
Mohu dostat různé podněty pro různá oddělení?+
Pohotovost je per- pracovní prostor. Pokud potřebujete odlišné chování AI pro různé oddělení, použijte znalostní základnu k poskytování konkrétních informací oddělení a zmínit kontext oddělení ve vaší rychlosti.
AI
Historie AI
Historie AI ukazuje každý rozhovor, který AI měl se zákazníky a administrátory. Použijte ji pro audit výkonnosti AI, najít špatné odpovědi, a identifikovat mezery v tréninku.
Historie AIKaždý AI obrat (chat, návrh tipu, admin akce) zaznamenán s přesnou rychlou, odpověď, trvání a výsledek.
Co každý rozhovor ukazuje
Datum a čas
Když se ten rozhovor stal.
Identifikace zákazníka
Jméno a e-mail, pokud je znám, jinak IP a země.
Kanál
Chat widget, tiket auto- odpověď, e-mail draft, nebo admin AI.
Zprávy
Plný přepis konverzace: zákaznické zprávy a odpovědi AI.
Použití tokenu
Kolik žetonů konverzace spotřebované. Vysoké používání token může znamenat, že AI dává příliš verbální odpovědi nebo rozhovor šel v kruzích.
Přijatá opatření
Jakékoli akce, které AI během rozhovoru (vyhledal pořadí, vytvořil tiket, atd.).
Hodnocení
Pokud je CSAT povoleno, zákazníkova spokojenost s touto konverzací.
Zjišťování problémů
Hledat pomocí klíčového slova
Hledat konkrétní témata, jak je AI zpracovává. Příklad: hledat "vrácení" pro kontrolu, zda AI je v souladu s vaší návratové politiky.
Filtr podle ratingu
Zobrazovat pouze málo hodnocené konverzace zaměřit se na nespokojených zákazníků.
Filtrovat podle kanálů
Zobrazovat pouze automatické odpovědi na audit automatizovaných odpovědí odděleně od chatu.
Setřídit podle použití tokenu
High- token konverzace může naznačovat problémy: AI blábolení, jít v kruzích, nebo neodpovědět na otázku.
Týdenní audit
1
Kontrolovat konverzace s nízkým hodnocením
Přečti si celý přepis. Co se pokazilo? Byla to mezera ve znalostech, problém s tónem nebo špatná odpověď?
2
Zkontrolujte high- token konverzace
To by mohlo znamenat zmatek.
3
Aktualizace školení
Pro nedostatek znalostí přidejte články do Znalostní základny. Pro problémy s chováním aktualizujte AI příkaz. Pro opakované nesprávné odpovědi přidejte explicitní korekční pravidla.
Zjišťování mezer ve znalostech
Scénář:
You search AI History for "installation" and find 15 conversations where the AI said "I do not have specific installation instructions for this product."
Co dělat:
To znamená, že vaše znalostní báze chybí instalační příručky. Vytvořte znalosti základní články pro každý produkt instalačních kroků. Po přidání, test tím, že položí AI instalační otázky.
AI
Náhled AI
AI Insights automaticky analyzuje konverzační vzory a povrchy napadnutelné nálezy: společné otázky, trendy spokojenosti, mezery ve znalostech a eskalační modely.
Náhled AISkutečný zpravodajský klub: AI- napsaný Dnešní stručný, Chytré varování pro anomálie, on-poptávka olovo bodování a analýzy stránek, a 14-den dopravní vzor.
Co ukazují pohledy
Hlavní otázky
Nejčastěji kladené otázky. Pokud "Jak resetovat heslo?" je #1, vaše znalostní základna potřebuje prominentní průvodce pro resetování hesla.
Trendy uspokojování
CSAT skóre v průběhu času. Je AI spokojenost zlepšuje nebo klesá? Náhlé kapky mohou naznačovat, že znalosti základní změny, které rozbily něco.
Rychlost rozlišení
Jaké procento rozhovorů řeší AI bez lidského zásahu? 70% je dobrý. Níže 50% To znamená, že AI potřebuje víc tréninku.
Eskalační důvody
Proč konverzace se předává lidem. Běžné důvody: zákazník požádal člověka, AI nemohl odpovědět, citlivé téma, fakturační problém.
Znalostní nedostatky
Topics, kde AI často říká "Nevím" nebo dává nízké sebevědomí odpovědi.
Průměrná délka konverzace
Kolik zpráv na rozhovor. Velmi dlouhé konverzace (10+ zprávy) může naznačovat, že AI není pochopit otázku.
Použití poznatků ke zlepšení
Scénář:
AI Insights shows that 23% of escalations are "Customer asked about warranty" and the AI could not answer.
Co dělat:
Toto je jasná mezera ve znalostech.1) Napište komplexní záruční článek do Znalostní základny zahrnující všechny podmínky záruky, proces reklamace a vyloučení. (2) Aktualizujte AI příkaz k referenci o záručních informacích. (3) Monitor AI Insights příští týden zjistit, zda se záruky eskalace snížit.
AI
Příručka pro správu AI
Admin AI (Zeptejte se OpsIQ) pomáhá vašemu týmu zvládnout OpsIQ z admin palubní desky. Můžete ji požádat, aby vyhledala data, vysvětlit funkce, shrnout tipy a provádět platformu akce.
Admin AIŘekněte admin AI, co chcete v jednoduché angličtině; navrhuje přesnou akci (oskenované, reverzibilní, auditované) a čeká na vaše potvrzení.
Co může admin AI udělat
Vyhledat data
Zeptejte se: "Ukažte mi všechny vstupenky od [email protected]"nebo" Jaký je stav objednávky # ORD-5523?"
Shrnout
Zeptejte se: "Shrňte poslední 10 lístky" nebo "Jaké jsou hlavní problémy podpory tento týden?"
Vysvětlit vlastnosti
Zeptejte se: "Jak nastavit autoodpověď?" nebo "Co znamená karta s odrážkou?"
Provést akce
Zeptejte se: "Vytvořte si tiket pro [email protected] o vyúčtování "nebo" Zavřít tip T-12345"
Otázky na nástupišti
Zeptejte se: "Kolik návštěvníků jsme dostali včera?" nebo "Jaké jsou naše příjmy tento měsíc?"
Příklad konverzace
Vyhledávání zákazníka
Scénář:
Admin asks: "Find customer [email protected] and show me their recent activity"
Co dělat:
AI vyhledává zákazníka přes všechny připojené zdroje dat: návštěvníky, lístky, chat konverzace, objednávky a CRM kontakty. Vrací souhrn nedávné činnosti s odkazy na každou položku.
Získání denního shrnutí
Scénář:
Admin asks: "What happened today?"
Co dělat:
AI shrnuje: "Dnes jste měli 245 návštěvníci (up 12%), 8nové vstupenky (3 vyřešen společností AI),2nové objednávky celkem $198, a1Vystupňování chatu o zpoždění přepravy. "
Provedení akce
Scénář:
Admin asks: "Change ticket T-5523 priority to Urgent"
Co dělat:
AI potvrzuje: "Změním tiket T-5523 priority z Normal na Urgent. To ovlivní SLA časovač. Potvrďte?" Potvrzujete, a akce je provedena.
💡
Admin AI provádí pouze akce, které jsou zapsány v akčním registru. Nemůže vynalézt akce nebo přístupové systémy mimo OpsIQ.
AI
Spektrum spotřebitelských AI
Tato část zahrnuje běžné scénáře AI, které čelí zákazníkovi, s očekávaným chováním a tipy na školení.
Zákazník AIKnihovna skutečných zákaznických otázek a přesně jak by se AI měla s každým vypořádat, aby otestovala váš trénink a našla mezery.
Knihovna scénářů
Vyšetření stavu objednávky
Scénář:
Customer: "Where is my order #12345?"
Co dělat:
Očekávané chování AI: (1) Vyhledejte si objednávku přes platformní konektor. (2) Hlášení aktuálního stavu (zpracování, odeslání, dodání). (3) Uveďte číslo sledování, je-li k dispozici. (4) Je-li příkaz odložen, potvrďte a uveďte odhadovanou časovou osu. (5Nikdy nevymýšlejte sledovací informace.
Požadavek na nastavení hesla
Scénář:
Customer: "I forgot my password and cannot log in"
Co dělat:
Očekávané chování AI: (1) Poskytněte kroky resetování hesla ze znalostní základny. (2) Zahrnout resetovat odkaz nebo cestu stránky. (3) Zmínit, že reset e-mailu může trvat několik minut. (4) Navrhnout kontrolu spam složky. (5) Pokud zákazník stále nemůže resetovat, eskalovat na člověka.
Žádost o funkci
Scénář:
Customer: "Can you add dark mode to the mobile app?"
Co dělat:
Očekávané chování AI: (1Děkuji jim za návrh.2) Vysvětlete, jak se vyřizují žádosti o funkce (přihlášené, přezkoumávané, prioritní). (3) NESlibujte, že bude tato funkce postavena. (4) Pokud podobná funkce existuje, zmiňujte ji.
Spor o zaplacení
Scénář:
Customer: "I was charged but my service is not working"
Co dělat:
Očekávané chování AI: (1) Potvrďte frustraci. (2) Pokud možno zkontrolujte stav služby. (3) Eskalujte do fakturačního oddělení se všemi detaily. (4Neslibuj vrácení peněz.5) Nastavte prioritu vstupenky na vysokou.
Off- topic question
Scénář:
Customer: "What is the weather like in London today?"
Co dělat:
Očekávané chování AI: (1) Poměrně přesměrovat. "Jsem váš [Společnost] asistent podpory a může pomoci s otázkami o našich produktech a službách. Pro informace o počasí, zkuste meteorologické služby." (2) Zeptejte se, zda mají otázku produktu.
Jak mohu otestovat chování zákazníka AI?+
Otevřete si webové stránky v soukromém / inkognito prohlížeči a chatujte s AI jako zákazník. Zkuste společné otázky, hrany případy, a soupeřskými scénáři. Zkontrolujte, zda AI dodržuje vaše rychlá pravidla a používá znalosti základní obsah správně.
AI
Znalostní základna AI
Znalostní báze je knihovna článků, které AI používá k zodpovězení otázek. Když se zákazník na něco zeptá, AI prohledá znalostní základnu pro relevantní články a použije je k vytvoření přesné, uzemněné odpovědi.
Znalostní základProhledejte stránky a importujte dokumenty do znalostní základny; AI získá správné kousky a odpovědi, uzemněné a citované.
Jak to funguje
1
Zákazník se ptá
"Jaká je vaše návratová politika?"
2
AI hledá znalostní základnu
OpsIQ najde článek "Návratová politika" odpovídající klíčová slova a sémantický význam.
3
AI generuje odezvu
AI čte článek a píše naturální-jazyk odpověď na základě obsahu článku.
4
Zákazník dostane přesnou odpověď
Reakce je založena na vaší skutečné politice, ne na obecných údajích o výcviku AI.
Vytváření dobrých předmětů
Jedno téma na článek
Napište samostatný článek pro každé téma: návratová politika, přepravní sazby, nastavení účtu, resetování hesla. Nekombinujte nesouvisející témata.
Napiš jako FAQ.
Začněte s otázkou, kterou zákazníci pokládají, pak poskytněte odpověď. To pomáhá AI odpovídat na otázky k článkům.
Buď konkrétní.
"Návraty musí být zahájeny v rámci 30 dnů dodání" je lepší než "Máme návratové politiky".
Zahrnout hrany
Co mezinárodní výnosy? Co digitální produkty? Co položky zakoupené ve prodeji? Pokryjte výjimky.
Udržujte to v proudu.
Recenze články čtvrtletně. Smazat zastaralé informace. Aktualizovat ceny, politiky a postupy, když se změní.
Starter články, které byste měli napsat
Přepravní a doručovací služby
Náklady na přepravu, dodací lhůty, sledování, mezinárodní lodní dopravu a manipulaci zpoždění.
Vratky a náhrady
Vrátit okno, podmínky, proces, vrácení času a výjimky.
Správa účtu
Resetovat heslo, změnit e-mail, smazat účet a exportovat data.
Ceny a vyúčtování
Popisy plánů, fakturační cyklus, platební metody, faktury a měna.
Pokyny pro výrobky
Jak používat každý výrobek nebo funkci. Step-by- step instrukce s screenshoty.
Řešení problémů
Společné problémy a řešení. Chybové zprávy a jejich opravy.
Kontaktní údaje
Pracovní doba, podpůrné kanály, reakční doby a eskalační cesty.
Právní předpisy a dodržování předpisů
Shrnutí zásad ochrany osobních údajů, shrnutí služeb, žádosti o data GDPR.
Znalosti spojovacích zařízení
Každý konektor může přispět k poznání AI. Pokud je zapnutý konektor, jeho vestavěný-in znalosti články (katalog produktů, společné otázky, konkrétní nastavení platform- specific problémů) jsou automaticky dostupné pro AI, můžete přepínat znalosti konektoru na nebo vypnutí jednoho konektoru v nastavení konektoru.
Rozpočet na token
Znalostní báze má konfigurovatelný token strop (výchozí: 32,000 tokens), který kontroluje, kolik znalostí je posíláno do AI za konverzaci. Pokud je vaše znalostní základna velmi velká, AI vybere nejdůležitější články v rámci tohoto rozpočtu. Zvyšte strop, pokud AI není najít příslušné články; snížit ji, pokud chcete snížit náklady na token.
Kolik článků bych měl mít?+
Začněte s5-10 články týkající se vašich nejčastějších otázek. Přidat více, jak si určit mezery prostřednictvím AI Historie a AI Insights. Většina podniků potřebuje 20-50 články pro komplexní pokrytí.
Mohu importovat články z jiného systému?+
V současné době jsou články vytvářeny ručně v OpsIQ. Obsah copy- pastu můžete kopírovat ze stávajících FAQ, pomocných center nebo dokumentů.
V jakém formátu by měly být články?+
Jednoduchý text funguje nejlépe. AI rozumí přirozenému jazyku lépe než strukturovaný HTML nebo markdown. Napište, jak byste vysvětlit zákazníkovi.
AI
Hodnocení AI a Strážná věž
Hodnotící sady přemění kritické otázky zákazníků na opakovatelné testy kvality odpovědí, citací, eskalací a bezpečnosti akcí.
Produktová obrazovkaAI Evaluation uvádí zlaté testovací případy, požadované chování, nejnovější výsledky a plánované běh Strážné věže.
Plná administrátorka může vytvářet evaluační sady s rychlým, očekávaným zdrojovým štítkem, požadovanými citacemi, lidskými pravidly, eskalací očekávání a zakázanými akcemi. Spustit soubor přímo, suchost-spustit ji, nebo přehrát zvolenou historii.
Strážná věž každý den nebo týden kontroly prostřednictvím cron a běží omezený počet případů (až osm na plánovaný průchod). Přezkum selhání vedle poskytovatele / modelu, rychlé verze, znalosti verze, opatření navržená a náklady před změnou chování výroby.
AI
Jazyky a překlady
Jazyky spravuje přeložený text na zákazníky- čelí a chování používané při OpsIQ následuje jazyk zákazníka.
Produktová obrazovkaStránka Jazyky ukazuje výchozí jazyk, přeložené jazyky, návrh / živý stav a chování uživatele-jazyk.
OpsIQ překládá operační-zadaný uživatelsky orientovaný text. Nastavte zdrojový jazyk správně před vytvořením překladu, přidat cílové jazyky, pak recenzi návrhů před publikováním. "Postupujte podle zákaznického jazyka" ovládá reakční jazyk; překlad widget rozhraní kontroluje jeho tlačítka, štítky a systémový text.
Překlady lze navrhnout pouze nebo žít. Nespoléhejte se na strojový překlad pro právní, vrácení, bezpečnost nebo bezpečnostní text bez lidského přezkumu.
Každé místo, kde máte vlastní znění je uvedeno s jeho počet zpráv: klientské chatovací zprávy, propagace, proaktivní zprávy, chat toky, prohlídky s průvodcem, oznámení, píchací bubliny a Průzkumy a formuláře. Průzkum povrch pokrývá každý zveřejněný průzkum zcela: název, každá otázka, každá odpověď možnost, tlačítka, vítání a díky- kopírujete, strana chrom a výsledné stránky. Klíče jsou vázány na ID otázky a hodnotu volby, takže přeobjednávání otázek nebo možností nikdy neztratí překlad, a přeformulování jedna zpráva překládá pouze tuto zprávu. Publikované živé průzkumy jsou nabízeny ve výchozím nastavení, návrhy se připojí, když rozšiřujete rozsah.
Post- chatu e-mailový průzkum následuje jazyk návštěvník skutečně chatted v, za předpokladu, že jazyk je ten, který zde nabízíte; jinak používá váš systémový jazyk. Jeho šest editable pole jsou přeloženy na této stránce příliš, a chování má svůj vlastní přepínač v nastavení Client Chat.
Zprávy o vstupence a portálu pokrývá pevné textové operátory typu jednou a každý zákazník pak obdrží v tomto jednom jazyce: potvrzení vstupenky, otevřené, uzavřené a zpětné vazby potvrzení, per- department sign- off a portál welcome line. (AI auto- odpověď nepotřebuje nic z toho, to již odpovídá v jazyce zákazníka.) Email zákazníci ve svém vlastním jazyce zapnuto OpsIQ Psaní, e-mailová jízdenka řeší jazyk příjemce v tomto pořadí: jazyk, který si vybrali v portálu nebo Help Centre (přenesený na vstupenku), locale na jejich kontaktní záznam, pak jazyk, ve kterém napsali, detekován lokálně podle rozsahu skriptu a znaková slova, bez externího volání. Pouze jazyky vybrané na stránce Jazyky jsou vždy používány, takže funkce je inertní, dokud jazyky jsou přidány. HTML Obal e-mailu není záměrně přeložen: je to markup, ne próza. Staff- čelí e-mail (oznámení, upozornění oddělení, analytiků, plánované zprávy, týdenní stravovací systém) vždy používá systémový jazyk.
Podpora
Centrum nápovědy
Vaše centrum nápovědy je self-sloužit pomoc stránky postavené z článků, které publikujete. Zákazníci mohou číst a hledat ji na vlastní veřejné stránce, a přímo uvnitř widget chatu, takže mohou najít odpovědi na své vlastní, než vůbec otevřít konverzaci. Vše v něm pochází z vaší znalostní základny, takže stejný obsah, který odůvodňuje vaše AI také pravomoci vaší veřejné pomoci.
Kde to vidí vaši zákazníci.
Vlastní veřejná stránka
Čisté, prohledatelné místo pomoci na /help.php. Zákazníci procházejí podle kategorie, vyhledávání a otevřít jakýkoliv článek. Můžete mu dát své vlastní jméno a styl.
Uvnitř widgetu chatu
Nápověda odkaz v widget chatu, takže zákazníci mohou prohledat vaše články, aniž by opustit chat. Pokud stále potřebují člověka, jsou jen jeden kohoutek od zahájení konverzace.
Zapni to.
1
Otevřít stránku centra nápovědy
Jdi Config, then Help Center ve vašem admin a zapněte Povolit veřejné centrum nápovědy.
2
Dej tomu jméno a pohled
Nastavte název Pomocného centra, který se zobrazí v záhlaví a záložce prohlížeče, a vyberte vizuální styl. Můžete vypnout horní navigaci pro čistou stránku bez menu.
3
Zveřejnit některé články
Nic se neukáže, dokud na to nepublikujete články.
Publikovat články do centra nápovědy
Články žijí ve vaší znalostní základně. Článek se objeví v centru nápovědy, jakmile je zveřejněna a označená veřejnost. Existuje několik způsobů, jak to udělat:
Vydat jeden článek
Otevřete článek, označte ho zveřejněné, a zapněte možnost ukázat jej v centru nápovědy.
Publikovat všechno najednou
Použijte Vydat vše tlačítko stiskněte celý publikovaný set do centra nápovědy jedním kliknutím, místo aby jste je dělali po jednom.
Přeměnit FAQ na články
Už máte FAQ? Vydat vše na pomoc aby je přeměnili v pomocné články, takže sedí vedle všeho ostatního.
Importovat existující znalostní základnu
Přesouvání z jiné asistenční služby? Importovat KB tlačítko na záložce Články přináší existující znalostní základnu pro vás. Máte tři způsoby, jak ji ukázat na váš obsah:
Vložit URL
Dejte mu adresu vašeho aktuálního centra nápovědy. Pokud rozpozná platformu (například Zendesk), čte přesný strom kategorie z této platformy. Jinak se plazí na místě a rebuduje strukturu ze stránek, importuje pouze skutečné články a přeskakuje přihlášení, ceny a kontaktní stránky.
Vyberte připojenou aplikaci
Pokud je platforma již připojena k tomuto pracovnímu prostoru a má znalostní základnu, objeví se v kapce pod Import z připojené aplikace. Vyberte a import, žádné URL nebo heslo potřebné. Aplikace je uvedena pouze po připojení a nastavení.
Nahrát CSV
Žádný živý web na místo k ukázání? Nahrát tabulku s title, categorya body Sloupce. Parent / Child v kategorii sloupec pro sestavení vnořených kategorií.
Ať se rozhodneš jakkoliv, dostaneš První náhled: články, které našel, seskupeny podle kategorií, každý se zaškrtávací políčko, takže můžete upustit vše, co nechcete. Nic není uloženo, dokud klepnete na Import. Poté můžete Zpět celý import jedním kliknutím nebo Přeložila channina a URL nebo připojit-app import později vytáhnout nové a změněné články.
💡
Vývojáři: jakýkoliv konektor může inzerovat své znalosti základny do tohoto dropdown deklarováním kb_capabilities blok v jeho settings.json (typ kb_source, s adapter a base_template). Viz část Connectors a odkaz na platform- connector.
Organizovat s AI
Čisté centrum nápovědy je snadné prohledávat a snadněji vyhledávat. Organizovat s AI tlačítko dělá uzávěrka pro vás. V jednom kliknutí čte vaše publikované články, seřazuje je do citlivých kategorií, a přidává tagy. To vytváří kategorii, když potřebuje jednu, znovu používá kategorii, která již vyhovuje, a přeskočí vše, co jste již organizovali, takže můžete spustit znovu kdykoliv přidáte nové články. Zapněte Nechť AI organizuje do podkategorií v nastavení centra nápovědy a může také soubory články pod vnořené Parent / Child kategorie, které jsou užitečné hned po dovozu znalostní základny, která měla podsekce.
💡
Kategorie dát zákazníkům způsob, jak procházet, a tagy ostře hledat na veřejné stránce a v widget. Můžete přejmenovat nebo přesunout věci později. AI vám dává silný výchozí bod, ne nastavení jste uvízli s.
Nápověda centrum uvnitř vašeho widget chatu
Můžete zobrazit centrum nápovědy přímo uvnitř widget chatu, takže lidé hledat odpovědi, než vám zprávu. Ve svém nastavení widgetu chatu vyberte, kde se objeví odkaz nápovědy:
V záhlaví
Malá ikona nápovědy v horní části widgetu.
Na dně.
Textový odkaz pod schránkou, například "Prohlížeč nápovědy". Slovní spojení můžete změnit.
Obě místa
Zobrazovat v záhlaví a na dně pro co největší viditelnost.
Nápověda odkaz má vlastní kontrolu barev pod nastavením widget Vzhled. Nechte ho na Žádné k porovnání barvy vašeho spouštěče, nebo vybrat Pevné barva nebo Gradient. Celá pomoc zkušenosti následuje widget téma, takže to vždy vypadá jako součást vaší značky.
Dejte si nápovědu na vlastní webovou adresu
Z krabice vaše centrum nápovědy již má čistou, sdílenou adresu vlastní (např. /help/your-help-center). Můžete jít o krok dál a sloužit pod svým vlastní doména, takže zákazníci a vyhledávače to vidí jako součást vaší značky, například yourdomain.com/help nebo help.yourdomain.com. Vše stále pracuje na vaší doméně: odkazy, obrázky, vyhledávání a článek hodnocení.
Pod vaší hlavní stránkou
V Nastavení, pak Pomocné centrum, otevřete Zapouzdřené karta a najít "Zobrazit centrum nápovědy na vlastní webové adrese". Vyberte si nastavení (Cloudflare, Nginx nebo Apache), zkopírujte ready- made blok, a vložte jej do svých stránek. Každá volba má Nastavit návod tlačítko vedle něj s přesnými kroky.
Na poddoméně
Preferuji help.yourdomain.com? Stejný panel má možnost subdomény. Na Cloudflare je subdoména nejspolehlivější cestou, a to vám dá čistou adresu s ničím po něm.
💡
Použití Cloudflare? To běží jen jeho Worker na adresu, která je proxied přes Cloudflare Vaše hlavní doména často ukazuje přímo na vaše webové stránky, takže pravidlo umístěné na hlavní doménu nemůže dělat nic. Spolehlivý způsob je proxied subdomain jako help.yourdomain.com. Setup průvodce vás provede přes jeden DNS záznam a trasu.
✅
Dobré pro SEO. Jakmile je vaše centrum nápovědy na vlastní doménu, vyhledávače index své články pod vaší značkou. Každá stránka prohlašuje svou správnou adresu a sitemap seznamy, takže stejný článek není nikdy indexován dvakrát.
💡
Pomocí nápovědy in- widget odkaz taky? V prohlížeči "Otevřít v centru nápovědy" nastavení, Kam vede odkaz do Vaše vlastní doména centra pomoci a zadejte stejnou adresu. Pak se tyto odkazy na článek otevře i na vaší doméně, ne na OpsIQ adrese.
Podívej se, jak se daří celému centru.
Kromě single-článek hlasování, nápověda centrum má své vlastní analytics. Zapněte jej v nastavení Pomocného centra a tiše zaznamenává, jak lidé využívají vaši pomoc: nejvíce prohlížené články, co hledají, a vyhledávání, které se vrátily prázdné (ready- made to- write list), pracuje na návštěvník země a zařízení na vlastní pěst, takže to nepotřebuje widget chatu nainstalován pro hlášení. Každé číslo je zobrazeno pro both místo, kde se objeví vaše pomoc, veřejná stránka a in- widget pomoc, stejně jako kombinovaná, takže můžete vidět, jak moc je každý z nich skutečně používán.
💡
Analytici zůstanou vypnuté, dokud je nezapnete, a můžete mít návštěvníka IP anonymizované adresy.
Vyberte si, co se objeví na každé části stránky
Každá část centra nápovědy (kategorie na domovské stránce, populární články, seznam článků na stránce kategorie a další) má své vlastní jednoduché pravidlo. Pro každého z nich můžete ukázat nebo skrýt, a ukázat all položky, a nastavené číslo, the posledníNebo jen ty, které feature Když pravidlo uzamkne seznam, zákazníci stále dostanou odkaz na "Zobrazit všechny", takže nic není opravdu mimo dosah.
Můžete také rozhodnout, jak užitečné hlasy vypadají: skryté, přátelský poměr jako "12 z 14 našel to užitečné, "nebo obyčejné palce počítá. Minimum-hlasové nastavení zastaví brand- nový článek ukazující trapné"0z0".
Podívejte se, které výrobky pracují
Každý článek ukazuje Pomohlo to? apply. Každé ano nebo ne se počítá za článek, takže můžete vidět na první pohled, které články odpovídají na otázky dobře a které z nich potřebují přepsat. Opakované hlasy od stejného návštěvníka jsou ignorovány, takže počty zůstávají upřímné.
Text a etikety
Můžete změnit záhlaví a štítky na centru nápovědy, aby odpovídaly vašemu hlasu. Zanechte pole prázdné a to se vrátí do rozumného výchozího nastavení, takže budete upravovat pouze znění, které chcete změnit.
✅
Centrum nápovědy sdílí jednu knihovnu s vaší AI. Každý článek, který zde zveřejníte, je stejný obsah, který používá AI k zodpovězení chatů a vstupenek, takže zlepšení jednoho zlepšuje druhý.
Společné otázky
Musím psát samostatný obsah pro centrum nápovědy?+
Ne. Je postaven ze stejných znalostí, které AI již používá. Publikujte jeden článek a může sloužit oběma.
Můžu si nechat nějaké články?+
Ano. V centru nápovědy se objevují pouze články, které zveřejníte a označíte veřejnost. Cokoliv nezveřejněného z toho zůstane.
Budou zákazníci stále schopni se s někým spojit?+
Ano, odkaz na widget je jen odposlouchávání od zahájení konverzace, takže self-service nikdy nikoho nechytí.
Růst a SEO
Zpravodajská služba (SEO suite)
Stránka Inteligence je OpsIQ je budova-v SEO a search- viditelnost suite. To plazí vaše stránky jako vyhledávač, stopy, kde si řadit, zkoumá klíčová slova, sleduje zpětné odkazy a konkurenty, skenuje místní přítomnost mapy, kontroluje stránku rychlost, a změní to vše na uživatelsky-připravené zprávy, s analytikem AI, který vysvětluje, co opravit a může navrhnout opravy. Je to prémiový rys, když se to umožňuje objeví jako Sidebar. Každá doména data zůstávají oddělená, plazí, rankings a zprávy nikdy míchat mezi doménami.
Zpravodajská služba na místěPřehled zpravodajských služeb: hodnocení situace - zdraví z posledního plazení, sledování klíčových slov, trend organických kliknutí a tříkroková smyčka: plazit, sledovat, nechat AI navrhnout opravy.
Proběhnout plazení · začít tady
Plazení je OpsIQ navštíví vaše stránky způsobem, jakým by vyhledávač, najít technické problémy: rozbité odkazy, chybějící tituly, tenký obsah, pomalé stránky, indexování problémů.
1
Začněte se plazit.
Na Přehledu, klikněte na začít plazit. OpsIQ fronty a pracuje přes vaše stránky v pozadí; ukazatel stavu ukazuje pokrok.
2
Přečtěte si zprávy.
Když to skončí, otevřete problémy a seznam stránek. Každý problém je seskupen podle závažnosti, takže se vypořádat s největší výhry první.
3
Nech AI pomoct.
Analytik AI vytvoří stručný popis toho, co je špatně a proč na tom záleží, a může vytvořit navržené opravy, které budete přezkoumávat před aplikací.
Co je to za stopy?
Procházení a stav webu
Projděte si stránky pro technické SEO problémy a seznam každé stránky s jeho problémy. Respustit kdykoliv, nebo naplánovat.
Sledování podle hodnotících bodů
Přidat klíčová slova, na kterých vám záleží; OpsIQ kontroluje, kde vaše stránky řadí a sleduje pohyb v čase.
Výzkumy klíčových slov
Objevte nové klíčové myšlenky k cíli, s AI klíčový slovo trenér pomoci prioritizovat.
Zpětné odkazy
Podívejte se, kdo s vámi spojuje, obnovte seznam a oddělte odkazy, které nechcete mít ve spojení s vašimi stránkami.
Soutěžící
Přidejte konkurenční domény a porovnejte svou viditelnost s jejich, s analýzou AI konkurentů.
Místní (mapový) systém
Prohledávat místní zobrazení přes geografickou síť, abyste viděli, kde se objevíte na mapě, plus nástroje Google Business Profile.
Rychlost stránky
Spustit page- rychlost kontroly, takže můžete opravit pomalé stránky, které bolí žebříčku a konverzí.
Obsah AI
Vytvořte obsah a návrhy zaměřené na klíčová slova, na která se zaměřujete.
Zprávy
Vybudovat potiskovatelné, uživatelsky připravené zprávy o všem nahoře.
Připojte Google pro přesné údaje
Dva konektory Google mění odhady na reálná čísla:
Google Search Console
Hledat
Vytáhněte přesné dotazy, kliknutí a dojmy Google zprávy pro vaše stránky, mapujte svůj majetek a možnosti hodnocení povrchu přímo z vlastních dat Google.
Google Analytics 4
Doprava
Sdělte dopravní a spojovací údaje spolu s vašimi údaji SEO, takže zprávy ukazují viditelnost a chování společně.
Plánované občerstvení a zprávy o bílé etiketě
Nemusíte všechno běžet ručně. Plánované občerstvení rerun crawls, řadové kontroly, klíčová slova kontroly, back link občerstvení, local- mřížka skenování a hlásit generaci na kadenci (denní nebo týdenní v závislosti na plánu a objemu). Tyto běží přes OpsIQ cron, viz Cron a automatizace sekce. Generované zprávy export jako tisknutelné, uživatelsky-připravené dokumenty: agentury poslat každému klientovi pravidelnou SEO aktualizaci, a protože každé domény data jsou odděleny, každý klient vždy vidí jen své vlastní.
✅
Některé funkce Site Intelligence volají externím poskytovatelům dat a AI prostřednictvím OpsIQ je nakonfigurovaný poskytovatel. Pracují mimo box, když je apartmán povolen pro váš plán. Pokud obnova není spuštěna, potvrďte OpsIQ cron běží (viz Cron a automatizace).
Mám na své stránky přidat něco pro sledování SEO?+
Crawls, sledování pořadí, klíčová slova výzkum a zpětné odkazy pracovat bez doteku vašich stránek. Pro provoz a přesné vyhledávání dat, připojit Google Search Console a GA4.
Mohu sledovat více než jednu doménu?+
Ano. Přidejte každou doménu zvlášť; jejich plazy, žebříčky a zprávy zůstávají zcela izolovány od sebe navzájem.
Jak často se mám plazit?+
Týdenní je dost pro většinu stránek; plazit na vyžádání po velkém obsahu nebo změna struktury. Nastavte plán, takže nikdy nezapomenete.
Růst a SEO
Automatické provádění (agent SEO)
Auto- Implementace je součástí webové zpravodajské služby, která skutečně používá opravy crawl a analytik AI doporučit, místo toho, aby vám pouze radit. Agent pracuje výhradně z toho, co Stránka Inteligence již našel (to nemůže nikdy vymyslet změnu) a prochází každý opravu přes stejnou bezpečnou smyčku: suchý-spustit náhled, vaše per- krok schválení, živý zápis, automatické snímek, a re- crawing, který dokazuje, že otevření vydání se snížil. Je to Managed- AI- pouze funkce; zdá se jako automatická implementace (raketa) akce uvnitř stránky zpravodajství sekce, a to je vypnuto, dokud jste ho zapnuli.
Automatické prováděníJak probíhá relace: agent uvádí opravy, které už doporučuje zpravodajská služba, ukazuje rozdíl mezi jednotlivými, aplikuje ty, které schvalujete SSH nebo hostitel API, snímky před každým napsáním, a re- crawls dokázat otevření-vydání počet klesl.
Co to může změnit
Agent vždy jen používá opravy, které Site Intelligence (nebo analytik AI) již doporučil pro tuto doménu. Na všech podporovaných platformách, které pokrývá:
Konfig serveru
sitemap.xml, robots. txt, a přesměrovat, kanonické a hlavičkové pravidla v . htaccess (Apache / LiteSpeed) nebo nginx config.
Přesměrové řetězy
Shromaždí multi- hop přesměrování řetěz dolů na jeden hop přímo do finálního URL, uvnitř stejné řízené . htaccess blok, takže rychlost a odkaz hodnota zastavit prosakování přes extra chmel.
Page <head>
Chybějící nebo slabé tituly stránky, meta popisy, kanonické značky a strukturované data (schema) bloky.
WordPress SEO
Yoast, Rank Matematika a SEOpress tituly & meta, a obraz alt text, aplikované přes WP- CLI na SSH cesta nebo zbytek API Na hostované cestě.
Strukturované údaje WordPress
Přidány JSON-LD (schéma) na stránky, které chybí. SSH cesta malý řízený pomocník (must-use plugin) tiskne markup tak, že funguje s nebo bez SEO pluginu; na hostované cestě váš SEO modul nese.
Vnitřní vazby
Přidá jeden relevantní vnitřní odkaz uvnitř stávajícího obsahu WordPress k záchraně osiřelých stránek a připojení souvisejících příspěvků. Jeden odkaz na stránku, nikdy uvnitř položky, existující odkaz nebo shortcode, a vždy schválen vy první.
Tenký obsah stránky přepíše
Kreslí plný náhradní obsah pro tenké stránky (zapnutý možností plazení, viz níže). Každý návrh je přezkoumán a schválen vámi před tím, než cokoli zveřejní, a starý obsah je zachován, aby mohl být obnoven.
Vyrovnávací paměť stránky (WordPress)
Zapne W3 Celkem Cache stránky caching, když se plazení najde problémy s rychlostí a že plugin je nainstalován, takže stránky slouží rychleji.
Shopify SEO
Produkt a kolekce SEO tituly & popisy, stránky a blog-článek SEO, plus 301 přesměrovává, prostřednictvím Shopify Admin API.
Webflow SEO
Per- strana SEO titulek a meta popis prostřednictvím Webflow Údaje API v2.
Automaticky připravit opravy (dvě možnosti plazení)
Stránka Intelligence Configure panel pro doménu (jeho nastavení plazení) má dvě možnosti, které rozhodnou, kolik agent řadí pro vás dopředu. Oba jsou vypnuty ve výchozím stavu a oba používají AI úvěr, takže je zapnete pouze tehdy, když chcete, aby tato práce pro vás udělal.
Automatické úpravy AI po každém plazení
Každý plazení také píše konkrétní obsah opravy (názvy, meta popisy, alt text, schémata, přesměrování) pro to, co našel, takže opravy jsou připraveny přezkoumat a použít okamžik, kdy plazení končí místo toho, aby byly generovány později na vyžádání. Používá AI úvěr na každé plazení.
Obsah AI přepisuje (tenké stránky)
Agent může navrhnout plný náhradní obsah pro tenké stránky. Nic není nikdy zveřejněno na vlastní pěst: každý návrh se objeví jako změna, kterou si prohlédnout vedle sebe a schválit nebo odmítnout, předchozí obsah je ponechán tak, že je vratný, a to je omezeno na několik stránek za průchod. Používá AI úvěr za návrh.
💡
Obě možnosti se připravují a navrhují práci. Každá změna stále prochází stejným schválením pro jednotlivé kroky, obratem a zpětným rázem jako každá jiná oprava, takže jejich zapnutí nikdy nic nezpůsobí.
Dva způsoby, jak se to spojuje
SSH / SFTP cesta
Self- řízeno
Pro stránky na vašem vlastním serveru, agent se připojí přes SSH/SFTP pomocí pověřovacích listin ukládat, upravovat konfiguraci serveru a soubory stránky přímo, a běží WP-CLI pro WordPress. Nejlepší, když máte shell přístup a chcete plnou kontrolu souborů.
Hosted...API cesta (ne SSH)
Bez skořápky
Pro nástupiště, které neumožňují SSH, agent pracuje zcela prostřednictvím úředníka API konektor, WordPress (Rest + aplikační hesla), Webflow (Údaje API v2) a Shopify (Admin API). Nic není nainstalováno na hostitele.
💡
Wix a Squarespace nemají veřejné SEO- psát API, takže na těchto platformách Auto- Implementace běží v poradním režimu: ukazuje vám přesnou změnu, aby (přesný název, meta nebo nastavení) pro vás použít ručně. Vše ostatní je read- pouze a bezpečné.
Zapněte konektory
Agent dosáhne každé platformy přes konektor:
Zabudované
Shopify a WordPress spojovací loď s OpsIQ, Stačí jim povolit pod konektory a přidat data obchodu / webu.
Z tržiště
Webflow, Wix a Squarespace instalovat z Connectors → Marketplace, pak připojit stejným způsobem.
Jak běží sezení
1
Vyberte opravy
Otevře Automatické implementace (raketa) z oddělení Site Intelligence. Seznam problémů, které Stránka Intelinary již zjistila, že to může opravit na této doméně.
2
Náhled na každou změnu
Pro každou opravu agent zobrazí suchý-spustit rozdíl (přesně to, co bude psát), než se cokoliv dotkne živé stránky.
3
Schválit krok za krokem
Schvalujete (nebo přeskočíte) každou změnu individuálně. Nic se nepoužije bez vašeho výslovného go- dopředu na tomto kroku.
4
Píše se to, pak snímky.
Po schválení agent dělá živé změny nad SSH nebo hostitel API a uloží snímek první, takže všechny změny lze vrátit zpět.
5
Dokaž to, žij.
Jak se uplatňuje každá změna agent okamžitě re- kontroluje, že přesné stránky a ukazuje per- krok "fixní live" verdikt, takže budete sledovat každý opravit zemi na živé stránce, jak to děje. Na konci to znovu-prolézá celou stránku a potvrzuje otevřené vydání počet klesl.
Bezpečnost a fakturace
Pouze SEO
Agent může dělat pouze to, co Site Intelligence doporučuje pro tuto doménu. Nemůže provést libovolné změny na vašem webu nebo serveru.
Schválení typu s předstupním
Každý zápis je považován za rozdíl a aplikuje se až poté, co schválíte tento konkrétní krok.
Snímek & zpět
Před každým zapsáním je uložen snímek, takže všechny změny mohou být vráceny.
Živé odolné proti podjetí zezadu
Každá změněná stránka je znovu zkontrolována v okamžiku, kdy je zapsána a dostane "fixní živý" verdikt, takže se oprava potvrdí proti živé stránce hned, nejen v závěrečném re- crawl.
Obsah není nikdy autopublikován
Vnitřní odkazy a ten- page obsah přepisuje jsou higher- impact, takže jsou vždy zobrazeny ke schválení a nikdy se neaplikují automaticky, bez ohledu na režim, který spuštíte.
Pouze Managed- AI
Automatické provádění běží na Managed AI; je blokováno, když pracovní prostor používá své vlastní (BYOK) klíče.
Účtování
AI tokens účet normálně, jak je používáte, plus jeden plochý poplatek za per- use za Auto- Implementation relace, oba čerpané ze stejného Managed-AI úvěru.
✅
Auto- Implementace je vypnuta ve výchozím nastavení. Povolit na konfigurační stránce AI (Auto- Resulment card) a ujistěte se, že je nejprve připojen konektor pro vaši platformu.
Změnilo to něco, aniž by se zeptali?+
Ne. Každá změna je považována za suchý rozdíl a aplikuje se až poté, co schválíte tento přesný krok. Snímek je uložen před každým napsáním, takže můžete vrátit zpět.
Potřebuji přístup k SSH?+
Nezapnuto WordPress, Shopify nebo Webflow Ti pracují přes své oficiální APIs Bez přístupu do ulity. SSH je pouze jedna ze dvou cest, používaných, když chcete, aby agent editoval konfiguraci serveru a soubory přímo na vašem vlastním serveru.
Jak mám vědět, že to fungovalo?+
Po použití schválených oprav se látka přeplazí na místo a zobrazí počet otevřených vydání před a po, takže si můžete potvrdit opravy snížil problémy.
Bude přepisovat nebo publikovat obsah stránky sám?+
Ne. Obsah AI přepisuje jsou vypnuty, dokud je zapnete v možnosti plazení, jsou omezeny na několik tenkých stránek na průchod, a každý návrh je vám ukázán pro side-by-side schválení před tím, než něco zveřejní. Předchozí obsah je zachován, takže přepis může být vždy vrácen.
Můžu to použít s vlastními AI klíči?+
Ne. Auto- Implementace je Managed-AI pouze a je blokován pod BYOK. To účty AI tokeny normálně plus jeden plochý poplatek za používání za sezení, ze stejného Managed- AI úvěru.
Růst a zapojení
Studio průzkumu
Survey Studio je pracovní prostor pro vytváření editable průzkumy, které mohou být dodány jako bohatý samostatný stránku, widget webové stránky nebo inline vkládané. Současný produkt také poskytuje hostované odkazy, podepsané návrhy předpokladů, soukromé pozvánky, QR sdílení, vyhledávání odpovědí a geodet-okoupené analytiky. Widget webových stránek je jedna volba dodání, není definice průzkumu.
⚠️
Hranice Current- versus- cílový kód: prémiový výtvor a náhled, Connector Builder survey schopnost, a Survey- vlastněné registr poskytovatelů / zdravotní hranice jsou k dispozici nyní. Průzkum Studio stále potřebuje nezávislé víceúčelové architektury, signedtoken Průzkumné identity Gateway, cílení / variabilní zapojení, CRM Outenach odeslat tok a zadaný surveys.* API.
Vytvořit průzkum
1
Vyberte si, jak to lidé budou brát
Současný průvodce nabízí Standalone stránky & link, Widget Webové stránky a Inline vložil. Schválený cílový tok začíná s typem průzkumu a později přidá CRM e-mail, private- link a QR nasazení jako první třídy volby.
2
Vyberte si účel
Vyberte NPS, CSAT, CES, zpětná vazba produktů, post- nákup, zrušení, na palubě, webové stránky, akce, webinar, podpora, vedení / demo, zkušební, posudek, výzkum, zaměstnanec, příjem nebo obecná zpětná vazbu.
3
Použít kompletní šablonu nebo Start blank
Současný katalog je připraven editovatelný startér seskupený podle účelu. Volba šablony vytvoří zkopírovaný návrh: změna vašeho průzkumu nezmění spouštěč ani jiný průzkum.
4
Přizpůsobení nebo Rychlá revize
Přizpůsobení otevře všechny otázky, design, chování a kontrola dodávek. Rychlá recenze otevře stejný návrh na konečné zákazník- pohled check. Nic zveřejňuje nebo posílá automaticky.
Volba dodávky a současné chování
Samostatná stránka a odkaz
Reagující značková stránka s vlastním URL. Použijte soukromé pozvánky a vypršení platnosti, když každý příjemce potřebuje kontrolovaný odkaz. QR sdílení bodů na tomto hosting zkušenosti.
Widget stránek
Migrující odkaz kanál. Může využít stránku, geografie, zařízení, návštěvník, datum, odběr vzorků, chlazení, návštěvy a kvóty pravidla. Je stále podporován dědictví activewidget most, zatímco nasazení architektura je postavena.
Inline insted
Reagující průzkum umístěný uvnitř stránky, portálu, produktu nebo pomocného centra. Nevyžaduje Promotion Studio.
E-mail
Dnes Studio může generovat pozvánku HTML a soukromé odkazy. End- to- end odesílání z CRM kontaktů / segmentů, se souhlasem, potlačení, plánování, retry a odezva korelace, je schválený CRM Outenge integration cíl.
Podnikatelský design a náhled
Stránky s průzkumem mají témata a rodiny v uspořádání stránek, responsible controls, vítání a dokončení kopie a podepsaný návrh náhledu. Náhled designérů je plný-šířka pod editorem, ne úzká boční kolejnice. Používá skutečný hostovaný runtime v pískovišti rámu a podporuje plochu, tablet a telefonu šířky; náhled provoz nepíše odpovědi nebo analytiky.
💡
Studio Survey je nezávislé na Promotion Studiu. Runtime cílení, identity, aktiva, renderování a analytika musí být v vlastnictví Survey-. Propagace obsah může být znovu použit pouze prostřednictvím explicitní jednotime kopie / import, který vytváří oddělená data průzkumu; později Propagační edity nesmí mít žádný účinek.
Kompletní produkt
Nezávislé nasazení
Živé
Jeden průzkum může mít samostatnou stránku s verzí, widget, vložil, CRM e-mail, private-link a QR nasazení, každý s vlastním stavu, design, publikum a analytika. Každý průzkum může být zastaven, zakázán nebo smazán.
Informace o CRM a kampaně
Živé
Vytvořte ověřené publikum z CRM segmentů a Survey- schopné konektory, zmrazit ji do neměnné verze, vydání jednoho podepsaného pozvání každý, a poslat přes přišpendlený externí e-mailový konektor s per- pozvánkový doručovací důkaz.
Polní souprava a validace
Živé
Posuvníky, volba obrazu, nahrávání souborů, podpis, adresa, telefon, záhlaví a bohatý text, s minimální / maximální délkou, e-mail /URL/ number presets, custom error text and per- question prefill URL parametry.
Logika, vzorce, výsledky
Živé
A / OR skupiny stavu, pravidla pobočky, bezpečný formulační motor nad odpověďmi, a skóre kapely, které nesou své vlastní výsledné stránky: bodované kvíz přistane na jeho verdikt.
Jazyk, kiosek, předplněný
Živé
Jazyk návštěvníka vynechává výpis pouze jazyky s reálnými překlady, kiosek režim pro sdílené tablety (větší cíle, autoreset, žádné přesměrování), předvyplněný odkaz stavitel, a editovatelný secure- odznak a footer text.
Verze A / B testování
Živé
Vydejte verzi vyzyvatele na libovolné nasazení s dopravním split. Návštěvníkům je přiřazeno stickly, odpovědi jsou označeny skutečně doručenou verzí a srovnávací tabulka ukazuje odpovědi, dokončení a střední skóre za verzi. Podporujte vítěze jedním kliknutím.
Týdenní stravovací
Živé
Týdenní e-mail s posledními dny 7 průzkumu KPI, nejrušnější průzkumy, zpětný impuls a nejnovější AI briefing, odeslaný přes přišpendlený odchozí konektor. Nastavit ji v Delivery Centre, Automation.
Správa
Živé
Per- anuit access lists limituje, kdo může upravovat, publikovat nebo smazat průzkum. Zveřejnění schválení (čtyřoké) vyžaduje druhý admin k uvolnění přesného návrhu; úprava resetuje schválení. Návrh sdílených odkazů umožní recenzentovi vidět skutečný návrh bez přihlášení.
Vývojářská platforma
Živé
Smlouva o konektoru 2.2, Psaní průzkumy. * a zpětná vazba. * akce na api/ v1, kanonický průzkum. * události, trvalé podepsané webháky se Slack a Google Prostěradla relé formáty, a jednoodezva PDF vývoz.
Růst a zapojení
Analýza a zpětné získávání různých produktů
Průzkum Analytics vysvětluje, jak se průzkum sám o sobě dotýká lidí a výkon. Zpětná vazba vysvětluje, co zákazníci řekli ve všech povolených zdrojích a co by s tím měl dělat podnik. Oba výrobky se navzájem spojují, ale nesdílejí ani nepřepisují analytickou pravdu.
Analýza průzkumu
Vstoupil z individuálního průzkumu v Survey Studio, ne z globální boční navigace. Měří způsobilost, expozici, spouštěcí chování, začíná, dokončení, opuštění, otázky a tření větví, načasování, nasazení / výsledky kampaně / verze a runtime spolehlivost.
Zpětný pohled & Inbox
Jeden permission- aware chronologický zdroj pro vyplněné odpovědi na průzkum, odkaz widget zpětnou vazbu, chat a jízdenka CSAT, odpověď na tip zpětnou vazbu (odpověď na dotazník), hodnocení odpovědí zákazníka AI-, znalosti - základna užitečné hlasy a schválené externí / vlastní zdroje.
Analytika zpětné vazby
Analyzuje význam zákazníka: původní metriky trendů, témata/motivy, nálady, emoce, záměry, naléhavost, požadavky, stížnosti, chválu, segmenty cesty/produktu/služby/týmu, detraktory a výsledky uzavřené smyčky.
Vlastnictví údajů
Odpovědi na průzkum zůstávají v úložišti. Zpětná vazba ukládá obnovitelný zdrojový odkaz a odvozené signály, pak načte povolené důkazy na vyžádání. Jedna vyplněná odpověď na zjišťování se stává maximálně jednou položkou zpětné vazby.
⚠️
Aktuální stránka Zpětná vazba má stále prohlížeč odpovědi na průzkum a samostatné odkaz widget inbox, a její AI součty ještě nepoužívají plně normalizovaný zdrojový model. Jednotný Přehled / Inbox / Analytics / Sources & Health design je implementační cíl.
NPS, CSAT, CES, hvězdy, palce a pomocnost musí vždy zachovat svou původní metodu, měřítko, vzorek, okno data a jmenovatel. Nikdy nesmí být kombinovány do jednoho nevysvětlitelného průměru.
Růst a SEO
Promo Studio
Promotion Studio změní vaše webové stránky na konverzní motor. Design pop-ups, bannery, slide-iny, horní / spodní mřížky, full- screen převzetí, inline bloky a dokonce country-based přesměrování, pak zobrazí správnou zprávu pro správného návštěvníka ve správný okamžik. Vše je dodáno prostřednictvím OpsIQ widget již na vašich stránkách, takže není nic extra instalovat. Navrhujete a šetříte kampaně kdykoliv; ukazují pouze jednou jste publikovat je a studio je zapnuto pro váš pracovní prostor.
Promo StudioVizuální designér: blokuje paletu vlevo, vaše kampaň na plátně (zde osobní kupón pop-up pomocí {first_name} token), a cílení + publikovat panel vpravo.
Velký obraz
Kampaň
Co?
Jedna propagace: pop-up, banner, bar, slide- in, fullscreen, inline block nebo geo- redict. Každý má cíl: prodej, vedení, sign- up, chat, průzkum, oznámení.
Design & verze
Jak
Každý uložení vytvoří novou verzi, takže se můžete vrátit.
Cílení
Kdo
Kdo to vidí: země, strana, zařízení, dopravní zdroj, vrací vs nové, rozvrh, a (s konektorem) vaše logged- v zákaznících.
Spouštěče
Kdy
Když se objeví: okamžitě, na zpoždění, na svitek, na exit- intent, když nečinně, na kliknutí, po N stránkách, nebo z chatu / tiket činnosti.
Analytika
Výsledky
Živé dojmy, kliknutí skrz, konverze, výpadkové trychtýře, země / strana / zařízení rozděluje, A / B vítězové a AI vhled.
Spusťte první povýšení v 5 krocích
1
Začátek ze šablony nebo prázdné
Otevřené Promotion Studio a klepněte na tlačítko Nová kampaň, nebo vyberte ready- made design z galerie Templats. Návrh se otevře v designéru.
2
Navrhnout
Přetáhněte do bloků, okruhů, textů, tlačítek, obrázků, odznaků, statistik, odpočítávání, formulářů, kupónů, videí, ratingů, spin- wheels. Stylové barvy, sklony a 3D efekty s posuvníky. Náhled Desktop / Tablet / Mobile, a použijte Volný tah umístit cokoliv kdekoliv.
3
Zosobnit
Typ žetonů jako {first_name}, {country} nebo {company} do jakéhokoliv textu. V show- time se stanou skutečné hodnoty návštěvníka.
4
Cílový & spouštěč
Vyberte si, kdo ji uvidí (země, strana, zařízení, publikum) a když vystřelí (zpoždění, posun, exit- intent).
5
Kontrola, pak publikovat
Klikněte na tlačítko Check pro rychlý předstartovní sken, pak publikovat. To jde živě během několika sekund a začne sbírat analytiky.
Bloky, které můžete postavit
Obsah
hlavní
Záhlaví, odstavec, seznam, citace, obrázek, ikona, odznak, stat, dělič a mezerník, stavební kameny jakékoli zprávy.
Výzva k akci
hlavní
Tlačítka s reálnými akcemi: otevřete odkaz, spusťte chat, vytvořte si lístek, zkopírujte kupón nebo skočte na stránku.
Naléhavé zachycení
Kladná
Odpočítávací časovače, formuláře (e-mail / telefon / text), výkazy kupónů a video embeds.
Gamifikovaná zpětná vazba
Kladná
Kola s výherními koly, stírací karty, NPS / hvězdná hodnocení a vícestupňová nálevka.
Rozvržení & efekty
Kladná
Sloupce, progress bary, sociální podíl, sociální důkaz tickers, ano / ne two-step, kvízy, a 3D efekty, náklon, záře, paralax, glassmorfismus.
Osobní tokeny
Napište některý z nich v záhlaví, odstavce, tlačítka, odznaky, statistiky, seznamy nebo citace. Jsou nahrazeny živou informací návštěvníka v okamžiku propagace ukazuje (vždy čištěny pro bezpečnost):
Dostupné žetony
From the visit: {country} {city} {device} {page_path} {utm_source} {referrer}
From your CRM: {first_name} {last_name} {email} {company} {segment} {lifecycle_stage}
From a connector: {balance_due} {unpaid_invoices} (logged-in customers only)
Cílový odkaz
Země a umístění
Zobrazit pouze ve vybraných zemích, městech nebo časových pásmech (nebo se skrýt před) přes GeoIP. Skvělé pro regionální nabídky nebo georedict.
Stránky & URLs
Omezení na určité stránky pomocí rovnic / starts- with / contains / regex, a vyloučit stránky také.
Zařízení
Desktop, tablet nebo mobil, např. štíhlá tyč na mobilu, modální na ploše.
Typ návštěvníka
Nové, vracející, známé (ve vašem CRM) nebo anonymní; CRM segmenty, životní cyklus fáze, olověné skóre nebo jazyk prohlížeče.
Dopravní zdroj
By UTM (utm_source, utm_campaign) or referring site, e.g. only visitors from a specific ad.
Časový rozvrh a frekvence
Start / konec data, time-of- den okna, a jak často je člověk může vidět (za sezení, za den, po zavření / klepněte na tlačítko / konvertovat).
A / B rozdělení provozu
Ukázat na procento návštěvníků a spustit varianty head- to-head; stejná osoba vždy vidí stejnou variantu.
Publikum (v sázkách)
S připojeným konektorem, cíl na živém účtu stavu, např. zákazníci s nezaplacenými fakturami, nebo aktivní předplatitelé.
Spouštěče
Vyberte si, jak se podpora objeví: Okamžitě, po zpoždění, na svislé hloubce, na exit- intent, když nečinný, na kliknutí prvku, po řadě stránek zobrazených, na form- opustit, nebo z chatu / tiket aktivity. Vývojáři mohou střílet jeden ze svého vlastního kódu s window.OpsIQPromo.fire('event').
Cílový logged- in zákazníky (konektory)
To je to co dělá OpsIQ speciální propagační akce: připojit platformu jako WHMCS (nebo jakýkoli konektor, který podporuje publikum) a studio může zaměřit návštěvníky podle jejich stavu živého účtu.
1
Povolit konektor pro publikum
Pod konektory, umožnit takový, který odhaluje fakta publika (WHMCS Zákazníci jsou při přihlášení do této platformy bezpečně uznáni, OpsIQ Nikdy nevěř psanému emailu.
2
Přidat pravidlo publika
V kampani Cílení > Publikum, vyžadují přihlášení a přidat pravidla jako nezaplacené faktury > = 1, předplatné je past- due, nebo účet úvěr > 0.
3
Vytvořit si vlastní údaje
Použít žetony, jako jsou {first_name} nebo {balance_due}. Připomínka "Máte zpoždění fakturu" píše sám.
✅
Zaměření diváků je neúspěšné: pokud konektor nemůže potvrdit skutečnost (nebo návštěvník není přihlášen), propagace jednoduše neukazuje, takže nabídka billing- cílené nikdy nedosáhne špatné osoby. Stavba vlastního konektoru? Viz "Propagace publikum zaměření" níže.
Propojené obchodní (studio superpower)
Produktové karty z vašeho obchodu
Živé údaje
Produktový blok přitahuje skutečné položky (jméno, cena, prodejní cena, obrázek, odkaz) přímo od WHMCS, WooCommerce, Shopify nebo OpsIQ fakturace. Tick "Udržujte čerstvé" a karta aktualizuje svou cenu z platformy každou hodinu, zatímco publikoval.
Kupóny s zásobami v obchodech
Kupóny
Kupní blok může vytvořit skutečný slevový kód ve vašem obchodě v okamžiku, kdy publikujete, takže kód návštěvník odhalí vždy pracuje na pokladně.
Příjmy z veřejných zakázek
Přiznání
Skutečné objednávky z vašich platforem jsou porovnávány s kampaní hodinové (pomocí kupónového kódu nebo e-mailem vedení), takže příjmy vidíte je ze skutečného prodeje, ne odhady.
Skutečný sociální důkaz
Důvěra
Social- proof ticker může vést s opravdovými nedávnými objednávkami ("Ada objednala Starter Plan · 2h před"), křestní jméno a položka pouze, nikdy e-maily nebo částky.
Experimenty a cesty
A / B varianty a autovítěz
Rozdělit provoz na konstrukční varianty; nechat studio podporovat statistického vítěze automaticky, nebo ruční provoz na bandita optimalizátor, který posune návštěvníky směrem k tomu, co konvertuje jako důkaz přichází.
Vydržet zvedání
Rezervujte si kousek návštěvníků, kteří nic nevidí, takže můžete dokázat, že samotná kampaň způsobuje výtah.
Varianty segmentů
Různé obsahy na publikum v kampani SAME (mobilní návštěvníci, velké vozíky, vracející se zákazníci), každý segment dostane svou vlastní verzi.
Spouštěcí experimenty
Varianty mohou také testovat, kdy se objevit: okamžité vs opožděných vs exit- intent, měřeno head- to- head.
Cesty (řetězy)
Cílem toho, co někdo udělal s jinou kampaní ("viděl kampaň A, ale nepřevedl") k vybudování multikrokové propagační sekvence.
Zdrhovadla
Malé pilulky návštěvníci mohou znovu otevřít po uzavření kampaně, takže uzavřený pop-up nikdy není pryč nadobro.
Víš, co se stalo?
Klikněte na heatmap
Návrhář
V designéru přepněte heatmap a nakreslete skutečné kliknutí návštěvníků na každý blok vašeho designu.
Křídlová nálevka
Řapíkatá a stonková zelenina
Vícekrokové kampaně ukazují, kde přesně lidé padají, obrazovka po obrazovce.
Porovnat kampaně
Studio
Nastavte až čtyři kampaně vedle sebe (dojmy, kliknutí, konverze), nejlepší hodnota zvýrazněna.
Týdenní příběh & strávení
AI
Každé pondělí strávení přistane ve vašich oznámeních; 📖 týdenní tlačítko příběh píše stručný souhrn s dalšími kroky, kdykoli chcete.
Pohodlně pracovat
AI kopilot & nápady
Chat s designovým kopilotem pro úpravu plátna ("aby titulek urgentní, přidat odpočítávání"), získat nápady kampaně z vlastních dopravních dat, přeložit kampaň za zemi, nebo auto- opravit nízké konstrukční skóre.
Import značkového kitu
Jeden příkaz čte vaše webové stránky a navrhuje vaše skutečné značky barvy a písma; uložit a každý picker vede s nimi.
Ostatní, s kruhovým příčným průřezem
Kroky bloky získat pravdivé per- screen editace: záložky pro každou obrazovku, přidat nebo přeobjednat obrazovky, a náhled následuje dále.
Pojmenované verze & přítomnost
Jmenujte důležité verze ("Start kandidát"), obnovte některý z nich a uvidíte varování, když spoluhráč upravuje stejnou kampaň.
Přístrojový pás & vládci
Viz tabulka, tablet a mobilní bok po boku v jednom pohledu; přepnout pixelové pravítka pro přesné umístění.
Hosted stránka & kanály
Každá kampaň může být také samostatnou hostí stránky pro bios a QR kódy, emailová kapačka sekvence pro zachycené vodítka, nebo one-click web- push draft.
Bezpečnost podniků
Zveřejněte mrazivá okna (změna doby), nouzové pauzy - všechny spínače, schválení, auditní stopu a verzi převrácení.
Mám přidat kód na své stránky?+
Ne. Propagace jsou dodávány stejným OpsIQ widget jste již nainstalován. Design, publikovat, udělat.
Budou návštěvníci vidět to samé pořád dokola?+
Ne. Nastavte frekvenční uzávěry (za sezení / den, nebo se zastavte po zavření, kliknutí nebo konverzi).
Kdo to může zveřejnit?+
Vydávání, zastavování, archivace a převrácení jsou omezeny na majitele pracovních prostor a plné administrátory. Každý člen týmu může vytvářet a navrhovat návrhy.
Růst a SEO
Propagace Designer
Propagace Designer je citlivý blokový editor pro budování, přezkum, verze a publikování zkušeností kampaně.
Produktová obrazovkaDesignér kombinuje živé plátno, předvolby zařízení, bloky, personalizace proměnných, komentáře a historii verzí.
Pomocí bloků sestavit zkušenosti, náhled každý podporovaný pohled a vložit schválené personalizace proměnných. Review komentáře a AI- media provenance před spuštěním. Uložení vytváří verze, takže předchozí design může být kontrolován nebo obnoven.
Růst a SEO
Šablona pro propagaci
Šablony poskytují vyhledávání, kategorizované startovní galerie pro propagační Studio kampaně.
Produktová obrazovkaV šabloně galerie filtruje prémiové rozložení a aplikuje barvy značky pracovní plochy, když se šablona stane draftem.
Hledat nebo filtrovat podle kategorie, načíst další výsledky, náhled kompletní zážitek, pak vybrat Použít šablonu. Nová kampaň zůstává návrhem a lze ji změnit v Promotion Designer před publikací.
Růst a SEO
Propagační analytika
Propagace analytiků spojuje dojmy a kliknutí s konverzemi, kontextem publika, výstupy konektoru a vzděláváním kampaně.
Produktová obrazovkaPropagační analýza ukazuje hlavní výkon, publikum a spouštěcí poruchy, vede k exportu a konektoru akční výsledky.
Přečtěte si dojmy, kliknutí -prostřednictvím rychlosti a konverzí dohromady. Rozlom výsledky podle země, stránky, spouštěč a zařízení; Export zachycené vede v případě potřeby. Konektor akční výsledky ukazují, zda je podpora přislíbená po-up skutečně běžel. AI vhled a hodnocení souhrny by měly být považovány za hypotézy potvrdit, ne automatický důkaz.
Růst a SEO
Oznámení
Oznámení zveřejňují zprávu v oblasti hlášení widget s volitelným cílením, rozvrhem a výzvou k akci.
Produktová obrazovkaEditor oznámení obsahuje obsah, CTA, publikum, segment, pravidlo stránky, aktivní data a vizuální styl.
Vyberte si všechny návštěvníky, signed- in visitors nebo nové návštěvníky; volitelně zúžit publikum s kontaktním segmentem a pravidlem stránky. Nastavte aktivní -od / aktivve- do datumů a aktivní vlajku. Premium styl přednastavené a barevné změnit prezentaci, ale nenahrazují jasný obsah.
Růst a SEO
Tlačit kampaně
Tlačit kampaně odesílat oznámení prohlížeč na upsané návštěvníky poté, co opustili stránky.
Produktová obrazovkaSkládačka ukazuje rozsah předplatného, obsah, média, akce, cílová pravidla a stav harmonogramu.
Nastavit klávesy na webové Push nejprve pod nastavením Web Push. Kampaň může zahrnovat název, tělo, ikonu, obraz hrdiny, odznak, CTA a až dva akční tlačítka; přetrvávající oznámení zůstává, dokud návštěvník interaguje.
Cíl diváky, volitelné pravidlo pro kontakt a segment stránky. Uložit návrh, naplánovat nebo odeslat okamžitě. Použijte předplatné a klepněte na tlačítko metrika pro posouzení dosahu. HTTPS a správně hostující pracovník služby jsou vyžadovány na vložených třetích stran stránek; viz Web Push na třetích stran stránkách.
Ochrana soukromí
Cookie souhlas studio
Studio Cookie Consent navrhuje banner cookie, který návštěvníci vidí, definuje, co je pro vaše podnikání důležité, uplatňuje správné chování pro každý region návštěvníků a (zásadně) vlastně prosazuje souhlas, takže analytika a marketingové značky nepoběží, dokud se návštěvník nedohodne. Banner je dodáván přes OpsIQ widget již na vašich stránkách. Jedná se o prémiový design studio, banner ukazuje pouze jednou zapnete souhlas pro svůj pracovní prostor.
Souhlas s CookieNa to se dívá i souhlas návštěvníků: vaše znění, Vaše kategorie (důležité jsou vždy zapnuté, ostatní jsou volba návštěvníka) a Accept / Odmítnout / Prefers, za ním je per- kategorie vynucování.
Studio karty
Konstrukce
Vyberte si z velké knihovny bannerových vzorů a plně barevný systém (transparentní, pevný nebo gradient), který bude odpovídat vaší značce.
Styl
Fine-tune formulace, tlačítka štítky, politické odkazy, banner pozice, a jak dlouho je volba je třeba pamatovat.
Kategorie
Definujte si vlastní kategorie cookie a znění návštěvníků viz. Rozhodnete, co je nezbytné. Základní je vždy na; vše ostatní je jejich povolit nebo odmítnout.
Cookies (skener)
Proskenujte své stránky a nechte OpsIQ AI automaticky detekovat všechny cookie a sledovač, kategorizovat, a psát jednoduchý jazyk účel. To umožňuje preference tabulky a autoblokování.
Zákon a oblast
Vyberte, jak se bude souhlas chovat podle zákona (níže), a zapněte sdílení group- domain, režim Google Consent v2 a re- consult intervaly.
Analytika
Viz statistiky o přímém souhlasu z reálných návštěv (přijímejte sazby, podle kategorií) načrtnuté do Vašeho pracovního prostoru.
Spravte zákon automaticky.
Automaticky podle regionu
Chytré.
Návštěvníci EU / UK dostanou opt- in (nic non - nezbytné běží, dokud nepřijmou); američtí návštěvníci dostávají opt-out s možností "Neprodávejte nebo sdílet". OpsIQ rozhoduje o návštěvníkovi podle místa. Doporučeno.
Všude je tu opt-in.
Přísný
Strict GDPR pro všechny návštěvníky, nic non-zásadní, dokud přijmou.
Všude je to tu.
Polehčující
Štítky běží, pokud návštěvník se rozhodne.
Signály prohlížeč Global Privacy Control (GPC) a Do-Not- Track (DNT) jsou dodrženy, ať už zvolíte jakýkoliv režim.
Jak vlastně vynucování zastaví zachycení
Souhlas zde není jen banner. Ovládá, co běží:
Prosazování v kategorii "Per-". Když návštěvník odmítne kategorii, OpsIQ zastaví odpovídající zachycení, s vypnutou analytikou, analytika opravdu nefunguje, nejen vizuálně.
Automaticky blokujete své vlastní značky. Označit jakýkoliv třetí strana skript zůstat inertní, dokud je udělena jeho kategorie. OpsIQ aktivuje ji v okamžiku, kdy návštěvník souhlasí, a nikdy předtím.
Autoblokovat třetí stranickou značku
<!-- This tag stays dormant until the visitor grants the "marketing" category -->
<script type="text/plain" data-opsiq-consent="marketing"
src="https://example.com/ads-pixel.js"></script>
💡
Google Consent Mode v2 (Zákona a region karta) vydává správné gtag signály z každého návštěvníka volby, takže GA4 a Google Ads poslouchat souhlas nativně. Většina stránek nepotřebují IAB TCF, to je pouze pro stránky běží IAB- framework programmatic reklamy.
Sdílet souhlas přes vaše stránky
Zapněte group- domain sdílení, takže návštěvník, který přijímá na jednom z vašich stránek není znovu požádán na ostatních v této pracovní skupině. Jejich volba se přenáší na počet dní jste nastavili. Vypnout pro přísné per- domény souhlas. Cookie Souhlas páry se záložkou Privacy & Compliance, která vede seznam souhlasu (důkaz o každém grantu a zrušení).
Opravdu odmítání analytiky přestává sledovat?+
Ano. Prosazování předřadníků zastavuje odpovídající zachycení u zdroje. Není to kosmetický banner.
Potřebuju vývojáře?+
Ne pro banner. To se přepravuje přes widget. Pouze autoblokování vlastních třetích-party tagy potřebuje jednorázovou změnu markup na těchto štítcích (zobrazeno výše).
Kde je důkaz, že s tím návštěvník souhlasil?+
Na stránce Ochrana soukromí a dodržování: vyhledávatelný souhlas s každou grant a zrušit kontaktem, kanál, akce a datum.
Růst a SEO
Proaktivní zprávy
Proaktivní zprávy se automaticky dostanou do okamžiku, kdy návštěvník chování odpovídá pravidlu, než se zeptá. Postavíte každý jako pravidlo se třemi částmi: co by se mělo stát, kdy by mělo oheň, a jak často. Vše je dodáváno prostřednictvím OpsIQ widget již na vašich stránkách.
ProaktivníKaždé proaktivní pravidlo je tři možnosti: co se stane (chat, banner, prohlídka, push, e-mail, webhook), kdy (podmínky), a jak často (vychladnutí).
Tři části pravidla
1
Co by se mělo stát (akce)
Zobrazit chatovací bublina nebo on-page banner, spustit prohlídku s průvodcem, poslat webové tlačení nebo e-mail, přiřadit oddělení, nebo oheň webhook. Tokens jako {{visitor_name}} a {{page_title}} stát se skutečnými hodnotami.
2
Pokud by mělo vznítit (podmínky)
Úzký, kdo ho spustí: strana /URL, čas na stránce, posun hloubka, skóre olova, návrat vs nové, volnoběžné. Bez podmínek, pravidlo hoří pro každého návštěvníka. Přidat alespoň jeden k cíli. Podmínky se kombinují s AND.
3
Jak často (frekvence)
Nastavte chladicí systém tak, aby stejná osoba nebyla obtěžována, např. jednou za sezení nebo jednou za den. Každé pravidlo má status zapnuto / vypnuto.
⚠️
Pracovní prostor přepíná "Run time / leave rules hourly" umožňuje serverboard akce (email, push, webhook, přiřadit) oheň na rozvrhu pro známé kontakty, kteří nejsou v současné době na stránce, takže můžete "e-mail neaktivní horké vedení" automaticky. To potřebuje OpsIQ cron spuštěn. Nechte to vypnuté, pokud chcete pouze živé on- page ndges.
Bude to střílet pro všechny?+
Pouze pokud nepřidáte žádné podmínky. Přidejte alespoň jednu podmínku (stránka, skóre vedení, návrat...) k cíli správné návštěvníky.
Jak se tyto týkají toků a zájezdů?+
Pracují společně: proaktivní pravidlo může spustit Provedenou Tour, a Chatbot Flow může být spuštěn proaktivním pravidlem. Začněte jediným pravidlem chat- message, pak vrstvit ostatní na.
Růst a SEO
Proudové motory na beton
Chatbot Flows rozvětvování konverzí uvnitř vašeho chatu widget (pozdravy, odpovědi klíčových slov, vedené cesty) bez kódu. Průtok je soubor připojených kroků (uzly): položit otázku, návštěvník vybere možnost, a tok posílá je dolů odpovídající větev. Pouze aktivní toky běží na vašich stránkách.
Jak to fungujeProudové motory na beton
Průtok vs AI · kdy použít, které
Použít tok
Když je cesta předvídatelná a chcete, aby byla pokaždé identická: rezervační kroky, průvodce vrátí, "který plán?" Vyhledávač, sbírání e-mailu před předáním.
Použijte AI
Když jsou otevřeny otázky, "funguje to s mým nastavením?" Zákazník Chat AI odpovídá z vašich vyškolených znalostí. Průtok může předat AI (nebo člověk) v každém kroku.
Spouštěče
Pozdravení
Spustí se jako úvodní zpráva, když návštěvník poprvé otevře chat.
Klíčové slovo
Běží, když návštěvník napíše slovo, které jste uvedl (např. vrácení peněz, ceny, zrušení).
Po podrobnostech / Po zpoždění
Začne, jakmile jsou sdíleny kontaktní údaje, nebo nastavený čas do konverzace.
Na konci chatu / Proactive
Běží jako chat se uzavírá (např. rating), nebo je spuštěn pravidlem Proactive Message.
Postavíme jeden ve čtyřech krocích
1
Vytvořit tok
Klikněte na Nový tok, pojmenujte ho, vyberte typ spouště (a klíčová slova, pokud je klíčové slovo), uložit. Začíná vypnut.
2
Otevři plátno.
Klikněte na Upravit Canvas. Vizuální stavitel, kde přidáte kroky (zprávy, otázky s tlačítky, větve) a připojte je.
3
Přidat větve a hand- off
Pro každou volbu nakreslete větev k dalšímu kroku. Koncové cesty řešením, předáním AI nebo přenosem na člověka.
4
Povolit
Klikněte na možnost Povolit. Průtok jde živě ve vašem widget okamžitě. Zakázat kdykoliv bez ztráty designu.
Nahrazují toky AI?+
Ne. Běží bok po boku. Používají toky pro předvídatelné cesty a AI pro otevřené otázky; tok může vždy předat na obou.
Růst a SEO
Prohlídky s průvodcem
Prohlídky jsou step-by- krok průchody, které bod na části stránky s bublin řeči a reflektory, vedení návštěvníka přes nastupování nebo nové funkce. Jsou plně tematicky a postaveny ve vizuálním designéra s živou náhled. Prohlídka běží pouze tehdy, když je označen Aktivní.
Jak to fungujeProhlídky s průvodcem
Jak se staví prohlídka
Kroky
Každý krok se zaměřuje na prvek a ukazuje bublina s textem. Přidat tolik zastávek, jak procházení potřeby a objednat je.
Přednastavení& téma
Začněte z přednastaveného nebo navrhujte vlastní bublinu (barvy, sklony, reflektory) s živým náhledem vpravo.
Spouštěč
Volitelně odkaz Proactive Rule, takže turné automaticky začíná, když toto pravidlo hoří (např. návrat návštěvníka první palubní deska návštěvu).
Aktivní přepínání
Prohlídka je způsobilá k běhu pouze při Active je zaškrtnuto. Odznačit, aby se to dolů bez smazání.
Postavíme jeden ve čtyřech krocích
1
Nové turné
Klikněte na Nové Proactive Tour, pojmenujte ji a volitelně odkažte Proaktivní pravidlo, aby se automaticky spustilo.
2
Přidat kroky
Přidat každé zastavení: vyberte prvek, který ukazuje na a zapište text bubliny. Přeobjednat, dokud cesta teče.
3
Navrhnout
Vyberte si přednastavený nebo styl bubliny sami. Živý náhled ukazuje přesně to, co návštěvníci vidět.
4
Aktivovat
Tick Aktivní a uložit. Tour může nyní spustit, na vlastní spouště, nebo začal pravidlo Proactive Message.
Jak začínají prohlídky?+
Na vlastní spouštění, nebo prostřednictvím Proactive Message pravidlo "Provedená prohlídka" akce, takže se rozhodnete, kteří návštěvníci vidět, které turné a kdy.
Růst a SEO
Přepočítávací cíle
Převodní cíle změní činnost, na které vám záleží (příchozí webhook událost, chatová zpráva, řešení tipu) na zaznamenanou konverzi s plným přiřazením. Když se činnost vyvolá, OpsIQ zaznamená konverzi proti kontaktu a připojí ji zpět k kampaním, segmentům a zdrojům, které vedly tam.
Jak to fungujePřepočítávací cíle
Definovat cíl ve třech krocích
1
Zmáčkni spouštěcí činnost
Klikněte na nový cíl konverze. Vyberte si typ činnosti, který se počítá jako převod, nebo použijte Quick- start přednastavený, Stripe nákup, Demo rezervován, Newsletter signup nebo Odepsat začal.
2
Jmenuj a nastav hodnotu
Give the conversion a name (purchase, demo_booked, signup) and optionally a fixed value and an attribution window.
3
Uložit
Uložit a povolit. Od té doby, kdykoliv se činnost vyvolá, OpsIQ zaznamenává konverzi proti kontaktu s přiřazením k předchozím dotekům.
✅
Cíle jsou již napojeny na vstupující webové háčky: každý gól, jehož spouštěč se shoduje s typem příchozího požáru, automaticky v okamžiku, kdy událost přistane. Použijte stránku Příchozí Webháky pro připojení Stripe, Calendly nebo jakéhokoli systému, který může POST JSON.
Co může být přeměna?+
Jakákoli zaznamenaná činnost: událost na příchozí webhook (payment. fugment. foundated), zachycení chatu, rozlišení vstupenky, cokoliv v časové ose kontaktu.
Analytika
Vlastní palubní desky
Vlastní Dashboardy vám umožní vybudovat vlastní pohled na metriky, které jsou důležité, místo spoléhání se pouze na standardní Přehled. Přidat widgety chcete, přetáhněte a předimenzovat je do rozložení, chcete, uložit, a sdílet s vaším týmem.
Vlastní palubní deskyVytvořte si vlastní desku: přidejte KPI, widgety grafu a seznamu, přetáhněte je a změňte jejich velikost do rozložení, které chcete, a pak se o ně podělte s týmem.
Postavíme jeden ve třech krocích
1
Přidat widgety
Klikněte na Přidat Widget a vyberte metrický nebo graf, který chcete sledovat. Opakujte pro vše, co chcete na palubě.
2
Uspořádat rozložení
Přetáhněte widgety k přestavení a přetažením hran k předimenzování. KPI přes horní, grafy níže. Cokoliv čte nejlépe.
3
Uložit & sdílení
Uložte palubní desku a sdílejte ji s týmem, aby se všichni dívali na stejná čísla.
✅
Udržujte oddělené desky pro samostatné práce ("denní pohled" deska s živým počítá, a "měsíční přezkum" deska se grafy trendů), takže každý zůstane soustředěn.
Růst a SEO
Informační kampaně
Osazení je OpsIQ s1:1a hromadný e-mailový motor: sestavit personalizovanou zprávu nebo spustit kampaň na CRM segmentu, s odpovědí detekce, Send- time řízení, open / click sledování, sledovací pixel a one-click odhlásit. Je consent- routed a CAN-SPAM / CASL v souladu.
Navázat kontaktyEngine Outreach: odeslat1:1nebo spustit kampaně do segmentu, trať otevírá a odpovědi, a zůstat v souladu s built- v odhlásit a odpověď detekci.
Čtyři karty.
Komposer
Napište personalizované1:1e-mail s {tokens} z kontaktu a CRM.
Kamery
Pošlete do CRM segmentu, naplánované nebo nyní, s čepice a Send- time control.
Šablony
Reservativní šablony zpráv pro opakované oslovení.
Odpovědi
Odpověď na detekci zaznamenává odpovědi a autostop sledování každého, kdo odpověděl.
Jak vede kampaň
1
Vyberte si publikum.
Vyberte si segment CRM (nebo nahrát seznam). Potlačení a souhlas se aplikují automaticky.
2
Složení
Napište zprávu s osobitostmi; náhled proti skutečnému kontaktu.
3
Naplánovat a odeslat
Odeslat nyní nebo v nejlepší čas. Zobrazí se záznamy sledovacích pixelů; připíše se kliknutí a odpovědi.
✅
Výstupní je consent- a supression- routed, obsahuje one-click odhlásit na každém odeslání, a následuje CAN-SPAM / CASL. Odpovědi automaticky zastaví další follow- up.
Analytika
Plánované zprávy
Plánované zprávy e-mailem vybraný metrický soubor pro vybrané příjemce na harmonogramu (denní, týdenní nebo měsíční) jako tisknutelné, bílé označení PDF. Nastavte jej jednou a zpráva přistane v inboxech automaticky přes OpsIQ Crone.
Plánované zprávyNastavit zprávu jednou (metrický soubor, rozsah, harmonogram, příjemci) a OpsIQ e-mail a white- label PDF automaticky na vaší kadenci.
Nastavit zprávu
1
Vyberte, co poslat
Vyberte si metrickou sadu (provoz, SEO, prodej, podpora...) a datový rozsah.
2
Nastavit harmonogram & příjemce
Denní, týdenní nebo měsíční, v době, kterou si zvolíte, na jednoho nebo více příjemců e-mailu.
3
Uložit
Uložit a povolit. Zpráva generuje a emaily se na časový plán, žádný manuální krok.
💡
Plánované zprávy běží přes OpsIQ cron, pokud zpráva nedorazí, potvrdit, že cron běží (viz Cron a automatizace).
Ochrana soukromí
Ochrana soukromí a dodržování předpisů
Stránka Privacy & Compliance je jediným místem, kde auditor, který zpracovává osobní údaje, odpovídá: listinu souhlasu, admin přístupový deník, vaše pravidla pobytu a uchovávání údajů a ready- to- print DPA, v jednom tabulkovém zobrazení. Pouze plný správce může otevřít.
Ochrana soukromí a dodržování předpisůJedna auditoru- ready obrazovka: vyhledávatelný souhlas kniha (granty / anukes by channel), přístupový záznam toho, kdo se dotkl dat, rezidence / retenční nastavení, a tištěný DPA.
Čtyři karty.
Souhlas s účetní závěrkou
Vyhledatelný záznam o každém udělení souhlasu a zrušení, kontaktem, kanál (e-mail, push, SMS, in- widget), akce, zdroj a datum. Váš důkaz kontakt dohodnut (nebo stáhl).
Přístupový deník
Kdo z vašeho týmu prohlížel, editoval, exportoval, vymazal nebo odeslal data kontaktu, s admin, kontakt, akce, uvedl důvod a IP. Přesně to, co regulační orgán požaduje.
Rezidentura a retence
Vyhlaste, kde tato data žijí, nastavte počet dní, kdy se vedou řádky aktivit (0 = navždy) a zaznamenejte svůj datový ovladač a DPO.
Šablona DPA
Vytisknutelný doplněk zpracování dat, který vyplní váš ovladač, adresu, DPO, rezidenci a retenci. Tisk nebo uložení jako PDF.
✅
Privacy & Compliance páry se studiem Cookie consent (které shromažďuje souhlas) a exportní stránku (která vytváří datovou kopii pro DSAR). Viz také Cron a automatizace pro noční retenční čištění.
Konektory
Připojte své platformy
Spojovací vedení OpsIQ na externí platformy: e-commerce obchody, fakturační systémy, platební procesory, e-mailové poskytovatele, a vlastní APIs. Po připojení, AI může vyhledávat objednávky, data zákazníků, předplatné, a další, a přijmout opatření s vaším souhlasem.
Jak to fungujeKonektory
Lodě s OpsIQ
Tyto jsou přítomny v okamžiku, kdy nainstalujete a potřebují pouze své pověřovací listiny.
WHMCS
Účtování
Výpis z webu: klienti, služby, vstupenky, faktury, domény, servery.
Místní podnikání: recenze, příspěvky, Q & A, poznatky. Používá OAuth.
Kalendář Google
Produktivita
Kalendáře a události. Používá OAuth.
GmailaIMAP
E-mail
Poštovní schránky: příchozí a odchozí pošta, adres- book synchronizace.
SendGrid
E-mail
E-mailová dodávka: odeslat e-maily a spravovat šablony.
Mailgun
E-mail
E-mailová dodávka: poslat e-maily přes Mailgun.
Slack, Telegram, LINE, X DM
Zprávy
Vysílání zpráv pro příchozí a odchozí rozhovory.
Meta kanály
Zprávy
Facebook Messenger, Instagram DM a WhatsApp.
Zpravodajská služba na webových stránkách (GA4, vyhledávací konzole)
Analytika
Analytika a vyhledávání dat pro SEO suite.
Obohacování webových stránek a import CRM
CRM
Obohacování a hromadný dovoz zákazníků.
Dostupné na trhu
Tyto jsou publikované balíky, které nejsou součástí instalace. Nainstalujte jeden z Connectors, Marketplace a je zkopírován do složky živých konektorů, po kterém se chová přesně jako ty nahoře.
Seznam konektorů se pohybuje tak, jak jsou zveřejněny balíky. Autoritativní seznam pro vaši instalaci je stránka Connectors: co je uvedeno tam je to, co runtime objevil, a Marketplace karta ukazuje, co můžete přidat.
Instalace konektoru
1
Přejít na konektory
Přejít na konektory v admin sidebar.
2
Najít konektor
Projděte seznam nebo vyhledávání. Konektory jsou seskupeny podle kategorií.
3
Povolit
Klikněte na konektor a přepněte možnost Povolit.
4
Zadejte údaje
Vyplňte požadovaná pole: API klíč, URL, žetony, atd. Každý konektor má specifické požadavky zdokumentované ve svém panelu nastavení.
5
Zkušební spojení
Klikněte na tlačítko "Zkušební připojení". Zelený výsledek znamená, že konektor může dosáhnout vnější plošiny. Červený výsledek ukazuje chybu.
6
Nastavení funkcí
Vyberte si, které funkce umožňují: sync znalostí, webhook synchronizace, AI akce. Ne všechny konektory podporují všechny funkce.
Co ti konektory dávají
Kontext AI
AI může vyhledávat data, objednávky, předplatné a další přes konektor. Když zákazník chatuje, AI má skutečné platforma data k referenci.
Kontext AI (autoři konektoru)
KontextProvider vašeho konektoru podává ticket- AI shrnutí účtu pouze pro čtení majitele jízdenky. customer_id pokud je známo; jinak, na vstupence autoodpovědí, kde ctx vlajka customer_trust_email je pravda, podívejte se na účet nahoru customer_email (ověřený odesílatel tipu). Vzdálené platformy odhalí /context/customer-by-email Konečný výsledek a konektor to nazývá. To je to, co dělá AI citovat skutečný zůstatek / fakturu místo slova "prosím přihlaste se". Cti operátorovy data- class přepínače (customer_sections, customer_allow_creditA zůstat přísně čitelný, nikdy nevypouštět tajemství.
Adresář zákazníků (autoři konektoru)
Identifikátor vašeho konektoru je dodáván tři univerzální vyhledávače tipů: lookupCustomerById() (zákaznická karta), lookupCustomerServices() (tabulka produktů / služeb) a listCustomers($query,$limit): "Vyhledávání zákazníka nebo typu e-mailu" picker na rodném Compose- New-Ticket formulář. Vrátit řádky {id, external_id, name, email, company, phone, platform, platform_label}. Vzdálené pravidlo: pokud vaši zákazníci žijí v jiné databázi nebo službě, přiveďte je přes platformu API uvnitř těchto metod, nikdy číst tabulky jiného systému přímo (v OpsIQ DB jsou prázdné prostírače, což je důvod, proč lokální čtení vrací prázdný picker). Brána vzdálenou cestu na nakonfigurované API URL; udržet místní čtení pouze jako stejné-DB záloha.
Když se přicházející e-mail stane rodným tipem, OpsIQ detekuje odesílatele voláním lookupCustomerById(0, ['email'=>$sender]) přes každý konektor; první zápas "vlastní" zákazník a jeho platform slimák je označen na ticket.created událost jako _pipe_owner_platform (prázdný = host).WHMCS-zákaznický e-mail otevře vstupenku v WHMCS (WHMCS číslování, zrcadlově jako jeden), zatímco neznámý odesílatel zůstává rodným hostem. Pokud váš konektor odráží rodné jízdenky na vlastní platformu, your ticket.created Dohled musí být uzamčen na tomto: if (array_key_exists('_pipe_owner_platform',$payload) && $payload['_pipe_owner_platform'] !== '<your-slug>') return;. Klíč chybí na non-piped (chat / manual / AI) vstupenky, takže ty zrcadlo jako dříve. Per- oddělení řízení žije v rámci Team & Departments → Otevřené vstupenky prostřednictvím e-mailu (Každý / Zákazníci pouze / Off).
Akce
AI může provádět akce přes konektor: vytvořit tipy, aktualizovat objednávky, zrušit předplatné, vše s vaším souhlasem přes Trust Layer.
Znalosti
Konektory přispívají k AI články specifické pro platformu. Shopify konektor přidává e- commerce řešení problémů; WHMCS konektor přidává hostingové znalosti.
Knowledge- base import (autoři konektorů)
Pokud vaše platforma hostí znalostní základnu, vyhlásit kb_capabilities blokovat settings.json (typ kb_source) a váš konektor se objeví v editoru Help Center Importovat KB → Importování z připojené aplikace depilace, kdykoli je zapnuta a nakonfigurována v pracovní ploše. Je deklarativní, není metoda implementace: název built- in adapter (zendesk pro přesné-strom Help Center API, nebo crawl pro jakékoliv KB stránky) a base_template jako například https://{subdomain}.zendesk.com, které OpsIQ vyplňuje z uloženého nastavení konektoru. Záruky nikdy neopustí server; prohlížeč posílá pouze konektor slimák. Chcete-li podpořit novou platformu, přidejte opsiq_kb_<platform>_manifest() adaptér a reference podle názvu. connectors/PLATFORM_CONNECTORS.md §5.
Webhooky
Některé konektory registrují webháky s externí platformou pro oznámení událostí v reálném čase (nové objednávky, aktualizace vstupenek atd.).
Sledování prodeje
E- commerce konekuje data o příjmech do dashboard prodeje pro přiřazení a analýzu.
💡
Konektory jsou pracovní prostor-scoped. Každý pracovní prostor může mít různé konektory zapnuty s různými pověřovací znaky. A WHMCS workspace používá WHMCS konektor; a Shopify workspace používá Shopify konektor.
Můžu použít více konektorů najednou?+
Ano. Pro objednávky můžete mít Shopify a Stripe pro platby ve stejném pracovním prostoru. AI sčítá data ze všech povolených konektorů.
Co když moje platforma není v seznamu?+
Pomocí Connector Builder vytvoříte vlastní konektor pro jakoukoli platformu s REST API. Nebo zkontrolujte Marketplace pro komunity- postavené konektory.
Pracují konektory s vlastním moderátorem OpsIQ?+
Ano, konektory fungují identicky v cloudu i v autodesilaných edicích.
Konektory
Smlouva o prodeji a fakturačním konektoru
Každý obchodní konektor používá stejnou platform- neutrální smlouvu o událostech. WHMCS je referenční implementace, ale SaaS Bridge, obchody, poskytovatelé plateb, tržní konektory a balíčky pro stavitele konektorů musí dodržovat stejná pravidla.
Co musí každý obchodní konektor zveřejnit
Jedna autoritativní kniha
Publish realised economic events to opsiq_sales_events through CommerceEventRegistry::normalize(). Do not build a connector-specific Sales table or make core analytics query a remote platform directly.
Stálá identifikace zdroje
platform is the connector registry slug, such as whmcs, shopify or opsiq_saas. traffic_source contains verified acquisition attribution when supplied; otherwise use that same slug as the fallback. Store identifiers, not display labels. OpsIQ resolves the friendly connector name in the UI.
Idempotence
event_id must be deterministic. Map at least one immutable order_ref, invoice_ref or subscription_ref so webhook retries and backfills update the same event instead of creating duplicate sales. service_ref identifies the affected product or service instance when one exists.
Časový údaj zdroje
occurred_at is the payment or economic-event time reported by the source platform. Never replace historical payment dates with the import time.
Peníze a FX
Odeslat zdrojovou částku a platnou třípísmennou ISO měnu. Pokud nastavení konektoru umožňuje konverzi OpsIQ FX, převede se hlášení do měny pro vykazování pracovních ploch; jinak zprávy uchovávají měnu skladovací nebo fakturační platforma. Kód konektoru nesmí být pevný kód vykazující měny nebo směnného kurzu.
Životní cyklus založený na dopadech
Použijte nový, obnovení, upgrade, vrácení peněz, úvěr nebo neznámá. Upřesněte z důvodu faktury, předplatné nebo servisní vztah, lin- item typ, nebo jiný autoritativní zdrojový pole. Opakované zakoupení stejným zákazníkem není automaticky obnova.
Hranice prodeje
Pouze pozitivní placené nové, obnovení, upgrade, nebo legitimně neznámé příjmy z obchodu patří do prodeje & Konverze. Náhrady jsou vykazovány pomocí náhrady a net- příjem analytiků. Účet úvěr, peněženky top-up, token top- ups a Add Funds zůstávají billing- knihy událostí a nikdy se nepočítají jako prodej, konverze, objem objednávky, nebo prodejní výnosy.
CRM zůstává oddělené
Nabídky CRM představují činnost plynovodu a dealování. Nejsou to prodej na platformě, pokud připojená fakturační nebo skladová platforma nevydává realizovanou zaplacenou objednávku nebo fakturu prostřednictvím této smlouvy.
Odvozené projekce
opsiq_conversions and dashboard summaries are compatibility projections rebuilt from the ledger. Connectors must not treat a projection as the financial source of truth. Contract revisions can re-evaluate derived rows without deleting the underlying billing history.
Vzdálená hranice nástupiště
Vzdálený konektor čte svou platformu přes konfigurované ověřené API. Nikdy nesmí záviset na tabulkách databáze same- server. Přesný ověřený doménový klíč je dodáván ConnectorRegistry a musí být použit pro každou knihu zápisu a zálohování. Pracovní prostor nebo rozsah skupiny je pouze agregací času, nesmí nikdy rozšířit uloženou událost vlastnictví.
When Sales and billing is enabled in Connector Builder, map amount, currency, source status and source date, plus at least one order, invoice or subscription reference. Map lifecycle_type when the API exposes authoritative lifecycle evidence. The generated SalesIngest passes every row through the same CommerceEventRegistry normalizer used by built-in and marketplace connectors.
⚠️
Kredity a fondy Add jsou záměrně uchovávány pro fakturaci historie, kontext zákaznické bilance a analýzu účetní knihy. Vyloučení z prodeje je nesmaže, pouze jim brání v nafukování obchodního výkonu.
lifecycle_type decides what becomes a CRM deal
lifecycle_type není analytický štítek. OpsIQ jej čte, aby se rozhodlo, zda prodej vstoupí do potrubí CRM, takže každý prodejní konektor činí rozhodnutí o potrubí, ať už má nebo nemá v úmyslu.
nový
Otevře uzavřený-won obchod (nový obchod).
obnova, modernizace
Rekorded as rekururing revenue. No new-business deal - obnova konvertuje na jiné pravděpodobnostní křivky a míchání je poškozuje obě prognózy.
vrácení, úvěr
Nikdy neotevřou dohodu, v žádném režimu. Peníze vrácené zákazníkovi nejsou výhra.
vynecháno / neznámé
Prodej je zaznamenán, ale nikdy nedosáhne potrubí.
Jeden prodej, jeden řádek knihy: identita je SALE, ne událost
Neshodujte se s event_id a vložte se do něj. event_id is platform:eventName:externalId, která odpovídá "už jsme tuto dodávku zpracovávali" a nemůže odpovědět "již jsme zaznamenali tento prodej." Platforma, která oznamuje jednu platbu dvakrát - jako invoice.paid a znovu jako payment.completed - Mints dvě ID a přistane stejné peníze dvakrát, s ničím se srážet a nic varovat.
💡
Found on the reference install: six invoices with three ledger rows each, from three code paths using three different event_id schemes. They all carried 0.00 so no total looked wrong, and any later process restoring real amounts would have counted one payment three times.
Místo toho zadejte sdílený zápis. Jádro počítá obchodní identitu prodeje (sale_fingerprint), odpovídá existující řádek na to, uchovává originál event_id při aktualizaci a filtry do reálných sloupců:
Jediný podporovaný způsob, jak napsat prodejní knihu
fakturace. paid, payment. complete and sale. comple. filled for one facto share one finger and update one row.
Náhrady zůstávají oddělené
Peníze jít ven je jiný fakt než peníze přicházejí. Vrácení faktury si udržuje svou vlastní identitu, takže nikdy nemůže přepsat platbu se obrátila.
Bez odkazu, bez otisků prstů.
Řádek bez objednávky, faktury, předplatného nebo servisu nemá žádný otisk prstu vůbec, takže dvě nesouvisející řádky se nikdy nesrazí jen proto, že oběma chybí ID.
Referenční precedence
invoice_ref, then order_ref, then subscription_ref, then service_ref — strongest first, so one sale keeps a stable identity.
Účetní kniha je pouze dodatek: nikdy nepřepsat prodej
Náhrada, zrušení nebo oprava je nová položka s datem. Nikdy zmutovat řádek opravuje. Přepsání platby do náhrady vypadá uklizeno a rozbije tři věci najednou:
Ničí hrubé příjmy.
Hrubá míra prodeje a náhrady se již nedá oddělit - a sazba náhrady je metrická, o níž lze informovat.
Zapisuje si zvrat ve špatném období.
Březen vrácení z lednového prodeje musí snížit březen. Přepsání ledna řádek tiše přestavuje uzavřené období.
To prolomí auditní stopu.
Zápis do knihy zaznamenává, co se stalo v určitém okamžiku. Opravy jsou kontra- entry, což je způsob, jak dvojí-entry účetnictví funguje po dobu pěti století.
Takže konektor hlásí spíše zvrat než jej použít: návrat refunded_at a refund_amount vedle vlastního životního cyklu prodeje, a nechte volající napsat náhradu jako vlastní řádek datovaný při vrácení peněz. Oba se nikdy nesrazí, protože otisk prstu odděluje návrat z prodeje.
💡
Stejný princip platí pro částky. Neopravujte "uloženou částku" na aktuální hodnotu platformy: faktura vypořádaná z účtu úvěr legitimně zaznamenal 0 v platební době, a peníze byly zaznamenány již při zákazníkovi doplněné. Obnovení nominální hodnoty počítá to dvakrát.
Smlouva o klasifikaci
OpsIQ rozhoduje o životním cyklu once, in \OpsIQ\Commerce\SaleLifecycleClassifier. Konektor prohlašuje pouze, který z vlastní platformu slova znamenají co, prostřednictvím provádění \OpsIQ\Connectors\SalesLifecycleConnectorInterface::salesLifecycleVocabulary(), a pak volá sdílený klasifikátor. Nereimplementujte uvažování.
Vyhlásit slovní zásobu, delegovat rozhodnutí
public static function salesLifecycleVocabulary(): array
{
return [
'credit' => ['addfunds'], // adds balance, sells nothing
'upgrade' => ['upgrade'], // resizes an existing commitment
'recurring' => ['hosting', 'domainrenew'], // continues something owned
'acquisition' => ['domainregister'], // obtains something new
'recurring_prefixes' => ['domainaddon'], // families that grow over releases
];
}
$lifecycle = \OpsIQ\Commerce\SaleLifecycleClassifier::classify([
'explicit' => $platformSaidSo, // wins outright when present
'line_types' => $types, // your platform's own line/item types
'vocabulary' => self::salesLifecycleVocabulary(),
'is_order' => $cameFromANewOrder,
'is_refunded' => $moneyWentBack,
]);
💡
Precedence is fixed and shared: explicit, then refunded/cancelled, then credit, then upgrade, then is_order, then recurring, then acquisition, then unknown. Upgrade sits above the order check because platforms raise an order for upgrades too; recurring sits below it because the first invoice of a new subscription carries a recurring line type. On an ambiguous non-order sale the classifier leans to revenue and away from the pipeline.
Vyhlásit celý slovník platformy
Toto je selhání, které stojí nejvíce a vypadá nejméně špatně.WHMCS konektor shodný ['hosting','addon','domain'] - seznam, který je jako kompletní. WHMCS nevydává holé Domain typ pro reálné doménové linie; emituje DomainRegister, DomainRenew, DomainTransfer, PromoHosting, PromoDomain, DomainAddon* a UpgradeVšichni propadli seznamu. unknown: 1,288 faktury, tři roky, žádná chyba a žádný log line.
Každý nový zákazník importuje svou historii přes konektor zadní vyplnění, takže klasifikační chyba nemá vliv na jeden pracovní prostor - to má vliv na každý pracovní prostor, který kdy na palubě přes tento konektor, v okamžiku, kdy se poprvé podívat na jejich potrubí. Vezměte slovní zásobu z dokumentace platformy nebo sčítání živých dat, a zápas rostoucí rodiny prefix Takže sourozence, kterého nikdo dosud neviděl, klasifikuje s příbuznými místo toho, aby zmizel.
💡
Praktická kontrola: Spočítejte, kolik vlastních řad přistane na neznámém místě. Zdravý prodejní konektor klasifikuje téměř všechno. Neustálý tok neznámého je téměř nikdy data, která nemáte - je to slovní zásoba, kterou se konektor nikdy nenaučil číst.
Opětovné uvedení importované historie
Každý dodávaný prodejní konektor OpsIQ implementuje toto — WHMCS, Shopify, WooCommerce, osCommerce, SaaS Bridge, Stripe, BigCommerce and Magento 2. Treat it as expected, not optional: a customer imports their old records on day one, so a classification fix that cannot reach that history only helps people who signed up afterwards. Implement \OpsIQ\Connectors\SalesLifecycleRepairInterface::reclassifySale() pomocí jakéhokoliv per- záznamu, který již máte. tools/crm_backfill_sales_lifecycle.php pak opraví importovanou historii konektoru bez kódu per- konektoru: suchý běh ve výchozím nastavení, zálohuje se a ověřuje počet řádků před zápisem, reverzibilní přes reverzní knihu, a nikdy nenapíše neúspěšné čtení jako odpověď.
💡
Pokud váš konektor nemůže přečíst předchozí záznamy - webhook- pouze konektor ne - neotupujte metodu. Stub vrací neznámé je horší než žádná implementace: backfill by přepsat dobré řádky jako uncrised a hlásit úspěch. Zavést slovní rozhraní pouze.
💡
Detailed package references remain available in connectors/CONNECTOR_EVENTS.md and connectors/PLATFORM_CONNECTORS.md in self-hosted source distributions.
Konektory
Smlouva o události v cestovním ruchu
Cestovní zpravodajská služba přijímá jeden platform- neutrální obálka události z widget prohlížeče, built- in konektory, SaaS Bridge, Tržní balíčky a Connector Builder výstup. Platform- specifické názvy jsou přeloženy na hraně; trychtýř, přiřazení a kód Site Intelligence konzumuje pouze kanonické události.
Izolace a hranice důvěry
Přesný klíč pro doménu
Every event is bound to the authenticated domain site_key. A connector must take that key from ConnectorRegistry or its authenticated endpoint, never from an untrusted request body. Domains keep separate records; a domain group is a read-time aggregate only.
Idemopotentní identita
event_id is required for connectors and must be deterministic for the same native event. Retries, webhooks and backfills update one event rather than duplicate a journey or sale.
Původní a kanonický název
Preserve source_event_name for evidence and troubleshooting, then map it to event_name_canonical. Core analytics must never branch on a connector slug.
Důkazy serveru vyhrávají
Pozorování prohlížeče může spustit nebo infer cestu. Autentizované konektorové události potvrzují signup, přihlášení, platby, nákup, obnovení, vrácení a další terminály výsledky. Platný srovnávací token je nejsilnější spojení; neplatný token se zamítá a jeho vložené ID se nedůvěřují.
Ochrana soukromí
Odeslat pouze identifikátory a pole potřebné pro deklarovanou cestu. Respektujte souhlas, maskování a zadržení nastavení. Nikdy umístit pověřovací listiny, data karty, autentizace tajemství nebo soukromé zprávy orgány ve vlastnostech.
Použijte nejužší pravdivé jméno. Podporované rodiny zahrnují zásnubní stránku / CTA události; signalizace účtu, přihlášení, MFA a resetování hesla; olovo a formy; produkt, vozík, checkout, platby, nákup, předplatné, obnovení a vrácení; propagační dojmy a konverze; help-centrum, chat a akce vstupenek; bezpečnostní události; a jmenované vlastní akce. Typické terminály názvy jsou account.signup.succeeded, account.login.succeeded, lead.form.succeeded, commerce.payment.succeeded, commerce.purchase.completed, commerce.subscription.renewed a commerce.refund.completed.
Odvozování prohlížečů, potvrzení a opuštění
Widget může fungovat bez konektoru sledováním struktury stránky, formátů akcí, výsledků návštěvníků a záznamů o cestě. Tento důkaz zůstává výslovně klasifikován jako pozorovaný nebo odvozený. Konektor přidá autoritativní potvrzení serveru a může jej korelovat se stejným pokusem prohlížeče. Opuštění je nejprve uloženo jako kandidát, bude opuštěno až po nečinnosti okno nastavené v UI a pouze tehdy, když neexistuje žádné pozdější zotavení nebo úspěch.
Přidělení a příjmy
Přiřazení preferuje platný podepsaný korelaci token, pak přesný výlet, pokus, relace nebo obchodní odkaz, pak souhlasný graf identity, a konečně ohraničený behaviorální zápas. Nevyrovnaný prodej zůstává nepřiřazen. Multi- touch Ledger váhy musí být celkové 1. Webové zpravodajství přisuzované příjmy čte tuto knihu; úvěry, peněženky top- ups, town top-up a Add fondy nejsou nikdy nákup konverzí. Připojení FX chování zůstává kontrolováno tímto nastavením konektoru.
⚠️
Model připisování, okénka pro vyhledávání, direct- traffic handling, minimální jistota, timeout opuštění a definice trychtýřů jsou UI. Kód konektoru nesmí být přísně kódovaný.
Declare pouze schopnosti balíček skutečně přináší. Connector Builder ověřuje mapování a generuje stejný platform- neutrální adaptér používané balíčky first-party. Cesta požití přijímá jednu událost nebo ohraničenou dávku 100 prostřednictvím generované ověřené integrace endpointu.
💡
Obchodní kniha zůstává finančním zdrojem pravdy. Commerce- to- travel bridge zveřejňuje server- potvrzené výsledky a smíření přiřazení po existující idempotent knihy nahoru, takže jedna platba nikdy se stává dva prodeje.
Konektory
Jak akce AI fungují
Každý konektor prohlašuje řadu akcí: věci, které může AI dělat přes vnější platformu. Akce jsou mostem mezi "AI říká" a "AL dělá".
Akce v oblasti AIŽádost se stává deklarovanou akcí (zapsaný čtení / zápis / smazání), která je prověřena, potvrzena, poté provedena a hlášena.
Akční životní cyklus
1
Zákazník si něco žádá.
"Cancel my subscription." The AI identifies this requires the "cancel_subscription" action.
2
Povolení k ověření AI kontrol
Je tato akce povolena? Je povolena? Má současný uživatel správnou roli?
3
Parametry AI shromažďuje
Akce potřebuje předplatné ID. AI to vyhledá z kontextu zákazníka nebo se zeptá zákazníka.
4
Potvrzení
V případě destruktivních nebo vysoce efektních akcí žádá AI o potvrzení před provedením.
5
Provedení
Akce vyzývá k tomu, aby vnější platforma API.
6
Výsledek
AI podává výsledky zákazníkovi.
Druh opatření
Čtení akcí
Look up data without changing anything. Examples: list_orders, get_customer. Safe, no confirmation needed.
Čtení akcí
Create or modify data. Examples: create_ticket, update_order. May require confirmation.
Vyhlášen v akci.json, generické API volání definovaná deklarativně.
Štítky způsobilosti
Optional per-action "capability" field in actions.json, a connector-neutral class tag (e.g. "tickets" for a ticket read/lookup, "ticket_create" for opening a ticket). OpsIQ gates the whole class uniformly across every connector: ticket reads drop out of the AI when the operator turns off AI Ticket Awareness, and ticket creation is reserved for OpsIQ's own composer (so a connector's create tool can't duplicate it). Declare it and your connector conforms. OpsIQ never needs to know your action names. The Connector Builder exposes it as a Capability dropdown per action.
Kodex činností
Implementovaný v PHP ve třídě konektorů. Plná kontrola nad logikou.
Příklad definice akce
{
"lookup_order": {
"label": "Look up an order",
"description": "Find an order by ID or email",
"method": "GET",
"endpoint": "/admin/api/2024-01/orders.json",
"params": {
"order_id": { "type": "string", "label": "Order ID" },
"email": { "type": "email", "label": "Customer email" }
}
}
}
Konektory
Vybudovat konektor
Konstrukční konektor umožňuje vytvořit kompletní konektor pro jakoukoli platformu se REST API. Pro základní konektory není nutné žádné kódování.
Vybudovat konektorBod stavitel v jakémkoli REST API. Set auth, base URL a akce, otestovat, a zveřejnit pracovní konektor. Žádný kód není potřeba.
Kompletní poskytovatel API pokrytí
Každý generovaný API konektor může odhalit samostatné Native API Čtení a domorodé API Psaní akce. Kurátované akce zůstávají preferovány; Nativní akce pokrývají poskytovatele koncové body přidány později. runtime podporuje REST, GraphQL, JSON, formulář, XML, surové a vícedílné subjekty, ohraničená paginace,API-Verze hlavičky a idempotence při zachování pověřovacích listin uvnitř nastavení konektoru pracovní plochy.
⚠️
Obchodní balíčky jsou vyráběny z /marketplace_connectors stejně jako svázané /connectors. Zvyšte verzi balíčku, regenerujte smlouvu a dokumentaci, spusťte konformní testy, pak se znovu podepište a publikujte novou verzi Marketplace.
Průvodce spojovacím zařízením
Průvodce má šest kroků, zobrazeny jako karty přes horní. Můžete skákat mezi nimi volně, a Uložit návrh v podnose si udrží svou práci kdykoliv.
1
Totožnost a profil
Name, slug, description and icon, then choose a contract profile: Standard API, Commerce, Helpdesk, Mailbox, Site Intelligence, SaaS Bridge, Local PHP Platform, or Platform with no API when the platform serves nothing callable and OpsIQ has to install a bridge. The profile selects a complete capability starting point; you can still adjust individual capabilities.
2
AuthCity in New York USA
Vyberte si ověřovací vzor platforma používá a vyplňte její pole. Zde zadejte i skutečné testovací údaje: jsou použity pro test spojení na dalším kroku a po zveřejnění nejsou uloženy.
3
Zkouška
Zadejte API základ URL a ověřte koncový bod, pak spusťte zkoušku živého spojení pomocí pověřovacích listin od kroku 2. To před tím, než definujete jakékoli akce, pokud auth nebo základna URL je špatné, každá akce, kterou napíšete, by selhala ze stejného důvodu a vy byste ladili špatnou věc.
4
Akce
Definujte každou operaci: název, HTTP metoda, koncová cesta, parametry, mapování pole odezvy a nastavení spolehlivosti popsané níže. Z tohoto kroku můžete spustit každou akci individuálně proti živému API.
5
Spouštěče
Mapujte události webháku, na které vaše platforma posílá OpsIQ události, takže věci, které se dějí na platformě může začít pracovat v OpsIQ.
6
Recenze, smlouva o podnikání a zveřejňování
Review every action, trigger and capability. Enterprise profiles expose the generated queue, worker, hook, migration, ticket-mirror, attachment and conflict contract before publishing. Publishing writes the package into /connectors/<slug>/.
⚠️
Publikace NESpustí conformance suite. Publikovat pouze validuje wizard formulář a vydává varování, které neblokují. Stiskněte Dry- run před odesláním, pokaždé.
Co publikování dělá, že formulář neukazuje
Pět chování generátoru překvapí lidi. Žádný je chyba; všechny z nich vás bude stát odpoledne, pokud se setkáte náhodou.
One question decides the passthrough: does the platform serve an API?
Answer it in step 1 by picking the data-access mode (or the "Platform with no API" profile). API mode declares native_api and emits the <slug>_api_call passthrough. Bridge mode declares platform_bridge instead and STRIPS native_api even if an older spec carried it, so the manifest, the generated class and the expertise docs cannot disagree. ai_brain_aware is added either way.
SILENCE MEANS "it has an API"
The Builder follows your answer; it does not work the truth out for itself, and the default when nothing is said is API mode. So a no-API platform must ACTIVELY say so — pick the "Platform with no API" profile, set data access to bridge, or tick platform_bridge; any one of the three is enough and they cannot contradict each other. Skip the question on a platform with no API and you are back to the old failure: a dead <slug>_api_call the model keeps reaching for. This used to be stamped unconditionally, so the trap is now escapable rather than gone.
Zkouška připojení pro GET /ping je neplatná.
Pokud necháte ověřenou cestu prázdnou, Builder píše /ping do generovaného konektoru a do profilu.jsontestovací blok. Téměř žádná skutečná platforma slouží této trase, takže Test Connection selže s HTTP404na každé instalaci a čte jako zákaznická chybná konfigurace spíše než vada balíčku. Nastavte ověřte si cestu, na kterou vaše platforma skutečně odpoví. Pro můstek konektor, namířit na svůj vlastní diagnostický cílový bod - to dokazuje celý řetězec v jednom volání: most je nasazen, klíč shoduje, a most může dosáhnout databáze.
Re-publishing still overwrites your hand-edits
Capabilities now follow the data-access answer, so those no longer drift. Everything else generated still does: edit ContextProvider.php or any other emitted file and the next publish replaces it. The one protected exception is the bridge file — the wizard only overwrites a bridge carrying its own marker, so a hand-written one is left alone.
Vyhlášení smazání souborů
Un- tick schopnost a další publikovat odstraní svůj soubor poskytovatele. Hand-edits na jakýkoli generovaný soubor - ContextProvider.php především - jsou přepsány bez varování. Kopírovat přizpůsobení se nejprve, nebo převzít vlastnictví balíčku smazáním.opsiq- Stavitel.json(po kterém to čaroděj už nebude řídit).
release_status is always preview
The wizard has no control for it. A package meant to ship as production must have release_status changed by hand in settings.json — and that edit breaks the signature, so re-sign afterwards.
Podpis dokazuje integritu, ne původ.
Balíčky pro stavební stroje jsou podepsány vlastním symetrickým klíčem této instalace. To detekuje manipulace. To nedokazuje, kdo balíček napsal, a každá instalace držící stejný klíč může produkovat stejný podpis. Zacházejte s lokálně podepsaným balíkem jako self-signed.
Srážka slimáků se kontroluje pouze v jednom stromu.
Publikace odmítá slimáka, který již existuje pod/connectors/.Nedívá se na to./marketplace_connectors/,takže ručně autorovaný balíček s první stranou se stejnou slimákem může skončit stínován.
💡
Průvodce nemá krok znalostí-autorizace. Znalostní soubor popisující platformu je generován pro vás z názvu, popisu, auth typu a akcí, které jste definovali, a je načtena do AI, když je zapnutý konektor.
Vymezení akce (krok 4)
Každá akce má následující nastavení. Jsou potřeba pouze první čtyři, kontrola zbytků, která ji může spustit a jak pečlivě.
Akční klíč a štítek
The key is what the AI calls; the label is what a human reads. Keys are namespaced with your connector slug automatically, so two connectors can both have a "list_orders" without colliding.
Metoda HTTP
GET, POST, PUT, PATCH nebo DELETE.
Cesta URL
Použité na základnu URL Použití {name} pro jmenovatele, například /opportunities/{id}/stage
Parametry
Pro každý parametr si také vyberete, kam se ubírá: tělo, path, query nebo hlavička. Parametr cesty vyplní {placeholder}; parametr dotazu je připojen k parametru URL.
Mapování odezvy
Řekněte, které pole v odpovědi JSON znamená co, což je jméno zákazníka, což jsou e-maily, což představuje celkový počet objednávek. To je to, co umožňuje AI číst data vaší platformy, spíše než hádat.
Kdo to může použít?
Váš tým (admin AI), znakový-in zákazníky (zákaznický chat), a to jak, nebo psaní asistent. Zákaznické akce běží pouze pro signed- in zákazníka, a pole identity jsou uzamčeny na ně automaticky, takže jeden zákazník nemůže ptát na jiné.
Vyžaduje potvrzení
Člověk musí schválit, než akce běží.
Ničivé
Označuje akci jako vymazání nebo změnu stavu. Používá se k varování před tím, než běží.
Požadované povolení
The admin must hold this permission for the AI to run the action on their behalf; full administrators always pass. Choose from manage_integrations, manage_general, manage_billing, manage_sales_bridge, manage_knowledge, manage_appearance, manage_behavior, manage_permissions, manage_dangerzone, reply_to_chats, escalate_to_ticket, send_agent_email, or none, meaning any authenticated admin.
Popis / náznak AI
Volitelné, ale stojí za to psát. To říká AI, kdy dosáhnout pro tuto akci, například "Použijte to, když admin žádá o změnu fáze dohody." Dobrý náznak je rozdíl mezi akcí, kterou AI používá správně a jeden to ignoruje.
Schopnost
Optional class tag, either tickets (a ticket read or lookup) or ticket_create (opens a ticket). Tagging lets OpsIQ gate the whole class at once, for example, hiding ticket reads when an operator turns AI ticket awareness off.
Cesta seznamu
Volitelné. Pro koncové body, které vrátí seznam, tečkovaná cesta do pole, například data nebo data. položek
Chyba
Volitelné. Pole těla, jehož přítomnost znamená, že volání selhalo, například error.message, užitečné pro APIs který vrací HTTP 200 při selhání.
Spusť to.
Každá akce může být spuštěna proti živému API z tohoto kroku, takže můžete opravit špatnou cestu nebo název pole, než někdo jiný používá.
⚠️
Write actions are protected by default. Any action using POST, PUT, PATCH or DELETE starts out requiring the manage_integrations permission a lidské potvrzení před spuštěním. To je záměrné. Nová akce zápisu selže spíše než nechat AI změnit vaše data bez dozoru. Můžete změnit jak na akci, ale změnit je vědomě.
💡
Aby bylo možné volat z chatu zákazníka, akce musí být read- only: zanechat jak vyžaduje potvrzení a zničení neškrcený. Akce zákazník může spustit, že také změny stavu není něco, co průvodce vám nechá loď náhodou.
Přijímající webové háky (krok 5)
Triggers krok vám webhook URL zaregistrovat se na platformě, a ověřuje každý požadavek, který přijde na něj.
Záhlaví podpisu
Záhlaví vaší platformy značí například X-Hub-Signature-256.
Algorimus podpisu
HMAC- SHA1, HMAK- SHAB256 nebo HMAC-SHA512.
Režim podpisu
Jednoduchý, obyčejný hex nebo base64 stravič. Nebo Stripe- styl, t =..., v1 =... formát používaný Stripe a několik platforem, které kopírují.
Předpis podpisu
Volitelné. Některé platformy prefix stravič, například sha256 =. Nechte ji prázdnou, pokud vaše ne.
Mapování událostí
Mapujte každou událost, kterou vaše platforma pošle na OpsIQ událost, která by měla zvýšit.
Automatické registrace webháku
Pokud vaše platforma má API pro správu svých vlastních webháků, nemusíte zaregistrovat URL ručně. Otevřít Automaticky zaregistrovat tento webhook na zapnuto a zaměřte to na dvě z akcí, které jste definovali v kroku 4:
Tvůrce- webhook akce
Volaný, když admin umožňuje připojení. Udáte název parametru, který nese URL, volitelně ten, který má seznam událostí, a cestu v reakci, která drží ID nového webhooku.
Delete- webhook akce
Volá se, když je konektor vypnut, pomocí ID zachycené výše, takže vypnutí konektoru také zastaví platformu odesílání do mrtvého cílového parametru.
Schopnosti, které můžete zapnout
Profily a schopnosti jsou definovány smlouvou o konektoru 2.2. Generované a deklarativní schopnosti jsou vydávány přímo; schopnosti podniku generují EnterpriseExtension.php Lešení s runtime životně dlouhou elektroinstalací.
Akce
Operace AI může spustit na platformě: seznam objednávek, najít zákazníka, vydat náhradu.
Spouštěče
Přijměte webové háčky z vaší platformy a přeměňte je na OpsIQ události.
Vstupenky na AI
AI Triage a odpověď Copilot na tipech, které zůstanou na platformě. Vyberte si koncový bod, který vrátí jeden tip s jeho odpovědi a map pole; OpsIQ čte vlákno přes něj.
Poštovní schránka a kontakty
Zobrazit zákaznickou poštu na jejich časové ose, odeslat z dohody, a synchronizovat adresář do OpsIQ CRM.
Dovoz zákazníka
Stránka projděte seznamem zákazníků a importujte každý z nich jako kontakt OpsIQ. Toto je to, co běží tlačítko Import.
Kontext
Tlačte živá data z vaší platformy do každé konverzace AI.
Identita
Zjisti, který z vašich zákazníků je návštěvník, a ukaž jejich profil a nákupy na jízdence.
Prodej a vyúčtování
Přiřadit příjmy a údaje MRR do dashboardů OpsIQ.
Vstupní vstupenky
Otočit vstupenky a e-maily, které vaše platforma dodává pomocí webhooku do OpsIQ podpůrných závitů.
Odpovědi na odchozí údaje
Post OpsIQ pracovníci odpoví zpět na platformu vlákno pochází.
Uživatelé synchronních programů
Importujte své zaměstnance účty do OpsIQ admin uživatelů.
Synchronizace
Importujte své podpůrné oddělení do OpsIQ.
Zaměření promo a krmivo pro produkty
Ať Promotion Studio zaměřit na fakta víte o osobě, a dělat své skutečné produkty v povýšení.
Poskytovatel studia pro průzkum
Expose server- ověřené Zjišťování skutečnosti, unikl proměnné a ohraničené CRM Overenge příjemce stránky prostřednictvím specializovaného SurveyProvider. php. To není znovu promoční runtime.
Individuální blokování IP
Kdy OpsIQ bloky a IP, zavolejte na své platformě je vlastní blok API Takže blok je tam také vynucen.
Bezpečnostní události
Přijímáme zablokované...IP Výstražné signály od OpsIQ.
Znalosti platformy pro AI
Každý konektor, který postavíte lodě krátký odkaz popisující, co je vaše platforma a co její akce dělat. OpsIQ admin AI čte to, když je váš konektor povolen, takže rozumí vaší platformě spíše než jen vidět seznam jmen akcí. To je generováno pro vás.
Průchod API
Váš konektor vždy dostane všeobecný-účel volání, takže AI může dosáhnout koncového bodu jste nedefinovali zadaný akce pro. Použijte zadané akce, kde můžete; to je únikový poklop.
site_intelligence · Site Intelligence data provider
SEO, analytics, search-console, local-search or monitoring provider with scheduled sync. Capabilities: actions, triggers, site_intelligence, seo, scheduled_workers, durable_queue.
no_api_bridge · Platform with no API (OpsIQ installs a bridge)
For a self-hosted PHP application that serves no callable API. The wizard generates a signed bridge file the operator drops into their own site, plus the typed actions that read and write through it. Capabilities: actions, platform_bridge, ai_brain_aware.
Specifikace stavitelů zůstávají autoritativním zdrojem. Do generovaných rozšiřujících bodů se vloží pravidla pro konkrétní platformu; životní cyklus, fronty, pracovníci, migrace a konformitní testy zůstávají řízeny.
Nastavení spolehlivosti na každé akci
Retrogy
Kolikrát opakovat neúspěšný hovor, s backoff, který zdvojnásobuje každý pokus. Pouze timeouts, 429s a 5xx chyby jsou znovu vyzkoušeny; 4xx je vaše žádost chyba a opakování by jen spálit limit sazby.
Mezní hodnota
Per- minutový strop pro tuto akci, takže rušný spoušť nemůže kladivem platformu. Nechte ji na 0 bez omezení.
Časový limit
Jak dlouho čekat na platformu, než to vzdáš.
Potvrzení
Vyžadujte, aby člověk schválil, než akce začne. Použijte ho pro cokoliv destruktivní.
Typy ověření
Krok 2 nabízí sedm vzorů. Vyberte si ten, který odpovídá platformě API dokumentace, generátor emituje správný HTTP klient pro to.
API klíč v záhlaví
Statický klíč vyslaný jako pevná hlavička, například X-API- Klíč. Dáte název hlavičky a štítek by měl být uveden admin formulář. To odešle klíč pouze jako záhlaví; pokud vaše API místo toho očekává klíč jako parametr dotazu, použijte vlastní hlavičky nebo konektor s plným kódem.
Token nosiče
Token sent as Authorization: Bearer <token>. Common for modern APIs.
Základní auth
Uživatelské jméno a heslo, zakódované do hlavičky Autorizace. Vyberte si štítky, které se zobrazí na admin formuláři.
HMAC- signed
Veřejný klíč plus tajemství, s podepsaným tělem žádosti. Dáváte hlavičku podpisu, hlavičku klíče a časovou značku, kterou vaše platforma očekává.
OAuth 2.0 (pověřovací listiny klienta)
Server- to- server, bez interakce s uživateli a bez přesměrování. Dáváte symboliku URL a volitelný rozsah; admin dodává klientovi ID a tajemství. Použijte jej, když vaše platforma vydává pověření k aplikaci, spíše než k osobě.
OAuth 2.0 (Připojit tlačítko)
Průtok autorizačního kódu s PKCE, pro Stripe, Shopify, Slack a QuickBooks- style aplikace.URL, token URL a rozsah. Po publikování, admin kliknutí Connect na konektoru, autorizuje na platformě, a OpsIQ ukládá refresh token a mints přístup žetony na vyžádání. URI se zaregistrovat ve Vašem OAuth Aplikace je zobrazena na stránce nastavení konektoru.
Vlastní záhlaví
Svobodná forma JSON mapka záhlaví pro cokoliv, co výše uvedené vzory nepokrývají, například {"X -API- Klíč:{api_key}"," X- Tenant ":"{tenant_id}". Každé místo se stane polem na administrátorském formuláři.
💡
PKCE se vztahuje pouze na tok tlačítka Connect- button. Průtok klient- putentations nemá žádný přesměrování a žádný uživatelský krok, takže PKC se na něj nevztahuje.
Styly pro zobrazení
Offset
Používá parametry ofsetu a limitu. Příklad:? ofset =100& limit =50.
Strana
Uses page number. Example: ?page=3&per_page=50.
Kurzor
Používá kurzor z předchozí odpovědi.
Záhlaví odkazu
Používá hlavičku odpovědi Odkaz s rel = "next".
Advanced: vlastní PHP kód
Connector. php RETURNS instance. Neprohlašuje, že pojmenovaná třída, která OpsIQ loví. Názvy metod níže jsou ty, které Connectore Interface vyžaduje; dostat jednu chybu je smrtelné při zatížení, ne varování.
connector. php - skutečná smlouva, minimální a runnable
<?php
/* connectors/myplatform/connector.php */
declare(strict_types=1);
use OpsIQ\Connectors\AbstractConnector;
require_once __DIR__ . '/Client.php';
return new class extends AbstractConnector {
/* ── the three identity methods. NOT identifier()/label(). ── */
public function slug(): string { return 'myplatform'; }
public function name(): string { return 'My Platform'; }
public function description(): string { return 'Orders and customers from My Platform.'; }
public function capabilities(): array { return ['actions', 'context']; }
public function settingsSchema(): array
{
$f = __DIR__ . '/settings.json';
if (!is_file($f)) return [];
$j = json_decode((string)file_get_contents($f), true);
return is_array($j['settings'] ?? null) ? $j['settings'] : [];
}
/* ── NOTE THE ARGUMENT. testConnection() with no parameter is a fatal. ── */
public function testConnection(array $settings): array
{
try {
$resp = \OpsIQ\Connectors\MyPlatform\Client::callWithSettings($settings, 'GET', '/me', [], []);
$code = (int)($resp['http_code'] ?? 0);
return ($code >= 200 && $code < 300)
? ['success' => true, 'info' => ['message' => 'Connection OK', 'http_code' => $code]]
: ['success' => false, 'error' => "Verify endpoint returned HTTP $code"];
} catch (\Throwable $e) {
return ['success' => false, 'error' => 'Test failed: ' . $e->getMessage()];
}
}
public function onEnable(array $settings): array { return ['success' => true]; }
public function onDisable(array $settings): array { return ['success' => true]; }
public function handleWebhook(array $payload, array $headers, array $settings): array
{
return ['success' => true, 'note' => 'No triggers declared.'];
}
/* Inherited from AbstractConnector: reads actions.json for you.
* Override only to ADD actions the manifest cannot express. */
public function registerActions(array $settings): array
{
return parent::registerActions($settings);
}
};
⚠️
Three things that fatal at class load rather than failing gracefully. The identity methods are slug(), name() and description() — not identifier() and label(). testConnection() TAKES an array of settings; a no-argument version is an incompatible signature. And there is no $this->http() or runAction() on AbstractConnector — HTTP goes through your own Client.php or through an action declared in actions.json.
Zrcací lístky do systému vstupenek
Pokud je vaše platforma vlastní jízdenku, zrcadlit ji do OpsIQ z vašeho konektoru pomocí vstupenky nejpozřít pomocník váš konektor zdědí (vytvořit pro nový tip, add- odpověď na follow- up). Emit a přihlásit se k univerzálním událostem tipu ve vašem konektoru subscribers() metoda, ticket.created, ticket.replied, ticket.updated, ticket.deletedAutomatické odpovědi, eskalace, SLA a CSAT všechny hákovat stejné události, takže je dědíte bez dalšího kódu.
Řekni, kdo napsal úvodní zprávu
Lístek je vždy pro zákazník, ale úvodní zpráva může být napsána staff: agent otevírající vstupenku na účet zákazníka, nebo oslovení proaktivně. Každý helpdesk podporuje, takže je součástí univerzální ticket.created kontrakty spíše než něco, co každý konektor řeší soukromě.
author_type
klient (přednastaveno) nebo admin. Vymiť to a zákazník je předpokládán.
author_id
The staff id when author_type=admin. Never the customer id.
author_name
Agent nebo oddělení, jméno na displeji.
author_email
Adresa agenta. Nikdy zákaznický. Zpráva zaměstnance pod e-mailem zákazníka je chyba v hlášení a auditu.
Tohle není kosmetické. Spotřebitelé čtou author_type - Je to pracovní úvod, který je hlášen jako client opustí autoodpověď způsobilá odpovědět na zprávu, kterou napsal váš vlastní agent, a dělá z vaší platformy echo tohoto otevření vypadat jako čerstvé zákaznické zprávy, které pak přistane jako duplikát a přehodí lístek na answered. Mapujte signál platformy na něj v konektoru normalizátor událostíNikdy u spotřebitelů.
Centralizované blokování
Když agent zablokuje odesílatele, to platí napříč every kanál okamžitě (e- mail, chat, portál, widget a každý konektor twin), protože blok je vynucen centrálně, před každým konektorem vidí zprávu. Váš konektor zdědí ji tím, že nedělá nic. Neexistuje žádná vstupní práce k realizaci a žádný způsob, jak to špatně.
Pole volitelné je outbound: když je váš zákazník zablokován zde. Provést jej pouze tehdy, pokud vaše platforma může vyjádřit něco ekvivalentního.
schopnosti ()
Must include block_registry AND the class must implement BlockRegistryInterface. The flag is a claim; the interface is the guarantee. The registry requires both.
Odblokování něčeho, co nikdy nezablokované není chyba.
isSenderBlocked($b)
Pro usmíření, takže drift je hlášena spíše než objeven zákazníkem. Vrací [výsledek, zablokován?].
Hodnoty výsledků
Dobře.
Applied on your platform. Include remote_ref when you have an id worth recording.
noop
Už v požadovaném stavu.
unsupported
Vaše platforma nemá žádný rovnocenný koncept.
selhalo
Mohl jsi to udělat a pokazilo se to.
Pokles je správná odpověď. Mnoho platforem nemá "blokovat tento odesílatel" koncept a nabízejí pouze zavěšení na účet, který zastaví fakturaci, přihlašovací údaje a služby spíše než jen podporu pošty. Mapování "agent zablokoval spam adresu" na "zavřít účet tohoto klienta" by jeden chybným kliknutím blok ukončit službu platícího zákazníka. Pokud je to jediná páka máte, vrátit unsupported a nech to být.
Uvedení do provozu zahrnuje rovněž případ, kdy nástupiště can udělat to, ale nenechá vás. Zkontrolujte, zda API, není funkce: páka, která existuje pouze v platformě admin UI je páka váš konektor nemá.
Pracovní příklad · Zendesk (referenční provedení)
Čtěte connectors/zendesk/connector.php alongside this. It is short, and every branch below is a decision you will face too.
E-mail → ok
PUT /api/v2/users/{id} with suspended=true. A suspended end user's new requests divert to Suspended Tickets instead of opening one, genuinely the same idea as blocking a sender, and it stops no billing because Zendesk end users have none. Returns the user id as remote_ref.
domain → nepodporované
Zendesk může pozastavit celou doménu, ale pouze prostřednictvím pozastavení: klíčové slovo v blocklist centra textarea, a ne API píše, že pole. Funkce existuje, páka nemá.
ip → nepodporované
Žádný blokáda IP neexistuje.
neznámá adresa → noop
Zendesk nemůže předem pozastavit adresu, kterou nikdy neviděl. Nic, co dělat, není selhání, a místní blok stále zastaví jízdenku.
agent nebo admin → nepodporovaný
Odvolaný personál by zablokoval kolegu mimo helpdesk. Adresa personálu dosahující blocklist je mnohem pravděpodobnější, že chyba než instrukce, zkontrolujte roli, než budete jednat na to.
Ta poslední řada je ta, která stojí za kopírování. Smlouva nemůže zastavit mapování bloku na něco destruktivní, takže každý konektor se musí rozhodnout sám o tom, co bude odmítnout. Odmítnutí hlasitě, s detail operátor umí číst, a je lepší než poslouchat.
Hlaste se upřímně. Všimněte si, jak málo z těchto řádků jsou ok. To je správný výsledek, ne mezera: doménový blok stále funguje (je vynucován v jádru okamžiku, kdy je napsán); to prostě nemůže být zrcadlem směrem ven. ok pro něco, co jste neudělali by říct operátor blok dosáhl své platformy, když nikdy opustil OpsIQ.
Pravidla
Místní blok vždy vyhraje.
Je psáno, než budete povoláni a stojí cokoliv vrátíte. Nemůžete zabránit operátor blokování někoho.
Nikdy neházej.
Házení je zacházeno jako nepodporované a zaznamenané. Návrat selhal s detailem místo toho, aby důvod přežil.
Buď idempotentní.
Stejný blok může být vyhlášeno vícekrát.
Rychle se vrať.
Fan- out je synchronní s operátorem kliknutím. Laťka pomalá práce spíše než držení požadavku otevřené.
Nevolej zpátky.
Nikdy se nevracejte do OpsIQ z vašeho handleru. Registr přeskočí původní konektor, ale druhý hop by smyčku.
Každé oznámení je napsáno opsiq_block_registry_log (provoz, druh, hodnota, důvod, admin, původ, konektor slimák, výsledek, detail a časový údaj) tak operátor může vidět blok dorazil z vaší platformy spíše než od agenta, a to, co každý konektor udělal s ním.
Tlačit správně
Ruka a attachments pole pro vytvoření ()/addReply(). Každá položka obsahuje soubor v jednom ze tří tvarů:
content_b64
Základ RAW souboru bytes, použít pro soubory za auth (většina přilétá případů). OpsIQ dekóduje a re- hostí soubor pro vás. Nejpřenosnější tvar.
url / source_url
A public https URL (e.g. a Zendesk content_url). Must be https; passes an SSRF / allowlist check before it is stored.
stored_path
Uložený odkaz na soubor, který jste již napsal (co nativní skladatel uploader produkuje).
Items also accept filename, mime_type and size_bytes. Caps: 12 MB/file, ~24 MB total, 10 files per call. Most platform read APIs return attachment pouze názvy souborů (ne bytes), takže spolehlivý příchozí vzor je: přečtěte si bajty, kde váš kód již běží (uvnitř platformy, nebo z webhook užitečné zatížení), base64 je, a poslat je jako content_b64 na akci.
Odjezd (OpsIQ → vaše platforma). Když agent připojí soubor, ticket.replied payload vám dá soubory odpovědi jako stored_path položky v rámci OpsIQ Sklad souborů. Přečtěte si je a zatlačte ve svém formátu platforma, a zkontrolujte dokumenty platformy, enkódování záležitosti: WHMCS chce base64_encode(json_encode([[name,data]])) (JSON, není serializovat); Zendesk nahrává surové byty na /uploads.json pro symbolické pak soupravy comment.uploads; Gmail posílá vícedílné / smíšené RFC-822 zprávy na základě 64url- kódované raw; Amazon SES inbound attachments need the S3 receive action (the SNS path caps at 150 KB).
Vzdálené platformy: API + webhook, nikdy žádné jiné tabulky aplikace
Pokud je vaše platforma je oddělená aplikace nebo databáze (hostil SaaS, vzdálený WHMCS, jiný DB na stejném serveru), nikdy nepište jeho tabulky přímo: cross- databáze psát přistane na jakékoli spojení je aktivní a tiše chybí skutečné řádky. Vždy: outbound = volejte podepsané FREST API (odpovědi, status, oddělení, smazání); inbound = platforma POST podepsaný webhook, váš handleWebhook() ověřuje to a vypálí odpovídající ticket.* událost. Chcete-li zastavit zrcadlovou smyčku, označte to, co stisknete značkou původu (např. mirror_origin:'opsiq'); platforma echokuje to na webhooku a váš příchozí ovladač přeskočí své vlastní ozvěny. Zkontrolujte OpsIQEvents::isMirroredEvent() na vrcholu každého manipulátoru.
Stav zrcadla, priorita a oddělení
Odpověď automaticky posune stav, agent Odpověď → answered, a zákazník Odpověď → customer_reply; zrcadlit to stejným způsobem. Pro explicitní změny se přihlásit ticket.updated a číst payload['changes'] (např. {status:'closed'}).
Stav: OpsIQ je kanonická sada open, customer_reply, answered, in_progress, pending, closed. Udržet malou dvoucestnou mapu na slovní zásobu vaší platformy, a ujistěte se, že váš sloupec skutečně přijímá hodnoty, které píšete ( ENUM chybějící hodnota se tiše snižuje na prázdné některé databáze). Oddělení: Oddělení OpsIQ je na vaší straně bezvýznamné, Nikdy to neposílej.. Pošlete deskriptor (name, email a slug) a vyřešit to proti svým vlastním oddělením e-mailem → název → slimák, takže "oddělení účtování" přistane v Vaše Oddělení účtování místo obecné. Spustit na obou ticket.escalated a department_id změna ticket.updated.
💡
Status / priority / subject / department / delete mirroring is gated by per-connector toggles (mirror_status_changes, mirror_priority_changes, mirror_subject_changes, mirror_department_changes, mirror_deletes) read through the shared OpsIQ\Connectors\MirrorOptions helper. Embed that block in your settings.json and every ticket-mirror connector reads the toggles identically.
Propojte jízdenku na produkt / službu
Pokud si zákazník zvolil konkrétní produkt při otevírání vstupenky, označte nápovědu, aby agent viděl cílenou servisní kartu (s jedním kliknutím "zobrazit jiné produkty" modal pro zbytek).
related_service_id
Preferred: the service id exactly as it appears in your IdentityProvider::lookupCustomerServices() list (each service's id). Unambiguous match.
related_service_label
Kód platformní služby, např. WHMCS S396 (služba396) / D11 (doména11). OpsIQ rozkládá volitelné písmo typu + id a odpovídá vašemu servisnímu seznamu, s typovou stráží, takže kód domény nikdy neodpovídá produktu stejné ID. Vystavuje odpovídající ref na každé službě pro přesný zápas.
related_domain
Název domény; je porovnáván jako podřetězec s detaily / doménou každé služby.
💡
Vytvořit seznam příloh jednou, ve tvaru výše, a OpsIQ zbytek: hostuje URLs jsou předávány a obsah base64 je uložen a rehostován pro vás. Nikdy nemusíte psát per- platform zpracování souborů.
⚠️
Akční klávesy jsou malá písmena, číslice a podtržení.3do80znaky a také umožňuje tečky; akční obchod přijímá2do100znaky bez bodů, takže držet se písmen, číslic a podtržení a uspokojíte oba. Přidání akce nevytváří žádnou AJAX cestu, takže není nic k regeneraci - re- uložit konektor a je synchronizován.
Konektory
Připojte platformu, která nemá API (mostní vzor)
Spousta reálných nástupišť loď žádný RESTAPIvůbec. Hotel CMS, starý fakturační systém, na míru interní nástroj. Stále můžete napsat kompletníOpsIQkonektor pro jednu: konektor přepravuje jeden soubor PHP, který operátor upustí do svého vlastního veřejného webroot, a tento soubor jeAPI. Tato stránka je celý vzor, s pravidly, která činí bezpečnou běh a důvod za každým pravidlem.
Tvar toho těla.
Normální konektor volá někoho jiného API. Mostový konektor přináší svůj vlastní. Nic jiného se nemění: stejné akce, stejné kontextové poskytovatele, stejná smlouva o identitě, stejné rozložení balíčků.
1
Napíšete jeden soubor s PHP
It lives in your package at bridge/opsiq-<platform>-bridge.php. It talks to the platform's database directly, or boots the platform's framework, or both. It answers JSON.
2
Operátor si to zkopíruje do svého bryndáčku.
Vedle platformy vlastní index. php. Žádný kód platforma není změněn, žádný plugin není nainstalován, nic, co by se mělo udržovat napříč platformami upgrady.
3
Konektor jim předá soubor
Your settings.json declares webhook_help.snippet_template. The connector page renders it as a copyable file with their live settings already substituted, so there is nothing to hand-edit.
4
OpsIQ tomu říká server- to- server
Váš Client.php posílá GET žádosti se sdíleným klíčem v X-OpsiqZákladna Bridge- Key.URLnastavení je kořen místa platformy.
✅
The Connector Builder CAN generate this for you now. Pick the "Platform with no API" profile (or set data access to bridge) and it emits the bridge file, the matching panel snippet and the typed actions that read and write through it — for a Laravel application reading its .env, for WordPress reading wp-config.php, or with credentials you paste in for anything else. Hand-author only when your platform is none of those, or when you need behaviour the generated bridge does not cover. A hand-written bridge is safe from the wizard: it only overwrites a bridge file carrying its own marker.
💡
Everything on this page is shown in PHP against MySQL, because that is the reference implementation and the only combination the packaging pipeline fully supports. The pattern itself is language-agnostic and engine-agnostic: see "The bridge in other languages and other databases" for the gate in Node, Python, Go, Ruby, .NET and Java, the introspection query for PostgreSQL, SQL Server, SQLite and Oracle, and the MongoDB equivalent — along with the packaging constraint that decides how a non-PHP bridge reaches the operator.
Bezpečnostní model a proč je tam každé pravidlo
Tento soubor sedí ve veřejném webroot za jeden sdílený klíč. Tento jediný fakt řídí každé pravidlo níže. Nerelaxujte žádný z nich, aby váš most jednodušší.
Volající nikdy nedodává SQL
Není to klauzule WHERE, není to fragment ORDER BY, není parametr "jen jednou" syrového dotazu. Volající jmenuje tabulku, sloupec a hodnotu; Váš soubor sestaví prohlášení. V okamžiku, kdy volající může přispět SQL text, se jeden sdílený klíč stává libovolným provedením databáze.
Table and column names are validated against information_schema
Identifikátory nelze vázat jako parametry, takže je třeba zkontrolovat místo. Přečtěte si skutečný seznam tabulek a sloupců pro TENTO databázi a odmítnout nic, co na ní není. Identifikátor, který není skutečným objektem tohoto schématu pak nemůže dosáhnout dotazu vůbec - což je to, co dělá bezpečnou odhalit každou tabulku.
Každá hodnota je vázaný parametr
Bez výjimky, včetně hodnot uvnitř vyhledávání. Validované identifikátory plus vázané hodnoty jsou dvojice, která činí povrch celkový a injekční povrch nulový.
Čtení jsou univerzální, psaní jsou přípustná
Tohle je pravidlo, které chtějí lidé přeskočovat.
Tajné sloupce jsou při čtení regovány a odmítnuty při zápisu.
Match on column NAME: password, remember_token, secret, api_key, private_key, salt, token. Replace the value with a placeholder on the way out. Refuse the write entirely on the way in — writing a raw password hash is not an operation, it is a footgun. Send the operator to the platform's own password flow.
Odstranění jsou jednořadá, podle primárního klíče
Nikdy hromadné smazat, nikdy smazat filtrem. Hromadné odstranění je způsob, jak databáze zemře. Pokud někdo opravdu potřebuje jeden, mohou to udělat na platformě.
Čtení jsou zapuštěné
Zasvorkujte limitní parametr s pevným stropem. Únikový dotaz nesmí být schopen vypustit databázi prostřednictvím chatovací zprávy.
Neúspěch uzavřen, dokud není klíč nastaven
Nekonfigurovaný most odpoví na všechno 403. Most, který je užitečný před tím, než je nastaven, je most, který byl užitečný pro cizince.
Konstant- time porovnání klíčů, klíč v záhlaví
hash_equals, never ==. The key goes in X-Opsiq-Bridge-Key, not the query string, so it stays out of access logs, proxy logs and Referer headers.
GET only
Jedna metoda, jeden tvar, nic propašovat v těle. Vše, co most dělá, je vyjádřitelné jako GET s ověřenými parametry, a OpsIQ je jediný volající.
Čte univerzální, píše albouristicke - a proč
Toto je pravidlo, které se argumentuje, takže zde je odůvodnění v plném rozsahu. Asistent by měl být schopen vidět celou platformu: to je to, co dělá to užitečné, a čtení nemůže zničit nic. Písma jsou odlišné. Tento soubor sedí ve veřejném webroot za ONE sdílený klíč. Pokud tento klíč uniká, neomezený plocha zápisu činí únik rovnocenný plné ovládání databáze - nový admin uživatel, prázdný rezervační stůl. Přípustný-seznam znamená, že uniklý klíč stále nemůže dosáhnout tabulky operátor nikdy povoleno.
⚠️
Schvalovací karta OpsIQ bránila AI, není klíčem. Admin kliknutí Povolit na destruktivní akci je kontrola nad asistentem. Není to kontrola nad tím, kdo drží most klíč. To jsou dvě různé hrozby, a povolený seznam je odpověď na druhý.
Oper- směřující knoflík, z Botble mostu
/* ── WRITE ALLOW-LIST — which tables the assistant may CHANGE here.
*
* READS are unrestricted: the assistant can see every table in the platform.
* WRITES are limited to this list, because this file sits in a PUBLIC webroot
* behind ONE shared key — an allow-list means that even a leaked key cannot
* reach a table you never enabled (no new admin users, no emptied bookings).
*
* Comma-separated table names. Add tables as you need them — e.g. append
* ',pages,posts' to let the assistant edit site content. Set it to '*' to
* allow every table, deliberately. Empty falls back to the hotel defaults. ── */
const OPSIQ_WRITE_TABLES = 'ht_bookings,ht_booking_rooms,ht_booking_addresses,ht_rooms,ht_room_types,ht_customers,customers';
Dva podrobnosti v check níže jsou snadno dostat špatně. Název tabulky dorazí již RESOLVED, nese tabulku tabulky prefix, zatímco operátor píše allowed-list nepřednastavený, protože to je to, co by přirozeně typ. Porovnejte obě způsoby nebo předem pevně nainstalovaná instalace tiše umožňuje nic a každé přerušení zápisu. A odmítnutí musí vysvětlit sám, protože osoba čtení je admin v chatu okno, ne vývojář se stopou stopy.
The allow-list check, verbatim from marketplace_connectors/botble/bridge/opsiq-botble-bridge.php
/** Tables a WRITE may touch. Empty = the built-in defaults. */
$writeAllowed = static function (string $table) use ($prefix): bool {
$raw = trim((string)(defined('OPSIQ_WRITE_TABLES') ? OPSIQ_WRITE_TABLES : ''));
if ($raw === '') $raw = 'ht_bookings,ht_booking_rooms,ht_rooms,ht_customers,customers';
if (trim($raw) === '*') return true; // explicit opt-in to everything
$bare = ($prefix !== '' && stripos($table, $prefix) === 0) ? substr($table, strlen($prefix)) : $table;
foreach (explode(',', $raw) as $t) {
$t = trim($t);
if ($t === '') continue;
if (strcasecmp($t, $table) === 0) return true;
if (strcasecmp($t, $bare) === 0) return true;
if ($prefix !== '' && strcasecmp($prefix . $t, $table) === 0) return true;
}
return false;
};
/** One refusal, one explanation — used by every write op. */
$requireWritable = static function (string $table) use ($writeAllowed): void {
if ($writeAllowed($table)) return;
opsiq_bridge_out(['success' => false, 'error' =>
'write_not_allowed: "' . $table . '" is not in this bridge\'s write allow-list. '
. 'Reads are unrestricted. To permit writes here, add the table to OPSIQ_WRITE_TABLES '
. 'in opsiq-botble-bridge.php (or set it to "*" to allow every table).'], 403);
};
Brána, v plném rozsahu
Čtyři kontroly, v tomto pořadí, než se cokoli dotkne dat. Kopírovat objednávky stejně jako kontroly.
Čtyři brány, aby se
<?php
declare(strict_types=1);
/* ── EDIT THIS: a long random secret (40+ chars). Empty = bridge OFF. ── */
const OPSIQ_BRIDGE_KEY = '';
header('Content-Type: application/json; charset=utf-8');
header('Cache-Control: no-store');
function opsiq_bridge_out(array $payload, int $code = 200): void
{
http_response_code($code);
echo json_encode($payload, JSON_UNESCAPED_SLASHES);
exit;
}
/* 1. Fail closed. An unconfigured bridge answers nothing to anyone. */
if (OPSIQ_BRIDGE_KEY === '' || strlen(OPSIQ_BRIDGE_KEY) < 24) {
opsiq_bridge_out(['success' => false, 'error' => 'bridge_not_configured'], 403);
}
/* 2. One method. */
if (strtoupper((string)($_SERVER['REQUEST_METHOD'] ?? '')) !== 'GET') {
opsiq_bridge_out(['success' => false, 'error' => 'method_not_allowed'], 405);
}
/* 3. Constant-time key comparison, key from a header (never the query string). */
$given = (string)($_SERVER['HTTP_X_OPSIQ_BRIDGE_KEY'] ?? '');
if ($given === '' || !hash_equals(OPSIQ_BRIDGE_KEY, $given)) {
opsiq_bridge_out(['success' => false, 'error' => 'forbidden'], 403);
}
/* 4. Only now read credentials and connect. */
Validating identifiers against information_schema
Toto je kus, který otočí "asistent může dosáhnout libovolné tabulky" z bezohledného do bezpečí. Vyřešte jméno volajícího tabulky proti skutečné schéma, tolerovat chybějící nebo navíc tabulka předčíslí, a vrátit nulu pro cokoliv jiného. Vše po proudu pak pracuje s názvem, který prokazatelně existuje.
Ověření a kontrola totožnosti, doslovně z mostu v Botble
/** Real tables in THIS database — the allow-list, straight from the DB. */
$allTables = static function () use ($pdo, $db): array {
static $cache = null;
if ($cache !== null) return $cache;
$st = $pdo->prepare('SELECT TABLE_NAME FROM information_schema.TABLES WHERE TABLE_SCHEMA = ? ORDER BY TABLE_NAME');
$st->execute([$db]);
return $cache = array_map('strval', $st->fetchAll(PDO::FETCH_COLUMN));
};
/** Resolve a caller-supplied table name to a REAL one, or null. */
$resolveTable = static function (string $name) use ($allTables, $prefix): ?string {
$name = trim($name);
if ($name === '' || !preg_match('/^[A-Za-z0-9_]+$/', $name)) return null;
$tables = $allTables();
foreach ($tables as $t) if (strcasecmp($t, $name) === 0) return $t;
/* Tolerate a missing or extra table prefix. */
foreach ($tables as $t) {
if (strcasecmp($t, $prefix . $name) === 0) return $t;
if ($prefix !== '' && strcasecmp($prefix . $t, $name) === 0) return $t;
}
return null;
};
/** Column introspection: table => [column => true]. Cached per request. */
function opsiq_bridge_columns(PDO $pdo, string $db, string $table): array
{
static $cache = [];
if (isset($cache[$table])) return $cache[$table];
$stmt = $pdo->prepare('SELECT COLUMN_NAME FROM information_schema.COLUMNS WHERE TABLE_SCHEMA = ? AND TABLE_NAME = ?');
$stmt->execute([$db, $table]);
$cols = [];
foreach ($stmt->fetchAll(PDO::FETCH_COLUMN) as $c) $cols[strtolower((string)$c)] = true;
return $cache[$table] = $cols;
}
/** Columns whose VALUES must never leave the platform. */
$secretCol = static function (string $c): bool {
return (bool)preg_match('/(^|_)(password|remember_token|secret|api_key|private_key|salt|token)($|_)/i', $c);
};
/** Columns a write may never touch — auth material. */
$writeBanned = static function (string $c): bool {
return (bool)preg_match('/(^|_)(password|remember_token)($|_)/i', $c);
};
/** Strip secret values from a row before it leaves the server. */
$redact = static function (array $row) use ($secretCol): array {
foreach ($row as $k => $v) if ($secretCol((string)$k)) $row[$k] = '[redacted]';
return $row;
};
Čtení a zápis, kompletní
Note what is bound and what is validated. The filter column is checked against the real column list and then interpolated as an identifier; its value is bound. The limit is clamped. Rows are redacted on the way out. The update refuses the primary key and any auth column, and stamps updated_at when the table has one.
case 'query': {
$t = $resolveTable((string)($_GET['table'] ?? ''));
if ($t === null) opsiq_bridge_out(['success' => false, 'error' => 'unknown_table'], 404);
$cols = opsiq_bridge_columns($pdo, $db, $t);
if (!$cols) opsiq_bridge_out(['success' => false, 'error' => 'unknown_table'], 404);
$sql = "SELECT * FROM `$t` WHERE 1=1";
$args = [];
/* Equality filter: column must be REAL, value is bound. */
$wc = strtolower(trim((string)($_GET['where_column'] ?? '')));
if ($wc !== '') {
if (!isset($cols[$wc])) opsiq_bridge_out(['success' => false, 'error' => 'unknown_column: ' . $wc], 400);
$sql .= " AND `$wc` = ?";
$args[] = (string)($_GET['where_value'] ?? '');
}
/* Ordering: column validated, direction from a fixed pair. */
$ob = strtolower(trim((string)($_GET['order_by'] ?? '')));
if ($ob !== '' && isset($cols[$ob])) {
$dir = strtoupper(trim((string)($_GET['order'] ?? 'DESC'))) === 'ASC' ? 'ASC' : 'DESC';
$sql .= " ORDER BY `$ob` $dir";
} elseif (isset($cols['id'])) {
$sql .= " ORDER BY `id` DESC";
}
/* Hard row cap. */
$lim = (int)($_GET['limit'] ?? 25);
if ($lim < 1) $lim = 25;
if ($lim > 200) $lim = 200;
$off = max(0, (int)($_GET['offset'] ?? 0));
$sql .= " LIMIT $lim OFFSET $off";
$st = $pdo->prepare($sql);
$st->execute($args);
$rows = array_map($redact, $st->fetchAll());
opsiq_bridge_out(['success' => true, 'data' => [
'table' => $t, 'returned' => count($rows), 'rows' => $rows,
]]);
}
Napište jeden řádek - povolená tabulka, odmítnuté sloupce auth, jeden řádek primárním klíčem
case 'record.update': {
$t = $resolveTable((string)($_GET['table'] ?? ''));
if ($t === null) opsiq_bridge_out(['success' => false, 'error' => 'unknown_table'], 404);
$requireWritable($t); // the allow-list, before anything else
$cols = opsiq_bridge_columns($pdo, $db, $t);
$pk = $primaryKey($t);
$id = (string)($_GET['id'] ?? '');
if ($id === '') opsiq_bridge_out(['success' => false, 'error' => 'id_required'], 400);
$set = json_decode((string)($_GET['set'] ?? ''), true);
if (!is_array($set) || !$set) opsiq_bridge_out(['success' => false, 'error' => 'set_json_required'], 400);
$frag = []; $args = [];
foreach ($set as $col => $val) {
$col = strtolower(trim((string)$col));
if (!isset($cols[$col])) opsiq_bridge_out(['success' => false, 'error' => 'unknown_column: ' . $col], 400);
if ($writeBanned($col)) opsiq_bridge_out(['success' => false, 'error' => 'refused: "' . $col . '" is auth material - change it through the platform own password flow, never by direct write.'], 400);
if ($col === $pk) opsiq_bridge_out(['success' => false, 'error' => 'refused: the primary key cannot be rewritten.'], 400);
if (is_array($val) || is_object($val)) $val = json_encode($val, JSON_UNESCAPED_SLASHES);
$frag[] = "`$col` = ?";
$args[] = ($val === null) ? null : (string)$val;
}
if (isset($cols['updated_at']) && !isset($set['updated_at'])) $frag[] = '`updated_at` = NOW()';
$before = $pdo->prepare("SELECT * FROM `$t` WHERE `$pk` = ? LIMIT 1");
$before->execute([$id]);
$prev = $before->fetch();
if (!$prev) opsiq_bridge_out(['success' => false, 'error' => 'not_found'], 404);
$args[] = $id;
$up = $pdo->prepare("UPDATE `$t` SET " . implode(', ', $frag) . " WHERE `$pk` = ? LIMIT 1");
$up->execute($args);
opsiq_bridge_out(['success' => true, 'data' => [
'table' => $t, 'id' => $id, 'changed' => $up->rowCount(),
'before' => $redact(array_intersect_key($prev, $set)),
]]);
}
Přežití schémat rozdílů
Verze platformy se liší. Sloupce se pohybují, přejmenovávají, nebo chybí. Most, který předpokládá jedno schéma funguje na jedné instalaci. Zavést a přizpůsobit místo toho: vyberte pouze sloupce, které zde existují, tolerujte tabulku předponu, a zkuste věrohodné hláskování reference.
tolerance Schema, od mostu v Botble
/* Only ever select columns that exist on THIS install. */
$pick = static function (array $cols, array $wanted, string $alias = 'b'): string {
$out = [];
foreach ($wanted as $c) if (isset($cols[$c])) $out[] = "`$alias`.`$c`";
return $out ? implode(', ', $out) : "`$alias`.*";
};
/* References vary: stored with or without a leading "#", with or without an
* operator-configured alpha prefix, or only as a numeric id. Try every
* plausible form — the PROOF match is what actually gates disclosure, so
* tolerant matching here is safe. */
$refCandidates = [$ref, '#' . $ref];
$digitsOnly = preg_replace('/\D+/', '', $ref);
if ($digitsOnly !== '' && $digitsOnly !== $ref) {
$refCandidates[] = $digitsOnly;
$refCandidates[] = '#' . $digitsOnly;
}
$refCandidates = array_values(array_unique($refCandidates));
💡
Dejte svůj most op = diag, který hlásí pouze STRUKTURA - které tabulky vyřešeny, které sloupce hlavní tabulka má, a SHAPE nejnovější odkaz s každou číslicí maskované. Je klíčový jako všechno ostatní, a to otáčí "lookup nenajde nic" z podpůrného tipu do ten- sekunda odpověď. Nikdy nechat vrátit skutečné záznamy.
Jednotné chyby a výčtová past
Jeden tvar pro všechno.
Success is {"success":true,"data":{...}}. Failure is {"success":false,"error":"snake_case_reason"}. Your Client.php and every action then have exactly one response shape to handle.
Nenajdeš a žádný zápas musí být stejný.
Na hledané ploše, odkaz, který neexistuje a odkaz, jehož důkaz nebyl shodný musí produkovat SAME odpověď. Různé odpovědi změní váš most do věštkyně, která potvrzuje, které odkazy jsou skutečné, což je volný zákazníkův-seznam export pro každého pacienta.
Nikdy nedávej důvod návštěvníkovi.
Most může být přesný sOpsIQO tom, co se dostane k návštěvníkovi, rozhodujeOpsIQ, v jednom pevném odmítnutí.
Přípustný soubor v panelu konektoru
Operátor nikdy neotvírá úložiště. Otevírají panel konektoru vOpsIQa stiskněte kopírování. Tato kopie pochází z nastavení.json, a musí to být stejný program jako most / * .php.
settings.json - vstup do panelu pro mostní konektor
{
"settings": [
{ "key": "base_url", "label": "API base URL", "type": "text", "required": true },
{ "key": "api_key", "label": "Bridge key", "type": "password", "required": true,
"autogenerate": true,
"help": "Auto-generated the moment you enable the connector. It must match OPSIQ_BRIDGE_KEY inside the bridge file; the copyable file below already carries this value once saved." }
],
"webhook_help": {
"title": "One file, three surfaces",
"body": "This platform has no public REST API, so this ONE file IS the API. Copy it into the site PUBLIC webroot, keeping the filename.",
"snippet_filename": "opsiq-yourplatform-bridge.php (drop next to the site index.php)",
"snippet_template": "<?php\n/* ... the whole bridge file ... */\nconst OPSIQ_BRIDGE_KEY = \u0027{{setting:api_key}}\u0027;\n..."
}
}
{{setting:key}} carries live values
The connector panel substitutes {{setting:<key>}} in the snippet with that connector's saved value, so the copied file already contains the operator's generated bridge key and needs no hand-edit. An empty or unsaved setting leaves the token visible, so the operator can see exactly what is still missing.
Ostatní stojany jsou nahrazeny serverside
Nezávisle na tom,{webhook_url}, {webhook_path}, {webhook_secret}, {site_key}, {base_url}a{slug}jsou vyplněny předtím, než panel vůbec uvidí odstřižek.
webhook_help may be one object or a list
Seznam vám v jednom panelu poskytne několik úlomků, např. soubor s mostem a samostatný relé hák.
🚫
Neudržujte útržek ručně. Soubor mostu a kopie obrazu jsou dvě kopie jednoho programu, a WILL drift - most byl aktualizován a jeho výtisk panel nebyl, takže každý, kdo reinstaloval a kopíroval z panelu nainstaloval starý most a tiše ztratil všechny nové schopnosti. Nic ho zjistilo: shoda prošel, podpisy prošel, testy prošly.
Udržet obě kopie stejné
# Regenerate every package's panel snippet from its bridge file
php tools/sync_connector_bridge_snippets.php --apply
# Show what would change, without writing
php tools/sync_connector_bridge_snippets.php
Drift is now a failing conformance check, not a support ticket: the verifier compares the two line by line (ignoring the {{setting:...}} placeholders, which are supposed to differ) and names the first line that differs. Run the sync tool as the last step before every release, right before signing.
Co by měl most odhalit
Tvarované operace a univerzální datový povrch, společně. Tvarové vrátí čisté, účelové-postavené odpovědi na otázky lidé skutečně klást; univerzální ty pokrývají všechno ostatní, takže asistent nikdy není zaseknutý.
Tvarované čtecí nástroje
statistiky, hlavní seznam objektů s filtry, jeden objekt s jeho související řádky, katalog toho, co se prodává, vyhledávání zákazníků s historií. Ty dávají AI dobrou odpověď v jednom volání místo pěti.
Tvarované texty
Dvě nebo tři změny stavu, na kterých záleží - stav nastavení, zrušit. Udržet přijaté hodnoty povoleny.
Univerzální objev
tabulky (s počtem řádků) a popište (sloupce, typy, primární klíč, plus čitelné a zapisovatelné vlajky na sloupec). Takto se asistent učí platformu, kterou jste nečekali.
Univerzální čtení a zápis
dotaz, recorde. get, record. create, reg. update, Record. delet. Každý z nich ověřený, jak je uvedeno výše.
Identita, před klíčovou branou
Identity sondy jsou nazývány ADMIN 'S Browser, same- původ, takže nemohou poslat vlastní hlavičku. Jejich autentizace je platforma session sám. Dejte jim před klíčové brány, držet je mimo všechny záznamy dat, a nikdy je nechat vrátit tajemství. Viz konektor identity stránky.
Diagnostika
op=diag, structure only, masked.
💡
Pouze pro čtení konektor nepotřebuje žádný povolený seznam. Pokud vaše platforma vždy jen odpoví na otázky, loď most bez psaní ops a celá třída psaní rizika zmizí. Přidat píše, když se někdo ptá na ně.
Kontrolní seznam před odesláním mostu
Most odmítá všechno bez klíčů.
Přejmenovat konstantu na vyprázdnit a potvrdit každou operaci odpovědi 403.
V neustálém čase je odmítnut chybný klíč
hash_equals, and the key read from the header only.
Název stolu je odmítnut
A pravé jméno stolu se špatnou předponou stále řeší.
Ve čtení se nikdy neobjeví sloupec hesla
A napsat, že jména jeden je odmítnut s vysvětlením.
Zapsat do tabulky mimo povolený seznam je zamítnuto
Se zprávou, která říká operátorovi, jak ji rozšířit.
Snippet obrazu odpovídá souboru mostu.
php tools/sync_connector_bridge_snippets.php reports it in step.
Přeinstalování konektoru nestačí
Pokud je váš balíček přepravován mostní soubor, provozovatel modernizuje konektor musí také přesunout tento soubor do jejich webroot. Řekni to v panelu tělo a ve vašem CHANGELOG, každé vydání.
Konektory
Most v jiných jazycích a dalších databázích
The bridge pattern is not a PHP pattern. What OpsIQ calls is an HTTP endpoint, so the file can be Node, Python, Go, Ruby, .NET or Java, and the store behind it can be any SQL engine or MongoDB. What IS PHP-shaped is the packaging pipeline, and that constraint decides how your bridge reaches the operator. Read the delivery section first: it is the part that surprises people.
Co konektor vlastně vyžaduje
Tohle je celá smlouva, nic v ní neoznačuje jazyk.
Doprava
HTTPS. Jeden požadavek na volání, žádné tělo, žádná jiná metoda.
Ověření
Sdílené tajemství v X-Opsiq-Bridge-Key Vyžádat hlavičku, ve srovnání s konstantním časem. Není parametr dotazu, není cookie, není Základní auth.
Parametry
Dotazy. op pojmenuje povrch, do pojmenuje operaci, zbytek jsou argumenty této operace.
Odpověď
JSON. {"success":true,"data":{...}} nebo {"success":false,"error":"snake_case_reason"}. Content- Type application / json, a bez cachingu.
Kódy stavu
200Úspěch.403nenakonfigurovaný nebo špatný klíč,404nenalezen,405chybná metoda,400špatný argument,501nepodporované na tomto schématu.
To je vše.
Žádný rámec, žádný runtime, žádná OpsIQ knihovna na vaší straně. Pokud to může sloužit, že, může to být most.
Dodávka: co může žít v mostu /, a co nesmí
Podepsaný balíček pokrývá pevný seznam rozšíření souborů a soubor mimo tento seznam je vynechán mimo ZIP. Přemostění v jazyce, který proto nemůže být dodáván uvnitř balíčku - ale již na vás nemůže dále mizet.26Srpen2026soubor v bridge/ že packager klesne je těžké konformity selhání, takže balíček odmítá projít spíše než instalaci bez mostu v něm.
Jak se s mostem / složkou zachází v době sestavení
bridge/bridge.php -> SHIPPED, and drift-checked against the panel snippet
bridge/server.js -> SHIPPED, and drift-checked against the panel snippet
bridge/bridge.py -> REFUSED at conformance: "Bridge files are packaged" FAILS
bridge/bridge.rb -> REFUSED at conformance
bridge/main.go -> REFUSED at conformance
bridge/Bridge.cs -> REFUSED at conformance
bridge/Bridge.java -> REFUSED at conformance
PHP a JavaScript - plně podporováno
Soubor lodě v podepsaném ZIP, a snippet ověřovatel drží svůj panel kopie byte- identický s ním, podle toho, co z nich je. Kontrola drift čte každý soubor v mostu /, nejen ty PHP, takže upgrade most se stable panel kopie selže budovat v obou jazycích.
Vše ostatní - doručit pouze přes panel
The panel snippet is plain text with no idea what language it holds, so it works for any stack. Put the whole program in webhook_help.snippet_template, name the file in snippet_filename, and do NOT leave a copy in bridge/ — conformance will refuse the package rather than ship it hollow. Say plainly in webhook_help.body that the operator copies this file rather than getting it from the package.
Pokud skutečně potřebujete jiný jazyk v balíčku
Widen PackageSigner::EXTENSIONS deliberately, then re-sign and re-seed. That is a decision about what executable code Nabtech distributes, so make it on purpose — do not discover it from a missing file.
💡
Název souboru v webhook_help.snippet_filename kdykoli váš balíček přepravuje více než jeden most. Tak ověřovatel ví, který most kopie panelu patří k; bez něj, je nejednoznačné párování hlášeny jako varování o shodě a že útržek je ponechán nekontrolován.
⚠️
Bod kontroly driftu je, že soubor s mostem a jeho kopie obrazu jsou dvě kopie jednoho programu a WON diverge. Regenerovat spíše než hand- editovat: php tools/sync_connector_bridge_snippets.php --applya pak to přepodepište.
Brána, v šesti jazycích
Stejné čtyři kontroly v tomtéž pořadí všude: selhání uzavřena bez klíče, jedna metoda, konstantní-time klíč porovnání z hlavičky, pak připojit. Jediná skutečná past je srovnání, a to je jiná past v každém jazyce.
⚠️
Porovnej SHA...256trávení dvou klíčů, spíše než samotné klíče. Je to správné v každém jazyce, a to odkrývá skutečnost, že několik konstantních-time komparátory buď hodit nebo netěsnost na délku - Node je načasování SafeEqual vyvolává RangeError, když buffers liší délky, což změní špatný klíč do500místo403.
# Python — Flask
import hashlib, hmac, os
from flask import Flask, request, jsonify
app = Flask(__name__)
BRIDGE_KEY = os.environ.get("OPSIQ_BRIDGE_KEY", "") # empty = bridge OFF
def same_key(a: str, b: str) -> bool:
return hmac.compare_digest(
hashlib.sha256(a.encode()).digest(),
hashlib.sha256(b.encode()).digest(),
)
def out(payload, code=200):
resp = jsonify(payload)
resp.status_code = code
resp.headers["Cache-Control"] = "no-store"
return resp
@app.before_request
def gate():
if len(BRIDGE_KEY) < 24:
return out({"success": False, "error": "bridge_not_configured"}, 403)
if request.method != "GET":
return out({"success": False, "error": "method_not_allowed"}, 405)
given = request.headers.get("X-Opsiq-Bridge-Key", "")
if not given or not same_key(BRIDGE_KEY, given):
return out({"success": False, "error": "forbidden"}, 403)
Go, Ruby, . NET a Java - stejné srovnání
// Go
func sameKey(a, b string) bool {
ha := sha256.Sum256([]byte(a))
hb := sha256.Sum256([]byte(b))
return subtle.ConstantTimeCompare(ha[:], hb[:]) == 1
}
func gate(next http.HandlerFunc) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "application/json; charset=utf-8")
w.Header().Set("Cache-Control", "no-store")
key := os.Getenv("OPSIQ_BRIDGE_KEY")
if len(key) < 24 { out(w, 403, "bridge_not_configured"); return }
if r.Method != http.MethodGet { out(w, 405, "method_not_allowed"); return }
given := r.Header.Get("X-Opsiq-Bridge-Key")
if given == "" || !sameKey(key, given) { out(w, 403, "forbidden"); return }
next(w, r)
}
}
// Ruby
def same_key?(a, b)
OpenSSL.secure_compare(Digest::SHA256.digest(a.to_s), Digest::SHA256.digest(b.to_s))
end
// C# / .NET
static bool SameKey(string a, string b) =>
CryptographicOperations.FixedTimeEquals(
SHA256.HashData(Encoding.UTF8.GetBytes(a)),
SHA256.HashData(Encoding.UTF8.GetBytes(b)));
// Java
static boolean sameKey(String a, String b) throws Exception {
MessageDigest d = MessageDigest.getInstance("SHA-256");
return MessageDigest.isEqual(d.digest(a.getBytes(UTF_8)), d.digest(b.getBytes(UTF_8)));
}
Ověření identifikátorů na každém databázovém motoru
Bezpečnostní vlastnost se nemění: tabulka nebo název sloupce, který volající dodal, musí být zkontrolován na reálné schéma před interpolací a každá hodnota musí být vázaný parametr. Pouze introspekční dotaz, citační znak a paging doložka se liší.
MySQLaMariaDB
Tabulky: SELECT TABLE_NAME FROM information_schema.TABLES WHERE TABLE_SCHEMA = ?. Sloupce: stejné proti information_schema.COLUMNS s AND TABLE_NAME = ?. Citace se zádama, zdvojnásobení jakékoli backtick uvnitř. Strana s LIMIT n OFFSET m.
PostgreSQL
Same information_schema views, lower-case names, WHERE table_schema = $1 (obvykle) public). Citovat s dvojitými citáty, zdvojnásobení jakékoli dvojité citace uvnitř. Strana s LIMIT n OFFSET m. Podívejte se na pravidlo skládání: necitovaný identifikátor je složen do nižší případ, takže porovnat case- bezcitný, když jste vyřešit jméno.
SQL Server
Same INFORMATION_SCHEMA views. Quote with square brackets, doubling any closing bracket inside. Paging needs an ORDER BY: ORDER BY [id] DESC OFFSET @o ROWS FETCH NEXT @n ROWS ONLY.
SQLite
Tabulky: SELECT name FROM sqlite_master WHERE type = 'table' AND name NOT LIKE 'sqlite_%'. Sloupce: SELECT name FROM pragma_table_info(?) - použít tuto tabulkovou formu, protože holá PRAGMA table_info(x) Výpověď nemůže mít vázaný parametr a vyzvání interpolace řetězce je přesně díra, kterou se snažíte uzavřít. Citace s dvojitými uvozovkami. LIMIT n OFFSET m.
Oracle
Tabulky: SELECT TABLE_NAME FROM ALL_TABLES WHERE OWNER = :owner; sloupce od ALL_TAB_COLUMNS. Citovat s dvojitými citáty, a pamatujte na necitovaný identifikátor se předává do UPPER případu, opak PostgreSQL. Stránka s OFFSET :o ROWS FETCH NEXT :n ROWS ONLY na 12c a později.
MongoDB
Žádný SQL, takže žádná interpolace identifikátorů a žádné vázané parametry - jiná disciplína pro stejný cíl. Viz níže.
Introspekční dotaz na motor
-- MySQL / MariaDB
SELECT TABLE_NAME FROM information_schema.TABLES WHERE TABLE_SCHEMA = ?;
SELECT COLUMN_NAME FROM information_schema.COLUMNS WHERE TABLE_SCHEMA = ? AND TABLE_NAME = ?;
-- PostgreSQL
SELECT table_name FROM information_schema.tables WHERE table_schema = $1;
SELECT column_name FROM information_schema.columns WHERE table_schema = $1 AND table_name = $2;
-- SQL Server
SELECT TABLE_NAME FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = @schema;
SELECT COLUMN_NAME FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA = @schema AND TABLE_NAME = @table;
-- SQLite
SELECT name FROM sqlite_master WHERE type = 'table' AND name NOT LIKE 'sqlite_%';
SELECT name FROM pragma_table_info(?);
-- Oracle
SELECT TABLE_NAME FROM ALL_TABLES WHERE OWNER = :owner;
SELECT COLUMN_NAME FROM ALL_TAB_COLUMNS WHERE OWNER = :owner AND TABLE_NAME = :tbl;
💡
Řešení, pak použít RESOLVED jméno. Nikdy projít hláskování volajícího přes do dotazu i po kontrole - podívejte se na skutečné jméno v seznamu čtete ze schématu a interpolovat, že. To nic nestojí a zavírá mezeru mezi "toto jméno odpovídá něco" a "to je jméno jsem asi spustit".
MongoDB: stejná pravidla, bezSQL
Není žádný řetězec otázek, do kterého by se vpíchl, takže lidé předpokládají, že není co střežit. Je zde: dokument filtru. Předávání volajícího dodávaného JSON přímo do find() nechá volajícího poslat {"$ne": null} nebo {"$gt": ""} kde jste očekávali hodnotu, a tiše vybrat každý dokument. Vytvořit filtr sám.
MongoDB - seznam výběrových možností, skalarně vynucený filtr, projekce jako reakční
// Node + the official driver
const names = (await db.listCollections({}, { nameOnly: true }).toArray()).map(c => c.name);
function resolveCollection(given) {
if (!/^[A-Za-z0-9_.-]+$/.test(given || "")) return null;
return names.find(n => n.toLowerCase() === String(given).toLowerCase()) || null;
}
const coll = resolveCollection(q.collection);
if (!coll) return out(res, { success: false, error: "unknown_collection" }, 404);
// Build the filter from a validated field and a SCALAR value. Never spread
// caller JSON into it: {"$ne":null} would match every document.
const filter = {};
if (q.where_field) {
if (!/^[A-Za-z0-9_.]+$/.test(q.where_field))
return out(res, { success: false, error: "unknown_field: " + q.where_field }, 400);
filter[q.where_field] = String(q.where_value ?? ""); // String() is the guard
}
// Projection is the redaction allow-list: drop secrets, never return them.
const projection = { password: 0, remember_token: 0, api_key: 0, secret: 0, token: 0 };
const limit = Math.min(Math.max(parseInt(q.limit ?? "25", 10) || 25, 1), 200);
const rows = await db.collection(coll)
.find(filter, { projection })
.limit(limit)
.skip(Math.max(0, parseInt(q.offset ?? "0", 10) || 0))
.toArray();
Názvy sbírek pocházejí z listSběrnic
That is your information_schema. Resolve the caller's spelling against it and use the resolved name.
Vytlačte každou hodnotu filtru na skalár
Řetězec () nebo číslo () kolem je celá obrana proti vstřikování operátora. Dokument, kde jste očekávali hodnotu, je ekvivalent NoSQL zatoulané citace.
Projekce je pravidlo o reakci
Vyjměte pole ve tvaru sekretu v projekci, aby nikdy neopustili server, než je poté smažou z výsledku.
Deletes stay single-document by _id
deleteOne with a resolved _id. Never deleteMany, and never a filter the caller influenced.
Písma zůstávají povolená
Stejné odůvodnění jako SQL: pojmenovat sbírky, které se mohou dotýkat zápisu, a odmítnout zbytek s vysvětlením.
Konečný ukazatel identity v jiných jazycích
Sonda identity je druhá polovina mostu, a to je HTTP také. Podpisový blok je identický ve všech jazycích: base64url užitečné zatížení,HMAC- SHA256, spoj se s tečkou.
✅
Nepište to ručně. Nastavení, Portál podpory již nese připravený katalog pro PHP, Laravel,WordPress, WHMCS, Uzel s závislostmi a bez závislostí, Flask a FastaPI, Django, .NET, Ruby on Rails, Java Spring Boot and Go. Vezměte signer z chuti, která odpovídá vašeho zásobníku.
Co změnit, když ji znovu použijete
Those snippets mint a PORTAL handoff token, which is deliberately stricter: it carries jti and single_use:true and lives about 120 seconds because it travels in a URL. A bridge or widget identity token carries neither of those and uses a longer exp, minutes to hours.
Co zůstane stejné
site_key, iat, exp and a top-level authenticated:true, plus an admin or customer subject with an id and a username or email. Same claims, same signature, same secret.
Oba symbolické tvary ověřují
Třídílný JWT podepsal HS256 práce, a stejně tak dvoudílné base64url užitečné zatížení plus hex HMAC, které referenční verze PHP emituje. Použijte podle toho, co vaše knihovny jazyka je přirozené - JWTknihovna je obvykle kratší cesta mimo PHP.
Nikdy to nemávněte v prohlížeči
Pravda v každém jazyce. Podepisování klient- side znamená, že předává tajemství stránky každému návštěvníkovi.
- Vážně si vybírám.
Platforma je PHP
Napište most v PHP. To se přepravuje v balíčku, je drift- checked, a to může spustit platformu vlastní rámec číst živé relace pro identitu sondy. Nic jiného vám všechny tři.
Platforma je Node
Mostové lodě, značky a je drift- kontrolována přesně jako PHP. Nic se nevzdá.
Platforma je Python, Ruby, Go, . NET nebo Java
Doručte přes panel snippet a řekněte to v panelu tělo; nenechávejte soubor v mostu /, kde shoda bude odmítnout balíček. Konektor je jinak zcela normální: akce, kontextové poskytovatele, identity a vyhledávání hostů všechny fungují stejně, protože žádný z nich nezajímá, co odpověď HTTP volání.
Nemůžete spustit proces na platformě hostitele
Pak je vzor mostu není ten správný nástroj. Most existuje pro dosažení platformy zevnitř svého hostitele. Pokud se k němu dostanete jen zvenčí, píšete obyčejný API konektor proti čemukoli povrchu, který vystavuje.
⚠️
One more constraint worth planning around: an identity probe has to read the platform's login session, which usually means running inside the platform's own process or at least on its host with access to its session store. A bridge written in a different language from the platform can serve data comfortably and may still struggle to answer op=admin_identity. If that is your case, ship the data bridge in your language and the identity probe in the platform's.
Konektory
Dejte asistentovi obě poloviny: akce a kontext
To je jediná nejčastější věc chybí z konektoru, který "funguje, ale je k ničemu". Akce nechat AI DO věci. Kontextové sekce nechat vědět věci. Spojovací prvky potřebují jak, a většina otázek admin klade jsou zodpovězeny kontextem, nikdy akce. Konektor s dokonalými akcemi a žádný kontext poskytovatele bude pravdivě hlásit, že nemůže vidět nic.
Dvě poloviny.
Akce - jak AI dělá věci
Vyhlášen v akci.jsonnebo vrácen registerActions (). Model si vybere jeden, vyplní své parametry, aOpsIQprovádí ji. Akce jsou pro slovesa: zrušit tuto rezervaci, otevřít tiket, změnit tento stav.
Kontextové sekce - jak AI ví věci
Sestaven ContextProvider před spuštěním modelu. "Kolik objednávek tento měsíc," "kteří jsou mými nejnovějšími zákazníky,", "co budeme prodávat" vše vyřešit prostřednictvím kontext vyhledávání, a nikdy se dotknout akce vůbec.
⚠️
Symptom chybějícího poskytovatele: asistent odpoví "Žádný zapnutý konektor dodal tuto kontextovou část", zatímco je konektor nainstalován, povolen a prochází jeho připojením testu. Nic není zaznamenáno, nic se nechybuje. Tato zpráva znamená, že žádný poskytovatel si sekci nárokoval.
Univerzální slovník sekce
OpsIQ žádá o sekce podle generického názvu. Vaším úkolem je rozhodnout, co každý z nich znamená na platformě a odpovědět na něj. Hotel rezervace je objednávka hotelu; pokoj je to, co hotel prodává. Mapa, nevymýšlejte.
orders / pending_orders
Whatever a transaction is on your platform: orders, bookings, reservations, jobs, shipments. pending_orders is the same list filtered to the unfinished ones.
klienti
Seznam zákazníků.
products
Co platforma prodává: produkty, pokoje, plány, služby.
vyúčtování
Příjmy a peněžní částky ve tvaru součtu podle státu.
vstupenky, služby, domény, servery, činnost
Používejte je, když je vaše platforma skutečně má. Nevynucujte mapování - nezodpovězená sekce je lepší než špatná.
Cokoliv jiného, co vaše platforma má
Vyhlaste si vlastní. Poskytovatel, který prohlašuje sekce (): ['licence', 'zásilky'] má ty sloučené do seznamu univerzálních vyhledávacích možností, takže platform- specifické vyhledávání se stává k dispozici bez zásadních změn.
Chyba, která stojí den.
Provider kontextu musí implementovat rozhraní. Typ registru ho kontroluje, takže je přeskočena třída, která pouze hledá pravdu - bez chyby, kdekoliv.
ContextProvider. php - smlouva z referenční balíku Bmble
use OpsIQ\Platform\ContextProviderInterface;
/* MUST implement ContextProviderInterface: ContextRegistry::collectAll()
* type-checks it, so a provider that merely LOOKS right is skipped and every
* section answers "No enabled connector supplied this context section" — the
* exact symptom, with no error anywhere. */
final class ContextProvider implements ContextProviderInterface
{
public function slug(): string { return 'yourplatform_context'; }
public function label(): string { return 'Your Platform (orders, customers, products)'; }
public function priority(): int { return 30; } // lower renders earlier
/** ADMIN only. The guest surface has its own provider and its own rules. */
public function surfaces(): array { return ['admin']; }
/** The universal section names this connector can answer. */
public function sections(): array
{
return ['orders', 'pending_orders', 'clients', 'products', 'billing'];
}
public function isAvailable(): bool
{
try {
$s = \OpsIQ\Connectors\ConnectorRegistry::getSettings('yourplatform') ?: [];
return trim((string)($s['base_url'] ?? '')) !== '' && trim((string)($s['api_key'] ?? '')) !== '';
} catch (\Throwable $e) {
return false;
}
}
public function build(array $ctx): string
{
$section = strtolower(trim((string)($ctx['section'] ?? '')));
$limit = max(3, min(50, (int)($ctx['limit'] ?? 20)));
$query = trim((string)($ctx['query'] ?? ''));
try {
switch ($section) {
case 'orders':
case 'pending_orders': return $this->orders($limit, $query, $section === 'pending_orders');
case 'clients': return $this->customers($limit, $query);
case 'products': return $this->products($limit);
case 'billing': return $this->billing();
}
} catch (\Throwable $e) {
return ''; // a provider must NEVER break prompt assembly
}
return '';
}
}
Zaregistrujte to z konektoru
Provést ContextConnectorInterface a vrátit své poskytovatele z contextProviders (). Třída konektoru může také implementovat ContextsProvider Interface přímo a být registrován jako sám.
Vrátit prostý text, ne JSON
build () vrací textový blok, který je koncentován do tlačítka. Napište to pro čtenáře: nadpis, pak jeden řádek za řadu.
"Vrať se" místo házení
Zachyťte si vlastní výjimky. Poskytovatel, který hází je přihlášen a přeskočil, ale vrací "je smlouva.
Stavitel pro vás nemůže psát sekce ()
Vygenerované sekce ContextProvider. php (): pole {return [];} a průvodce pro něj nemá žádné pole. Vyplňte jej ručně - a pamatujte, že znovu publikování z souboru průvodce OVERWRITES. Kopírujte si své edity jako první.
⚠️
Uveďte skutečný TOTAL, ne počet řádků, které jste zaslali. Stránka není celkem. Poskytovatel, který uvádí dvacet řad, aniž by řekl, tak dostane asistent důvěrně odpověď "máte20rezervace "pokud platforma drží669. Jeden levný COUNT a jeden explicitní řádek - "CELKEM v souboru:669(tento seznam ukazuje nejnovější20pouze) "- je celá oprava, a sebevědomě nesprávné počet je horší než žádný počet.
Blok sekce, který nelze přepočítat
$lines = ['YOUR PLATFORM — ORDERS (live, newest first)'];
$lines[] = 'TOTAL orders on file: ' . (int)$total
. ' (this list shows the newest ' . count($rows) . ' only — never count these rows to answer "how many")'
. ' | by status: ' . $byStatus;
foreach ($rows as $r) {
$lines[] = '#' . (int)$r['id'] . ' ' . $r['reference'] . ' | ' . $r['status']
. ' | amount ' . $r['amount'] . ' | ' . substr((string)$r['created_at'], 0, 16);
}
$lines[] = 'Use yourplatform_get_order (order_id) for the full record.';
return implode("\n", $lines);
Jmenujte své akce, aby OpsIQ může rozpoznat čtení z písma
OpsIQ classifies an action by the WORDS in its action_id, and it is deliberately conservative: anything it cannot recognise is treated as a write and demands an approval card. Get the verb right and a read just runs.
1
is_destructive or requires_confirmation wins
Pokud je nastaveno jedno nebo druhé, akce vždy potřebuje souhlas. Vyhlaste je upřímně - to je to, co se nachází na admin schvalovací karty.
Nerozpoznané znamená, že je vyžadováno schválení. Tento výchozí hodnota je úmyslný.
⚠️
Write words are checked BEFORE read words, so a mixed name like get_and_sync_orders is classified as a WRITE. Pick one verb, put it first, and keep it clean: list_orders, get_customer, search_bookings, cancel_booking, set_order_status.
Only declare native_api if the platform really has one
The native_api capability registers a generic <slug>_api_call passthrough so the model can reach endpoints your typed actions do not cover. On a platform with no API it is worse than useless: the model keeps reaching for a tool that cannot succeed, instead of using the tools that can.
The Builder decides it from your data-access answer
Say the platform has an API and it declares native_api and emits the passthrough. Say it has none (bridge mode, or the "Platform with no API" profile) and it declares platform_bridge instead and strips native_api, so the two can never both be true. You no longer hand-edit this.
Hand-authored packages must still get it right
If you are writing the manifest yourself, declare exactly one of native_api or platform_bridge. Conformance treats platform_bridge as the escape hatch a bridge connector is expected to have, and the Builder refuses a spec that claims platform_bridge on an API connector.
Keep ai_api_reference.md honest either way
On a connector that declares native_api the admin brain heads that file with a line naming <slug>_api_call. Without native_api it is headed neutrally instead, so a bridge connector no longer advertises a tool it does not have. Describe your real surface — for a bridge, that is your op and do vocabulary, not a REST endpoint table.
Naučte se admin mozek o své platformě
Declare ai_brain_aware and ship two Markdown files. They are read from the INSTALLED package directory (opsiq/connectors/<slug>/) for ENABLED connectors only, and injected into the admin agent's system prompt.
ai_expertise_admin.md
Co je tato platforma je, jak jsou její data tvarována, jak se jí říká objekty a co by jinak asistenta uhodla. Napište to pro kompetentního kolegu, který nikdy tuto platformu neviděl.
ai_api_reference.md
Volitelný povrch. Pro můstkový konektor je to vaše operace a dělat slovní zásobu s jejich parametry, ne Rest koncový stůl.
Rozpočet
Zhruba6,000znaky uchovávané na jednom konektoru a asi24,000znaky pro celý blok přes každý zapnutý konektor. Přes per- konektorový uzávěr je váš soubor zkrácen; být stručný před tím, než je redukátor.
Přesné platby
Tyto soubory jsou rozdíl mezi asistentem, který používá vaše univerzální stolní nástroje a odpovídá ze špatné sekce, protože nic mu nikdy neřekl, že tyto nástroje existují.
💡
Oba soubory musí být v balíčku INSTALLED, nejen váš zdrojový strom. Jsou to běžné balíkové soubory, takže jsou zahrnuty do podpisu a odeslány v ZIP - což také znamená jednu editaci po podpisu prolomí pečeť.
Konektory
Identita přes konektor: admin, zákazník, portál
Jeden podpis smlouvy slouží tři povrchy. Konektor je úkolem je, aby se "kdo je přihlášen na platformě" na podepsaný tokenOpsIQmůže ověřit, a pak předložit ověřený subjekt vOpsIQKontejner nikdy nikoho neověřuje - platforma ano, a podpis nese toto tvrzení.
Tři povrchy, jeden znalec
Admin - váš personál, uvnitř vašeho pozadí
Admin subjekt. Widget zatížení uvnitř platformy admin panel a každý zaměstnanec je zapsán do svého vlastního OpsIQ agenta. Plný průchod na stránce admin widget.
Zákazník - znakový zákazník, v pokecu s klientem
Zákaznický subjekt. To je to, co umožňuje logged- in zákazník získat svůj celý účet místo anonymní vyhledávání: každá objednávka, úplné detaily, a jakékoli self-servis akci, kterou povolíte.
Portál - hluboké spojení do portálu podpory
The same claims plus jti and single_use, with a 120-second life, because the token travels in a URL and must be spendable once. Do not hand-roll this one: Settings, Support Portal carries a ready snippet per language, and the platform mints it for you when the account area runs on this server.
Smlouva o užitečném nákladu
Toto jsou tvrzení ověřovatele, které nejsou volitelná, ať už by to naznačoval nějaký jiný dílčí příklad.
site_key
Nejvyšší úroveň. Musí se rovnat klávesy stránky požadavku, nebo je token zamítnut.
iat a exp
Nejvyšší úroveň, unix sekundy. exp musí být v budoucnosti a po iat. Token více než asi minutu v budoucnosti je odmítnut. Udržujte život krátký - minut až hodiny.
ověřeno: pravda
Nejvyšší úroveň, vedle exp. Vaše platforma tvrdí, že skutečný člověk je přihlášeni.
plošina
Nejvyšší úroveň. Krátká slimák pojmenování původu. Doporučeno, a to umožňuje konektor je poskytovatele identity říct své vlastní žetony z jiné platformy.
admin nebo zákazník
Objekt s názvem subjektu. Musí mít neprázdné ID, a uživatelské jméno nebo e-mail - per- admin přístupová brána se shoduje na těchto. Zahrňte obojí, když máte oba.
OpsIQ má dva token ověřovatele, a nebyly totožné. Vědět, že to ušetří vám odpoledne, protože symptom nevypadá vůbec jako příčina.
Admin widget má vlastního ověřovatele.
opsiq/embed/admin_ajax.php carries a local verifier that accepts the authenticated flag in either position. Conversation list, history and unread all go through it, so they authenticate fine.
Sdílený ověřovatel je přísnější
opsiq/includes/customer_identity_token_verify.php sits behind the chat stream and the core AJAX API. It historically required the flag at the TOP level.
Symptomy
Historie a konverzace fungují. Každý chat se obrátit odpovědi "Admin přihlášení potřebné". Čte přesně jako relace chyba a není: token chybí horní úroveň vlajky.
Co dělá současné jádro
Nyní přijímá vlajku na nejvyšší úrovni OR uvnitř předmětu, takže smlouva je jednotná. Starší jádra číst pouze horní úroveň. Emit kanonický tvar a balíček funguje na každé vydání.
✅
This is machine-checked now. Any file in your package that mints identity tokens is statically scanned against the contract, and a payload the platform would refuse fails conformance with the exact file and line. Run it yourself: php tools/verify_identity_contracts.php.
Signed- v zákaznících v pokecu s klienty
Dvě věci musí být pravdivé. Jádro musí razítko ověřeného zákazníka, a váš konektor musí prezentovat.
1
Váš most nebo koncový bod, který vám pomůže se zákazníkem
Stejný znalec jako admin jeden, se zákazníkem subjektu. Přečtěte si zákazníka z platformy vlastní relaci. Pokud vaše platforma připisuje zákazníky na jinou stráž od administrátorů, přečtěte si strážní, kterou chcete a nikdy se nevracejte přes subjekty - to je, jak by zákazník byl předán admin token.
2
Jádro to ověřuje a razítko.
Na základě platné známky, jádro razítka ověřený předmět do zasedání. Váš poskytovatel čte prokázanou identitu, to nikdy ověření.
3
Váš identifikátor je prezentován
detectZákazník () vracíOpsIQtvar. Musí implementovatOpsIQ\ Platform\ IdentifityProviderInterface, nebo registr tiše přeskočí - stejná past jako kontextový poskytovatel.
4
Your customer-scoped actions accept a customer_id
A OpsIQ to před provedením uzamkne na ověřenou identitu. Model to nemůže dodat.
IdentifityProvider. php - přečtěte si prokázanou identitu, prezentujte ji ve tvaru OpsIQ
use OpsIQ\Platform\IdentityProviderInterface;
final class IdentityProvider implements IdentityProviderInterface
{
public function slug(): string { return 'yourplatform_identity'; }
public function label(): string { return 'Your Platform identity (bridge-signed identity_token)'; }
public function priority(): int { return 25; } // ahead of the generic session provider
public function isAvailable(): bool
{
try {
$s = \OpsIQ\Connectors\ConnectorRegistry::getSettings('yourplatform') ?: [];
return trim((string)($s['base_url'] ?? '')) !== '';
} catch (\Throwable $e) { return false; }
}
public function detectAdmin(): ?array
{
$row = $this->sessionRowFor('_opsiq_admin_identity');
if (!$row || !$this->isOurs($row)) return null;
return [
'id' => (int)($row['id'] ?? 0),
'name' => $this->displayName($row, 'Admin'),
'email' => (string)($row['email'] ?? ''),
'username' => (string)($row['username'] ?? ''),
'role' => (string)($row['role'] ?? ''),
'platform' => 'yourplatform',
'source' => 'yourplatform_identity_token',
];
}
public function detectCustomer(): ?array
{
$row = $this->sessionRowFor('_opsiq_customer_identity');
if (!$row || !$this->isOurs($row)) return null;
return [
'id' => (int)($row['id'] ?? 0),
'name' => $this->displayName($row, 'Customer'),
'email' => (string)($row['email'] ?? ''),
'phone' => (string)($row['phone'] ?? ''),
'platform' => 'yourplatform',
'source' => 'yourplatform_identity_token',
];
}
/* A session identity stamped by ANOTHER platform's token must not be
* claimed here. An empty platform is accepted because older bridges did
* not stamp one, and the site key already scoped the token. */
private function isOurs(array $row): bool
{
$p = strtolower(trim((string)($row['platform'] ?? '')));
return $p === '' || $p === 'yourplatform' || $p === 'remote';
}
private function sessionRowFor(string $key): ?array
{
if (session_status() !== PHP_SESSION_ACTIVE) return null;
$row = $_SESSION[$key] ?? null;
return (is_array($row) && (int)($row['id'] ?? 0) > 0) ? $row : null;
}
}
Vlastní-skenované akce: dva zámky, obojí potřebné
Model nesmí nikdy zvolit, čí data čte. OpsIQ prosazuje, že na jeho straně, a vaše platforma musí vynutit ji na druhé straně také. Jeden zámek je chyba daleko od úniku, dva zámky jsou smlouva.
Zamknout1 — OpsIQpřepíše parametry identity
Before a customer-chat action runs, OpsIQ replaces every identity-shaped parameter with the VERIFIED visitor identity: client_id, clientid, user_id, userid, customer_id, account_id take the verified numeric id; client_identifier, customer_identifier, account_identifier take it as a string; email, client_email, customer_email, user_email take the verified email. Whatever the model proposed is discarded.
Lock 2 - vaše platforma re-cops každý dotaz
Vezměte id jste dostali a přidat do bodu Where každého čtení a každý zápis na tomto povrchu. Nikdy nevěřte referenci v žádosti sám o sobě. Znamení-v zákazníkovi ptát se na objednávku někoho jiného musí vrátit prázdný, není zakázáno.
Jmenujte své parametry tak, aby je 1 mohl najít
Call it customer_id, not cust or ref. A parameter OpsIQ does not recognise is a parameter it cannot lock.
⚠️
Dejte značce-in zákazníkovi povrch jeho vlastní provoz, oddělený od admin ty, i když SQL vypadá podobně. Dvě povrchy s různými pravidly zůstávají poctivé, jeden povrch s vlajkou se stane únik v den, kdy někdo edituje špatné větve.
Nulová strana zapojení: sonda s konektorem
You can spare the operator all page wiring. Add an admin_identity_probe_url setting (https only) pointing at your identity endpoint. The plain admin-widget loader from Remote Sites, Codes then works with no page attributes at all: the widget discovers the endpoint through the connector, calls it with the site key and widget token, and authenticates each admin individually. A page can still override with a data-identity-endpoint attribute or window.OpsIQAdminIdentityEndpoint.
settings.json - nastavení sondy
{
"key": "admin_identity_probe_url",
"label": "Admin identity probe URL",
"type": "text",
"placeholder": "https://your-site.com/opsiq-yourplatform-bridge.php?op=admin_identity",
"help": "Set this to your bridge admin_identity endpoint and the plain admin-widget loader works with NO page wiring: the widget probes this URL by itself, the bridge answers with the signed identity of the CURRENTLY logged-in admin, and every admin is matched to their own OpsIQ agent. Leave empty to keep the admin embed off."
}
Sonda je volána prohlížečem
Same- původ, takže nemůže nést vlastní hlavičku. Jeho autentizace je platforma relace. Dejte ji AHEAD vaší brány klíče, držet to mimo záznam dat, a vrátit vůbec nic pro logged- out návštěvníka.
To odpovídá pevnému tvaru
{"success":true,"authenticated":true,"admin":{...},"identity_token":"..."} — and {"success":false,"authenticated":false,"error":"..."} when nobody is signed in.
Žádné dlouho-žil tajemství ve zdroji stránky
Pouze podepsaný, vypršející symbol.
Kompletní koncový parametr implementace pro Laravel,WordPress, WHMCS, Symfony and plain PHP, plus hard-won Laravel specifics and the troubleshooting order, are on the admin widget page. They are the same code for a customer subject: change the guard you read and the object key you signer.
Konektory
Publikování: editace složky není publikování
The most common way to lose an afternoon is to edit a connector under marketplace_connectors/, reinstall it, and find nothing changed. Installs do not read that folder. They pull a signed ZIP from the marketplace catalogue. Publishing is the sequence that puts your changes into that ZIP.
Proč editace nic neudělala
marketplace_connectors/<slug>/ is the SOURCE
Tam pracuješ, nic z toho neinstaluje.
Katalog obsahuje podepsanou ZIP
Instalace stahuje, že ZIP, ověřuje podpis a rozbaluje jej. Dokud si znovu ZIP nepřebudujete, každá instalace stále dostává starý balíček.
Builder konektoru vydává někde jinde
It writes into /connectors/<slug>/ on this install. That is a local connector, not a marketplace release. The two paths do not overlap.
Sled uvolnění
1
Vybumpujte verzi ve dvou souborech
settings.json and connector_contract.json. Conformance compares them and fails if the slug, the version or the capability set disagree. Add a CHANGELOG.md entry while you are there — it is a required file.
2
Přesynchronizovat mostní odstřižek
php tools/sync_connector_bridge_snippets.php --apply — only relevant if your package ships bridge/*.php, and mandatory if it does. Skipping it means the panel hands operators the previous bridge.
3
Přepsat každý balíček
php tools/resign_all_connectors.php — the signature covers file hashes, so ANY edit invalidates it. Sign last, after every file is final.
4
Exportovat podepisovací klíč, pak osivo
Seeder značí každý balíček, když staví ZIP, a běží v kontextu, kde klíč nelze číst z nastavení - takže musí pocházet z prostředí.
5
Vyšlete soubor s mostem, pokud jednu pošlete.
Přeinstalování konektoru aktualizuje balíček. NEDOTČÍ se kopie sedící v nosítkách operátora. Řekni jim to, v panelu a v měňavce.
Celé to propuštění, v pořádku
# 2 — hold the panel copy identical to the shipped bridge
php tools/sync_connector_bridge_snippets.php --apply
# 3 — re-sign (do this last, after every file is final)
php tools/resign_all_connectors.php
# 4 — the seeder reads the signing key from the ENVIRONMENT only
export OPSIQ_CONNECTOR_SIGNING_KEY="$(php -r 'require "bootstrap/init.php"; echo opsiq_setting("connector_signing_key","");')"
php saas/scripts/maint/seed_marketplace_free.php --apply --only=<slug>
# verify before and after
php tools/verify_identity_contracts.php
php vendor/bin/phpunit tests/phpunit/Unit/Connectors
⚠️
Why the export is not optional: the signer looks for the key in OPSIQ_CONNECTOR_SIGNING_KEY first and the connector_signing_key setting second. The seeder runs on the SaaS bootstrap and tools/sign_connector.php boots nothing at all, so in both the settings reader does not exist — with no environment variable there is no key, and you get "No signing key available" or every package reported as signing_failed. Only tools/resign_all_connectors.php boots OpsIQ and can find the key on its own.
Co vlastně lodě
Pouze soubory, které se na podpis vztahují
ZIP je postaven z vlastního seznamu souborů znaku, takže není odeslán zatoulaný soubor ve složce balíčku. To je záměrné: nepodepsaný soubor používaný k jízdě na zákazníky.
Krytá rozšíření
fp,json, js,css, md, txt,html, sh, svg, png, jpg, jpeg, gif, webp, ico, yml, yaml - rekurzivně, včetně mostu / a testů /. signature.jsonsám je vyloučen z haše a pak přidán do ZIP, takže instalace mohou ověřit.
Anything else is reported as not_packaged
Seeder pojmenuje každý soubor, který po sobě zanechal. Přečtěte si tento seznam. Soubor, který jste očekávali, že tam bude odeslán, znamená nesprávné rozšíření nebo špatné umístění - ne tichý úspěch.
Machine- čitelná smlouva. Jeho slimák, verze a schopnost musí být identické s settings.json.
README. md, DEVELOPEROr. md., CHANGELOG. mD
Všechny tři jsou kontrolovány na existenci A minimální velikost. DEVELOPEROPER. MD potřebuje skutečný obsah, ne stub.
Soubor na každou deklarovanou způsobilost
Each capability names the file it expects — ContextProvider.php for context, IdentityProvider.php for identity, GuestLookupProvider.php for guest_lookup, and so on — unless the connector implements the capability inline.
Nic, co by vypadalo jako důvěryhodné.
Konformance prohledává tři Markdownové soubory pro tajné hodnoty a soukromé klíče a na místě se to nepovede.
Zkontroluj to, než to tam pošleš.
Kompletní conformance suite je stejný jako install běží. Kontroluje manifest proti kanonické smlouvy, že runtime a zjevné schopnosti souhlasí, že každá deklarovaná schopnost má svůj soubor a své metody, identifikační-token smlouva v každém mincovním souboru, bridgesnippet zápas, guest- look allowlist hygiena, akce jedinečnost a potvrzení bezpečnosti, a podpis balíčku.
Proběhněte všechny čtyři před každým vydáním
# conformance for every marketplace package
php tools/test_marketplace_connector_conformance.php
# the identity-token contract, statically, with file:line on failure
php tools/verify_identity_contracts.php
# the connector unit suite
php vendor/bin/phpunit tests/phpunit/Unit/Connectors
# the release gate
php tools/release_gate_connectors.php
💡
Jedna chyba se očekává a není problém: kontrola podpisu balíčku hlásí varování, zatímco jste ještě editace. To čistí okamžik, kdy re- podepsat. Každá další selhání je skutečný jeden.
Konektory
Kontejner a životní cyklus
Toto je zdrojová smlouva na výstavbu konektoru, který OpsIQ může objevit, konfigurovat, validovat, povolit, provádět, testovat, podepsat a distribuovat.
Odkaz na vývojářeBalíček konektorů má požadovanou implementaci konektoru a manifest, s volitelnými akcemi, recepty, znalosti, aktiva a podpisovými metadaty.
settings.json používá manifest verze 1. The validator expects a slug, name, version, manifest_version, compatibility, description and capabilities. Compatibility declares opsiq_min a opsiq_max. Stav uvolnění je jedním z production, beta, náhled nebo template; Schopnost zralosti využívá úrovně L1-L6. Legacy balíčky lze normalizovat s varováním, ale nový balíček by měl projít bez varování.
Rozhraní hlavního konektoru
Identita a nastavení: slug(), name(), description(), capabilities(), settingsSchema(), testConnection().
Celoživotní cyklus: onEnable() a onDisable(). Zakázat musí být non-destruktivní; data očista je samostatná záměrná operace.
Příjezd / synchronizace: handleWebhook(), poll(), backfill(). Poll zpracovává přírůstkové práce; zpět vyplnit historii dovozu a musí být bezpečné opakovat.
Podpora: pushReply() pokud platforma přijímá odpovědi.
Abstraktní báze také nabízí volitelné zaostřené zadní vyplnění, zákaznický výpis, email- account objev / tvorba, předplatitelé, admin / detekce zákazníků, fakturační / kontextové / identity poskytovatelů, reextrakce, přezkoušení HTTP volání, JSON-path access, fuzzy ranking a pagination helpers.
Schopnosti a autentizace
Supported capability names include actions, triggers, context, identity, sales, billing, inbound_ticket, outbound_reply, sync_users, sync_departments, security_events, customer_import, security_native_block, promo_audience, promo_feed, email_mailbox, native_api, ai_brain_aware and ai_tickets. The builder provides API key, bearer, basic, HMAC, OAuth 2 client credentials, OAuth 2 authorisation code and custom authentication templates.
Životní cyklus registru
Objevení načte balíček a potvrdí jeho manifest.
Konfigurace je uložena na pracovní prostor; tajemství jsou zašifrována.
Zkouška připojení dokazuje průkaznost bez umožnění konektoru.
Povolit volání onEnable(), synchronizuje definice činnosti a může spustit počáteční backfill.
Vydávání lístků / webhook / poprava předplatitelů vždy nese kontext pracovního prostoru.
Zakázat volání onDisable() a zastaví činnost bez vymazání importovaných dat.
Očista je samostatná explicitní operace.
Pravidla korektnosti
Pomocí klávesy pracovní prostor / stránky v každém čtení, psaní, cache klíč, deduplikační klíč a vyhledávání webhook.
Vytvořte back fill, webhook požití a psát akce idempotent. Zaznamenejte externí ID / událost, kdekoli platforma poskytuje jeden.
Pro vzdálené systémy použijte jejich API; nikdy předpokládat, že jejich databáze tabulky existují v OpsIQ spojení.
Vracet strukturované, zákazní- bezpečné chyby. Nikdy odhalit tajemství, syrové poskytovatele stopy nebo jiné pracovní prostor existence.
Vyhlásit pouze schopnosti balíček skutečně implementuje. actions.json katalog neučiní akci použitelnou, dokud není konektor nainstalován, zapnut, nakonfigurován a jeho připojení je platné.
Zkoušení a uvolnění
Spusťte PHP kmínky, manifest validace, připojení testy, akční schémata testy, webhook signature / REplay testy, workspace- izolačních testů, backfill- opakující se zkoušky, vyřazené konektorové testy a selhání / retry test. Tržní balíček by pak měl být podepsán a ověřen, patří nastavení / oprávnění / webhooku dokumentace a uveďte jeho skutečný stav uvolnění. Konektory a manifesty jsou autoritativní signál dostupnosti.
Konektory
Recepty pro konektory
Step-by- step recepty pro běžné konektory setups.
ReceptyKaždý recept je kontrolní seznam, který budete sledovat shora dolů, zde, Shopify s reálným-time objednávky webháky, ověřeno testovacím pořadí.
Recept: Shopify s real-time webháky
Scénář:
Goal: Connect Shopify with automatic order sync and GDPR compliance.
Co dělat:
1. Create a custom app in Shopify admin (Settings > Apps > Develop apps).
2. Grant scopes: read_orders, read_customers, read_products, write_customers.
3. Copy the Admin API access token.
4. In OpsIQ Connectors > Shopify, enter store domain and token.
5. Click Test Connection.
6. Enable Webhook sync, OpsIQ registers order/customer webhooks automatically.
7. GDPR webhooks register automatically (data_request, customers/redact, shop/redact).
8. Verify: place a test order, check it appears in OpsIQ Sales within 30 seconds.
Recept: WHMCS integrace
Scénář:
Goal: Connect WHMCS so AI can look up clients, services, tickets, and invoices.
Co dělat:
1. In WHMCS admin, Setup > Staff Management > Manage API Credentials. Create a key.
2. In OpsIQ Connectors > WHMCS, enter URL, API identifier, and secret.
3. Click Test Connection.
4. Install the WHMCS module addon for ticket relay.
5. Verify: ask the admin AI "Find client [email protected]". WHMCS data should appear.
Recept: Stripe platby
Scénář:
Goal: Track Stripe payments and let AI look up transactions.
Co dělat:
1. In Stripe Dashboard > Developers > API keys, create a restricted key (read: Customers, Charges, Invoices, Subscriptions).
2. In OpsIQ Connectors > Stripe, enter the restricted key.
3. Test Connection.
4. Add webhook endpoint in Stripe: copy the webhook URL shown on the connector's
own settings page. It carries a per-connector token and looks like
https://your-domain.com/api/connectors.php?slug=stripe&token=THE_TOKEN
A URL without the token is rejected with "Missing slug or token".
5. Select events: charge.succeeded, invoice.paid, customer.subscription.updated.
6. Copy the webhook signing secret to OpsIQ.
7. Verify: make a test payment, check it in OpsIQ Sales.
Recept: Google Business Profile
Scénář:
Goal: Connect GBP for review management, posts, and insights.
Co dělat:
1. Create a Google Cloud project, enable Business Profile API.
2. Create OAuth 2.0 credentials (Web application).
3. Set redirect URI: copy it from the connector's own settings page. Google and
Microsoft connectors share one slug-less callback:
https://your-domain.com/connectors.php?oauth=callback
Everything else uses https://your-domain.com/connectors.php?slug=<slug>&oauth=callback
OAuth redirect URIs must match EXACTLY, and a URI missing oauth=callback is read
as a webhook and answered with "Missing slug or token".
4. In OpsIQ, enter Client ID and Client Secret.
5. Click Authorize, sign in, grant access.
6. Select your business location.
7. Verify: reviews, posts, and insights should appear.
Konektory
Rozšiřte zpravodajskou službu CRM & Site
OpsIQ subsystémy jsou otevřeny pro rozšíření. Konektor může připojit novou schopnost do CRM nebo Site Intelligence beze změn OpsIQ jádro, přes registr schopností platformy (\OpsIQ\ Platform\ CapabilityRegistry). Vyhlaste schopnost, zadejte její malou sadu metod, pošlete konektor,OpsIQ objeví a navede do UI, Zákazník 360 časová osa a instalace je doporučena.
Rozšiřte CRM & SIKontejner prohlašuje schopnosti (kalendář, obohacení, hodnotové údaje, analytika...) a OpsIQ je automaticky převede do CRM a Site Intelligence, žádné změny jádra.
Vyhlášení způsobilosti
Prohlášení (usazení.json)
Přidat <domain>_capabilities pole, nejlepší pro nekódové / tržně orientované konektory. crm, site_intelligence.
Kód (connector. php)
Provádění crmCapabilities() / siCapabilities() Vrací stejné deskriptory.
Vyhlášení CRM kalendáře poskytovatele (settings.json)
Scénář:
Goal: make a calendar connector appear in the CRM Schedule-meeting panel.
enrich($settings,$params) → {úspěch, vlastnosti}. Řízen\OpsIQ\ CRM\ EnrichmentBridge (také běží automaticky na vytváření společnosti, když je poskytovatel připojen).
crm / esignCity in New York USA
sendForSignature($settings,$params) → {success,envelope_id,sign_url}. Driven by \OpsIQ\CRM\EsignBridge.
site_intelligence / local_listing
listLocations, listReviews, getInsights. Lodě přes konektor Profil Google Business.
report($settings,$params) (sync / export) + ingest($settings,$events) (import). Driven by\OpsIQ\ Analytics\ WebAnalyticsBridge. Lodě: Google Analytics (GA4) konektor. Data API pro zprávy, Measurement Protocol for import. Analytika je otevřena pro konektory jako CRM + Site Intelligence (doména analytics / analytics_capabilities).
payments / payment_provider
listPayments, customerPayments, createPaymentLink. Řízen\OpsIQ\ PaymentsBridge. Ukázat platby zákazníka na časové ose CRM + poslat platební odkaz na dohodu. Lodě: Stripe Payments konektor. Domain payments / payments_capabilities.
mailbox / email_sync
listMessages + sendMessage. Driven by\OpsIQ Mailbox\ MailboxBridge. E-maily zákazníka na zákazníkovi 360 Časová osa + odeslat e-mail z obchodu. Lodě: Gmail + Outlook / Microsoft 365 konektory. Domain mailbox / mailbox_capabilities.
Sdílená aplikace OAuth + ONE přesměrování
Všechny konektory Google sdílejí jednu aplikaci pomocí\OpsIQ\OAuth\ SharedGoogleApp. Set google_oauth_client_id/_secret jednou a Kalendář, Analytics, Business Profile + Gmail všechny práce (per- konektor "(nepovinné)" pole jsou overrides). URI, <site>/connectors.php?oauth=callback (žádný per- konektor slimák), protože Google vystavuje ne API přidat do aplikace přesměrování URI; OpsIQ obnovuje konektor z podepsaného OAuth state ne. Registrujte, že jediný URI jednou a každý konektor Google (současnost + budoucnost) povoluje bez dalšího nastavení Console. SharedGoogleApp::resolve(...)Je to jen... redirect_uri od oauthParams(); nikdy hard-code a per- slig přesměrovat. Microsoft konektory dělat to samé přes\OpsIQ\OAuth\ SharedMicrosoftApp (microsoft_oauth_*).
Importní tlačítka jsou capability- routed
V Importovat (historická backfill) a Dovoz zákazníků tlačítka ukazují pouze pro konektory, které je skutečně implementují, detekované reflexem, takže není žádná vlajka k vyhlášení. backfill() nebo backfillChunk() Vydělat tlačítko Import; přepsat listCustomers() (návrat {e-mail, jméno,...} stránky) vydělat Import zákazníků. AbstractConnector ne-op a tlačítko zůstane skryto, takže UI nikdy nenabízí import konektor nemůže provádět.
AI v autobusech
Agent CRM navrhuje a knihy setkání off deal signály (\OpsIQ\ CRM\ MeetingProposer → CalendarBridge), a autoenforth nové účty, "AI provozuje CRM" smyčku, prováděné přes konektorové autobusy.
Když návštěvník odkáže číslo vstupenky v klientském chatu ("jaký je stav T-000123?"), OpsIQ Vyřeší to ve dvou stupních. Úroveň 1 si přečte společný obchod s vstupenkami OpsIQ, každý konektor s inbound_ticket tam zrcadlí své vstupenky, takže synchronizované vstupenky prostě pracují pro ALL konektory s nulovým kódem perkonektoru. Úroveň 2 je živý záloha pro staré lístky, které se nikdy nezrcadlily: jádro nazývá VOLITELNĚ fetchTicket() na každém zapnutém konektoru, který ji implementuje. duck-typed (objeven method_exists()Jako třeba contextProviders()/audienceCatalog()), tak podepsaný ConnectorInterface je nedotčený a konektory, které to nepotřebují (e-mailové / chatové zdroje, které vytvářejí lístky nativně) prostě vynechají.
⚠️
Vlastnictví je povinné a vaše je třeba vymáhat. fetchTicket() obdrží Verified identitu návštěvníka v $ctx (client_id + client_email, stejná ověřená identita, kterou klient chat AI používá). Řešení platforma zákazníka z této identity a dotaz Pouze, že zákazník vstupenky, pak re-zkontrolovat vlastnictví na detail záznamu. null na jakékoli chybějící, nesoulad, nebo chyba, nikdy další údaje zákazníka. null "Nemohl jsem najít ten lístek."
<?php
// connector.php — OPTIONAL universal client-chat ticket resolver (Tier 2).
// Only add it if your platform keeps its OWN ticket store that may hold tickets
// not yet mirrored into OpsIQ. Return the normalised array below, or null.
//
// $ref = ['mode' => 'id'|'tid', 'value' => string] (from extract_ticket_ref)
// $ctx = ['client_id' => int, 'client_email' => string] (VERIFIED visitor)
// $settings = your connector settings
public function fetchTicket(array $ref, array $ctx, array $settings): ?array
{
try {
$email = trim((string)($ctx['client_email'] ?? ''));
$cid = (int)($ctx['client_id'] ?? 0);
if ($cid <= 0 && $email === '') return null; // no verified identity → refuse
// 1) Resolve THIS visitor on your platform (by verified email/id).
// 2) List ONLY their tickets and match $ref against the ticket number/id.
// 3) Re-confirm ownership on the detail record before returning.
// On any miss/mismatch/error → return null (never leak).
return [
'tid' => 'T-000123', // the customer-facing reference
'id' => 123, // your internal id
'status' => 'open',
'subject' => '…',
'department' => 'Billing', // '' if your platform has none
'priority' => 'high',
'opened_at' => '2026-06-29 10:00:00',
'last_reply' => '2026-06-29 12:00:00',
'message' => 'opening message text',
'replies' => [ // oldest → newest; opening message may be first
['who' => 'You', 'date' => '…', 'message' => '…'],
['who' => 'Staff', 'date' => '…', 'message' => '…'],
],
];
} catch (\Throwable $e) {
error_log('[yourslug][fetchTicket] ' . $e->getMessage());
return null; // graceful degrade
}
}
Jak ji platforma využívá
Objevení
CapabilityRegistry::providers($domain,$type) uvádí poskytovatele s nainstalovaným / povoleným / připraveným stavem (na základě systému souborů; DB pouze pro povolené označení).
Výběr
CapabilityRegistry::active($domain,$type) vrací první připraveného poskytovatele s načteným konektorem a nastavením. Mosty tomu říkají místo tvrdých kulek.
Notify- to- instalovat
Pokud funkce potřebuje schopnost, která ještě není připojena, UI zobrazí jedno kliknutí na tlačítko Connect / Install, nikdy nemrtvé ovládání.
Kompletní průvodce
Viz connectors/PLATFORM_CONNECTORS.md (CRM + Site Intelligence) a connectors/CRM_CONNECTORS.md v balíčku.
Konektory
Samoobslužné vyhledávání a náhrady (budovat konektor pro zákaznický chat)
Signed- in zákazníci mohou požádat zákazníka chatu AI o jejich vlastní účet ("můj zůstatek", "moje objednávky", 'podporoval odpověď na můj lístek ") a, pokud to podnikání umožňuje, požadovat náhrady. Vše je poháněno prohlášeními vašeho konektoru: žádné změny OpsIQ jádro, žádné platforma tvrdé kódování. AI volá vaše vyhledávání jako nativní nástroje (nemůže vymyslet jeden), identita je uzamčen serverside ověřovaného zákazníka, a výsledky jsou automaticky zkráceny pro AI.
Vyhlásit zákaznický vzhled
Ve vaší actions.json, Čtení pouze akce se stává uživatelsky-volatelné s ALL TREE: "scope":"client", "requires_confirmation":false, "is_destructive":falsePoužití "scope":"both" když stejný vzhled by měl být také volatelný vaším týmem v Admin AI. Plná slovní zásoba je admin, client, both a system (system ani AI - API a pouze webové trasy). Vše ostatní je odmítnuto přímo: validace balíčků selže a akce není nainstalována. writing rozsah - je doručen asistent psaní admin akční sada.
Pravidlo identity (povinné)
Jmenujte svůj parametr identity ze standardní sady. Zamčeno na ověřené numerické ID: client_id, clientid, customer_id, user_id, userid, account_id. Zaměřeno na id jako řetězec: client_identifier, customer_identifier, account_identifier. Zamčeno na ověřeném e-mailu: email, client_email, customer_email, user_email. OpsIQ zámky a auto- vyplní jej z platform- ověřený znaménko -in zákazníka; AI nikdy nevidí nebo vybere identitu. Nestandardní název selže uzavřen (odepřen, nikdy unikl).
Co musí zůstat administrátor- pouze
Cokoliv, co není zachyceno touto identitou: fetch-by-bare-id (order_id/ticket_id sám), skladem-široký seznam, free-text vyhledávání. To jsou cross-zákazník úniky na jakékoliv platformě. "scope":"admin".
Cílení výsledků (klávesy pro uložení odpovědi)
Lookup výsledky jsou strukturálně ořezány před dosažením AI: sekret- tvaru kláves jsou upuštěny, dlouhé struny a seznamy jsou omezeny, prázdné pole jsou prořezávány, a plochá mapa širší než klíčová uzávěrka udržuje jeho nejprve klávesy pro zodpovězení ložisek, peníze (credit, balance, amount, total, due, paid), identity (email, *name, phone, company), stát (status, active, expir*, renew*), data, plán / produkt / doména / služba / předplatné / objednávka / faktura / pole vstupenek, měna, počet a stats/summary/totals, Před každým zbývajícím sedadlem jít na jiné klíče smallest- value- first. Praktické vedení: pojmenovat svá pole s tímto standardním slovní zásobou a vrátit pole, která odpovídají zákazníkovi otázku spíše než syrové 100-key platforma skládka; pole pojmenované mimo slovní zásobu soutěží o zbývající sedadla a může být ořezána z velmi širokého zatížení.
Náhrady · co váš konektor poskytuje
Dvě surové operace, bez politiky: (1) a payment- verification read filterable by identity And a transaction reference (your API musí A filtry), např. whmcs_get_transactions; (2) a refund execution action (scope:"admin", requires_confirmation:true, is_destructive:true, nikdy neexponovaný), např. whmcs_refund_order. Podnikání vybere oba klíče v Nastavení → Klient Chat; OpsIQ re-ověřuje platbu serverside, aplikuje business pole politiky (limit částky, věkové okno, měsíční limit), problémy uvnitř krabice, a soubory recenzi vstupenku na všechno ostatní.
Ne- kód stavitel
Akční editor Connector Builder 's má stejné ovládací prvky: nastavit "Kdo to může použít" pro zákazníky Signed-, nechat jak zapisovací políčka vypnuté, tak používat standardní název parametru identity.
Referenční provádění
Zápisy "Zákaznický Self-Service" v connectors/whmcs/actions.json, woocommerce/actions.json, oscommerce/actions.json; plná smlouva v connectors/README.md §8.1–8.2 a ConnectorInterface::registerActions().
Konektory
Guest lookups — let visitors track a booking, shipment or order WITHOUT signing in (guest_lookup)
Hotely, kurýři a mnoho obchodních platforem slouží zákazníkům, kteří mají referenci, ale ne přihlášení: host s potvrzením rezervace, příjemce se sledovacím číslem. guest_lookup schopnost (smlouva o konektoru, režim: generován) umožňuje Vašemu konektoru sloužit návštěvníkům v klientském chatu AI - neOpsIQzměny jádra, žádné pevné kódování platforem. Váš konektor prohlašuje, co dokazuje nárok a která pole jsou viditelná;OpsIQVyvolává přepínače, plyn a uniforma popírají.
Model důvěry
Referenční + důkaz, nikdy totožnost
Návštěvník dodává referenci záznamu (odpovídající regexu, který deklarujete) plus důkaz, který vyberete - obvykle e-mail v záznamu. Vaše akce pro vyzvednutí získá záznam SERVER-SIDE referencí; vytvořený poskytovatel OpsIQ porovnává důkazy proti záznamu FETCHED. Vstup návštěvníka není nikdy důvěryhodný, a žádná ověřená identita není vytvořena: zápas opravňuje návštěvníka k tomu, že jeden záznam je povoleno pole, nic jiného.
Jednotné popření (bez výčtu orákula)
Note- found and corrossment - mismatch product ONE identická odpověď. AI je výslovně instruován nikdy potvrdit, zda odkaz existuje a nikdy vynalézt podrobnosti záznamu. Pokusy jsou rate- limited na rozhovor + IP po jádru před tím, než bude váš konektor vůbec konzultován.
Dvojité opt- in, oba výchozí OFF
Nic neslouží hostům, dokud podnik neumožní oba přepínače: pracovní prostor - široké ovládání v Nastavení→Bezpečnost→"Vyhledávání záznamů v klientském chatu" (povolení - routed A vždy heslo - potvrzeno, i když volitelný step-up je vypnutý), a váš konektor je vlastní guest_lookup_enabled nastavení přepínat. Instalace nebo umožnění připojení sám o sobě nikdy neotevírá povrch hosta.
Dedikovaný povrch hostí
Vygenerovaný poskytovatel registruje guest kontextový povrch - strukturálně oddělený od admin a customer. Stávající kontextové poskytovatelé nejsou nikdy konzultovány pro anonymní návštěvníky, a host poskytovatel není nikdy konzultován pro signed- v těch. Ctx přijímá nese chatovací zprávu, vlákno ID a návštěvník tvrdí (neověřený) pre-chat e-mail jako důkaz kandidáta - žádné pole identity.
Vyhlašuje to ve Staviteli
1
Definovat akci pro vyzvednutí
V kroku Akce přidejte akci pouze pro čtení, která vrací záznam o jednom z jeho referencí (např. GET /bookings/{booking_number}) and map its response fields with aliases: status, arrival, departure, room_type, customer_email…
2
Tik "Pohled na hosty"
Na kroku schopnosti, zapněte guest_lookup. Dedikovaný panel se objeví: vyberte akci pro načtení, pojmenujte referenční parametr, uveďte referenční vzor (regex tělo, jako je \bBK-[0-9]{4,10}\b), název záznamu ("rezervace"), a vyberte důkaz - e-mail na záznamu (doporučeno) nebo žádný (odkaz sám, pro status- pouze kurýrní sledování).
3
Seznam viditelných polí
Zaškrtněte přesně pole, která může host vidět. Vše ostatní je DROPPED - nikdy nerušen. Builder odmítá PIL-tvarovaná pole (email, telefon, adresa, platba...) v allolistu, a releasegate conformance suite re-kontroluje stejné pravidlo před zveřejněním, takže ručně upravené spec nemůže propašovat jeden dovnitř. Všimněte si, že instalátor -time validace pokrývá manifest a podpis pouze, takže spusťte confornance suit před vaší lodí. Důkazní pole nemůže být nikdy zobrazeno.
4
Zveřejnit a povolit
Stavitel vysílá GuestLookupProvider.php - kanonicky ztvrdlá implementace, identická pro každý generovaný balíček - a přidá guest_lookup_enabled business arms dva spínače a chat AI začne nabízet vyhledávání, když se návštěvník zeptá na váš typ záznamu.
Smluvní pravidla
Pouze pole ve tvaru prvku
Představte si "co by kurýr vytisknout na veřejné sledovací stránce": status, data, pokoj nebo kategorie služeb, počítá. Jména, kontaktní údaje, adresy ulic, platební data a free- text poznámky nemají místo v anonymním chatu - Builder a konformita oba odmítnout.
AI odpovídá pouze z bloku
Vygenerovaný poskytovatel končí výstup s instrukcí odpovědět pouze z uvedených polí a nabídnout jízdenku na cokoliv jiného. Detail není v seznamu povolených položek "není k dispozici v chatu" - podle návrhu.
Follow- ups pokračovat v práci
Poskytovatel odvozuje referenci z posledních zpráv návštěvníka v téže konverzaci, takže "a kdy je check- out?" funguje bez přepsání reference. Srovnávaný odkaz a důkaz e-mail jsou zapamatovány na vlákno chatu jako CANDIDATES, takže follow- up nevrací-apply. Jsou to pouze kandidáti: každý obrat stále re-ficts záznam serverside a re- porovnává důkaz před uvolněním jednoho pole.
Ručně autorované balíčky
Balíček na trhu může přepravovat vlastní GuestLookupProvider.php implementing ContextProviderInterface s surfaces(): ['guest']. Postupujte podle vygenerované šablony smlouvy přesně - apply reference, korekčně -match serverside, uniform believe, allolist- only output - a deklare guest_lookup in capabilities. Konformance ověřuje povrch hosta a skenuje povolenky pro PII.
💡
Hledání hostů jsou read- pouze kontext pro chat AI. Nikdy provádět akce, nikdy vytvářet identity, a nikdy odemknout zákaznický self-servis akční cesta výše - že cesta stále vyžaduje platform- ověřený znaménko -v zákazníkovi.
Konektory
Promotion audience targeting (promo_audience)
Ať se promotion Studio cílí kampaně LIVE klienta a fakturační stav z vaší platformy: "má nezaplacenou fakturu", "objednávka čeká", 'předplatné zrušeno ". Každý konektor (předem nainstalovaný, tržiště, nebo jeden si postavit) připojí implementací dvou malých metod. Ne OpsIQ změny jádra, žádné pevné kódování platformy: váš konektor se objeví jako platforma v záložce Studio Targeting s jeho vlastním poklesem faktů, a několik konektorů může být povoleno bok po boku.
Promo publikumVáš konektor odpovídá na fakturační údaje pro návštěvníka, studio se zaměřuje na ně, a selže tak nabídka účtování nikdy nedosáhne špatné osoby.
Jak to funguje
1
Vyhlaste svá fakta
Zavést audienceCatalog () na vaši třídu konektorů. Vrací štítek a seznam klíčů, které může platforma odpovědět. Každý klíč se zobrazí ve studiu dropdown pod názvem platformy.
2
Odpověď pro jednoho klienta
Implement audienceFlags(array $identity). OpsIQ calls it at delivery time with the VERIFIED logged-in visitor identity (from the widget identity token, the same identity the client chat AI uses). Return a flat key => value map.
3
Hotovo.
Enable the connector. The Promotion Studio Targeting tab grows a "Client & billing" section listing your platform; admins build rules like "unpaid_invoices >= 1"; every fact also becomes a personalization variable such as {unpaid_invoices}.
connector.php, the complete promo_audience contract
Přidat 'promo_audience' na konektor capabilities() pole tak platforma a tržiště jej jako audience- schopné (objev také funguje z přítomnosti metody, ale prohlašuje, že je čistý signál). Předinstalovaný connectors/whmcs konektor je kompletní referenční implementace.
Název klíče
Lowercase snake_case, 2-60 chars, matching ^[a-z0-9_]+$. Types: number, text, bool. Undeclared keys returned by audienceFlags() are still usable in rules, but declare everything you support so admins can see it.
Identifikace je ověřena
The $identity array comes from the signed widget identity token issued by the customer site at login, never from client-supplied fields. If your platform cannot resolve the identity, return an empty array.
Selhání uzavřeno · vždy
O jakékoli chybě (API dole, klient nenalezen, timeout) vrátit []. Pravidlo, jehož skutečnost chybí, je kampaň NENÍ show. Výnosy-cílené nesmí nikdy dosáhnout špatné osoby; OpsIQ To také prosazuje pravidlo Matchera.
Výkonnost
audienceFlags () je volán maximálně jednou za konektor na stránku zobrazení, a POUZE, když publikovaná kampaň skutečně používá pravidla platforma. Anonymní návštěvníci stojí vás nula hovorů. 1-2 API volání; OpsIQ Memorizuje v rámci požadavku.
Provozovatelé poskytovali zdarma
Aplikace kombinují klávesy s =,! =, >, > =, <, < =, obsahuje, je nastavena, je prázdná, pouze dodáváte hodnoty.
Personalizační tokeny
Každý fakt se zdvojnásobí jako proměnná v kopii kampaně: {unpaid_invoices}, {client_status}, plus budovy-iny {first_name} a {client_email} Hodnoty jsou před vykreslením dezinfikovány.
Nekódové konektory pro trh
Automatická fakta
Declarative (JSON-only) marketplace connectors get promo_audience for FREE: if your connector declares customers/users, invoices, orders or subscriptions resources, OpsIQ derives customer_status, unpaid_invoices, amount_due, pending_orders, active_subscriptions and subscription_status from your existing search actions. No code at all.
Vlastní katalog (settings.json)
Add an audience_capabilities object · {"label": "My Platform", "keys": [{"key": "open_carts", "label": "Open carts", "type": "number"}]}, to control exactly which facts (and labels) appear in the studio dropdown.
Testování vašeho poskytovatele
1
Povolit konektor
Konektory > Váš konektor > Povolit. Poté otevřete libovolnou kartu cílení kampaně. Vaše platforma se musí objevit pod "Klient & fakturace (konektory)".
2
Vytvořit pravidlo
Přidat: Vaše platforma · klíč · > = · 1 a nastavit "Logged- v klientech pouze". Uložit a zveřejnit.
3
Ověřte oba směry
Přihlaste se na platformu jako klient, který odpovídá pravidlu (popup musí ukázat) a jako ten, který není (pozapp musí zůstat skrytý).
Vypalte kampaň z vlastního kódu (vlastní spouštěč)
Proč?
Za stavební- in spouštěče (zpoždění, posun, exit- intent, nečinný, kliknutím, pages- shlédnutý, chatu / tiket aktivity) můžete střílet kampaň odkudkoliv na vašich stránkách nebo konektoru předku-end, po úspěšném kroku checkout, když je vůz opuštěn, když vaše SPA změní cestu, atd.
Jak
Nastavit spouštěč kampaně na Vlastní s názvem události (např. checkout_failed), pak zavolejte globální hák ze své stránky:
vaše stránky / konektor front- end JS
// Any campaign whose Custom trigger event matches will be evaluated
// (it still respects targeting, frequency caps and audience rules).
window.OpsIQPromo && window.OpsIQPromo.fire('checkout_failed');
💡
Zapálení události nikdy neobchází cílování nebo frekvenci. To jen uvolní "kdy". Kampaň musí projít každé pravidlo (geo, publikum, souhlas, čepice), než se ukáže.
✅
Kompletní průvodce (návrh, bloky, analytika, A / B, publikování) žije v in- app Help Center pod Vpřed → Promotion Studio. The capability here is discovered automatically from any ENABLED connector in connectors/ or marketplace_connectors/. There is nothing to register. Ship the two methods, and the studio does the rest.
Konektory
Schopnost průzkumného konektoru (Contract 2.2)
V survey schopnost umožňuje jakékoli platformě dodávat ověřené adaptéry identity zákazníka, obecenstvo fakta, bezpečné proměnné a přijímací kandidáty na Survey Studio. Je nezávislá na promo_audience a neposkytuje konektor vlastnictví průzkumů, odpovědí, analytiky nebo e-mailové doručení.
💡
Stav realizace. Autorizace je dnes kompletní a použitelné: Connector Contract 2.2, SurveyConnectorInterface, Dedikovaný panel Builder, generovaný SurveyProvider.php, balíčková metadata a izolace shody všech lodí. Spotřeba není ještě připojena: SurveyConnectorRegistry je implementován a testován, ale žádný Průzkum runtime to ještě volá, takže poskytovatel zdraví není vynořen v admin UI a žádný publikovaný konektor balíček prohlašuje schopnost. Signedtoken Průzkumný Průzkum Identity Gateway vydání, cílení a variabilní integrace, CRM Outenge materializace a první dodávané poskytovatele mapování zůstávají samostatné fáze. Budovat proti této smlouvě nyní; očekávat runtime začít spotřebu v pozdější verzi.
Odpovědnost poskytovatele
Katalog publika a fakta
Declare typed canonical facts and resolve values only for a server-verified, workspace-bound subject. Typical facts include order_count, last_order_status, cancelled_order_count, customer_created_at, active_subscription_count, past_due_invoice_count and open_ticket_count.
Proměnná katalog a hodnoty
Vyhlásit zákaznické, účetní, objednávkové, předplatné a podporu proměnných s typem, citlivost a povoleným kontextem. Průzkum kopie vyžaduje chyby a output- context unikání.
Paging příjemce
Volitelně vyjmenovat kandidáty na CRM Outenach se stabilními externími ID, ohraničené stránky, deterministické kurzory a consent- related metadata. Průzkum zmrazí vybrané publikum před každým odesláním.
Identita
Přijetí identity pouze z Průzkumného průvodu totožnosti po znakovém podpisu, vypršení platnosti, účelu, ověření konektoru a pracovního prostoru. E-mail dodaný prohlížečem, ID, tagy nebo faktury nejsou nikdy autoritativní.
Zdraví při běhání
SurveyConnectorRegister je navržen tak, aby nahlásil kompatibilní, blokované a nedostupné poskytovatele bez odhalení nastavení, cest, surové identity nebo zprávy o výjimkách, a blokovaný poskytovatel nemůže být nikdy volán. Povrch hlášení není ještě vystavený v admin UI: dnes zablokovaný poskytovatel je prostě inertní.
Platná - uzavřená pravidla
Nehlášené klíče, špatné typy, nadměrné hodnoty, neshody objektů, časové odstupy konektorů a neznámé identity jsou zamítnuty. Zacílení pravidlo, které potřebuje nedostupný fakt neodpovídá. Příjemci stránky jsou omezeny a auditovány. Citlivé hodnoty se nikdy neobjeví ve veřejné náhled nebo protokoly.
Stavební uvolňovací brána
Smlouva 2.2 přepravuje vstup do registru schopností, rozhraní, mapovací panel pro průzkum, generovaný SurveyProvider.php, Schopnost verze, README / vývojářské reference a konformity fixtures. Obchod, helpdesk, SaaS bridge a místní PHP profily patří; Standardní API konektory opt in. Statická brána odmítá poskytovatele průzkumu, který nazývá Promotion jmenné space, tabulky nebo schopnosti.
💡
Kopie z Promotion je import- only: Builder může přeložit kompatibilní Mapování Propagace jednou, uložit kompletní Survey- vlastněné kopie a záznam provenance. Smazání nebo změna mapování Promoční nesmí změnit chování Průzkumu.
Konektory
Reply response capacity (Contract 2.2)
V reply_feedback schopnost zrcadlit vlastní hodnocení platform per- odpověď do OpsIQ. Hvězda zákazník dává zaměstnance odpověď uvnitř WHMCS klientská oblast přistává na odpověď SAME v OpsIQ admin vlákno, se stejným čipem, agent úvěr, Zpětný vstup stránky a Team & Performance výpočet jako rating uvedený na OpsIQ Portál. Jeden sklad, jeden čip, jeden ropovod; konektor pouze překládá.
Cesta jednoho zápisu
Existují přesně dvě vstupní cesty a jedna pravda. OpsIQ portálové vstupenky psát nativně. Platforma vstupenky proudí přes konektor, a jádro přistane každou událost prostřednictvím ReplyFeedback::recordMirrored(): stejné sloupce, pravidlo pouze pro zaměstnance, jedno-rating-per- odpověď latest- vyhrává sémantiku, pracovní mezeru razítko a hlas zákazníka indexování portáže používá. Konektor nikdy nepíše zpětnou vazbu řádky sám.
Konformace (čtyři soubory, pak přeznačit)
1
connector_contract.json
Add the capabilities.reply_feedback entry: version 1.0, the ReplyFeedbackConnectorInterface, methods replyFeedbackCatalog and pullReplyFeedback, implies inbound_ticket.
2
settings.json
Add reply_feedback to the capabilities list. This is what connector discovery reads.
3
spec.json
Declare reply_feedback.modes (poll and/or webhook) and the platform's rating scale. This is what the conformance gate reads.
4
Běh kategorie
Implement the interface, list reply_feedback in capabilities(), then re-sign the package.
Odpovědnost poskytovatele
Katalog
Vyhlásit režimy, platforma vlastní ratingovou stupnici (jádro normalizuje na původní 1-5), a všechny reakční tokeny. Katalog musí souhlasit s spektrometrem.json.
Tahat překlad
pullReplyFeedback returns canonical events: platform ticket id, platform reply id, rating, optional reaction/comment, submitted time and a stable event_id. It reads and translates. It never writes.
Idempotence
event_id is stable per feedback STATE, so a replayed event is a no-op and a changed rating overwrites (latest wins, like the portal).
Kurzovní disciplína
Stránky jsou ohraničeny a deterministické; kurzor, který nepokračuje končí běh. Historické zadní vyplnění kanálků jako valivé okno, nikdy jeden obrovský tah.
Bezpečnost sondy
Bez konfigurace, vrátit prázdné kompletní stránku místo házení. Shodující běžec sondy s prázdnými argumenty.
Vyřešení sporů
Jádro řeší každou událost na místní odpověď pomocí znaménka, které již razítka (<slug>:<ticket>:reply:<reply>). Událost, která nemůže být vyřešena, je upuštěna, nikdy neuhodla, zpětná vazba se váže pouze na odpovědi zaměstnanců a úvěr agenta vždy pochází od stávajícího autora odpovědi. Rating nikdy nemění autorství. Proto schopnost vyžaduje inbound_ticket nebo ticket_mirror.
Pracovní příklad: WHMCS
WHMCS ukládá klient- area per- odpověď hvězdných hodnocení v tblticketreplies.rating. WHMCS konektor prohlašuje, že anulovací režim s 1-5 měřítko, lodě a ticket_reply_ratings relé příkaz ve svém mostovém souboru, a převádí každý řádek do události, jejíž ID odpovídají whmcs:<ticket>:reply:<reply> označí své zrcátko již známky. Po upgrade konektoru překopírujte mostní soubor na server WHMCS, aby tam byl nový příkaz.
💡
Úplná developerská smlouva s rozhraním, tvary událostí, normalizovací pravidla a kontrolní seznam shody: doc/contracts/TICKET_REPLY_FEEDBACK_CAPABILITY.md v OpsIQ balíček. Přijetí: Hodnotit odpověď uvnitř platformy, čekat na hodinový průzkum, a stejná odpověď v OpsIQ zobrazuje čip, stránku Feedback uvádí a přehraná událost nic nemění.
Konektory
Trh konektorů
Marketplace vám umožní objevovat, instalovat a publikovat konektory postavené komunitou.
MarketplaceProjděte komunitní konektory, nainstalujte do jednoho kliknutí nebo podepište a publikujte své vlastní, předem instalované a tržní úrovně jak vyhledávatelné.
Hledání a instalace konektorů
1
Procházet
Přejděte na Propojky > Marketplace. Hledání podle jména, kategorie nebo platformy.
2
Přezkum
Zkontrolujte popis, podporované akce a hodnocení.
3
Instalovat
Click Install. The connector package downloads and installs to marketplace_connectors/.
4
Nastavit
Povolit v konektorech, zadat API pověření, a test.
Vydávání konektoru
1
Stavět a zkoušet
Použijte Connector Builder. Ověřte všechny akce práce.
2
Balení
Vytvořit profil.json, akce.json, znalosti.json, a soubory PHP.
3
Podpis
Run php tools/sign_connector.php <slug> to sign ONE package (it also accepts a path). It does not boot OpsIQ, so give it the key: either --key=<secret> or the OPSIQ_CONNECTOR_SIGNING_KEY environment variable, otherwise it stops with "No signing key available". tools/resign_all_connectors.php re-signs EVERY package on the install and reads the key from settings by itself, but it can also mint a NEW install-wide signing key, so reach for it only when that is what you want.
4
Odeslat
Nahrávání prostřednictvím toku pro předkládání nabídek na trhu za účelem přezkumu.
Dvě konektorové úrovně
konektory / - co skutečně běží
Run time objev kořen. Vše zde je živě: konektory, které loď s OpsIQ, cokoliv instalováno z trhu, a cokoliv, co Connector Builder zveřejňuje na této instalaci.
marketplace_connectors/ — where packages are authored
Vydavatelství SOURCE pro balíčky na trh pro první strany. Není to objev kořene: nic není živě, dokud je zabaleno, podepsáno, nasazeno do katalogu a nainstalováno, na kterém místě se kopie přistane v konektorech /.
💡
Look in both places. A package you authored under marketplace_connectors/ is not the copy that runs — installing copies it into connectors/, and only that copy is discovered at runtime. Stripe, BigCommerce, Magento 2, PrestaShop, OpenCart, Amazon SES, Postmark and Resend are all marketplace packages: install one before expecting to find it in Connectors.
Vývojář
API a stavitel webháků
U API a Webhook Builder vám umožní vytvořit vlastní API koncové body a webhook posluchače uvnitř OpsIQ bez psaní syrového PHP.
API stavitelVybudovat koncové body bez surového PHP: stiskněte spoušť (přilétající webhook, plán, událost nebo manuál), pak mapujte pole do akce.
Spouštěče
Událost
Uteč, když se něco stane v OpsIQ, nebo když externí systém umístí odpovídající událost na váš webhook URL. Napište název události, například ticket.created.
Plán
Použijte jednu z built- in interval událostí jako název události: cron. minentně, crons. hourly nebo cron. daile. Actions a Triggers obrazovka má tlačítka pro tyto, takže nemusíte pamatovat.
Fráza
Spustit, když admin žádá AI pro to v prostém jazyce. Přidat frázi, která by měla odpovídat, například najít zákazníka.
Přibližující se webhook
Vnější systém posílá HTTP POST do vašeho OpsIQ webhook URL Každý spouštěč, který tu událost poslouchá, vystřelí.
Proveďte to někdy: podmínky
Spouštěč událostí může nést podmínky, takže běží pouze tehdy, když se přicházející data shodují. Bez podmínek běží pokaždé, když událost vyvolá.
Pole
Cesta do dat události. Použijte tečku pro vnořené hodnoty, například customer. email..
Srovnat všechny nebo jakékoliv
Vyberte si, zda se musí každé pravidlo shodovat, nebo jen jedno z nich.
Textové zkoušky
rovná se, není roven, obsahuje, neobsahuje, začíná s, je jedním z, Není jedním z. Odpovídající ignores hlavní města.
Počet zkoušek
větší než, alespoň, menší než, nanejvýš. Čísla napsaná jako text stále správně porovnávají.
Přítomnost testů
je přítomen, chybí, je prázdný, není prázdný.
Pouze na stránce on- call inženýr pro urgentní vstupenky
Scénář:
Event ticket.created, with one rule: priority equals urgent.
Co dělat:
Akce běží pro urgentní lístky a je přeskočen na všechno ostatní. Není třeba filtrování na konci.
💡
Pokud ponecháte pravidla prázdná, spouští se spouštěč při každé odpovídající události, což je stejné chování jako před tím, než podmínky existovaly.
Akce
Poslat webhook
Odeslat HTTP POST na externí URL s vlastním užitečným zatížením.
Vytvořit tiket
Vytvořte si podpůrnou jízdenku se specifikovaným oddělením, předmětem a zprávou.
Odeslat email
Poslat e-mail s vlastní šablonou.
Aktualizovat záznam
Aktualizujte zákazníkovi, jízdenku nebo CRM záznam.
Spustit činnost konektoru
Proveďte registrovanou akci z povoleného konektoru s jeho pravidly pro oprávnění a potvrzení.
Běž. OpsIQ Obecné API akce
Vyhledávání kompletní název General API katalog. Pole, skoky, oprávnění, potvrzení, idempotence a suchý-run podpora pochází ze smlouvy o živé akci; pracovní tok probíhá uvnitř svého uloženého pracovního prostoru a administrátora kontext.
Poslat žádost provider-native API
Použít konektor Native API Přečtěte si nebo potvrďte původní API Napište akci, pokud endpoint poskytovatele nemá žádnou kurátorskou akci. Kredity zůstávají uvnitř konektoru a jsou akceptovány pouze relativní cesty poskytovatele.
✅
Akce & Triggers stavitel, /api/v1.php, OpenAPI a Postman používají stejný ActionContractRegister, takže volitelná akce nemůže unášet z runtime dokumentace.
Vývojář
Kuchařská kuchařka Triggerů
Read-to-use spouštěcí-akční recepty pro běžné automatizace.
Jak to fungujeKuchařská kuchařka Triggerů
Automaticky vytvořit tiket z monitoringu
Scénář:
Monitoring system sends POST when server goes down.
Slack message every time a customer places an order over $100.
Co dělat:
Trigger: Event (order.completed)
Condition: order.amount > 100
Action: Send webhook to Slack incoming webhook URL with order details
Týdenní strávený email
Scénář:
Summary email to management every Monday at 9am.
Co dělat:
Trigger: Schedule (Monday 09:00)
Action: Send email with last week's stats pulled from the REST API
Escalete staale tickes
Scénář:
If a ticket has no reply for 24 hours, assign to team lead.
Co dělat:
Trigger: Schedule (every hour)
Condition: ticket.status = "Open" AND ticket.last_reply_age > 86400
Action: Assign to team-lead, add internal note
Vývojář
Stavím první akci
Tento průchod vytváří jednoduchou konektorovou akci od nuly.
Stavební akceVytvořte jednu akci od nuly. Pojmenujte ji, nastavit metodu a koncový bod, prohlásit zadané paramy, a otestovat ji na živý 200.
Dva druhy akcí
Než začnete, rozhodněte se, který z nich potřebujete. Oba jsou nakonfigurovány na stejné obrazovce.
Zavolejte externí API
Akce posílá HTTP požadavek na platformu. Vyberte si, když OpsIQ potřebuje oslovit a udělat něco na vaší straně.
Spustit činnost konektoru
Akce běží něco, co nainstalovaný konektor již poskytuje. Vyberte si, když práce je již k dispozici a chcete jen spustit. Vyberte činnost konektoru ze seznamu, takže není nic k protažení.
✅
Druhou možností je, jak znovu použít vše, co konektory mohou dělat, aniž by se něco z toho znovu: přečtěte si nit vstupenky, vyhledejte zákazníka, importovat kontakty, a tak dále. Vyberte si akci konektoru z dropdown a jste hotovi.
1
Plán akce
Example: "lookup_product". Look up a product by name, return price, stock, and description.
Three things that make an action fail to register at all. action_id is REQUIRED and must be 2 to 100 characters of lowercase letters, digits and underscores — an entry without one is rejected outright. The manifest is an object with an "actions" LIST, not a map keyed by action name. And response mapping is "returns" with DOTTED paths (data.id), not JSONPath ($.data.id) — there is no "response_mapping", "method", "endpoint" or "params" key anywhere in the registry.
3
Zkouška s suchým běhounem
Ve kroku Přezkoumání spojovacího zařízení stiskněte suchý běh. Spustí kompletní kontrolní seznam shody s vaším balíčkem a když jste dodali pověření, provede skutečný test připojení. Nepoužívá data vzorku.
4
Ověřit použití AI
Zeptejte se admin AI: "Vyhledat produkt Widget Pro." AI by měl najít a provést akci.
⚠️
Adding an action to actions.json does NOT create an AJAX route, so there is nothing to regenerate. Connector actions are synced into OpsIQ when the connector is enabled or its settings are saved: re-save the connector and the new action appears. tools/gen_route_registry.php covers the admin AJAX dispatch and has no bearing on connector actions.
Vývojář
Výstupní body události v rámci příchozího kurzu
Vstupní koncové body akceptují podepsané JSON z jiného systému a přemění jej na deduplikovanou kontaktní činnost, která může krmit časové linie, bodování a pracovní toky.
Produktová obrazovkaKaždý příchozí zdroj má svůj vlastní URL, tajný, mapovací a nedávný výsledek činnosti.
Vytvořit jeden zdroj na odesílací systém. OpsIQ generuje URL/ Token and secret. Odeslat JSON s Content-Type: application/json a podepište přesně syrové tělo pomocí HMAC-SHA256:
X-OpsIQ-Inbound-Signature: sha256=<hex hmac>
Mapa cesty JSON pro kontaktní e-mail, název události a volitelné ID události. ID události je preferovaným klíčem k duplikaci. Přijatá činnost vstupuje do časové osy kontaktu a může ovlivnit bodování olova, segmenty, pravidla životního cyklu a pracovní toky.
Zamítněte neplatné podpisy před rozesláním obchodních dat. Otočte tajemství aktualizací obou stran uvnitř kontrolovaného okna; nezaznamenávejte tajemství.
Vývojář
Operace s odchozím webhokem
Odchozí webhook administration vytváří podepsané předplatné, testuje koncové body a monitoruje asynchronní dodání a retry zdraví.
Produktová obrazovkaNa odchozí webhook stránce seznam HTTPS koncové body, předplatné událostí, zdraví dodávek a one-click podepsaný test.
Plných administrátorů vytvořit HTTPS koncový bod, vybrat konkrétní události nebo divokou kartu, ukládat tajemství bezpečně a poslat test. OpsIQ značí syrové užitečné zatížení s HMAC- SHA256:
X-OpsIQ-Signature: sha256=<hex hmac>
Ověřte podpis před odsterilizací nebo účinkem. Dodávka je asynchronní a automaticky znovu testována po přibližně 1Minuta. 5 minut, 30 minut,2hodiny a 12 hodiny. Použijte retent- delivery pro kontrolu stavu, kódu odezvy a pokus o počet.
Váš přijímač musí být idempotentní, protože jakýkoli asynchronní systém může obnovit. Vraťte odpověď 2xx pouze po trvalém přijetí.
Vývojář
Webhooky
Webové háčky dávají vnějšímu systému vědět OpsIQ když se něco stane, a pak to nech být.OpsIQ informovat vnější systémy, když se něco děje interně (odbourává).
WebhookySkutečný outlimit- webhanges obrazovka: každý koncový bod s jeho událostí, nedávné dodání zdraví, a one-click Odeslat test, podepsal a znovu vyzkoušel.
Výstupní webháky
Předplatné
Přejděte na Nastavení > Webháky. Přidejte koncový bod URL a vyberte události, které obdržíte.
Události
ticket.created, ticket.replied, chat.started, chat.message, order.completed, crm.deal.stage_changed, crm.contact.created, etc.
Znovu
Po 15 po sobě jdoucích selháních je koncový bod automaticky zakázán. The endpoint is auto-disabled.
Podpis
Každá žádost obsahuje podpis HMAC v X-OpsIQ- Podepiš to, vždycky to ověř.
Ochrana SSRF
OpsIQ neposílá se do soukromého / interního IPs (127.x, 10.x, 172.16.x, 192.168.x, 169.254.169.254).
Asynchronní doručování
Webháky jsou dodávány přes frontu pracovních míst, ne blokování OpsIQ operací.
Stálé ID události
Each event has a unique event_id that stays the same across retries for deduplication.
Použijte ngrok k odhalení místního serveru. Nastavte koncový bod webhooku na váš ngroku URL.
Co když je můj koncový bod dočasně dole?+
OpsIQ se retestuje s exponenciálním zpětným výpadkem. Pokud se váš cílový parametr v okně retry zotaví, žádné události se neztratí.
Vývojář
API klíče
API klávesy ověřují požadavky na OpsIQ REST API Každý klíč má prověřená oprávnění.
API klíčeSkutečný API klávesy: vydejte skenovaný, pouze pro čtení nebo omezený klíč výběrem přesných skoků a kdykoliv jej odebere.
Vytvoření klávesy API
1
Přejděte na Nastavení > API klávesy
Přechod na API správu klíčů.
2
Klikněte na Vytvořit klíč
Dej tomu popisné jméno.
3
Vybrat si skenery
Dejte klíč pouze to, co potřebuje. Scopes přijít do čtení a psát páry na oblast, takže reporting integrace může být udělena čtení a nic jiného.
Dostupné mikroskopy
Vyberte si nejtěsnější sadu, která dělá svou práci. admin splňuje každý rozsah níže, takže jej použijte pouze tehdy, když skutečně potřebujete široký přístup.
crm. read / crmm. write
Kontakty, společnosti, obchody, činnosti, segmenty, informační materiály, konverze, životní cyklus a CRM webháky.
tickets. read / tickets. write
Seznamte a přečtěte si tipy a jejich zprávy; odpověď, aktualizace, otevření a spuštění hromadné fronty operací.
conversations. read / conversetions. write
Přečtěte si konverzace a historii zpráv v životě, pošlete zprávy, přiřaďte a změňte stav.
kb. read / kb. write
Záznamy o znalostech.
chat. read / chat. write
Uložené šablony odpovědí.
connectors.read
Podívejte se, které konektory jsou instalovány, co mohou dělat, a otestujte jejich pověřovací listiny.
automations.read
Podívejte se na své činy, spouštěče a jejich historii.
departments.read
Departmenty jsou k dispozici pro směrování.
notifications.read
Oznámení pro jmenovaného operátora.
analytics.read
Zprávy sekce, CSV vývozy a termínované definice zpráv.
site_intelligence.read
Monetary a jejich zprávy SEO.
files.read
Podepsané odkazy ke stažení pro přílohy.
status.write
Status stránky komponenty a incidenty.
writing
Asistenti pro psaní AI: návrh, shrnutí, překlad, přepis, kompostování, analýza.
admin
Vše, včetně malého počtu citlivých akcí, které nejsou záměrně dosažitelné žádným úzkým rozsahem: vymazání kontaktu, změna nastavení soukromí a čtení přístupového záznamu.
💡
Zavolejte meta. actions s klíčem, abyste viděli, které akce mohou být spuštěny na vaší instalaci. To je vždy spolehlivější než práce ze seznamu.
Úroveň přístupu
Všechny
Klíč může nazvat cokoliv, co jeho skenery dovolí.
Pouze pro čtení
Každý zápis je odmítnut, ať už to říkají mikroskopy, nejbezpečnější volba pro hlášení, palubní desky a cokoliv, co by nikdy nemělo měnit data.
Omezeno
Vydáte seznam přesně akcí, které klíč může vyvolat. Cokoliv jiného je odmítnuto, i v povoleném rozsahu.
4
Kopírovat klíč
Jednou se zobrazí. Začíná s "opq _". Uložit bezpečně.
🚫
Nikdy nesdílet API klíče ve veřejném zákoníku, klient- side JavaScript, nebo ovládání verze. Použijte proměnné prostředí.
Vývojář
Připojte své webové stránky
U OpsIQ Widget je JavaScript Snippet přidáte na své webové stránky pro sledování, AI chat, vytvoření vstupenek a identifikaci zákazníka.
Ne, pod 15 KB GZP se načítá async po obsahu stránky.
Můžu upravit vzhled?+
Použijte barvu dat pro primární barvu. Kontaktní podpora pro možnosti přepínání CSS.
Vývojář
Widget install recepty
Návody pro instalaci podle platform- specific.
Jak to fungujeInstalovat recepty
WordPress
Scénář:
Add to all pages of a WordPress site.
Co dělat:
Option 1: Edit theme footer.php, paste snippet before </body>.
Option 2: Use "Insert Headers and Footers" plugin > Scripts in Footer.
Option 3: Use a child theme footer.php to survive theme updates.
Shopify
Scénář:
Add to your Shopify store.
Co dělat:
Online Store > Themes > Edit Code > Layout > theme.liquid. Paste before </body>. Save.
Reagovat / Next. js
Scénář:
Add to a React or Next.js app.
Co dělat:
In Next.js, use next/script in app/layout.tsx:
import Script from "next/script";
<Script src="https://your-opsiq.com/widget.php" data-site-key="site_abc" strategy="lazyOnload" />
WHMCS
Scénář:
Add to your WHMCS client area.
Co dělat:
Nastavení > Obecná nastavení > Ostatní > Globální obsah Footer. Vložte odstřižek. Nebo upravte šablonu foter. tpl. @ info: whatsthis
Google Tag Manager
Scénář:
Add via GTM.
Co dělat:
Vytvořit vlastní HTML tag, pasta snippet. Trigger: Všechny stránky. Publikovat.
Vývojář
Admin widget v pozadí (jedna smlouva, jakékoliv platforma)
Embed the OpsIQ admin assistant — admin chat, ticket inbox and AI Writing — inside YOUR OWN platform's admin panel, so your team never leaves their tools. Like visitor identity and portal SSO, this is ONE generic contract implemented in ~15 lines of your platform's server code — the same pattern Zendesk, Intercom and Discourse use for SSO. There is no per-platform plugin to wait for: any stack that can compute an HMAC can do this today.
Krok 1 - vložka
Od Vzdálené stránky→Vaše stránky→Kódy, zkopírujte nakladač řádek a přidejte jej na stránky admin panel (footer včetně, rozložení šablonu, nebo admin- pouze vlastní-JS box):
Krok2- ŘekniOpsIQkdo je přihlášen (server- signed)
Pouze Vaše aplikace ví, který admin je přihlášen- to není nedostatek, je to bezpečnostní model. Váš server generuje krátký-žil podepsaný token z vašeho vlastního zasedání, přesně jako návštěvník Token identity, podepsaný se stejným webhook tajemství stránky:
PHP · podepsat admin identitu z vašeho relace
<?php
$secret = "opsiq_whsec_your_site_secret"; // Remote Sites → Codes
$payload = json_encode([
"site_key" => "SITE_KEY",
"iat" => time(),
"exp" => time() + 6 * 3600,
"authenticated" => true, // REQUIRED, top level — see note below
"platform" => "your-platform",
"admin" => [
"id" => (string)$admin->id, // from YOUR session
"name" => $admin->name,
"username" => $admin->username,
"email" => $admin->email,
"role" => $admin->role,
"authenticated" => true,
],
]);
$payload64 = rtrim(strtr(base64_encode($payload), "+/", "-_"), "=");
$identityToken = $payload64 . "." . hash_hmac("sha256", $payload64, $secret);
// Put $identityToken into the embed line (identity_token=…), or expose it as
// window.OpsIQAdminIdentityToken before the loader script.
Per- admin přístup, automaticky
Každý admin, který se přihlásí do vaší platformy, je zarovnán individuálně:OpsIQPer- admin přístupová brána řeší token uživatelské jméno + email proti jednéOpsIQagent (týmová stránka; použijte seznam agentových "six e-mailů", když se platforma emaily liší) a použije pracovní prostor, oddělení a inbox oprávnění That agenta. Nový zaměstnanec = přidat agenta vOpsIQŽádné změny.
Roles ride along
Jakýkoliv řetězec rolí, který vám platforma pošle, je zobrazen na webuOpsIQstrana pro přiřazení; autorizace vždy pochází zOpsIQZáznamy agentů, nikdy z prokázané role.
Proč si nepřečtete naše přihlašovací cookie?
Prohlížeči nikdy neposílají admin cookie do jiného původu - žádný prodejce nemůže "jen detekovat" váš přihlašovací cross- domain. Každý seriózní produkt řeší to stejným způsobem: váš server se udává, podepisuje. To je celá smlouva.
Jednoduchý režim (jednoadmin obchody)
Skip step 2 and use the static token from Remote Sites → Codes in the loader line (token=… instead of identity_token=…). The widget works with the workspace's shared identity; the per-admin gate can stay enforced later when the team grows.
V authenticated vlajka - dát ji na TOP úrovni
Tato vlajka je vaše server tvrzení, že člověk je opravdu přihlášen, a OpsIQ odmítá jakékoli žeton bez něj. "authenticated" => true beside site_key/iat/exp, Ne pouze uvnitř admin objekt. Aktuální OpsIQ přijímá buď v jedné pozici, ale starší verze pouze číst nejvyšší úroveň - a selhání je klamavé: seznam konverzace, historie a nepřečteno všechny ověřené v pořádku, zatímco každý chat obrátit odpovědi "Admin přihlášení potřebné", který vypadá jako relace chyba a není. Pokud vidíte přesně to rozdělení, zkontrolujte tuto vlajku první.
Tokenova hygiena
Přihlásit se pouze na serveru, nikdy v prohlížečiJavaScript. Udržujte exp krátké (minuty až hodiny);OpsIQodmítnutí vypršela a future- dated žetony, a podpis váže token na váš klíč.
Referenční provádění
The WHMCS module does this automatically from the WHMCS admin session; the Botble Hotel connector's bridge file does it from the Laravel session (op=admin_identity). Both are just this contract in their platform's dialect — copy whichever reads closest to your stack.
Dezstránková elektroinstalace (sonda s konektorem)
Když váš konektor OpsIQ uloží cílový parametr identity ve svém admin_identity_probe_url nastavení, linka plnicí plošiny PLAIN je vše, co potřebujete admin stránky: widget objeví sondu z konektoru, nazývá ji klávesou webu + widget token, a ověřuje každý admin automaticky. Stránka může stále přepsat s data-identity-endpoint atribut nebo window.OpsIQAdminIdentityEndpoint.
Zavedení cílového parametru identity na Laravel (hard-won notes)
Pokud je platforma Laravel (Botble, Bagisto, vlastní aplikace) a váš koncový bod je samostatný soubor, který boty rámec pro čtení logged- in admin, tři specifika ušetří vám hodiny - každý z nich produktivní selhání před tím, než se to naučil:
Připojit žádost před bootstrap
Vaši poskytovatelé služeb mohou vyřešit request z kontejneru během zavazadlového prostoru. Laravel vlastní životní cyklus váže zachycený požadavek první věc uvnitř Kernel::handle() - zrcadlem tohoto pořadí: $app->instance('request', Request::capture()) PŘED $kernel->bootstrap()Nebo dostaneš "Cílová třída [žádost] neexistuje".
Předpona session-cookie jeHMAC-Keyed
Moderní Laravel předpovídá hodnoty cookie pomocí HMAC vypočteného pomocí APP Key (CookieValuePrefix) - a plain sha1(name."v2") Nikdy se to nedá srovnat. CookieValuePrefix::validate($name, $decrypted, $keys), se strukturálním zápěstím (40 hex chars + | v pozici40). Tell: relace id delší než40CHARS (81= prefix stále připojený) a relace, která se zatíží pouze _token V něm.
Kde se přihlašovatel nacházel
Razítko je login_<guard>_<sha1(guard class)> - pro výchozí webový kryt: 'login_web_' . sha1(Illuminate\Auth\SessionGuard::class). Proskenujte jakékoliv login_* Číselný klíč jako záloha pro vlastní stráže.
Debug jako most dělá
Loď a debug=1 režim, který označuje selhání STEP a výjimku - slepou chytač- všichni udělali živé nasazení nediagnostikovatelné. Botble most (od v1.0.7) je referenční: krokové značky na jádru / vázání / bootstrap / dešifrování / session / auth / db.
Widget se nikdy neobjeví, konzole říká "je vyžadován podepsaný admin identifikátor"
Váš cílový parametr se vrátil ne identity_token. Otevřete cílový parametr URL přímo v prohlížeči logged- v admin &debug=1 - uvidíte chybný krok. Na Laravel je to téměř vždy request- binding nebo cookie- prefix položka výše.
Historie a konverzace fungují, ale každý rozhovor říká "Admin přihlášení potřebné"
Klasický rozchod. Váš symbol chybí TOP- ÚROVEŇ authenticated flag - widget vlastní endpoint přijímá token, sdílený ověřovatel za chatovým proudem jej odmítá. Přidat "authenticated" => true beside exp.
"admin není upraven v OpsIQ" (HTTP 401)
The token verified, but its username + email match no OpsIQ agent. Add the agent in OpsIQ → Team, or add the platform email to that agent's match-emails list when it differs from their OpsIQ email.
Vše 403s z prohlížeče, ale pracuje s curl
Předlet CORS odmítá jeden z vašich titulků požadavku. Váš koncový bod musí odpovědět OPTIONS a echo žádající původ, nebo jednoduše vyhnout vlastní hlavičky - widget potřebuje pouze cookie.
Pracoval včera, dnes selhal.
Kontrola exp: tokens jsou krátké-žil podle návrhu. Widget re- sondy automaticky, takže to obvykle znamená, že koncový bod přestal vidět relaci - rotace klávesy aplikace, session-driver změna, nebo cookie- doména změna.
💡
Admin widget se skryje, dokud identita nevyřeší, a každý chat / inbox / data volání je vynucen serverside proti shodnéOpsIQagent bez ohledu na cokoliv stránka tvrdí. Token odemyká UI; oprávnění vždy pochází zOpsIQ.
Vývojář
Totožnost návštěvníka
Identita spojuje anonymní návštěvníky se známými zákazníky. Po identifikaci, OpsIQ odkazy prohledávání historie, chaty a vstupenky na profil zákazníka.
Jak to fungujeTotožnost návštěvníka
Dvě úrovně identity, a když je každý stačí
Úroveň 1 - neznačená nápověda
Řekni tomu widgetovi, kdo je ten návštěvník s plání.JavaScriptobjekt. Vyplňuje email a zákaznický ID v záznamu návštěvníků, takže vaše palubní deska ukazuje signed- v provozu a sessions připojit. Jedná se o HINT: každý může editovat ve svém prohlížeči, takžeOpsIQnikdy nezveřejňuje data o síle účtu.
Úroveň 2 - znaménko totožnosti
Váš server podepisuje krátkosrstý token s webhokem na webu tajemství. OpsIQ ověřuje podpis a teprve pak zachází s osobou jako osvědčený zákazník. To je úroveň, která odemyká odpovědi na účet v chatu zákazníka a vyhledávání konektorů. Použijte ji pro cokoliv cizí nesmí vidět.
⚠️
Úroveň1je zobrazení pohodlí. Úroveň2je autentizace. Pokud lze na otázku odpovědět pouze pro skutečného držitele účtu, potřebujete Úroveň2.
Úroveň 1 - nesignalizovaná nápověda
Nastavte objekt před skriptem widget, nebo zavolejte identifikovat () později, jakmile vaše aplikace bude vědět, kdo je přihlášený. Oba formuláře jsou čteny; použijte podle toho, co odpovídá vaší stránce.
JavaScript · obě podporované formy
<!-- Form A: set the global before the loader -->
<script>
window.OpsIQClient = {
id: "cust_1001",
email: "[email protected]",
name: "Jane Smith",
plan: "pro"
};
</script>
<script async src="https://YOUR-OPSIQ/widget.php?site_key=YOUR_SITE_KEY"></script>
<!-- Form B: identify later, e.g. after a client-side login -->
<script>
window.opsiq.identify({
id: "cust_1001",
email: "[email protected]",
name: "Jane Smith",
plan: "pro"
});
</script>
⚠️
Only these forms are read: the window.OpsIQClient global, window.opsiqConfig.user, and window.opsiq.identify(). There is no OpsIQ.push(['identify', ...]) queue and no OpsIQClientSignature global — if you find either in an old note, it does nothing.
Úroveň 2 - ukazatel totožnosti podepsaný serverem
Přesně stejný token smlouva jako admin widget, s customer předmět namísto admin 1. Podepište to na serveru a pošlete do widgetu. Dva podrobnosti rozhodnou, zda se potvrdí, a oba jsou snadno dostat špatně:
UHMACpokrývá BASE64URL řetězec, neJSON
Podpis $payload64, ne $payload. Podpis syrového JSON produkuje symbol, který vypadá správně a je odmítnut pokaždé s podpisem nesoulad.
base64url, unpaddined
Přeložit +/ do -_ a svléknout = padding. Plain base64 náhodou přežít dnes; base64url je smlouva a je to, co každý OpsIQ ověřovatel a referenční konektor emituje.
ověřené je na úrovni TOP
Beside site_key, iat a expJe to vaše tvrzení, že skutečný člověk je přihlášena, a OpsIQ odmítá token bez něj.
customer. id je povinný
Token s emailem se ověřuje jako podpis a pak je tiše upuštěn. Vždy pošlete ID.
Udržujte exp krátký
Zápis z několika minut do hodin, je to tvrzení, ne oprávněný.
PHP - podepište symbol identity zákazníka (tento přesný kód ověřuje)
<?php
/* Server-signed customer identity. Runnable as-is: set the two constants. */
$siteKey = "YOUR_SITE_KEY"; // Remote Sites -> Codes
$secret = "opsiq_whsec_your_site_secret"; // Remote Sites -> Codes
$payload = json_encode([
"site_key" => $siteKey,
"iat" => time(),
"exp" => time() + 3600,
"authenticated" => true, // TOP LEVEL - required
"platform" => "your-platform",
"customer" => [
"id" => (string)$user->id, // REQUIRED
"email" => (string)$user->email, // REQUIRED
"name" => (string)$user->name,
"plan" => (string)($user->plan ?? ""),
"authenticated" => true,
],
], JSON_UNESCAPED_SLASHES);
/* base64url(payload) . "." . hex HMAC-SHA256 OF THAT STRING. */
$payload64 = rtrim(strtr(base64_encode($payload), "+/", "-_"), "=");
$token = $payload64 . "." . hash_hmac("sha256", $payload64, $secret);
/* Hand it to the widget either way: */
printf(
'<script async src="https://YOUR-OPSIQ/widget.php?site_key=%s&identity_token=%s"></script>',
rawurlencode($siteKey),
rawurlencode($token)
);
// or, if the loader is already on the page:
// echo '<script>window.opsiqConfig = window.opsiqConfig || {}; '
// . 'window.opsiqConfig.identityToken = ' . json_encode($token) . ';</script>';
🚫
Přihlásit se pouze na serveru. Token vyražený v prohlížeči JavaScript znamená předávat stránky tajemství každému návštěvníkovi, který dává komukoliv možnost vydávat se za jakéhokoliv zákazníka.
Stejná smlouva, tři povrchy.
Zákaznický chat na vašich stránkách
customer subject, passed as identity_token to widget.php. Covered above.
Admin chat uvnitř vašeho backendu
admin subject, passed to opsiq/embed/admin_widget.php. Same signer, different subject key. See "Admin widget in your backend".
Podpora hlubokých odkazů portálu
A stricter variant: the same claims plus jti and single_use:true, and a 120-second life, because the token travels in a URL and must be spendable once. Do not hand-roll it. Settings, Support Portal has a ready snippet for your language, and the platform mints it for you when your account area runs on this server.
Co když návštěvník vyčistí sušenky?+
Stávají se anonymními, dokud nejsou znovu identifikovány. OpsIQ spojuje nový anonymní záznam s profilem zákazníka v okamžiku, kdy narážka nebo token dorazí.
Proč můj token potvrzuje záznam návštěvníků, ale ne otázky na účet?+
To je úroveň1/ Úroveň2split. Nepodepsaná nápověda vyplní záznam návštěvníků a nic jiného. Odpovědi na účet potřebují ověřený podpis.
Vývojář
Moduly a SDK
OpsIQ poskytuje SDK balíčky a pluginy pro společné platformy.
Jak to fungujeModuly a SDKs
PHP SDK
Balíček skladatelů: Token identity generování, akce API helpers, ověření podpisu webháku.
JavaScript SDK
Browser- side: sledování, identita, vlastní akce, chat control.
WordPressplugin
Widget injekce, identita z WP uživatelských sessions, WooCommerce synchronizace.
Modul WHMCS
Plné integrace: widget, relé vstupenek, identity, admin AI.
Prodloužení tématu Shopify
Aplikace vložená s automatickou identitou zákazníka.
Survey Studio je určen pro použití stejného typu General API, interní exekutor, event bus a webhook operace jako zbytek OpsIQ. To umožňuje vývojářům integrovat konec až konec bez budování baleného konektoru.
⚠️
Stav realizace: pouze živý katalog platform.get.survey.config a platform.save.survey.config. The surveys.* a feedback.* níže uvedené rodiny jsou schválenou cílovou smlouvou a musí se vrátit unknown_action až do registrace.
Cílové akční rodiny
Typy, šablony a rychlé spuštění
surveys.types.*, surveys.templates.* a surveys.quick_launch.* seznam, náhled, ustrnout a potvrdit kompletní startéry.
Průzkumy a verze
surveys.create|get|list|update|archive|duplicate plus neměnná verze, validace a zveřejnění akcí.
Rozmístění a cílení
surveys.deployments.*, surveys.links.*, surveys.audiences.*, surveys.triggers.* a surveys.variables.*.
Informace a odpovědi
surveys.invitations.*, surveys.campaigns.*, surveys.recipients.*, surveys.responses.*, vývoz, reakční a analytická opatření.
Webové háky, import a zpětná vazba
surveys.webhooks.*, surveys.imports.*, feedback.items.*, feedback.analytics.*, feedback.sources.* a feedback.analysis.*.
Propojovací-volný průtok
1
Vytvořit a zveřejnit prostřednictvím General API
* akce s workspace- prised klíčem. Spisy deklarují povolení, riziko, potvrzení, idempotenci a suchozemské chování.
2
Přijmout svou obchodní událost
Odeslat podepsanou událost na přilétající webhook, např. zrušení objednávky nebo dokončeno po nástupu.
3
Mapovat v akcích & Triggers
Vyberte si OpsIQ Obecné API akce, jako je vydání pozvánky na průzkum nebo příprava kampaně, poté mapy polí z ověřeného spouštěcího užitečného zatížení.
4
Přihlásit se k událostem průzkumu
* životní cyklus podmnožiny do vašeho cílového parametru s podpisem, filtrem, retry, logem a autorizovaným přehráváním.
Cílový kanonický jev
Sdílený katalog bude zahrnovat průzkum / nasazení publikovat stav, publikum a spouštěcí rozhodnutí, pozvánky, vykreslování / start / parciální / resume / complete / leave, odezvu na změny stavu kampaně a selhání dodávek. Vysokoobjemové zaměření, posun a čas otázky pobyt v úložišti Průzkumné analýzy, pokud není výslovně zdokumentováno pro fan- out.
✅
Konektor je volitelný. Přidává opakovaně použitelné nálezné platformy, ověřenou identitu, fakta, proměnné a výčet příjemců. General API plus Akce & Triggers / Webové háčky zůstává kompletní integrační cestou pro vývojáře, kteří nepotřebují balený konektor.
Vývojář
REST API
U OpsIQ REST API umožňuje programově přístup ke všem funkcím platformy.
Jak to fungujeREST API
Formát žádosti
Poslat klíč jako Authorization: Bearer opq_... nebo X-OpsIQ-Key: opq_...Použijte jednu autentizační hlavičku, ne obojí.
Formát žádosti API
POST https://your-opsiq-domain.com/api/v1.php
Authorization: Bearer opq_your_api_key
# Alternative header: X-OpsIQ-Key: opq_your_api_key
Content-Type: application/json
{
"action": "endpoint.name",
"site_key": "site_abc123"
}
Společná akce
API je založena na činnosti: poslat action jméno v těle. Každý registrovaný správce JSON operace má stabilní název akce. POST {"action":"meta.actions"} (není vyžadován žádný klíč) pro autoritativní, per- install seznam, žádost o smlouvu, metadata rizika a rozsah. platform.routes.* Most zůstává pouze pro starší integraci.
crm.contacts.list
Seznam CRM kontaktů (rozsah crm. read). Params: q, status, source, tag, olovo skóre, limit.
crm.contacts.upsert
Resolve- or- vytvořit kontakt (rozsah crm. write). Params: email plus pole, tagy, poznámky.
One conversation and its messages (scope conversations.read). Params: conversation_id or thread_key, include_messages.
conversations.messages
Paged message history (scope conversations.read). Params: conversation_id, page, per_page, include_internal.
conversations.send
Send a message into a conversation (scope conversations.write). Params: conversation_id, message, sender_type, internal.
conversations.update
Assign, re-status or re-title a conversation (scope conversations.write). Params: conversation_id, status, assigned_admin_id, subject.
Connectors. list / . get / . test
Podívejte se, které konektory jsou instalovány, co každý z nich může dělat, a zda jeho pověření funguje (rozsah connectors. read).
automations.actions.list
Akce, které bude vaše akce stavitel provozovat (rozsah automaticky. read).
automations.triggers.list
Co bude střílet a za jakých podmínek (rozsah automatických. read).
automations.runs.list
Execution history for debugging an integration (scope automations.read). Params: status, action_key.
departments.list
Odbory, do kterých můžete přesměrovat jízdenku (rozsah repartments. read).
notifications.list
Notifications for one operator (scope notifications.read). Params: admin_id (required), unread_only.
analytics.export
Sekce zprávy jako CSV (rozsah analytics. read). Params: sekce, přednastaveno, od, do. Call analyticks. sections. seznam platných hodnot.
site_intelligence.sites.list / .reports.list
Monitored sites and their SEO reports (scope site_intelligence.read).
files.get
Short- live podepsaný odkaz ke stažení pro přílohu (rozsah files. read). Params: reference, ttl.
security.check
Zeptejte se, zda IP nebo e-mail je blokován nebo podezřelý zde (rozsah security.read). Kombinuje IP firewall, blocklist vstupenek a cached Security AI verdikt. ip, e-mail.
security.report
Hlášení zneužití váš systém pozorovaný (rozsah security. write). Nahráno jako bezpečnostní událost, klasifikované bezpečnostní AI okamžitě, a administrátoři jsou upozorněny na high-riziko verdicts. Params: ip, e-mail, druh, důvod, zdroj.
Security. blocklist. add / . list
Manage the spam rules the ticket pipeline enforces (scope security.write / security.read). Same store as the Tickets page "Block sender" control. Params: kind (email, domain, ip), value, reason, expires_hours.
💡
meta. actions je vždy autoritativní. Vrací každou akci, která je k dispozici na vaší instalaci s rozsahem, který každý potřebuje, takže nikdy nemusíte hádat nebo zakódovat tento seznam.
Sběr, filtrování a třídění
Každá akce v seznamu používá stejné parametry, takže se je naučíte jednou.
page / per_page
Číslo stránky začínající na 1, a velikost stránky. Výchozí 50, maximálně 200. limit a offset jsou také přijímány, pokud dáváte přednost jim.
seřazeno / pořadí
Pole třídit podle, a asc nebo desc (výchozí desk). Každá akce přijímá pevný soubor druhů polí; vše ostatní je ignorováno spíše než chybování.
filters
Odeslat filtry jako objekt, nebo předat filtr jako parametr úrovně top- level. Neznámé filtry jsou ignorovány.
Co se vrátí
items, page, per_page, count, total and has_more. Keep requesting pages until has_more is false.
Nebyl odeslán žádný klíč, nebo je špatně nebo vypršela. HTTP 401.
missing_scope
Klíč je platný, ale postrádá rozsah této akce potřebuje. HTTP 403.
read_only_key / action_restricted
Klíčem je pouze pro čtení, nebo tato akce není v jeho povoleném seznamu. HTTP 403.
unknown_action
Žádné takové akce. Volejte meta. acces pro aktuální seznam. HTTP 400.
missing_parameter / invalid_parameter
Vyžadovaný parametr chybí, nebo není hodnota přijata. HTTP 400.
not_found
Záznam neexistuje, nebo není v pracovním prostoru tento klíč vidět. HTTP 404.
rate_limited
Hodinové omezení tohoto klíče je využito. HTTP 429.
server_error
Something failed on our side. The request_id identifies the attempt if you need to report it. HTTP 500.
Bezpečné retry
Pokud se píše timesy ven nemůžete říct, zda to přistálo. idempotency_key a opakování stejného hovoru vrací původní výsledek místo toho, aby se práce dvakrát.
Idempotentní zápis
{
"action": "tickets.reply",
"ticket_id": 4192,
"body": "Thanks, that is now fixed.",
"idempotency_key": "your-unique-id-for-this-attempt"
}
Jak dlouho to trvá
Klíč je zapamatován pro 24 hodiny proti stejné akci a API Klíč.
Co dostaneš zpátky
The original response, plus idempotent_replay: true so you can tell it was a replay.
Nevýhodě zůstávají vymahatelné.
Zapamatování si zapamatujte pouze úspěšných zápisů. Pokud se hovor nezdařil, odeslání je opět s stejným klíčem, což je to, co chcete.
Čtenky
Čtení ignoruje klíč, opakování čtení je neškodné.
Test bez změny
Přidat dry_run: true Váš klíč, mikroskopy a parametry jsou kontrolovány přesně tak, jak je obvyklé, pak se hovor zastaví, než bude něco vytvořeno nebo změněno.
Suchý běh: bezpečně ověřte průkaznost a užitečné zatížení
{
"action": "tickets.update",
"ticket_id": 4192,
"status": "closed",
"dry_run": true
}
{
"success": true,
"dry_run": true,
"would_execute": true,
"message": "Authorised and validated. No write was performed because dry_run was set."
}
✅
Use dry_run while you are building. It is the quickest way to confirm a key has the right scopes and your payload is shaped correctly, without creating test data you then have to clean up.
Mezní hodnoty sazeb
Mezní hodnota per- key
Konfigurovatelný hodinový limit na API klíč (výchozí 1000 požadavky za hodinu). Nastavte jej na klíč pod Nastavení,API Klíče.
Při překročení
HTTP 429 with code rate_limited, plus a Retry-After header telling you how many seconds to wait. The limit resets at the top of the next clock hour.
Vědět, kde stojíš.
Každá odpověď nese X- RateLimit -Limit, X- RAteLimit-Resistující a X- rateLimis-Reset (Unix timestamp). Sledujte Zbývající a zpomalit, než vyběhnete spíše než čekat na odmítnutí.
Vyprávění 429 od 401
A 429 znamená počkat a zkusit to znovu. 401 znamená, že samotný klíč je chybný nebo prošlý, takže opětovné zkoušení nepomůže, dokud klíč nespravíte.
Preauth brute- silent guard
Opakované pokusy o selhání - auth od jednoho IP jsou řešeny odděleně. Platné klíče nikdy zakopnout to.
Nejlepší praxe
Stáhněte se, když Zbývající klesne, a ctít Retry- Po 429 místo aby se znovu okamžitě.
Verze a stabilita
Aktuální verze
v1. Každá odpověď nese X -OpsIQ-API-Verze a X...OpsIQ-API-Stav, abyste si mohli potvrdit, s čím mluvíte.
Jak budete varováni
If a version is ever retired, responses gain standard Deprecation and Sunset headers, and meta.actions reports deprecated and sunset_at. Check those in your monitoring and you will never be surprised.
Co se nezmění
Stávající názvy akcí, jejich parametry a kódy jejich chyb. Nová opatření a nová volitelná pole mohou být přidány kdykoli, takže ignorujte pole, která nepoznáváte, spíše než je nedáte do selhání.
Kompletní integrace, začít dokončit
Tohle je celá smyčka: najdi práci, přečti si ji, jednej na ní a potvrď, co jsi udělal.
Plný pracovní tok vstupenek přes API
# 1. Discover what this install offers and what each action needs.
POST /api/v1.php
{"action":"meta.actions"}
# 2. Find the urgent open tickets.
POST /api/v1.php
Authorization: Bearer opq_your_api_key
{"action":"tickets.list","status":"open","priority":"urgent","per_page":25}
# 3. Read one, including its conversation history.
{"action":"tickets.get","ticket_id":4192}
# 4. Reply, safely enough to retry if the network drops.
{"action":"tickets.reply","ticket_id":4192,
"body":"We have issued the refund.","idempotency_key":"reply-4192-attempt-1"}
# 5. Close it.
{"action":"tickets.update","ticket_id":4192,"status":"closed"}
# 6. Page through anything larger: keep going until has_more is false.
{"action":"tickets.list","page":2,"per_page":50}
💡
Vše výše funguje stejně pro konverzace: conversations. list, conversetions. get, convertions. send a converzations. update sledovat stejný vzor, parametry a tvar odezvy.
Každá akce, s rozsahem, který potřebuje
Tento seznam je generován z běžícího katalogu, takže vždy odpovídá verzi, na které jste. meta.actions vrací stejné informace jako JSON.
✅
1744 named actions: 587 reads, 1157 writes and 62 scopes. Every registered administrator JSON operation has a stable named action. OpenAPI: /api/v1/openapi.php. Postman: /api/v1/postman.php. Contract quality: declared_dynamic: 390; explicit: 92; route_inferred: 1146; source_inferred: 116.
Read. Scope: crm.read. Contract: source_inferred. Crm Workflows List
crm.workflows.save
Write. Scope: crm.write. Contract: source_inferred. Crm Workflows Save Retry-safe with idempotency_key.
zákazníci (44)
customers.analyze
Write. Scope: customers.write, journey.write, admin. Contract: explicit. Analyze a customer journey with AI Required fields: client_id. Retry-safe with idempotency_key.
Write. Scope: security.write, admin. Contract: route_inferred. Security Ai Analyze
security.ai.ask
Write. Scope: security.write, admin. Contract: route_inferred. Security Ai Ask
security.ai.briefs
Read. Scope: security.read, admin. Contract: declared_dynamic. Security Ai Briefs
security.ai.chain.explain
Read. Scope: security.read, admin. Contract: route_inferred. Security Ai Chain Explain
security.ai.incident.action
Write. Scope: security.write, admin. Contract: route_inferred. Security Ai Incident Action
security.ai.incidents
Read. Scope: security.read, admin. Contract: route_inferred. Security Ai Incidents
security.ai.js.triage
Read. Scope: security.read, admin. Contract: route_inferred. Security Ai Js Triage
security.ai.policies
Read. Scope: security.read, admin. Contract: declared_dynamic. Security Ai Policies
security.ai.policy.action
Write. Scope: security.write, admin. Contract: route_inferred. Security Ai Policy Action
security.ai.verdicts
Read. Scope: security.read, admin. Contract: route_inferred. Security Ai Verdicts
security.blocklist.add
Write. Scope: security.write, admin. Contract: source_inferred. Add a spam rule (email, domain or IP) to the ticket blocklist Required fields: kind, value. Retry-safe with idempotency_key.
security.blocklist.list
Read. Scope: security.read, admin. Contract: explicit. List the current ticket spam rules
Write. Scope: site_intelligence.write, admin. Contract: route_inferred. Si Speed V2 Collect
site_intelligence.speed.v2.read
Write. Scope: site_intelligence.write, admin. Contract: route_inferred. Si Speed V2 Read
site_intelligence.speed.v2.run
Write. Scope: site_intelligence.write, admin. Contract: route_inferred. Si Speed V2 Run
site_intelligence.start.crawl
Write. Scope: site_intelligence.write, admin. Contract: route_inferred. Si Start Crawl
site_intelligence.task.approve
Write. Scope: site_intelligence.write, admin. Contract: route_inferred. Si Task Approve
site_intelligence.task.assign
Write. Scope: site_intelligence.write, admin. Contract: route_inferred. Si Task Assign
site_intelligence.task.bulk.apply
Write. Scope: site_intelligence.write, admin. Contract: route_inferred. Si Task Bulk Apply
site_intelligence.task.bulk.assign
Write. Scope: site_intelligence.write, admin. Contract: route_inferred. Si Task Bulk Assign
site_intelligence.task.bulk.deadline
Write. Scope: site_intelligence.write, admin. Contract: route_inferred. Si Task Bulk Deadline
site_intelligence.task.bulk.dismiss
Write. Scope: site_intelligence.write, admin. Contract: route_inferred. Si Task Bulk Dismiss
site_intelligence.task.deadline
Write. Scope: site_intelligence.write, admin. Contract: route_inferred. Si Task Deadline
site_intelligence.task.note
Write. Scope: site_intelligence.write, admin. Contract: route_inferred. Si Task Note
site_intelligence.task.proof
Write. Scope: site_intelligence.write, admin. Contract: route_inferred. Si Task Proof
site_intelligence.task.reject
Write. Scope: site_intelligence.write, admin. Contract: route_inferred. Si Task Reject
site_intelligence.task.review
Write. Scope: site_intelligence.write, admin. Contract: route_inferred. Si Task Review
site_intelligence.topical.map
Write. Scope: site_intelligence.write, admin. Contract: route_inferred. Si Topical Map
site_intelligence.webhook.delete
Write. Scope: site_intelligence.write, admin. Contract: route_inferred. Si Webhook Delete
site_intelligence.webhook.save
Write. Scope: site_intelligence.write, admin. Contract: route_inferred. Si Webhook Save
site_intelligence.webhooks.list
Write. Scope: site_intelligence.write, admin. Contract: route_inferred. Si Webhooks List
site_intelligence.workflow
Write. Scope: site_intelligence.write, admin. Contract: route_inferred. Si Workflow
Stav (6)
status.component.save
Write. Scope: status.write, admin. Contract: declared_dynamic. Status Component Save
status.components.save
Write. Scope: status.write, admin. Contract: explicit. Create or update a public status component Required fields: name. Retry-safe with idempotency_key.
status.incident.create
Write. Scope: status.write, admin. Contract: declared_dynamic. Status Incident Create
status.incident.resolve
Read. Scope: status.read, admin. Contract: route_inferred. Status Incident Resolve
status.incidents.create
Write. Scope: status.write, admin. Contract: explicit. Create a status-page incident Required fields: title. Retry-safe with idempotency_key.
status.incidents.resolve
Write. Scope: status.write, admin. Contract: source_inferred. Status Incidents Resolve Retry-safe with idempotency_key.
průzkumy (22)
surveys.analytics.get
Read. Scope: surveys.read, admin. Contract: source_inferred. Surveys Analytics Get
surveys.audiences.list
Read. Scope: surveys.read, admin. Contract: explicit. List survey audiences
Write. Scope: tickets.write, admin. Contract: source_inferred. Update a ticket status, priority, subject, department or assignment Retry-safe with idempotency_key.
Write. Scope: writing. Contract: source_inferred. Writing Analyze Retry-safe with idempotency_key.
writing.compose
Write. Scope: writing. Contract: source_inferred. Writing Compose Retry-safe with idempotency_key.
writing.reply
Write. Scope: writing. Contract: source_inferred. Writing Reply Retry-safe with idempotency_key.
writing.rewrite
Write. Scope: writing. Contract: source_inferred. Writing Rewrite Retry-safe with idempotency_key.
writing.summarize
Write. Scope: writing. Contract: source_inferred. Writing Summarize Retry-safe with idempotency_key.
writing.translate
Write. Scope: writing. Contract: source_inferred. Writing Translate Retry-safe with idempotency_key.
Jsou OpenAPI a Pošťák k dispozici?+
Ano. Vygenerovaný OpenAPI 3.0 Doklad je na /api/v1/openapi.php, generovaná sbírka Postman je na /api/v1/postman.php, a lidsky čitelné developerské dokumenty jsou na /api/docs/.
Jak mohu pracovat s více než jedním pracovním prostorem?+
Send site_key in the request body to choose a workspace. A key issued for one workspace stays pinned to it; a key with admin context can select any workspace it is permitted to see, and is refused for any it is not.
Které akce mohou číst pouze klíčový hovor?+
Any action marked as a read. Set the permissions mode on the key to read_only and every write is refused with read_only_key, so a reporting integration cannot change anything even by mistake.
Proč mě nenašli za něco, co vidím v administrátorovi?+
The key is scoped to a workspace. Records in other workspaces return not_found rather than a permission error, so the API never confirms whether something exists elsewhere.
Vývojář
Bezpečnostní API
Jedna bezpečnostní smlouva pro každý konektor a integraci: požádat OpsIQ co to ví o IP nebo odesílatel, a krmit zpět zneužívání váš vlastní systém vidí.
OpsIQ se již brání: IP Firewall blokuje útočníky, potrubí jízdenek filtruje spam, a Security AI klasifikuje pachatele a navrhuje bloková pravidla. API otevře tuto inteligenci pro vaše další systémy. Platforma fakturace, klientský portál nebo vlastní aplikace může zkontrolovat návštěvníka před důvěrou, a nahlásit, co pozoroval, aby se celá instalace učí z každého povrchu.
Co můžeš udělat
Zkontrolujte, zda před důvěrou
Security. Zkontrolujte odpovědi s firewall stavu, jakékoliv spam pravidlo odpovídající odesílateli, a cached AI verdikt pro IP. Jeden hovor, jeden konsolidovaný názor.
Nahlaste, co jste viděl.
Bezpečnost. Zpráva zaznamenává pozorování jako bezpečnostní událost, má bezpečnostní AI klasifikovat IP A upozorní administrátory, když se verdikt vrátí s vysokým rizikem. OpsIQ vidí přímo.
Sdílet spam pravidla
Security. blocklist. add a security. Blocklist. list číst a psát stejná spam pravidla, která stránka Vstupenky používá, takže odesílatel zablokovaný v jednom systému je blokován všude.
Potřebné pro bezpečnost. Kontrola a bezpečnost. Blocklist. liste. bezpečné poskytnout zprávu integrace.
security.write
Potřebné pro bezpečnost. Zpráva a bezpečnost. Blocklist. add. Dejte to pouze systémům, které chcete krmit pravidla a zprávy v.
Nic není tiše zničeno.
Blocklist odesílatel stále přistává v pohledu Spam, kde jízdenku lze přečíst a obnovit.
Platforma se chrání sama.
The server's own IP Adresy nemohou být nikdy zablokovány, blokovány nebo hlášeny prostřednictvím tohoto API, takže špatně nakonfigurovaná integrace nemůže platformu spustit.
💡
Mint klíč pod Integrations, pak API Keys, a dát mu pouze bezpečnostní aplikace, které potřebuje. Plný požadavek smlouvy pro každou akci je v meta. acces a dokument OpenAPI.
Používají to moje stávající konektory automaticky?+
Outbound synchronizace je již automatická: při zablokování IP, připojené platformy jsou sdělovány přes bezpečnostní synchronizaci konektoru. API je příchozí polovina. Namiřte konektor nebo vlastní kód na tyto čtyři akce s klíčem nesoucím bezpečnostní senzory.
Kde žijí pravidla spamu?+
Jeden obchod. Záložka Vstupenky Block odesilatel ovládání, spam AI v Nastavení, a tento API všechny pracují proti stejnému blocklist, takže je přesně jedno místo k hledání.
Vývojář
Události API
Pošlete vlastní události ze serveru nebo webové stránky na OpsIQ pro analýzu, experimenty, CRM spouštěče a podmínky webháku.
Serverside, rekordní aktivity a konverze proti kontaktu prostřednictvím akce API. Použití crm.activities.record pro celoživotní / obchodní činnost a crm.conversions.record pro konverzi. events.send akce; příchozí přijímač CRM událostí žije na /v1/inbound.php?t=<token> pro systémy třetích stran, které vtlačují události do.
Pochopení toku dat vám pomůže debugovat integrace a optimalizovat výkon.
Jak to fungujePrůtok dat
Příchozí datový tok
1
Maják widget
U JavaScript widget posílá zobrazení stránky, kliknutí a chatu zprávy na /beacon.php.
2
Požití události
Events stored in opsiq_events with site_key, event type, customer, and properties.
3
Sezení
Session stavitel skupiny stránky zobrazení do zasedání (přes cron).
4
Řešení totožnosti
Po identifikaci jsou anonymní záznamy spojeny s profilem zákazníka.
5
Synchronizace konektoru
Konektory vytáhnou data z vnějších platforem a uloží se v pouzdře konektoru.
6
Kontext AI
AI sestavuje kontext z: historie návštěvníků, zákaznický profil, konektorová data, KB a instantní.
Odchozí datový tok
1
Požáry událostí
Vnitřní požáry událostí (ticket. created, chat. message, order. complete).
2
Pracovní fronta
Událost umístěná ve frontě na práci async.
3
Dispečink Webhook
Dispečerské značky a posílají na všechny upsané koncovky.
4
Znovu opakovat selhání
Neúspěšné dodávky se znovu zkoušely s exponenciální zálohou.
Nastavení
Odkaz na nastavení
Nastavení je řídící centrum pro pracovní prostor. Vše níže je načten do pracovního prostoru, kde jste, takže jeden účet může provozovat několik značek s různými identitami, chatu chování a retenční pravidla.
Najít nastavení
V Nastavení je asi 600 jednotlivých ovládacích prvků, rozložených na 11 tabulek seskupených pod čtyřmi menu. Neočekává se, že se po nich budete dívat.
Nastavení vyhledávání (Ctrl + K)
Stiskněte Ctrl + K, nebo Cmd + K na Mac, kdekoliv na stránce Nastavení. Zadejte jednoduchými slovy a stiskněte Enter pro skok přímo k ovládání. Hledání toleruje malé typy a rozumí souvisejícím slovům, takže plánovač najde Cron a soukromí najde ovládací prvky sledování. To pouze ukazuje nastavení, které vaše role může otevřít.
Pracovní prostor a plán
Generál a licence.
Podpora AI a zákazníků
Admin AI asistent, Klient Chat, OpsIQ psaní a podpora portálu.
Údaje a správa
Sledování a ochrana soukromí, oprávnění a zabezpečení.
Systém
Cron Setup (pouze pro sebe) a Nebezpečí zóny.
Ukládání
Každá karta uschová na vlastní pěst pomocí vlastního tlačítka Uložit. Klient Chat a OpsIQ Zápis je jejich pin na obrazovku. Uložte před přepínacím záhlavím, změny nejsou přenášeny přes.
Hluboké vazby
Aktivní záložka je zapsána do adresy stránky, takže může být karta označena nebo zaslána kolegovi.
Obecně: Obchodní identita
Nejdůležitější karta na stránce. AI čte tyto hodnoty v každé odpovědi, zprávy a denní stručné.
Obchodní název
Používá se ve zprávách AI, denních slipech a formulaci na míru. Srovnejte si webovou stránku footer.
Podnikatelský průmysl
Analýza AI, olověné bodování, stručné a průzkumné presety. Vyberte si z webhostingu, e- commerce, SaaS, realitní, agentura, poradenství, zdravotní péče, vzdělání, finance nebo obecné podnikání.
Jazyk systému
Jazyk zobrazený každému, kdo si nevybral svůj vlastní. Každý agent může přepsat v jejich profilu.
Použít jazyk prohlížeče
Zobrazí signate-in stránku v návštěvníkově vlastním jazyce. Jakmile si tam někdo vybere jazyk, jeho volba vyhraje a to ho nikdy nepřekoná.
Časový rozpis systému
Zóna, v níž běží celý systém: data, zprávy, plány a pozadí cron. Použijte svůj operační časový rozchod, nikoli vaši zákazníci.
Obecné: GeoIP a sledování
Databázová cesta GeoIP2
Plnou cestu k GeoLite2-City. mmdb. Autodetekuje na prvním zatížení přes cPanel, Plesk, DirectAdmin, Cloudways, Docker a plain Linux nebo Windows. Přidat GeoLITE2-ASN. mmddb ve stejné složce pro návštěvníka poskytovatele internetu.
Geo zdrojový režim
Pouze GeoLite2, GeoLeite2 s Cloudflare záloha, nebo Cloudflare pouze.Cloudflare režimy vyžadují proximaci stránky Cloudflare, s návštěvní umístění hlavičky povoleny pro město a region detail.
Časový limit zasedání
Nečinnost před návštěvou je považována za ukončenou. Výchozí 14400, což je čtyři hodiny.
Živé refresh interval (y)
Jak často se živé krmivo osvěžuje. Výchozí 30 sekundy.
Aktivní práh (min)
Jak dlouho se návštěvník počítá jako živý po jejich poslední stránce zatížení. Výchozí 2 minut. Jedná se o Live Feed drop- off, ne délka relace.
Údržba údajů (dny)
Odstraní shromážděné a generované záznamy v minulosti: analytika, chat, vstupenky, zpětná vazba, transakce, AI telemetrie, integrační protokoly a CRM aktivity. 0 uchovává vše navždy. Nastavení, autentický obsah a příjem souhlasu nejsou nikdy odstraněny.
Když je rozhovor smazán
Výběr, kolik z vymazané konverzace zůstane na záznamu: plný záznam, záznam bez rozhovoru, nebo pouze skóre. Odstranění vždy skrývá chat z schránky a historii návštěvníka. Plánováno retence a zapomenout návštěvník vždy vymazat v plném rozsahu bez ohledu na to.
Track bot provoz
Počítá se s plazi jako návštěvníky. Vynechte to; nafoukne počet návštěvníků a podělá každou zprávu.
Povoleno vyskakování průzkumů zpětné vazby
Zobrazí widget pro návštěvníky, který je široký a přístupný. Oddělené od chatových průzkumů v rámci Klientského chatu, Support Flow.
Obecné: AI funkce
Master přepne na každý povrch AI. Vše je výchozí a ušetří na pracovní prostor.
AI Trariage na vstupenky
Upřesňuje každý lístek podle kategorie, priority a sentimentu a na horní straně tipu zapíše shrnutí závitů.
Shrnutí AI Triage hover
Zobrazí triage tagy a shrnutí v nástrojovém tip, když agent otáčí řádek v seznamu tipů. Vyžaduje AI Trary.
Inbox Copilot (skladatel)
Přidá návrh AI odpověď, Warmer, Shorter, Formální a omluvy tlačítka pod políčko odpovědi na tip. Nic odešle bez agenta.
Ask- OpsIQ Copilot
Page- vědomi plovoucí kopilot na každé admin stránce. Ví, který zákazník, faktura nebo jízdenka je otevřena.
Dobré ráno.
Na první otevřené každý den copilot představuje urgentní vstupenky, opožděné odpovědi a čekání chaty. Neděle produkovat týden v recenzi.
Obecné: peníze, značka, záloha
OpsIQ Základní měna
Každá peněžní částka v admin je převeden na tuto měnu pro zobrazení. Konektory ukládají vlastní zdrojovou měnu; nastavit, že na konektor.
Automatické synchronizace FX rates
Obnovuje sazby každých šest hodin z volného veřejného krmiva bez API klíče. Můžete přidat ruční sazby, které přepínají kanál. S autosynchronizace off, měny bez manuální sazby jsou ponechány nekonvertované.
Povolit funkce obchodu a účtování
Vypnout. Zapnutí ukazuje stránku Prodej a Konverze, palubní desky příjmové karty a Živé zpravodajské služby. S tím vypnuto, každá cena povrch je skryt a prodejní stránka opustí menu.
Obchodní slovní zásoba
Učí OpsIQ vaše znění: zda regenerační, slovo pro obnovení, co prodáváte, a jak se tomu říká kupujícím.
Značení a loga
Dva uploads, jeden pro lehké pozadí (admin sidebar) a jeden pro tmavé (sign- in page). PNG, JPG, Web P nebo SVG až do 3 MB.
Agentko pro zpravodajskou službu, povolte soukromé cíle SSH
Automaticky implementující SEO agent se připojí přes SSH. Soukromé, loopback a vyhrazené adresy jsou zablokovány ve výchozím nastavení jako anti- SSRF opatření. Povolit pouze na self-hosted instals, které musí dosáhnout místního serveru.
OpsIQ Backup / Obnovit
Exportuje každé nastavení a OpsIQ-vlastněný stůl plus nahrané soubory. Obnovit nahrazuje OpsIQ pouze konfigurace a záznamy; nikdy se nedotkne klientů, faktur, vstupenek, služeb, domén, objednávek nebo transakcí.
⚠️
Vezměte zálohu před použitím cokoliv v Nebezpečí zóny. Záloha žije v Obecné a akce smazat živě v Nebezpečné zóně, takže je snadné dosáhnout tlačítka smazání bez exportu první.
Nastavení
Nastavení: Bezpečnost
Ochrana pro admin sign- in, vaše personální účty a data OpsIQ sbírá. Zákaznický signál pro podporu portálu je nastaven samostatně.
Ochrana při signalizaci
Google reCAPTCHA
Zastaví boti a kreditní nádivku na admin sign- in. Vyberte v3 (neviditelný, bodovaný) nebo v2 (checkbox), nastavit práh v3 skóre, a dodat stránky a tajné klíče. Tyto stejné klávesy jsou znovu použity pomocí formuláře podpory portálu požadavek.
Automatické přihlášení-Zablokování
Blokuje adresu po několika poruchách v okně, na několik hodin. Můžete přizpůsobit uzamčená-stránka zprávy a ukázat malé čekání-obrazovka rozptýlení.
Zpevnění přihlašovací údaje
Zásada hesla s minimální délkou, odmítnutí hesel nalezených ve známých porušeních, omezení účtu na kreditní náplň, povinný dvoufaktor pro každou admin, návrat hesla před nebezpečnými činy a signalizace nového zařízení v záznamech.
Jednosměrný signál zapnutý (OIDC)
Personál sign- in prostřednictvím svého poskytovatele identity. Potřebuje emitenta URL, ID klienta a tajemství klienta. Automatické poskytování domén, jeden na řádek, vytvářet uživatele automaticky na první sign- in.
Jednosměrný signál zapnutý (SAML 2.0)
Pro poskytovatele, kteří hovoří SAML. OpsIQ dodává odpověď ACS URL a SP ID entity; dodáte ID IDP subjektu, sign- in URL, volitelné označení-out URL a X.509 podepisování certifikátu. Pole atributu e-mail a název jsou potřebná pouze pro nestandardní názvy atributů.
SCIM Provisioning
Vytvoření, aktualizace a deaktivace řízení OpsIQ účty.OpsIQ zásobuje SCIM základ URL Vygenerujete zde označené žetony, takže můžete být odvoláni, aniž byste porušili zbytek.
Výhrůžky, blokování a sbírka
Odlétající Egress Allow- list
Omezení, které externí hostitele těchto konektorů pracovní plochy mohou volat. Spojením s SSH cílovou kontrolu v obecné.
Výstraha Scoring a Auto- Block
Blokuje návštěvníka, jakmile jejich skóre hrozby projde práh. 0 zakáže. Podívejte se na stránku Bezpečnostní přehled po dobu jednoho týdne před výběrem čísla.
Blokovat zprávu o stránce
Zpráva, kterou návštěvník vidí, jako prostý text nebo vlastní obrazovku bloku HTML.
Hlavní webové vitálie od skutečných návštěvníků
Měří LCP, INP a CLS z reálných sezení.
Zachycené, znovu-bezpečné doručení události
Vlastní akce fronty v prohlížeči a dodávat v dávkách s retry, snížení ztráty na špatné mobilní připojení.
Podepsané sledovací majáky
Real widget Embeds nesou rotující kryptografický token, takže padělané sledovací data mohou být zamítnuty. Vypnuto ve výchozím nastavení; umožňuje změnit, jak embeds ověřovat, takže nejprve test.
Bezpečnostní upozornění
Vypnuto ve výchozím nastavení. Detekce a blokování běží bez ohledu na to,. Tato karta kontroluje, zda vám bude řečeno, a kolik AI pomáhá.
Povolit bezpečnostní záznamy
Hlavní vypínač pro tuto kartu.
Práh přihlašovací vlny
Kolik neúspěšných signálů v krátkém období se počítá jako vlna, která stojí za varování.
IP reputace inteligence
Přidá výhružné skóre pro návštěvníky, kteří se objevují ve veřejných zdrojích zneužívání.
Hlídka na místě
Přesčasy a kontroly doby platnosti TLS, upozornění před propadem osvědčení.
Bezpečnostní analytik a informace o incidentu v AI
Přidává vysvětlitelný verdikt k podezřelé aktivitě a skupinové útoky do jediného čitelného incidentu, spíše než proudu událostí.
Autopilot politiky
Jedná sama o sobě, mění to, co se z incidentu naučí, na navrhované nebo použité pravidlo. Nechte toho, dokud si nepromyslíte jeho návrhy a nebudete s nimi souhlasit.
Denní bezpečnostní stravovací a týdenní postoj poradce
Denní rekapitulace na stránce Bezpečnostní přehled a týdenní seznam tvrzených kontrol, které ukazují, co je chráněno a co je stále otevřené.
Automatické vypršení platnosti opozdilých návrhů
Navrhované blokové pravidlo, které jste nikdy nejednali, vyprší samo o sobě, místo aby se hromadilo.
Replay pro sezení
Povolit přehrávání relace session
Rekordy návštěvníků pro přehrávání. Když se replay knihovna není nikdy načtena, takže není třeba nic zakládat. Nahrávky jsou odebírány vzorky a privacy-mask, a jsou sledovány na stránce Session Replay pod Analytics.
Rychlost odběru vzorků, maximální zachycení, zadržování
Jaký podíl z nahrávání, jak dlouho může běžet jediná nahrávka a kolik dní je vedeno.
⚠️
Session replay záznamy skutečné lidi pomocí vašich stránek. Udržujte rychlost vzorku a uchovávání tak nízké, jak bude stále odpovídat na vaši otázku, a zveřejnit ve svém upozornění na soukromí.
Nastavení
Nastavení: Sledování a ochrana soukromí
Co OpsIQ může sbírat a jak dlouho každý druh záznamu přežije.
Vyloučení
Vyloučené oblasti IPs a CIDR
Adresy nikdy sledovat, jeden na řádku, přesné adresy nebo CIDR rozsahy. Nejčistší způsob, jak udržet svůj vlastní tým mimo své analytické, protože to pokrývá každého na této adrese spíše než jen signed- v admins.
Vyloučené cesty URL
Vzorky stránek nikdy nesledovaly, jedna na řádek, divoké karty s hvězdičkou. Například /admin/* udržuje celou zadní kancelář mimo záznam návštěvníků.
Politika uchovávání údajů
Per- subsystém auto- očista ve dnech. Oddělené od celkového nastavení uchovávání dat v obecné a z čištění nebezpečné zóny.
Poznámky k interakcím AI
Telemetrie důvěry drží krátké náhledy na dotaz a odpověď. Výchozí 90 dny. To má nejvíce zákaznický text, takže zkraťte to nejprve při utahování soukromí.
Události týkající se využití AI
Výchozí dny 90. Pouze čísla, žádný obsah zpráv.
Sledování činnosti
Výchozí dny 365. Udržujte to nejdéle, je to vaše důkazní stopa.
Diagnostika
Zdravotní záznamy systému. Výchozí dny 30.
Nezodpovězené otázky
Seskupení otázek, na které AI nemohla odpovědět. Výchozí dny 90. Projděte je na Otázkách, které AL vynechala před vypršením platnosti.
Hlídací psi a export
Metrické Anomálie Alarty
Denní srovnání včerejšího s nedávnou základní hodnotou, upozorňující, když metrický pohybuje více než váš práh. Výchozí 35 procent. Vypnuto ve výchozím nastavení.
Export skladu
Nightly skládky zasedání, návštěvníků, pageviews a souvisejících tabulek pro vaše vlastní BI zásobník, ve formátu si vyberete, uchováván po řadu dní. Vypnuto ve výchozím nastavení.
Nastavení
Nastavení: Admin AI asistent
Plovoucí asistent, který váš personál používá v admin, s přístupem k živé čtení k klientům, faktury, vstupenky, servery a cron protokoly. Jiný asistent od zákazník- čelí jeden pod Client Chat.
Povolit OpsIQ AI Widget
Zobrazí tlačítko asistenta na každé admin stránce.
Rozvržení a chování
Poloha rohovky, šířka panelu (320 do 600 px), maximální výška (400 do 900 px), poloměr rohu (0do 24), velikost písma, a matné sklo rozmazané za panelem.
Zobrazit rychlé žetony
One- klepněte na tlačítko zkratky pod hlavičkou. Nejrychlejší způsob, jak se pro většinu zaměstnanců.
Zobrazit modelovou informaci
Zobrazí, který model odpověděl a jak dlouho to trvalo. Užitečné při ladění náklady, hluk pro každodenní použití.
Per- admin přístupová brána
Pouze ukazuje asistent signed- in admin, jehož uživatelské jméno a e-mail odpovídají OpsIQ agent přidělený do tohoto pracovního prostoru. Vlastníci vždy projít. Použijte tlačítko Zkontrolujte můj přístup před povolením, nebo můžete zamknout svůj vlastní tým ven.
Al Persona
Zobrazení názvu, záhlaví tagline a vlastní uvítací zprávy zobrazené při otevření panelu.
Chytré rychlé akční žetony
Upravit štítek a základní příkaz pro každou zkratku, přidat vlastní, nebo reset do selhání. Štítek je to, co zaměstnanci vidět, příkaz je to co AI obdrží.
Barvy a tvar
Tvar čipu (pilulka, zaoblené, čtvercové), barvy čipů, téma karty a tvar odpalovače (kulatá, stříkací, čtvercová), s živým náhledem.
Paměť konverzací
Asistent si pamatuje každou osobu historii přes prohlížeč sessions, až na 120 zprávy, uložené ve vaší vlastní databázi. Vymažte ji začít znovu.
Nastavení
Nastavení: Klient Chat
Šifrování chatu, které používají vaši zákazníci, a největší oblast nastavení. Šest podkaret, s hlavním spínačem a Uložit připnuté na horní část karty.
Práce přes podkarty v pořadí na nové instalaci: Identita a kopírování, Vzhled, Chování, Podpora Flow, Znalostní školení. Pokročilý je infrastruktura a může čekat.
Totožnost a kopie
Identifikační značka
Widget jméno, tagline, AI jméno, název používaný pro systém a neaktivní oznámení, a jak se objeví jména agenta. Agent Název Zdroj rozhoduje mezi reálnými jmény, vlastní jméno nebo team label.
In- Chat pozdrav
Dvě pozdravy, jeden pro všechny návštěvníky a jeden pro identifikované návštěvníky. Otázka začíná více konverzace než prohlášení.
Popup Teaser
Plovoucí zpráva před chatem je otevřena, s vlastním názvem, velikost písma a barvy. AI může psát kávová zrna, s ovládacími prvky pro kolik generovat, kolik ukázat za návštěvu a mezeru mezi nimi.
Náboje a odpalovací zařízení
Celý scénář: požádat o jméno a e-mail, potvrzení, požadovat člověka, bez agentů k dispozici, jízdenka vytvořena nebo zrušena, předání čeká. Asi dva tucty jednotlivých řádků v skládací panel.
Status a nedovolená oznámení
Tři uživatelsky viditelné zprávy: agent zavře chat, návštěvník se ztišil, a agent ruce zpět do AI. Vyhněte se interní formulace jako vyřešené nebo triaged.
Skladatel a návrhy
Vstupní pokladní, talk- to-a- lidský štítek a navrhované úvodní otázky. Tři dobré návrhy odkloňují více vstupenek než stránka článků.
Spouštěč, Icon a Avatars
Ikona spouštěče, volitelná ikona, když je otevřená, velikost odpalovače a obrázky pro člověka a AI.
Vzhled
Téma a sklo
Tématický režim, prémiový preset barev, intenzita rozmazaných a opacita, plus přepínače pro animace, oddělovací čáry, skrývání řádku stavu, skrývající kartu do schránky zpráv a skrytí tlačítka close. Začněte s přednastaveným, nastaví desítky barev najednou.
Hlavní barvy
Spouštěč, hlavička, pomocný panel, odkazy, tlačítka, systémová upozornění a skladatel, každý s barvou start a konec pro gradienty. Použitá výchozí možnost skla je ignoruje a udržuje transparentní povrch.
Panel, bublina a čipy
Kolem třiceti pickers pokrývající panel, hranice, text, vstupní plocha a každý typ bubliny (návštěvník, AI, agent, psaní, systém) plus sugesce čipy a jejich stav vznášedla. Otevřete pouze pro přesné shodování značky, a zkontrolujte kontrast na bublinkové text.
Rozvržení a tvar
Šířka a výška panelu, poloměr rohu, velikost písma, pozice obrazovky, tvar odpalovače, styl bubliny a zda se zobrazují avatary. Otestujte šířku telefonu.
Chování
AI automaticky odpoví
Hlavní vypínač pro odpovědi na AI. Vypnuto znamená, že každá zpráva čeká na člověka.
Lidské následná opatření a přirozené dvojité-textování
Jemný follow- up, když návštěvník ztichne, a volitelné krátké druhé zprávy, jak by člověk poslat jeden. Tunded s max. follow-ups per silence, první zpoždění, pozdější multiplikátor, přítomnosti okna a maximální sekvence okno. Může být omezena na pracovní hodiny, a potlačena po jednoduchém poděkování.
Odpovědi na psací stroj a tempo odpovědi
Ať už odpovědi zadejte slovo za slovem, a jak rychle asistent odpoví, přednastaveným nebo vlastní minimum a maximální zpoždění v milisekundách. Malé zpoždění čte jako více člověk než okamžitá odpověď.
Živý překlad
Každý agent čte a píše ve svém vlastním jazyce, zatímco návštěvník čte jejich.
Po volnoběhu se vraťte zpět do AI.
Zápis o nečinnosti agenta před tím, než AI obnoví konverzaci.
Automaticky otevřít chat
Sekundy, než se widget otevře sám.0nikdy neotvírá. Narušitelné na mobilní; nechte na0pokud není testováno.
Chytřejší odpovědi
Plánování dopředu pro jednopass odpovědi, myšlení hloubka, volitelný samostatný model pro agent odpovědi, ukazující úvahy návštěvníkům, tolerování chybných hlásek, dlouhotrvající konverzace paměti, omezení asistenta pouze pro vaše podnikání, ceny v měně návštěvníka, a jak se objeví odkazy. Pouze mluvit o své podnikání by mělo být na téměř každý.
Úspora nákladů
Skips znalosti hledání pozdrav, jako je hi a díky, a udává nejdelší odpověď v žetonech. Trimy náklady beze změny kvality odpovědi na skutečné otázky.
Jazyky
Který jazyk widget podporuje a jak si vybere jednu pro návštěvníka.
Odpovědi na účet zákazníka
Odpovědi z vlastního účtu znakového zákazníka, volitelně nahlížet živě, a volitelně naložené pouze v případě potřeby. Čtení - pouze ve všech případech; načtení - když - potřeboval znatelně snižuje náklady.
Výše náhrad
Asistované žádosti o vrácení peněz, kde asistent shromažďuje detaily a ruce na osobu. Nikdy dokončí náhradu sama.
Rozhovor a widget
Udržování minulých rozhovorů, pokračování chatu přes vaše připojené stránky, draggable okno, žádat hosty o e-mail, a nechat váš tým obrátit chat do vstupenky.
Funkce widget
Emoji picker, přílohy s volitelným paste- only módem, AI pochopení obrazu, inline ikony, mikrofon, talk-to- agent tlačítko, zvuk návštěvníka, náhled připojení, hlasové-volání a izolaci relace. AI obrázek je to, co umožňuje návštěvník vložit chybový screenshot a získat užitečnou odpověď.
Admin Inbox, oznámení a uvítací pop
Návštěvník uvítá vyskakování, plus upozornění vašich agentů: inbox zvuky, oznámení na plochu, šepot zvuky, zda soukromé šeptání pípnutí, a interval pro průzkum inbox.
Podpůrný tok
Lidská práce
Jak jsou žádosti o osobu přiřazeny, sekund agent musí reagovat, zda se vrací chatu na AI, a zda AI pokračuje, když vyprší timeout. Nastavit to před tím, než jít živě nebo návštěvník, který žádá člověka prostě čeká.
Pracovní doba
Otevírací doba, časová zóna a zavřená hodinová zpráva. Mimo tyto hodiny nebude AI nabízet člověka. Oddělený rozvrh od pracovní doby vstupenek v rámci OpsIQ Psaní.
Odpovědi, když je AI vypnutý
První odpověď na novou zprávu, odpověď, když je někdo již fronta, a jak dlouho před opakováním.
Offline formulář
Zobrazí kontaktní formulář místo chatu.
Vyhledávání lístků a oznámení oddělení
AI povědomí o vstupenkách, takže návštěvník citující číslo jízdenky dostane svůj skutečný status, a které oddělení AI může směřovat do. Built- in panel ukazuje skutečné příjemce pro každé oddělení, vyřešil stejným způsobem oznamovatel řeší je, takže můžete vidět, než zákazník dělá, že oddělení upozorňuje nikoho.
Nápověda centrum v widget chatu
Umožňuje návštěvníkům procházet publikované články, aniž by opustili chat. Vyberte si místo, kde se objeví vstupní bod, štítek dolní lišty a ikonu, a zda nabídnout odkaz na celé centrum nápovědy. Vypnuto ve výchozím nastavení.
Hodnocení konverzací
Hvězdná rating se spustí, když agent uzavře chat, když předávka skončí, nebo po nečinnosti období, které nastavíte. Vyberte jeden nebo dva spouštěče, ne všechny.
Post- Chat Survey
Krátký průzkum, kdy návštěvník uzavře chat, s vaší otázkou, zpoždění, načasování a čepice za návštěvu. Návštěvníci mohou také e-mailem nebo stáhnout přepis. Jedna otázka dostane odpověď; tři ne.
Post- Chat emailové šetření
Následné sledování emailem po ukončení konverzace, volitelně v jazyce návštěvník chatoval, s kontrolou nad zpoždění, předmět, intro, otázka, jak tlačítek štítky a díku- jste řádek.
Odpověď Zpětná vazba
Palce nahoru a palce dolů na každé odpovědi AI, krmit kvalitní palubní desky.
Archiv konverzací
Autoarchiv po dnech, automatické řešení po minutách ticha a odstranění archivovaných rozhovorů po dnech. Nastavuje se třetí místo retence, vedle General a sledování.
Školení znalostí
Na ničem jiném v Client Chat nezáleží.
Výcvik na znalostech internetových stránek
Proplíží vaše stránky, aby asistent může odpovědět z něj. Až deset startovní odkazy, limit stránky, hloubka odkazu, a vyloučené složky. Jeden URL lze testovat před celou plazit. Vyloučit Checkout, účet a admin cesty.
Vložení
API klíč a model, který mění stránky na vyhledávatelný význam spíše než klíčové slovo shoduje.
AI Znalostní organizátor
Jedno kliknutí a AI čte každý FAQ a plazil stránku a třídí je do kategorií.
FAQ, ověřené odpovědi
Otázkové a odpovědi páry zachází jako nejvyšší prioritu zdroje, každý se statusem, hmotnost a kategorie. Vyhledatelné, importable z JSON, a AI může psát je z popisu vašeho podnikání. Když asistent dostane něco špatně, napsat FAQ: to předčí plazí stránky, takže fix je okamžitý.
Pokročilé
Výkonnost a limity
Interval hlasování, omezení rychlosti zpráv a okno, maximální velikost připojení, pokusy o připojení na okno a povolená rozšíření souboru. Seznam rozšíření je bezpečnostní kontrola, držte ji pevně.
Realtime Delivery
Okamžitá zpráva a status doručení místo hlasování, přes Pusher, Ably nebo Firebase, s nouzovým volebním intervalu. Volba je v pořádku pro většinu stránek.
Spustit oznámení
Zařízení upozorňuje agenty přes Kočičí paprsky nebo OneSignal, se zájmem o zařízení.
Webový push (VAPID)
Prohlížeč tlačit pomocí vlastních generovaných kláves bez třetího poskytovatele strana. Generované zde, ne v Nebezpečí zóny.
Sdílet hlas, video a obrazovku
TURN pověření tak volá připojit prostřednictvím restriktivních sítí, pomocí Cloudflare nebo Twilio pověření nebo vlastní TURN URL, uživatelské jméno a kreditní.
Zadat pracovní tok
Nastavení pracovního prostoru agenta spíše než nastavení návštěvníků: první odpověď SLA v minutách, uložené zobrazení fronty, klávesové zkratky a paleta příkazů, vyhledávání v rámci konverzace a zákaznické lístky v inspektorovi.
Zprávy
WhatsApp, SMS, Facebook Messenger, Instagram, Telegram, X přímé zprávy a LINE, každý s vlastním AI automatickou odpovědí přepínač, plus pojistný spínač pro AI akce na kanálech, debuci odpovědi a WhatssApp re- angažovací šablonu. Každý kanál přistane ve stejné inbox jako web chat.
✅
Živý Widget Náhled v dolní části aktualizace karty, jak budete upravovat. Použijte ji místo přečtení své webové stránky zkontrolovat změnu.
Nastavení
Nastavení: OpsIQ Psaní
Vstupenky odpověděl písemně: automatické odpovědi, rodné letenky systém, eskalace, pracovní hodiny, směrování a zákazníků- čelí e-maily.
Automatická odpověď
Zobrazit tlačítka OpsIQ
Přidá psací pomocná tlačítka pro vaše agenty v admin.
Povolit automatické zodpovězení tipu
Vyvolá nové vstupenky a odpovědi a odpoví na ně po zpoždění. Začněte s tím a recenzi návrhů na týden. Refundy, zrušení a změny přístupu by měly vždy oslovit člověka.
Oddělení pro automatickou odpověď
Které oddělení auto- odpověď může odpovědět v. Vše, co není uvedeno je ponecháno pro člověka, což je bezpečný výchozí.
Plán zodpovědného zpoždění (minuty)
Jak dlouho čekat, než automaticky odpověď odešle. Okamžitá odpověď se čte jako robot, několik minut se čte jak rychlý tým.
Max AI odpovědi na letenku podle oddělení
Kšiltovka, například Billing 1 a podpora 3Bez čepice se může zaplést nit.
Délka odpovědi, status a totožnost
Maximální psaní tokeny, stav vstupenky po odpověď a po eskalaci, a které admin účet automatické odpovědi jsou připisovány. Použijte jasně pojmenovaný účet, aby personál mohl říct AI odpovědi od lidí.
Původní provoz jízdenek
Systém původního tipu
Systém vstupenek zabudovaný do OpsIQ, pro instalace bez externí helpdesk.
Přijíždějící e-mail do rodné vstupenky
Mění příchozí e-mail na lístky. OpsIQ dodává cílový parametr URL, auth token, script path a PHP binárně. Cokoliv, co může poslat do tohoto koncového bodu, může vytvářet tipy, takže udržet token tajemství.
Víceotáčecí odpovědi a zpoždění a decount
Zda AI stále odpovídá, jak konverzace pokračuje, a zda to čeká klidné okno, takže tři rychlé zprávy dostat jednu zvažovanou odpověď. Tiché okno je nejlepší jednotné nastavení pro automatické odpovědi pocit uvažování.
Portál veřejné podpory
Stránka, na kterou může někdo zvýšit a sledovat jízdenku s volitelnou vítací linkou. Jeho adresa a vzhled jsou nastaveny v záložce Portal Support.
Formát čísla tipu
Kolik náhodných písmen se objeví v generovaných číslech tipu.
Email zákazníci ve svém vlastním jazyce
Ticket e-maily podle jazyka zákazníka. Personál e-mail nikdy nemění jazyk: oznámení, oddělení upozornění, instruktáž a plánované zprávy zůstávají ve vašem jazyce systému.
Potvrzení a potvrzení
Pevné potvrzení nových tipů, plus potvrzující zprávy při otevření tipu, při ponechání zpětné vazby a při uzavření tiketu, každý s živou náhled. K dispozici je také globální obal e-mailové šablony a odkaz za zobrazení tlačítka tipu.
AI screening spamu
Screens vstupenky z neznámých odesílatelů, a může volitelně přesunout podezření spam na vlastní pěst. Nechte automatické odjezd, dokud jste sledovali jeho úsudek.
Automatické-close volnoběžné tipy
Uzavře jízdenku po několika klidných dnech. V závěrečné zprávě řekněte zákazníkovi, jak se má znovu otevřít.
Pracovní doba (kalendář SLA)
Časová zóna, otevírací a zavírací doba, pracovní dny a svátky pro první-odpověď a rozlišení časovače. Samostatný harmonogram od pracovní doby pod klientem chat.
Automatické přidělení nových tipů
Automatické přiřazení, volitelně pouze agentům, kteří jsou online, s dovednostmi agenta a citlivostí na zápas pro směrování založené na dovednostech.
Navrhnout duplikát tipů
Spots když zákazník otevře lístek blízko k tomu, který již má, s nastavitelnou citlivostí na zápas.
Průzkum spokojenosti po uzavření
Emails a survey day after closing. Výsledky se zobrazí na stránce CSAT.
Upozorňovat oddělení e-mailem
Emailuje oddělení, když nová jízdenka dorazí. Příjemci jsou členové tohoto oddělení, ne adresa poštovní schránky oddělení, což je vstupenky na příchozí adresu.
Co může Al číst
Přístup k údajům o klientech AI
Master switch plus individuální oprávnění pouze pro read- only pro shrnutí profilu klienta, faktury, transakce, kreditní bilance, produkty a služby, domény, připojené servery a přehled účtu vysoké úrovně. Začněte s profilem shrnutí a přidejte kategorie jako odpovědi je třeba.
Eskalace a znalosti
Povolit eskalaci vstupenek AI
Přesune jízdenku do lepšího-vhodné oddělení před odpovědí. Vyberte si povolená oddělení, kontrola zpoždění, a můžete napsat vlastní eskalační upozornění pokyny. Zapněte vnitřní eskalaci poznámka, aby váš tým vidět, proč se lístek přesunul.
Nastavení znalostí
Zda odpovědi používají zákaznický jazyk, zda čerpávají na plazivé odkazy a FAQ, zda AI čte obraz a PDF přílohy, režim odpovědi na znalosti, ať už dovážené JSON používají znalosti a zda se mohou objevit zdrojové odkazy. Používejte prolezlé odkazy a FAQ by měly být zapnuté, nebo AI je odhad.
Zastavit auto- odpověď po lidské odpovědi
Jakmile personál odpoví, AI přestane odpovídat na ten lístek.
Pokyny k lístku a e-mailu
Free- text pokyny tvarování tón a obsah pro každou odpověď, s načtením pracoval příklad. Buďte konkrétní o tom, co AI nesmí nikdy dělat.
Importovat znalosti JSON
Nahrát nebo vložit soubor znalostí JSON pro asistenta.
Studio tlačítek
Plná designérka pro tlačítko na míru: styl zobrazení, velikost, štítek, ikona, tvar, minimální šířka, styl pozadí s primárními a sekundárními barvami, úhel sklonu, hranice, poloměr rohu, stín, typografie, vycpávání, animace, pohyb a barvy vznášedla a zaostřovací kroužek, plus vlastní CSS box pro cokoliv, co ovládací prvky nepokrývají.
Nastavení
Nastavení: Portál podpory
Stránka, kde lidé zvyšují a sledují jízdenky a čtou vám nápovědy. Tato záložka kontroluje, jak je dosaženo a jak se zákazníci přihlásí; jeho vizuální design probíhá v Support Portal Studio.
Portálový ateliér nebo vestavěný portál vstupenek: který chci?
Jedná se o dva různé produkty a lidé je neustále míchají. Řeší různé problémy a běžet oba dohromady je normální.
Podpora Portálové Studio: místo, kam posíláte zákazníky
Studio navrhuje kompletní podpora stránky, které OpsIQ hostuje pro vás. Má vlastní webovou adresu, nebo svou vlastní doménu, a nese celý self-servisní zkušenosti: pomoci články s vyhledáváním, formulář žádosti, historie vstupenek, zákaznický sign- in a asistent. Vyberte šablonu, práci přes téma, Navigace, Rozvržení, znalosti, Footer, Značka, Vstupenky, asistent, Form a CSS, náhled na plochu, tablety a velikosti telefonu, pak publikovat.
Používejte ji, když Chcete jednu značkovou destinaci můžete ukázat každý zákazník na, a vy byste raději nepostavit nebo udržovat podpůrnou oblast uvnitř svých vlastních webových stránek.
Vložený portál vstupenek: vstupenky na vaše vlastní stránky
Vložené listy pouze zážitek z vstupenky na stránce vašich vlastních webových stránek. Zákazníci otevírají, sledují a odpovídají na žádosti o podporu, aniž by někdy opustily vaše stránky, a vaše vlastní hlavička, navigace a design zůstat přesně tak, jak jsou. Nastavte rozložení, vzhled a pravidla přístupu v widget stavitel, náhled výsledku, pak zkopírujte vložený snippet do vaší stránky.
Používejte ji, když již máte webové stránky nebo aplikaci s vlastním designem, a chcete podporu, aby se stalo uvnitř něj spíše než předání zákazníka na jinou adresu.
Krátká verze
Studio staví místo, kam posíláte zákazníky. Vložené přináší lístky tam, kde jsou již vaši zákazníci. Mnoho podniků běží jak, vkládání widget vstupenky v jejich oblasti účtu pro in- kontextové žádosti při zachování hostitelského portálu jako plné self-service destination s články a vyhledávání. Jsou nezávislé přepínače.
Adresa a přístup
Režim přístupu
Zda je portál otevřen komukoliv nebo omezen na zákazníky značeného čísla. Otevřené portály dostanou více vstupenek a spamu.
Volby rozložení
Zda portál a nápověda centrum sdílet jednoho hrdinu nebo použít dva, které navigace a footer objeví na obou površích, a štítek navigační sekce.
Portálová adresa
Uživatelé adresy. Vyberte si jméno a OpsIQ zobrazí výsledný portál a odpovídající adresy centra nápovědy. Změna později přeruší odkazy, které jste již odeslali.
Vaše vlastní doména
Slouží portálu z domény, kterou vlastníte, jako je podpora. Your domain. com.
Portál vloženého vstupenky
Přepínače na drop- in widget popsané výše, a otevře vložené stavitel, kde si vyberete rozložení, vzhled a přístupová pravidla, náhled výsledku a kopírovat snippet pro vaši stránku. To není Portal Studio: Studio navrhuje hostovaný portál, to dává vstupenky uvnitř vlastního webu. Oba mohou být uvedeny najednou.
Jak se zákazníci přihlásit
Toto jsou vaše zákazníky sign- in volby. Sign- v Personal je nakonfigurován v Nastavení, Bezpečnost.
Metody sign- in
Které volby se objeví na stránce sign- in. Připojení a emailová sign- v práci automaticky.
Sociální signál
Poskytovatelé spotřebitelských účtů, každý potřebuje ID a tajemství klienta, s přesměrovanou adresou poskytnutou OpsIQ pro registraci u tohoto poskytovatele.
Jednoznačný (OIDC)
Zákazník sign- in prostřednictvím poskytovatele identity, s emitentem URL, ID klienta, tajné a volitelně povolený e-mailový doménový seznam.
Zákazník SAML 2.0
U SAML ekvivalentní. OpsIQ dodává odpověď ACS URLa SP ID entity; dodáváte ID, sign- in a sign- out URLs, X.509 certifikát a volitelné názvy atributů. Turn SAML v Sign- in metodách, nebo se neobjeví.
Bezproblémový signál z vaší aplikace
Podepsaný hluboký odkaz, takže zákazník již přihlásil do vaší aplikace přistává v portálu bez přihlášení znovu. OpsIQ dodává podpisové tajemství, portál URL a klíč pracovní plochy, plus generátor pro podepsaný zkušební odkaz. Použijte generátor před zapsáním jakéhokoliv kódu.
Odhlásit se všude.
Přihlášení z portálu také přihlašuje zákazníka z vaší aplikace.
Příjem a ochrana
Pole formuláře žádosti
Které strukturované pole formulář žádosti sbírá. Každý další pole ztrácí podání, takže se zeptejte pouze na to, co potřebujete k třídění.
Ochrana proti spamu a zneužívání
Medvídek a omezení sazby vždy chrání veřejný formulář. Na vrcholu můžete zablokovat jednorázové e-mailové adresy, přidat vlastní blokované domény, a přidat CAPTCHA pomocí Google reCAPTCHA nebo Cloudflare Turnstile. reCAptCHA znovu používá klíče již nastavené v Nastavení, Bezpečnost; Turnstie klávesy jsou zadány zde.
Portálové analytiky
Předem-pouze shrnutí aktivity portálu za posledních třicet dní.
Nastavení
Nastavení: Licence, zóna Cron a nebezpečí
Skupina System, plus ovládání přístupu týmu, které rozhoduje, kdo se podívá na záložku Nastavení.
Přístup k týmu a oprávnění
Per- admin oprávnění
Každý admin dostane explicitní soubor oprávnění, která zahrnují přístup k chatu, které sekce Nastavení mohou upravovat, a jejich oddělení. Každý, kdo má plnou roli správce vždy má každé svolení. Oprávnění nastavení rozhodnout, které karty osoba vidí, tak udělte nejtěsnější sadu, která jim umožní pracovat.
Licence
Ukazuje váš současný průkaz, jaký máte nárok a jaké je jeho postavení.
Nastavení cron
Self- hosted installs only. Na cloudu OpsIQ běží pro vás plánované úkoly a karta je skryta. Jeden řádek crontab řídí každý plánovaný úkol: tiket auto- odpověď, eskalace směrování, výměnná -rate refresh, poštovní hlasovací a konektorové synchronizace.
1
Kopírovat řádek
Karta zobrazuje přesnou řádku crontab pro váš server se správným PHP binárním již zvoleným.
2
Přidat to do crontab
Spustit crontab -e jako uživatel, který běží PHP a vložit jeden řádek. Na cPanel použít nástroj Cron Jobs místo.
3
Ověřit
Během minuty se rozsvítí tlukot srdce, teď použijte Run a otestujte ho, raději než abyste čekali.
Obraz tlukot srdce ukazuje poslední běh, dobu trvání a to, co bylo zpracováno jak pro automatickou odpověď frontu a e-mailové a konektorové ankety. Varuje, když poslední spuštění přišlo z manuálního webového tlačítka spíše než skutečný server cron, a když srdeční tep je stagled.
Nebezpečí
Smazat všechna sledovací data
Prostírá vše, co OpsIQ shromáždil nebo generoval. Zaškrtněte, co mají obsahovat a zadejte potvrzovací frázi přesně. Nastavení a konfigurace stránek, blokované adresy, vše, na čem váš tým napsal (znalostní základna, FAQ, překlady, portální návrhy, definice akce) a potvrzení souhlasu jsou zachovány.
Očistit data starší než
Stejný průzkum omezený na záznamy starší než 30, 60, 90 nebo 180 Pro automatické zadržení valení použijte místo toho retenční hodnoty v obecné a sledovací jednotce a nechte to provést plánovaný úkol.
🚫
Exportovat zálohu z Nastavení, Obecné před použitím cokoliv v Nebezpečí zóny. Tyto akce nelze odčinit.
Nastavení
Správa vašeho týmu
Pozvat členy týmu a přiřadit role k ovládání, kdo může mít přístup k čemu.
TýmSkutečný týmový obraz: každý admin s jejich kontaktem, rolí a odděleními, které mohou oslovit, agenti prohledáni, majitelé plní.
Role
Majitel
Plný přístup včetně licence, fakturace a nebezpečné zóny.
Kompletní admin
Plný přístup kromě licence a nebezpečné zóny. Může spravovat administrátory.
Agent
Pouze pro přidělenou sekci, lístky, chaty a analytiku.
Pozvaní členové týmu
1
Jdi do týmu.
Přejít do týmu v postranní čáře.
2
Klikněte na Pozvat
Zadejte e-mail člena týmu.
3
Nastavit roli
Vyberte si majitele, Full Admin, nebo Agent.
4
Přiřazování oddělení
Pro agenty vyberte přístupná oddělení.
5
Poslat pozvánku
Obdrží email s linkem na nastavení.
Nastavení
Výkonnost týmu
Jak se váš tým podpory provádí. Přístup je na základě povolení, ne podle role: View oprávnění otevře stránku, řízení svolení odemyká cíle, QA a kolegium-identifikace čtení, a reward- financial povolení je to, co přidává kartu Odměny. Tým vedení může být uveden kterýkoli z nich, aniž by se stal úplným administrátorem.
Výkonnost týmuSkutečná týmová obrazovka: každý agent skóroval na hlasitosti a CSAT, s odměnou zůstatek můžete vyplatit za řadu.
Jak je stránka organizována
Tým výkon je pět karet. Každý odpovídá na jinou otázku, a jsou objednány tím, jak naléhavě obvykle potřebují vás.
Středisko pro velení 01
Stav živé fronty, výsledky zákazníků proti vašim cílům, jak byla kapacita vynaložena, situace, které vyžadují rozhodnutí, a index per--spoluhráčů upravený dokázanýmzpůsobem.
02 Teammates
Leaderboard, uznání (nejvíce zlepšené a pruhy), questy, a opt- v kontrole pro ty, kteří mohou vidět pořadí.
03 Kvalita
Scorecards, zaznamenané hodnocení, dohoda recenzenta opravená o Chance- opravené recenze, posun recenzentů a spory o důkazy.
Odměny 04
Hodnota tokenu, výplatní nároky a přidělení stanoveného období: autorizovat financovaný strop, přezkoumat náhled, dokončit.
05 Historie
Jak se pracovní prostor pohyboval v čase: trendová metrika s grafem a 28-denní heatmap ukazující, kdy tým skutečně pracoval. Každá karta se skrývá, dokud není dostatek historie k nakreslení.
Odbodováno není nula
Spoluhráč bez dostatečného zpracovaného objemu - nebo jehož rozměry s důkazy tvoří méně než polovinu nastavené hmotnosti - je zobrazen jako Unscored. Jejich skóre, hodnost a pásmo jsou prázdné a jejich rozpad je skryt. To je záměrné: vykreslování chybějící měření jako nula staví někoho na spodní část žebříčku pro mít klidný týden. Prahové hodnoty důkazů jsou konfigurovatelné pro pracovní prostor v cílech & bodování.
Oba důkazy prahy dělat různé práce a to stojí za to udržet je od sebe. Minimální zařízené rozhodne, zda někdo je bodován vůbec. Minimální hodnocení nemá vliv na skóre: rozhoduje o ocenění a odměňování způsobilosti. Takže spoluhráč může být plně skóroval a zařadil a stále není způsobilý pro toto období, protože příliš málo zákazníků hodnotil je.
💡
Každá postava je oskenována do pracovního prostoru, který sledujete, a časového rozsahu, který si vyberete. Spoluhráč pracující ve dvou oddělených pracovních prostorech má nezávislý záznam v každém. Dvě výjimky stojí za to vědět: web GROUP je jeden pracovní prostor, takže jeho členské domény jsou měřeny společně; a All- weby zobrazit záměrně měří vše najednou.
Index výkonnosti
Kompozice pěti rozměrů, každý měřený proti cíli jste nastavit spíše než proti kolegům, pak tažen směrem k středu, když důkazy za ním je tenký. Všimněte si směru: úprava pohybuje figurku směrem 70, takže tenké vynikající skóre se stáhne dolů a tenké špatné skóre je vytaženo nahoru. Špatný první týden na čtyřech rozhovorech není ustálený verdikt buď. Jako důkaz hromadí upravený údaj konvertuje na surový jeden.
Kvalita
Spokojenost zákazníků z ověřené zpětné vazby. Doplňují výsledky QA skóre tam, kde existují a jsou řízeny.
Reakce
První reakční doba na percentilech P50 a P90, proti vašim cílům.
Usnesení
Čas rozlišení a jednodotyková rychlost rozlišení.
SLA
Nahrávání proti SLA, které jste nakonfiguroval, plus riziko a narušení počtu.
Stewardship
Znovu otevřít a převádět sazby - práce, která se vrací.
💡
Váhy jsou konfigurovatelné a relativní; nemusí být zcela 100. Chybějící důkazy mohou pouze snížit index, nikdy zvýšit - plná nakonfigurovaná hmotnost zůstává ve jmenovateli.
Kapacita a produktivní doba
Okupace, produktivní čas, řešen za výrobní hodinu a online podíl okna. Využití není záměrně hlášeny: potřebuje plánované hodiny jako jmenovatel, OpsIQ nemá rozpis nebo posun zdroj, a nahrazen jmenovatel by byl odhad nosí procentuální znaménko. To zní jako nedostupný s tímto důvodem připojený.
⚠️
Hlášení pouze. Okupace říká, jak byl čas strávil, nikdy, jak dobře to bylo vynaloženo, a to nikdy peníze, brány nebo velikosti platby. Spoluhráč bez handle- time důkazy se čte jako nedostupný, nikdy jako nula.
Zajištění kvality
Scorecard je rubrika recenzenti skóre skutečné konverzace proti. Pouze publikovaná verze může získat hodnocení, a zveřejnění nové verze nikdy přepíše to, co již bylo vstřelil. Přezkum je důkaz o jednom rozhovoru, ne verdikt na osobu.
Dohoda o přezkumu
Hlášen jako "Chance- corrected statistika" (Cohen 's a Fleiss' kappa), není hrubý podíl dohody. Dva recenzenti, kteří projdou všechno dohodnout 100% času, zatímco nesou žádné informace.
Přezkumník drift
Zda recenzent skóre systematicky těžší nebo měkčí než jejich kolegové na stejné konverzace - srovnání se zbytkem panelu, není trend v čase. Potřebuje interakci přezkoumán nezávisle více než jednou.
Spory
Spoluhráč může formálně zpochybnit důkazy zaznamenané o nich. Otevřené spory bloky reward- období dokončení, dokud je vyřešen.
Self- review
Spoluhráč nemůže předložit hodnocení sebe sama.
⚠️
AI- hodnocené hodnocení nemůže ovlivnit plat, dokud je zveřejněna kalibrace ukazuje model souhlasí s lidskými recenzenty dostatečně úzce, měřeno kappa proti minimálnímu vzorku. Otevřená brána znamená, že model souhlasí se lidmi dostatečně blízko počítat - to nikdy neznamená, že je model správný.
Uznání
Samotný ranking má zdokumentované selhávání režimů: metrická hra, vyhoření, a veřejné zahanbení toho, kdo je poslední. Tři alternativy sedí vedle něj.
Nejvylepšenější
Měřeno proti předchozí rekord spoluhráče, nikdy proti kolegům, s zmenšením tak malý jmenovatel nemůže koupit výhru.
Proudové sítě
V jednotlivých obdobích, která splňují pevný, deklarovaný bar - průměrný rating, zpracovaný objem, počet ratingů a negativní- zpětná vazba, všechny absolutní čísla. Každý může držet pruh současně, takže to nevytváří žádné pořadí, a kolega s výjimečným měsícem nemůže zlomit váš.
Opt- in ranking
Vypnuto standardně. Spoluhráč vždy vidí svůj vlastní index; zda vidí kolegy je rozhodnutí pracovní prostor. Percentile kapely mohou být zveřejněny místo absolutních pozic.
💡
Uznání se nikdy nedotkne peněz. Pruh nemůže financovat výplatu nebo rozbít jeden, a nejvíce zlepšené není kategorie ocenění.
Quests
Cíl, ke kterému tým pracuje, měřeno proti pevnému deklarovanému baru spíše než proti sobě navzájem - takže každý může vyčistit stejné hledání ve stejném období.
Oblast působnosti a kadence
Individuální nebo týmová; jednorázová, opakovatelná nebo sezónní s explicitním oknem.
Kritéria
Rozhovory řešeny, ratingy obdržené, aktivní dny, průměrný rating, nebo negativní zpětná vazba. Všechny absolutní - žádný metrický, jehož hodnota závisí na tom, co kolegové udělali.
Ochránce kvality
Požaduje se na každé výpravě s objemem cíle. Trefit počet, zatímco kvalita padá pod podlahu brání hledání spíše než dokončit, a to je uvedeno jako zadržený, ne nedokončený.
Opakovací limity
Víčko na dobu neurčitou, poháněné nejpomalejším kritériem, plus volitelné chlazení před tím, než se může počítat opakování.
Týmové questy
Sdílený pokrok bez předspoluúčasti publikovaných, takže týmová výprava se nemůže stát žebříčkem.
Trénování
Trenérské zasedání je rekord, ne chat. Má trenér, spoluhráč je koučování, plánovaný čas, dohodnuté body k hovoru, a shrnutí napsané poté. Skutečné chaty, lístky a QA hodnocení jsou připnuty k tomu jako důkaz, takže konverzace je ukotvena na práci, která skutečně se stala spíše než na zapamatovaný dojem.
Řečnické body
Dohodnuto před zasedáním, takže spoluhráč není vchází do překvapení.
Důkazy
Chaty, vstupenky a QA hodnocení připojené k relaci. Pin ukládá odkaz - typ a ID - není kopie, takže vždy ukazuje na živé záznamu. OpsIQ neověřuje id před přijetím.
Akční body
Každý s vlastníkem a termín splatnosti. Položka po datu je zobrazena jako zpožděný - odvozený stav, ne status, který si někdo musí pamatovat nastavit.
Soukromý vzkaz
Trenérův vlastní vzkaz. Kolega, který je koučován, ho nikdy nemůže přečíst - ne jako agent, ne jako manažer, ne jak majitel. Tento šek běží před každým dalším povolením a nelze jej přepsat.
Kdo může vidět sezení
Trenér, spoluhráč a kdokoliv s výkonnostním povolením vedení týmu. Nikdo jiný, včetně ostatních spoluhráčů ve stejném oddělení.
Audit
Každý výtvor, aktualizace, pin, odpinutí a dokončení je zaznamenáno s tím, co se změnilo, kým.
💡
Koučování je záměrně odděleno od bodování a od peněz. Sezení nemění ničí index, neruší odměnu, a neobjevuje se na žebříčku.
Odměny a odměny
Nahrávaná aktivita převádí na žetony s peněžní hodnotou, kterou nastavíte. Cesta k platbě je záměrně pomalá a každý krok se zaznamenává.
1
Nastavit symbolickou hodnotu
Kolik žetonů se rovná kolik peněz a jakou má každá činnost hodnotu.
2
Autorizace financovaného stropu
Po uzavřenou kalendářní dobu, celý správce uvádí maximální žetony, které může platit. Uložení formuláře nastavení nepovoluje rozpočet, a nemůže změnit strop, který již byl povolen.
3
Přezkoumat náhled
Příjemci, rezervní a důvod, proč je někdo nezpůsobilý. Otevřené důkazy tento krok blokují.
4
Dokončit
Přídělový poměr je trvale zaznamenáván s důkazy za ním. Období, které alokované nic nelze zrušit a re- spustit přímo. Ten, který vydal žetony musí být obrácen první: OpsIQ píše kompenzační záznam proti každé peněžence a nikdy smaže originál, takže kniha stále ukazuje, co se stalo a proč, a teprve pak je období uvolněno. Odvrácená verze odmítá, pokud někdo již vyinkasoval více než částka byla získána zpět, a jména, kdo a tím, jak moc.
⚠️
Způsobilost vyžaduje ověřenou zpětnou vazbu od zákazníků. Kvalita AI skóre může doplnit, že úsudek, ale nikdy nahradit, a spoluhráč ukázal jako Unscore není způsobilý. Každý přispěvatel je omezen na 25% nad jejich očekávaný podíl období, takže jeden velmi vysoký objem měsíc nemůže absorbovat celý rozpočet.
💡
Majitel účtu se nepodílí na odměňování ani na symbolických odměnách, bez přepínače: povolují financovaný strop a dokončují každý příděl a není nad nimi nikdo, kdo by schvaloval, co by si sami platili. Jejich práce je měřena, bodována a hodnocena na tabuli přesně jako kdokoliv jiný.
Všichni ostatní se účastní ve výchozím nastavení, tým vede a spolumajitelé zahrnuty. Chcete-li někoho vynechat, otevřít je v Team & Departments a vypnout Takes část v odměňování a možnosti odměny. Jejich práce je stále skóroval a ukázal, že přestanou být kandidátem od tohoto bodu, a nic již dokončeno není dotkl.
⚠️
Nikdo neschválí peníze pro sebe. Protože lidé, kteří se mohou zúčastnit jsou také lidé, kdo mohou schválit výplaty, OpsIQ odmítá výplatu nebo úvěr do své vlastní peněženky, placení vlastního nároku, dokončení období, ve kterém byste byli placeni, a dokončení ocenění byste vyhráli. Další plný správce nebo majitel musí udělat. Platit všechny pohledávky přeskočí svůj vlastní a hlásí to jako přeskočil, ne selhala.
Kdo vidí a dělá co
Zobrazit výkon týmu
Rada, živý stav, kapacita a přehled kvality pracovního prostoru.
Správa týmového výkonu
Cíle a bodování, exporty, skóre a hodnocení QA, koučování, questy a čtení, které nesou údaje o kolegiích, jako jsou per- admin historie a historii ocenění.
Zobrazit odměnu týmu finance
Zůstatky, peněžní hodnoty, směnky a platební reference - oddělené od důkazů o výkonnosti, protože jsou v blízkosti výplaty.
Pouze úplný správce
Každá peněžní mutace: vyplácení odměny, placení nebo zamítnutí pohledávky, schválení rozpočtu, dokončení, zrušení či zvrácení přídělu a stanovení sazby token- to- cash. Ty nemohou být delegovány udělením povolení.
Používat ji spravedlivě
Index výkonnosti je řídící důkazy, ne automatické rozhodnutí o zaměstnání. Otevřete zdroj konverzace za číslem před jednáním na něm, a zvážit složitost případů, plány, dovolenou a dostupnost potřeby. Jeden těžký týden nevypadá nic jako trvalý vzor.
Nastavení
Vaše stránky (pracovní prostory)
Stránky (pracovní prostory) vám umožní spravovat více webových stránek z jedné OpsIQ instalace. Každý má svůj vlastní sledování, AI, konektory a přístup do týmu.
StránkySkutečná obrazovka Stránky: každé místo je vlastní izolovaný pracovní prostor (vlastní doména, konektor a nastavení), přidaný a otevřený z jednoho seznamu.
Vytvoření webu
1
Přejít na připojené stránky
Přejít na propojené stránky.
2
Přidat nový web
Zadejte název, doménu a popis.
3
Kopírovat klíč k webu
Each site gets a unique key (site_xxx) for the widget snippet.
4
Nastavit nezávisle
Každá stránka má své vlastní AI, konektory a nastavení.
Kolik stránek můžu mít?+
To záleží na tvém plánu, zkontroluj si detaily.
Nastavení
Licence a plán
Vaše OpsIQ licence kontroluje funkce, limity stránek a AI kreditní zůstatek.
LicenceSkutečné licenční centrum: váš plán a aktivní stav, maskovaný klíč, váš AI- kreditní zůstatek a one-click force re-verification.
Licenční klíč
Zadejte v Nastavení > Licence. Validováno proti licenčnímu serveru OpsIQ.
Rychlostní rychlost / ověření
OpsIQ běžně čte podepsanou místní licenční cache a v případě potřeby obnovuje validaci. Použijte Silou dálkovou kontrolu, pokud potřebujete okamžitý výsledek; diagnostika identifikuje DNS, HTTPS nebo server- time problémy.
Plán
Určuje dostupnost a limity.
Mezní hodnota místa
Maximální počet pracovních míst.
Úvěry AI
Pokud používáte Managed AI, váš kreditní zůstatek je uveden zde.
Konec platnosti
Před vypršením doby platnosti se prokluz, aby se zabránilo přerušení služby.
Co se stane, až mi vyprší licence?+
Sledování, jízdenky a CRM pokračuje. AI má pauzu až do obnovení. Data jsou zachována.
Nastavení
Profil, heslo a ověření dvou faktorů
Každý administrátor si může zachovat svou vlastní identitu, pracovní preference, heslo a ověření dvou faktorů.
Produktová obrazovkaProfil stránka odděluje osobní údaje, jazyk / časové pásmo, avatar / podpis, heslo a dva-faktor autentizace.
Nastavení profilu patří k administrátorovi znakového tvaru a nemění značku pracovního prostoru. Použijte jedinečné heslo a povolit autentizaci dvou faktorů. Změna e-mailu nebo nastavení ověřovací funkce může vyžadovat opětovné ověření nebo nové označení.
Nastavení
Oznamovací preference
Kontrola preferencí oznámení, které provozní události se dostanou k administrátorovi ve výrobku nebo e-mailem.
Produktová obrazovkaStránka oznámení poskytuje per- event in- app a e-mailové volby plus seznam aktuálních oznámení.
Předpisy zahrnují zadání vstupenek, odpovědi zákazníků, upozornění SLA, chatu a akce pro schválení AI. Udržet někde aktivní operační signály; vypnutí emailu nemusí nutně vypnout oznámení v rámci aplikace.
Nastavení
Přehled bezpečnosti
Bezpečnostní přehled je první obrazovka pro hodnocení bloků, přihlašovacích útoků, hrozeb sessions, bezpečnostních trendů a integrity událostí.
Produktová obrazovkaSecurity Přehled kombinuje aktuální karty rizika, a 14-Denní trend, seznam útočníků, stav událostí a integrity.
Použijte hlavní karty pro třídění, poté otevřete související Audit, Selhal Logins, Blocked IPs nebo JavaScript Záložka Chyb pro práci na záznamní- úrovni. 14-day trend je užitečnější než jeden hrot. Vysoce-hrozící sezení by měla být zkoumána proti návštěvníkům, požadavek a autentizace důkazy před permanentní blok je aplikován.
Nastavení
Evidentní evidenční zpráva auditora
Účetní záznamy zaznamenávají, kdo co udělal, kdy, k němuž vznést námitku, na jaké úrovni rizika a zda uspěl.
Produktová obrazovkaNa stránce auditu je možné vyhledat, zda je to zřejmé, činnost s akcí, aktérem, rizikem, cílem a výsledkem.
Filtr podle činnosti, rizika a činitele; vývoz CSV nebo JSON pro šetření. Hašišový řetězec pomáhá odhalit chybějící nebo změněné řádky auditu, ale nenahrazuje chráněné zálohy a omezený přístup do databáze. Zacházet s auditními vývozy jako citlivými, protože mohou identifikovat uživatele, záznamy a bezpečnostní opatření.
Operace
Diagnostika
Diagnostika přemění kontroly subsystému na výsledky v oblasti zdraví prostého angličtiny a přímé další akce.
Produktová obrazovkaDiagnostika skupiny kontroly zdraví widget, AI, vstupenky, integrace, Site Intelligence, pozadí úkoly, automatizace CRM, licence a skladování.
Stránka kontroluje rychlost stránek, pořadí / klíčová slova / backlink / lokální data, AI a akční brána, vstupenky, crawler / audity, integrace / event příjem, úkoly pozadí, CRM automatizace, licence, widget a související služby produktu. Úmyslně hlásí, že operator- čitelné příčiny spíše než odhalování surových tajemství.
Po změně, Obnovit a potvrdit postižený subsystém vrátí zdravé. Zelená diagnostika stránka je nezbytná, ale není dostačující pro spuštění; vyplňte také předběžný seznam.
Nastavení
Bezpečnost a přístup
OpsIQ obsahuje více bezpečnostních vrstev pro ochranu admin, data, a API přístup.
Jak to fungujeBezpečnost
Bezpečnostní prvky
Autorizace administrátora
Email / heslo s volitelným 2FA.
Uzamčení přihlášení
Dočasný zámek po příliš mnoha neúspěšných pokusech.
IP blokování
Blok IPs nebo CIDR se pohybuje od přístupu ke sledovaným stránkám.
Skórování hrozeb
Výhružné skóre na základě chování. Vysoce ohrožené návštěvníky lze automaticky zablokovat.
Vymáhání HTTPS
Vyžaduje všechna spojení. HTTP přesměruje na HTTPS.
Okamžitě aplikujte aktualizace pro bezpečnostní záplaty.
Nastavení
Role a oprávnění
Rolery - Na základě přístupového řízení můžete kontrolovat, co každý člen týmu může udělat.
Role a oprávněníRole matice na první pohled: Majitel dostane všechno, Full Admin všechno kromě fakturace a nebezpečné zóny, Agent pouze jejich koupené vstupenky.
Výchozí role
Majitel
Všechno včetně licence, nebezpečné zóny a řízení instalace.
Kompletní admin
Všechno kromě licence a nebezpečné zóny.
Agent
Reagovat na assigned- oddělení vstupenky a chaty, zobrazit analytiky. Žádné nastavení, tým, nebo přístup k bezpečnosti.
Můžu si vytvořit vlastní role?+
Tři role plus úkol oddělení dává zrnitou kontrolu.
Nastavení
Blokovaný IPs
Správa IP adres zablokovaných z přístupu k vašim sledovaným stránkám.
Blokovaný IPsPravý Block IPs displej: zablokovat jeden IPnebo CIDR rozsah, a spravovat seznam, každý s datem, důvod a one-click odblokovat.
Jak blokovat
1
Přejít na bezpečnost > Blokované IPs
2
Přidat rozsah IP nebo CIDR
Příklad: 203.0.113.42 nebo 203.0.113.0/24
3
Přidat důvod
Dokument, proč: spam, zneužívání, škrábání atd.
Bude blokování mít vliv na legitimní uživatele?+
Pokud zákazníci sdílejí společnost IP nebo VPN, blokování, že IP Všechny na něm zablokuje.
Nastavení
Neúspěšné přihlášení
Všechny neúspěšné přihlašovací pokusy k vaší OpsIQ admin.
Neúspěšné přihlášeníSkutečný neúspěšný záznam: každý účet /IP s jeho počet selhání a poslední pokus, blokovat brute- size zdroj přímo z řady.
Co každý záznam ukazuje
Datum / čas
Když se to stalo.
E-mail
Použitá e-mailová adresa.
IP adresa
Zdroj pokusu.
Země
Geografická poloha.
Důvod
Špatné heslo, zamčené, nebo nenalezeno.
Varovné příznaky
Mnoho pokusů, stejný e-mail
Hádání hesel. Zajistit 2FA je povoleno.
Mnoho pokusů, různé e-maily
Automatický útok. Blokovat zdroj IP.
Neobvyklé země
Pokud je váš tým místní, cizí pokusy jsou pravděpodobně útoky.
Nastavení
Analytik zabezpečení AI
Opt- in analytikem vrstva nad bezpečnostními stránkami: verdikt, incidenty slipy, denní trávení, týdenní kontrola držení těla, Zeptejte se bezpečnosti, a 0Nikdy se nekoná na cestě pro návštěvníky.
Každá stránka Security zaznamenává, co se stalo, ale čtení je stále trvá úsudek. AI bezpečnostní analytik dodává, že soud na místě, a to je postavena k tomu, aby téměř nic netrávil: nikdy sedí v majáku nebo přihlašovací cestě, deterministické pravidla řeší zjevné případy bez volání AI, verdikt jsou cached, a analytik je nejlepší výstup je determinační pravidlo, které pak vynucuje navždy na nulové žetony. Zapněte funkce v Nastavení → Bezpečnost; všechny výchozí vypnuty.
Co to přidává
Verdikt čipy + Vysvětlit
Zablokováno IPs a selhané logins řádky ukazují benigní / podezřelý / nepřátelský čip se skóre sebevědomí. Vysvětlit otevírá odůvodnění, použité skutečnosti, a one-click Block / Release akce. Cached 24h, takže re- prohlížení IPje zdarma.
Incidentní informace
Související události se shlukují do jednoho incidentu (přihlašovací vlna, URL scan, autoblock burst) s prostou anglickou časovou osou a doporučeným dalším krokem. Probíhající útoky se skládají do stejného incidentu.
Denní stravovací
Jeden rekapitulace za den: včera versus vaše základní linie, bloky, incidenty, a jediná věc, která dělat. Tiché dny vyslat deterministické vše jasné na nulové žetony.
Týdenní kontrola polohy
Pondělí zpevnění kontrolní seznam (2FA mezery, výluka práh versus skutečný objem útoku, upozornění off) s vážností, úsilí a přesné opravy na položku.
Zeptejte se bezpečnosti.
Otázková schránka na bezpečnostní přehled, která odpovídá z vašeho živého bezpečnostního státu. Hluboké serverové otázky jsou předány admin inženýr chatu spíše než uhodl.
Návrhy politiky + autopilot
Analytik navrhuje konkrétní bloková pravidla jako schválené / Vyřazovací karty; schválená pravidla vynucují nulové tokeny s počítačem live hit. Volitelný autopilot automaticky schvaluje pouze nejbezpečnější pravidla.
Nastavení
AI security analyst (security_ai_enabled)
Master switch. Umožňuje verdikt čipy, Vysvětlit a zeptat se bezpečnosti. Pouze nejednoznačné IPs dosáhnout modelu, přichycen do jednoho hovoru.
Incident briefs (security_ai_incidents)
Seřazuje události do incidentů a píše každý nový příběh. Běží na stávající hodinový bezpečnostní cron.
Daily digest (security_ai_digest)
Jeden bezpečnostní rekapitulace za den na zvonek a Přehled. Tiché dny nestojí nic.
Weekly posture check (security_ai_posture)
Pondělní utvrzovací kontrolní seznam na Přehledu. Kontrolní seznam je plně deterministický.
Policy autopilot (security_ai_autopilot)
Umožňuje analytikovi aktivovat své nejbezpečnější návrhy bez dozoru: reverzibilní čas-omezené bloky, jediný IPs nebo rozsahy, které nejsou širší než /24, nikdy nesdílené / mobilní / soukromé, s limitem 10 za hodinu, vždy auditované a nerealizovatelné.
💡
Every call is tagged security_ai with its own monthly cap in AI Config → Cost Guardrails (default 300k tokens). If the cap is hit, features degrade to deterministic reads. Blocking, lockouts and alerts never depend on this budget. The analyst can never delete data, change settings, touch the audit ledger, or make a permanent ban.
Operace
Cron a automatizace
OpsIQ používá jeden program produktů pro spuštění e-mailové hlasování, automatizace lístků, analytické rollupy, retence, AI fronty, CRM práce, zprávy a konektorové práce.
Produktová obrazovkaJeden produkt cron vstup dodává tlukot srdce; OpsIQ rozhoduje, která vnitřní pracovní místa jsou splatná.
Požadovaný produkt cron vstup
Přidat tento řádek do crontab pro stejný server a PHP prostředí, které běží OpsIQ:
Nahradit /path/to/opsiq s instalační kořenem. Použijte plnou cestu PHP CLI, když hostitel potřebuje například jednu /usr/bin/php8.4.
Nepoužívejte horní hladinu /cron.php pro práci s výrobky. V tomto úložišti, který běžec patří do samostatné non-produkt služby mimo tuto příručku. OpsIQ produktový běžce je opsiq/cron/all.php.
Co sjednocený plánovač řídí
Vstupenky a fronty AI
Proces, které se mají provádět autoodpovědi, eskalace, schválení a další práce na produktu v rámci fronty.
Příchozí e-mail
Zpravodajské služby nakonfigurované poštovní schránky, kde je zvolenou metodou příjmu.
Analytika a zasedání
Sestavuje zasedání a obnovuje plánované agregáty, když jsou splatné.
CRM a zapojení
Skóruje, pracuje, probíhá, kampaň a je možné provádět zprávy.
Zadržování a údržba
Provádí práce na čištění, archivu, ukončení platnosti a integritě.
Konektory
Vysílá konektory cron předplatitelů a hlasovací lístky pouze pro nainstalované, zapnuté a konfigurované konektory.
Ověřit cron
Otevřít Nastavení - Nastavení chronu a potvrdit, že výrobce existuje.
Použití Běž hned. jednou, pak potvrďte admin a hlasovací srdce beats aktualizace.
Kontrola Diagnostika pro pozdní srdeční tep, PHP CLI, databáze nebo problém s cestou souborů.
Prohlédněte si /tmp/opsiq-cron.log nebo cestu záznamu, kterou jste zvolili, když manuální běh selže.
Udržujte konektory krátké, idempotentní a workspace- scoped. Šarže dlouhé synchronizace a ukládat kurzor / kontrolní bod, aby další běh může pokračovat bezpečně.
🚫
Když produkt cron zastaví, čas-based OpsIQ práce zastaví nebo se opozdí, i když běžné admin stránky mohou stále načíst.
Operace
Operace s hnacím zařízením
Hostované OpsIQ nasazení využívá stejné produktové obrazovky a pracovní toky, zatímco hosting operátor spravuje server vrstvy. Obchodní sign- up, plány, fakturační a účetní portálové postupy jsou mimo tuto příručku.
Produktová obrazovkaHosted provoz se mění, kdo udržuje infrastrukturu; nemění, jak zákazníci používají OpsIQ.
Co obvykle hostující operátor spravuje
Web server, PHP runtime, databázová služba, TLS a úložiště.
Jednotný produkt cron a jeho server- level protokoly.
Aktualizace aplikací, monitorování infrastruktury a proces zálohování stanovený dohodou o hostování.
Co stále spravuje správce OpsIQ
Instalace webových stránek a widget, nastavení AI, znalosti, poštovní schránky a pracovní toky pro podporu uživatele.
Přístup do týmu, oddělení, bezpečnostní kontroly, API klíče, konektory, automatizace a data-retence nastavení.
Ověření výrobku pomocí diagnostiky, protokolu auditů, zkoušek konektorů a skutečných kontrol koncového stavu.
Provozní kontroly
Nepředpokládejte, že řízená služba znamená, že každý produkt integrace je zdravý. Potvrďte nejnovější zálohovací důkazy a retenční politika s hostingovým operátorem, a používat OpsIQ Diagnostika po změnách DNS, e-mail, AI poskytovatelé, webové stránky nebo konektory.
Tato část zahrnuje pouze operace produktů. Komerční správa nastupování, předplatné, fakturace a zákazníků- účet zůstává mimo příručku OpsIQ.
Operace
Self- hosting OpsIQ
Sám-hostitel OpsIQ instalace běží na infrastrukturu, kterou ovládáte. Jste zodpovědní za runtime, databáze, TLS, produkt cron, zálohy, aktualizace a monitorování.
Produktová obrazovkaSelf- hosting poskytuje řízení infrastruktury a dělá váš tým zodpovědný za každou provozní závislost.
Minimální softwarová smlouva
PHP
PHP 8.4 or newer. Required extensions: curl, pdo_mysql, mbstring, json, xml, openssl, zip, intl and gd.
Databáze
MySQL 5.7+ nebo MariaDB 10.3+ pomocí InnoDB. Vytvořte vyhrazenou databázi a least- privilegovaný uživatel aplikace.
Webový server
Apache nebo Nginx nakonfigurované pro přední regulátor OpsIQ, statická aktiva a požadované přepisy.
HTTPS
Požadováno pro admin sessions, widget provoz, API klíče, webháky a volání poskytovatele.
Přístup na východ
Umožněte DNS a HTTPS přístup k AI, e-mailu, konektoru a licenčním koncům, které skutečně povolíte.
Přístup k souborům
Uživatelé webových a CLI musí být schopni číst soubory aplikací a psát pouze do zdokumentovaných míst runtime / store.
CronCity in New York USA
Spustit OpsIQ plánovač produktů každou minutu se stejnou konfigurací aplikace a přístupem k databázi jako webový proces.
Instalace sekvence
Nahrát uvolnění do zamýšleného kořene dokumentu a zachovat dodanou strukturu adresáře.
Vytvořte databázi a aplikační uživatele, pak zadejte databázi, kanonický URL a nastavení licence.
Spusťte tok instalátoru / nastavení a vytvořte první účet vlastníka.
Povolit HTTPS a ověřit přesměrování, cookies a veřejné widget /API cesty.
Spusťte zdrojové brány a před spuštěním nebo prvním uvedením do provozu dokončete kontrolu produktu. Příkaz, který je k dispozici, není důkazem, že prošel ve Vašem prostředí.
Produktová obrazovkaZobrazení výhybek ukazuje, že je nutné spustit bránu; neoznačuje je tak, jak prošly.
Zdroj a uvolňovací brány
Spusťte kontrolu úložiště z instalačního kořene a uchovejte jejich kompletní výstup s vydáním záznamu.
Primární předletová brána
php tools/preflight.php
Rozšířená uvolňovací brána
php tools/release_gate.php
Předlet kontroluje běh PHP 8.4 a vyžaduje prodloužení, provede syntaxe PHP, spustí AI vyhodnocovací lodní bránu a plnou sadu PHPUnit a provádí kontroly PHPStan / Node při instalaci těchto nástrojů. Rozšířená brána zahrnuje také kouřovou, čistou instalaci / schéma a kontrolu konce prohlížeče, když je jejich prostředí nastaveno.
Přeskočení kontroly není průchod. Zaznamenejte, proč nebyl k dispozici, nainstalujte chybějící závislost nebo spusťte ji do správného prostředí CI / staging před uvolněním.
Kontroly produktů
1. Autentizace a role
Přihlaste se jako každá zamýšlená role; ověřte si povolené a zamítnuté stránky / akce.
2. Widget a sledování
Načíst reálné stránky v soukromém prohlížeči; ověřte provoz majáku, Live Feed, návštěvník a relace záznamy.
3. Chat a AI
Položit reprezentativní otázky; ověřit znalosti uzemnění, bezpečnost, eskalace a historie AI.
4. Vstupenky
Vytvořit, přiřadit, odpovědět, eskalovat, zavřít a znovu otevřít přes každou povolenou cestu příjmu.
5. E-mail
Testovací odchozí dodávka a každá nakonfigurovaná příchozí poštovní schránka nebo cesta webhooku.
6. CRM a analytika
Vytvořit řízený kontakt / deal / konverze a ověřit přístrojové desky, nádobky, bodování a zprávy.
7. Connectors
Spustit zkoušky připojení, jedno čtení, jeden bezpečný zápis / suché běh a webhook / hlasovací cesty pro každý povolený konektor.
8. API a háčky
Ověřte úzké skoky, omezení sazeb, idempotentní retry, podpisy a duplikát manipulace.
9. Cron
Spusťte jednotný program produktů a potvrďte všechny potřebné tlukot srdce v Cron Setup / Diagnostics.
10. Bezpečnost
Ověřit 2FA, CSRF / řízení zasedání, záznamy o auditu, zrušení klíče a izolaci pracovního prostoru.
11. Zálohování a obnovení
Obnovit aktuální zálohu do samostatného zkušebního prostředí a ověřit data a konfiguraci.
12. Pozorovatelnost a návrat
Potvrdit záznamy / upozornění, zachovat ID žádosti a prokázat postup zpětného vrácení.
⚠️
Vydejte se pouze po každé požadované bráně a obchodní-kritické cestě má aktuální důkazy pro přesné uvolnění a prostředí.
Vývojář
Web Push na třetích stránkách
Upozornění na push prohlížeč (včetně OpsIQ Push Campaigs) potřebují servisní pracovník sloužil ze stejného ORIGIN jako stránka.OpsIQ widget zatížení z vašeho OpsIQ nasazení, takže třetí strana stránky nemohou zaregistrovat OpsIQ je pracovník přímo. Hostit jeden malý soubor na webu vlastní doménu, aby bylo možné tlačit tam. Kamery dodávají prostřednictvím metody podpory obou.
Jak to fungujeWeb push
Proč je to potřeba?
Prohlížeče jen nechat stránku zaregistrovat servisní pracovník z jeho vlastního původu. Widget zatížení cross-původ z vašeho OpsIQ nasazení, takže nemůže nainstalovat tlakový pracovník na zákaznické stránky, dokud hostitel pracovník na místě původu, widget tiše přeskočí tlačit (bez chyby, žádné předplatné). Máte dvě možnosti níže;OpsIQ Push Campaigs publikovat přes oba.
Volba A · Self- hostované webové Push (VAPID, žádná třetí strana)
1. Stáhněte si pracovníka z vašeho nasazení OpsIQ: https://YOUR-OPSIQ/opsiq/opsiq-push-sw.js
2. Nahraj to do svého webová kořene takže je dosažitelný na https://yoursite.com/opsiq-push-sw.js. Widget Automaticky detekuje tuto cestu na stránce je vlastní původ a registruje ji, žádná drobná změna potřeba. (Používá úzký rozsah, takže nikdy nahradit servisní pracovník již spustit.)
Nepovinné: pokud je nutné hostit na nestandardní cestě, nasměrujte widget na něj před je akceptován pouze tehdy, pokud pochází ze stejného místa:
Volitelné · pouze pokud soubor není NOT na kořenu webu
3. V OpsIQ, generovat VAPID klávesy (Nastavení → Klient Chat AI → Advanced → Web Push). Widget pak žádá návštěvníky o povolení k oznámení a předplatné je.
Za CDN /Cloudflare? Ujistěte se, /opsiq-push-sw.js vrací HTTP 200 (Vyčistěte cache, pokud to bylo 404 před nahráním; cached 404 bude blokovat registraci).
Možnost B · Pusher Beams (řízený poskytovatel)
1. V nastavení OpsIQ nastavte poskytovatele push na Kostřava a vcházejte do svých beamů Identifikace účastníka a Tajný klíč.
2. Hostit Beams servisní pracovník na místě kořene jako /service-worker.jsRozumím. https://YOUR-OPSIQ/opsiq/pusher-beams-service-worker.js, nebo sloučit tuto řádku do vašeho stávajícího kořenového pracovníka:
Pracovník na korálech, hostitel na https://yoursite.com/service-worker.js
3. Widget automaticky načte Beams SDK a připíše každému návštěvníkovi per- site úrok opsiq-site-<your-site-key>Žádné další vedení není potřeba.
Jak se kampaně šíří
Tlačit kampaně publikovat prostřednictvím both metody najednou: návštěvníci na sebe-hostovaný VAPID pracovník získat šifrované webové Push, a návštěvníci přihlášeni přes Pusher Beams dostat Beamse publikovat. Každý návštěvník je dosaženo prostřednictvím toho, co se přihlásili, takže můžete spustit same-původ VAPId na některých stránkách a cross-Origin Beamsi na jiných.
HTTPS je vyžadován pro servisní pracovníky a Web Push (localhost je osvobozen od testování). Admin chat inbox již používá stejný Beams mechanismus zájmu pro upozornění operátora.
Operace
Řešení problémů
Společné otázky a jak je napravit.
Obecné
Prázdná stránka+
Zkontrolujte chybové protokoly PHP. Příčiny: starý PHP (potřeba 8.4+), chybějící rozšíření, DB připojení selhalo, špatná oprávnění souboru.
Přístrojová deska ukazuje nuly+
Kontrola: widget nainstalován? Cron běh? Datový rozsah správný? IP vyloučen?
AI
AI neodpovídá.+
Kontrola: nakonfigurovaný poskytovatel? API platný (použít zkušební připojení)? Vyčerpaný rozpočet? Sestava Workspace AI správně?
AI dává špatné odpovědi+
Kontrola: Znalostní základna aktuální? Prompt jasné? Propojovací vyhledávače vrací správné údaje? Recenze konverzace v historii AI.
AI je pomalý.+
Závisí na tom: Poskytovatel API rychlost, kontext velikost (velké KB = více tokenů = pomalejší), sítě latence. Zkuste rychlejší model.
Sledování
Widget chybí+
Kontrola: skript ve zdroji stránky? Chyby JS v konzoli? Blokování CSP? Ad blocker?
Neznámá země+
GeoIP není nakonfigurován. Použijte Cloudflare (automatická) nebo MaxMind GeoLite2 databáze.
Kontrola: povoleno? Oddělení povoleno? AI nakonfigurováno? Cron běh? Člověk odpověděl první?
Konektory
Spojení selhalo+
Kontrola: oprávnění správně? Klíč vypršel? API přístupný ze serveru? Základna URL Je to tak?
Připojeno, ale bez dat+
Kontrola: API klíčové skopy? Synchronizace Webhook povolena? Cron běh?
Výkonnost
Pomalé stránky+
Kontrola: výkon databáze (SHOW PROCESSLISLX), paměť PHP (zvýšení na 1GB), možnost opcache, zkrácení retenčního období.
Operace
Widget neloguje návštěvy
Použijte tuto cílenou kontrolu, pokud widget zatížení nesprávně nebo Live Feed zůstane prázdné.
Kdy widget není logování návštěv, ověřte klíč k webu, načíst stránku v soukromém prohlížeči, zkontrolujte prohlížeč Síť / Console panely pro blokované maják nebo widget žádosti, přezkoumat Content- Security-Policy a ad blokátory, potvrdit, že web je aktivní v OpsIQ, a otevřít diagnostiku. Viditelná chatovací bublina neprokáže sám o sobě, že analytický maják byl přijat.
Odkaz
Glosář
Definice pojmů používaných v rámci OpsIQ.
Akce
Něco, co může AI udělat přes konektor nebo plošinu.
Agent
Člen týmu s omezeným přístupem, nebo agent AI.
BYOK
Přineste si vlastní klíč, poskytnete svůj vlastní AI API klíč.
Konektor
Modul integrující vnější platformu s OpsIQ.
CSAT
Skóre spokojenosti zákazníků.
Platí
Příležitost k získání příjmů v CRM.
Oddělení
Kategorie vstupenek pro řízení tratě a přístupu.
Eskalace
Přesun letenky na jiné oddělení nebo z AI na člověka.
GeoIP
Detekce polohy návštěvníka z IP adresy.
HandoffCity in New York USA
Převádím rozhovor z Al na člověka.
Totožnost
Podepsaný symbol identifikující návštěvníka webových stránek.
Znalostní základ
Články, které AI používá k zodpovězení otázek.
Olovo
Návštěvník, který ukazuje záměr nákupu.
Olověné skóre
0-100 číslo udávající pravděpodobnost přeměny.
Stadium životního cyklu
Pokud je zákazník: Olovo, Prospect, Zákazník, Na riziko, Koordinováno.
Spravovaná AI
AI je poskytována jako součást vašeho plánu OpsIQ.
Potrubí
Vizuální deska stádií.
RBAC
Rolery-založené na přístupovém řízení.
Sezení
Série zobrazení stránek v timeout okno.
Klíč pro stránky
Jedinečný identifikátor pro sledované webové stránky.
SLA
Dohoda o úrovni služeb, časy odezvy cíle.
TokenCity in New York USA
Jednotka AI. Zhruba 4 znaky = 1 Token.
Důvěřujte vrstvě
Bezpečnostní systém kontroluje autonomii AI.
Webhook
HTTP volání zpět pro oznámení událostí.
Widget
JavaScript kód vložen na vašich webových stránkách.
Pracovní prostor
Stránka s vlastním sledováním, AI, konektory a tým.
Odkaz
Sežeň si další pomoc.
Pokud tato dokumentace neodpovídá na vaši otázku:
Admin AI
Klikněte v adminu na tlačítko "Zeptejte se OpsIQ". Má přístup k této dokumentaci a vašim platformám.
Podpůrná jízdenka
Zahrnout: to, co jste zkoušeli, co se stalo, co očekáváte, a jakékoli chybové zprávy.
E-mail
E-mailová podpora s licenčním klíčem a popisem vydání.
Tipy pro účinné žádosti o podporu
Zahrnout stránku
Která admin stránka (URL nebo název).
Zahrnout nastavení
Přesné nastavení jména a aktuální hodnoty.
Zahrnout chybu
Přesná chybová zpráva s kódy.
Zahrnout kroky
Co jsi udělal, krok za krokem.
Zahrnout očekávané vs aktuální
Co by se mělo stát, nebo co se stalo.
💡
Čím konkrétnější je vaše žádost, tím rychlejší odpověď. "Nefunguje" vyžaduje šetření. "Kliknutím na Uložit na AI konfiguraci dává chybový kód 502" dostane přímou odpověď.