Centrum nápovědy Zendesk
Propojte své centrum nápovědy v Zendesk s lokalizačním engine. Zapněte synchronizaci u kategorií, sekcí a článků, které chcete překládat, a Lingo.dev je přeloží do jazyků vašeho centra nápovědy a zapíše překlady zpět do Zendesk.
Funguje s obsahem Zendesk Guide (Centrum nápovědy): kategoriemi, sekcemi a články.
Zendesk je dostupný s tarifem Enterprise. Pokud se na stránce Připojit zobrazuje Zendesk není ve vašem tarifu, ozvěte se nám a vyřešíme to.
Než začnete#
Budete potřebovat tři věci:
Přístup správce do Zendesk. Připojení používá OAuth a účet, který autorizaci provádí, musí mít oprávnění ke správě obsahu centra nápovědy. Každý překlad, který Lingo.dev zapíše, se v Zendesk přiřadí tomuto účtu. Pokud tedy nechcete, aby se u celého centra nápovědy zobrazovalo jméno jednoho člena týmu, připojte se přes sdílený servisní účet.
Cílové jazyky aktivní v Zendesk. Lingo.dev nabízí přesně ty jazyky, které má vaše centrum nápovědy aktivní — a žádné jiné. Zapněte je v Zendesk v Knowledge -> Settings -> Language settings.
Jazyky přidané v části Admin Center -> Account -> Appearance -> Localization jsou vedené zvlášť a jazyk Centra nápovědy NEaktivují.
Pokud chcete přesně vidět, co vaše centrum nápovědy přijímá, otevřete
https://<subdomain>.zendesk.com/api/v2/help_center/locales.jsonpo přihlášení jako správce. Cokoli tento endpoint uvádí, to bude Lingo.dev nabízet.Lokalizační engine. Jeho glosář, hlas značky a pravidla určují, jak budou překlady vašeho Centra nápovědy vypadat.
Zdrojový jazyk nevybíráte: Lingo.dev při každém spuštění načte ze Zendesk výchozí jazyk vašeho centra nápovědy.
Už máte Centrum nápovědy přeložené?
Při první synchronizaci se zachovají překlady, které už v Zendesku jsou. U každé položky a jazyka platí, že pokud už je v Zendesk k dispozici kompletní překlad, Lingo.dev ho ponechá beze změny a přeloží jen to, co chybí. Pokud chcete stávající překlad nahradit, použijte Přeložit znovu.
Propojte své Centrum nápovědy#
Otevřete integraci
Přejděte do Studio -> All integrations a na kartě Zendesk klikněte na Connect.
Vyplňte formulář
| Pole | Co zadat |
|---|---|
| Název | Jak toto propojení pojmenovat, abyste svá Centra nápovědy snadno rozeznali |
| Centrum nápovědy | Pouze subdoména z vaší URL v Zendesk. Pro https://acme.zendesk.com zadejte acme — formulář za ni doplní .zendesk.com |
| Engine | Lokalizační engine, jehož glosář, pravidla a hlas značky budou tyto překlady používat |
| Režim | V režimu Draft se překlady zapíšou jako nepublikované koncepty, Publish je zveřejní hned po zapsání. Níže najdete rozdíl mezi koncepty a publikovanými verzemi |
Klikněte na Continue to Zendesk.
Autorizujte v Zendesk
Zendesk vás požádá o udělení přístupu pro Lingo.dev. Klikněte na Allow. Dokud to neuděláte, nic se nevytvoří: po kliknutí na Deny se vrátíte zpět do formuláře a žádné připojení nevznikne.
Vyberte jazyky
Po návratu do Lingo.dev uvidíte jazyky, které má vaše centrum nápovědy aktivní, bez jeho výchozího jazyka. Všechny jsou předem vybrané. Zrušte zaškrtnutí u těch, které nechcete, a pak klikněte na Save and open.
Pokud má centrum nápovědy jen jeden jazyk, Lingo.dev vás nejdřív vyzve, abyste v Zendesk přidali další.
Vyberte, co se bude překládat#
Stránka připojení má pět karet: Categories, Sections, Articles, Workflow runs a Settings.
První tři vypisují obsah daného typu, vždy po jednom řádku na položku, s vyhledávacím polem pro názvy a ID. Název v každém řádku odkazuje na danou položku v Zendesk, takže si můžete ověřit, co vybíráte. Každý řádek má přepínač Sync: jakmile ho zapnete, daná položka se od té chvíle stane součástí připojení. Změna se uloží hned po přepnutí, žádné tlačítko Uložit tu není. Přepínač v záhlaví tabulky zapne nebo vypne synchronizaci pro vše v seznamu.
Zaškrtávací políčka slouží pro jednorázová spuštění. Zaškrtněte řádky a objeví se dvě tlačítka, Queue sync (N) a Queue retranslation (N), která spustí jen tyto řádky, aniž by změnila to, co má zapnutý Sync.
Nic se nepřenáší dál
Zapnutí kategorie přeloží jen její vlastní název a popis, ne sekce a články pod ní. Pokud chcete pokrýt celou kategorii, zapněte také její články na kartě Articles. Přepínač v záhlaví zapne vše, co je v seznamu, a pak můžete zrušit zaškrtnutí toho, co nechcete.
Co se překládá#
| Položka | Překládaná pole |
|---|---|
| Kategorie | Název, popis |
| Sekce | Název, popis |
| Článek | Název, obsah |
Obsah článků se překládá jako HTML, takže formátování, odkazy i vložená média zůstanou po celém procesu zachované.
Synchronizace a opětovný překlad#
Dvě tlačítka, dvě různé úlohy:
| Tlačítko | Co dělá | Kdy ho použít |
|---|---|---|
| Sync | Přeloží jen to, co se od posledního spuštění změnilo | Běžné aktualizace. Ve většině případů budete chtít používat právě toto |
| Retranslate | Přeloží vše znovu bez ohledu na to, jestli se něco změnilo | Po změně glosáře, hlasu značky nebo pravidel vašeho engine, když chcete znovu vygenerovat stávající překlady |
Obě možnosti najdete v záhlaví stránky, kde se vztahují na vše se zapnutým Sync, a zobrazí se také nad tabulkou po zaškrtnutí řádků, kde se vztahují jen na tyto řádky. Retranslate ze záhlaví vás nejdřív požádá o potvrzení, protože se účtuje každá vybraná položka a každý jazyk.
Běhy se spouštějí ručně. Když v Zendesk upravíte článek, nový běh se nespustí — o tom, kdy překládat, rozhodujete vy.
Na jedno připojení může běžet vždy jen jedno spuštění. Když během běhu vyžádáte další, zařadí se do fronty za něj; pokud je fronta plná, zkuste to znovu, až některé spuštění skončí.
Sledujte spuštění#
Karta Workflow runs uvádí všechna spuštění: kdy začala, co je spustilo, které jazyky zahrnovala, jak dlouho trvala a jaký mají stav. U spuštění, které ještě běží, je tlačítko Stop. Otevřením řádku zobrazíte výsledek pro jednotlivé jazyky.
Spuštění, které skončí jako Up to date, není chyba. Znamená to, že se od posledního spuštění nic nezměnilo, což je běžný výsledek, když synchronizaci spustíte dvakrát bez jakékoli úpravy mezi tím.
Kam se překlady ukládají#
Každý překlad se připojí ke stejnému článku, sekci nebo kategorii jako jazyková verze pro dané národní prostředí — podle vlastního modelu překladu Zendesk. Čtenáři si v Centru nápovědy přepnou jazyk a uvidí ji; nic se neduplikuje ani nepřesouvá.
Koncepty vs. publikované#
V režimu Draft dorazí překlady do Zendesk jako nepublikované koncepty. Dokud je někdo v Zendesk nezkontroluje a nepublikuje, čtenáři nic neuvidí. Tohle je nejlepší režim pro začátek, pokud vaše centrum nápovědy ještě nemá žádné překlady a vy teprve hodnotíte kvalitu.
V režimu Publish se překlady zveřejní hned po zapsání.
Už máte publikované překlady? Použijte Publish
V režimu Draft se překlad, který Lingo.dev zapíše pro jazyk, jenž už je publikovaný, stane konceptem tohoto jazyka a čtenáři přijdou o živou verzi, dokud ji někdo znovu nepublikuje. Pokud vaše centrum nápovědy už překlady nabízí, zvolte Publish.
Režim můžete později změnit na kartě Settings spolu s engine a cílovými jazyky.
Nastavení#
Na kartě Nastavení vidíte, ze kterého Centra nápovědy propojení čte a u kolika položek obsahu je synchronizace aktivní. Můžete tu také změnit název, cílové jazyky, engine a režim. Každá změna se uloží hned, jak ji provedete.
Pokud už některý z vybraných jazyků není v Zendesk aktivní, karta na to upozorní. Synchronizace tento jazyk přeskočí a při další změně seznamu se odstraní.
Odpojení#
Disconnect dole na kartě Settings zastaví Lingo.dev ve čtení z centra nápovědy i v zapisování do něj. Odstraní připojení, jeho historii spuštění i záznam po jednotlivých článcích o tom, co už bylo přeloženo. Překlady, které už byly zapsané, zůstanou v Zendesk — patří vašemu centru nápovědy, ne nám.
Opětovné připojení
Opětovné připojení spustí nový záznam o tom, co už bylo přeloženo. První synchronizace po opětovném připojení zachová překlady, které už v Zendesku jsou, včetně těch, které Lingo.dev přeložil dříve, a přeloží jen to, co chybí.
Omezení#
| Omezení | Detail |
|---|---|
| Typy obsahu | Kategorie, sekce a články. Tickety, makra, motivy a příspěvky komunity podporovány nejsou |
| Bloky obsahu | Články sestavené ze Zendesk content blocks se nepřekládají |
| Triggery | Pouze ručně — bez webhooku, bez automatické synchronizace při změně článku |
| Souběžná spuštění | Jedno na každé připojení; další požadavky se řadí do fronty za něj |
| Cílové jazyky | Než je Lingo.dev může nabídnout, musí být aktivní ve vašem centru nápovědy v Zendesk |
| Připojení | Několik Center nápovědy v rámci jedné organizace, každé připojené jen jednou |
Řešení problémů#
Na stránce Připojit se zobrazuje, že Zendesk není ve vašem tarifu. Zendesk je dostupný s Enterprise. Ozvěte se nám a vyřešíme to; vše, co už je připojené, bude mezitím dál fungovat.
Na stránce Připojit se zobrazuje, že tohle nemůžete připojit. Připojení vyžaduje oprávnění, které vaše role nemá. Připojit ho může správce organizace, nebo vám toto oprávnění může udělit.
V seznamu chybí cílový jazyk. Nejprve ho aktivujte v Zendesk v Knowledge -> Settings -> Language settings a potom znovu otevřete kartu Settings v Lingo.dev. Seznam se pokaždé načítá ze Zendesk.
Po kliknutí na Allow vás Lingo.dev vyzve, abyste v Zendesk přidali jazyk. Centrum nápovědy je napsané v jednom jazyce a žádný další nenabízí, takže zatím není do čeho překládat.
Synchronizace skončí jako Up to date. Buď se od posledního spuštění nic nezměnilo, nebo ještě nic nemá zapnutý Sync. Zapněte obsah, který chcete pokrýt, na kartách Categories, Sections a Articles.
Překlady se v centru nápovědy nezobrazují. Zkontrolujte, jestli není připojení v režimu Draft. Koncepty v Zendesk existují, ale čtenářům zůstávají neviditelné, dokud nejsou publikované.