Ak chcete používať Blitzz Cobrowse na vlastnej webovej stránke, musíte pridať Cobrowse SDK na každú webovú stránku, ktorú chcete podporovať. Urobili sme to čo najjednoduchšie – stačí len niekoľko riadkov kódu.
Po pridaní SDK do vašej aplikácie sa overení agenti môžu pripojiť k zariadeniam používateľov výlučne cez svoj webový prehliadač – bez inštalácií či doplnkov.
Cobrowse SDK pre web je k dispozícii pomocou značky
<script> cez CDN.Poznámka: Nasledujúci návod slúži na to, aby sa agenti mohli pripojiť k návštevníkom webovej stránky bez nutnosti ručne generovať a zdieľať 6-miestny kód relácie. Ak chcete implementovať ručné generovanie kódu, kliknite sem.
Pomocou značky script
Pridajte tento fragment JavaScriptu na začiatok sekcie <head> vašej webovej stránky.
<script>
let blitzz;
let st = document.createElement("script");
st.src = "https://media.blitzz.co/sdk/blitzzcobrowse.min.js";
st.async = 1;
let tx = document.getElementsByTagName("script")[0];
tx.parentNode.insertBefore(st, tx);
st.onload = function () {
if (!blitzz) {
blitzz = new BlitzzCobrowse({});
blitzz.initialize({
license:"your license key",
});
}
};
</script>Zaregistrujte si účet a vygenerujte si licenčný kľúč (License Key) na https://{{Domain}}.blitzz.co/cobrowse/settings/installation.
Tým sa relácie z vašej webovej stránky priradia k vášmu účtu Blitzz.
Keď máte nastavený fragment JavaScriptu a licenčný kľúč, prejdite na https://{{Domain}}.blitzz.co/cobrowse/ a uvidíte svoje zariadenie v zozname. Kliknutím na tlačidlo „Connect“ (Pripojiť) spustíte reláciu Cobrowse!
Poznámka: Cobrowse musí mať prístup k vašej webovej stránke, preto adresy localhost na testovanie neodporúčame. Na testovanie lokálnej vývojovej verzie odporúčame použiť ngrok.
Cobrowse pre web podporuje všetky hlavné prehliadače vrátane Chrome, Firefox, Safari, Opera, Edge a IE11.
Naše Web SDK má voliteľný režim „full-device“ (celé zariadenie), ktorý umožňuje používateľovi zdieľať celú pracovnú plochu bez akejkoľvek inštalácie. Z dôvodu obmedzení prehliadačov nie je táto funkcia dostupná v IE11 ani v mobilných prehliadačoch, ako sú Mobile Chrome a Mobile Safari.
Podporované konkrétne verzie prehliadačov sú Chrome 16+, Firefox 11+, Safari 7+, Opera 12.1+, Edge 12+ a IE11.
Pri riešení problémov na webe postupujte podľa týchto krokov:
- skontrolujte, či boli dodržané všetky kroky a požiadavky z tejto dokumentácie
- skontrolujte vývojársku konzolu na strane agenta aj klienta, či neobsahuje chybové hlásenia
- skontrolujte nižšie uvedené sekcie, či zodpovedajú chybovým hláseniam, ktoré vidíte
Niektoré zdroje (napr. CSS) nemusia byť dostupné z verejného internetu (napr. predprodukčné prostredia, ako je UAT), a preto sa tieto prvky vašej webovej stránky agentom nezobrazia.
Ktoré súbory sú zakódované, zistíte vložením hexadecimálneho kódu do https://cryptii.com/pipes/hex-decoder.
Zabezpečte, aby boli tieto súbory dostupné pre náš server tým, že ich zverejníte.
Ak má vaša webová stránka zásady CSP, môžu blokovať funkčnosť Cobrowse. Keď CSP blokuje blitzz.co, v konzole JavaScriptu sa zobrazí chyba:
Refused to connect to https://blitzz.co/... because it violates the document's Content Security Policy.Na vyriešenie je potrebné v CSP povoliť nasledujúce:
connect src pre:
connect-src blitzz.co *.blitzz.co wss://*.blitzz.co ;Ak svoju inštanciu hostujete sami, nahraďteblitzz.covašou adresou<your instance domain>v každom prípade.
script-src pre:
script-src 'unsafe-inline' media.blitzz.co/sdk/;Ak namiestomedia.blitzz.co, používate samostatne hostovanú verziu web SDK, použite namiesto toho jej úplnú URL, napr.https://<your instance domain>/sdk-js/Cobrowse.js.
Ak chcete, môžete unsafe-inline nahradiť hashom svojho fragmentu. Nájdete ho v konzole JavaScriptu.
Ak má ten istý používateľ súčasne so svojím bežným oknom prehliadača otvorené jedno alebo viac okien inkognito, okná inkognito sa v zozname zariadení zobrazia ako samostatné zariadenia.