Propojte své Centrum nápovědy Zendesk s lokalizačním engine. Vyberte kategorie, sekce a články, které chcete zahrnout, a Lingo.dev je přeloží do vašich cílových jazyků a zapíše překlady zpět do Zendesk.
Funguje s obsahem Zendesk Guide (Centrum nápovědy): kategoriemi, sekcemi a články.
Integrace Zendesk je aktivní pro každou organizaci zvlášť. Pokud ji nevidíte v Settings -> Integrations, ozvěte se nám a zapneme ji pro vás.
Než začnete#
Budete potřebovat tři věci:
Administrátorský přístup 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.
Vaše cílové jazyky jsou v Zendesk aktivní. Zendesk přijme překlad jen pro jazyk, který už má Centrum nápovědy k dispozici. Aktivujte je v Zendesk v části 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ě zjistit, které jazyky vaše Centrum nápovědy podporuje, otevřete
https://<subdomain>.zendesk.com/api/v2/help_center/locales.jsona přihlaste se jako správce. Co je uvedené na tomto endpointu, to si pak můžete vybrat v Lingo.dev.Lokalizační engine. Jeho glosář, hlas značky a pravidla určují, jak budou překlady vašeho Centra nápovědy vypadat.
Kódy jazyků se musí přesně shodovat se Zendesk
Zendesk používá kódy jako en-us a de-de. Pokud je zdrojový jazyk vašeho Centra nápovědy vedený jako en-us, vyberte v Lingo.dev English (United States), ne jen English – jde o dva různé jazyky (en-US vs en) a tenhle nesoulad je zdaleka nejčastější důvod, proč připojení selže.
Propojte své Centrum nápovědy#
Otevřete integraci
Přejděte do Settings -> Integrations a u Zendesk klikněte na Connect.
Vyplňte formulář
| Pole | Co zadat |
|---|---|
| Subdoména | Jen označení z vaší Zendesk URL. Pro https://acme.zendesk.com zadejte acme – bez https:// a bez .zendesk.com |
| Engine | Lokalizační engine, který bude tento obsah překládat |
| Zdrojový jazyk | Jazyk, ve kterém jsou vaše články napsané, přesně tak, jak ho uvádí Zendesk |
| Cílové jazyky | Jazyky, do kterých chcete překládat. Všechny musí být nejdřív aktivní v Zendesk |
| Uložit jako koncepty | Nechte zapnuté, pokud chcete zapisovat překlady jako nepublikované koncepty. Vypněte, pokud je chcete publikovat hned |
Autorizujte v Zendesk
Budete přesměrováni do Zendesk. Klikněte na Allow. Potom se vrátíte na stránku Zendesk v Lingo.dev a připojení bude aktivní.
Vyberte, co se bude překládat#
Stránka Zendesk má dvě karty: Content a Runs.
Karta Content zobrazuje vše ve vašem Centru nápovědy – kategorie, sekce a články v jedné tabulce. Pomocí filtračních štítků nad ní (All, Categories, Sections, Articles) seznam zúžíte a pomocí zaškrtávacích políček vyberete, co chcete zahrnout. Název v každém řádku odkazuje na danou položku v Zendesk, takže si můžete snadno ověřit, co vybíráte.
Výběr kategorie automaticky nevybere její obsah
Kategorie, sekce a články se vybírají nezávisle na sobě. Pokud chcete přeložit celou kategorii, vyberte kategorii a zároveň její sekce i články.
Než spustíte synchronizaci, nejdřív uložte. Nové připojení začíná s prázdným rozsahem a synchronizace používá uložený rozsah — ne to, co máte zrovna zaškrtnuté na obrazovce. Když synchronizaci spustíte dřív, než cokoli uložíte, běh se vrátí s tím, že není nic k překladu. Klikněte na Uložit a pak teprve překládejte.
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 | Znovu přeloží vše v rozsahu, úplně od začátku | 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 na dvou místech: v záhlaví stránky, kde pokrývají celý uložený rozsah, a nad tabulkou obsahu, kde se vztahují jen na řádky, které máte právě vybrané.
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.
Najednou může běžet jen jedno spuštění. Zatímco je spuštění aktivní, obě tlačítka jsou neaktivní.
Sledujte spuštění#
Karta Runs zobrazuje všechna spuštění včetně jejich stavu, co je spustilo, kdy začala a jak dlouho trvala. Spuštění, které ještě běží, můžete ze seznamu zrušit.
Otevřete běh a podívejte se na jeho podrobnosti: v jaké je fázi — načítání obsahu ze Zendesk, překlad, zapisování zpět — i na celkový průběh a průběh pro každý cílový jazyk. Snadno tak uvidíte, že němčina už je hotová, zatímco japonština ještě běží.
Běh, který skončí hláškou není nic k překladu, není chyba. Znamená to, že vše v daném rozsahu už odpovídá svým překladům, což je běžný výsledek, když synchronizaci spustíte dvakrát po sobě, aniž byste mezi tím cokoli upravili.
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á.
Komu jsou překlady připisovány
V Zendesk je jako autor každého překladu uveden účet, který připojení autorizoval, ne člověk, který klikl na Synchronizovat. Pokud nechcete, aby se u celého Centra nápovědy zobrazovalo jméno jednoho kolegy, připojte službu pomocí sdíleného servisního účtu.
Koncepty vs. publikované#
Když je Save as drafts zapnuté, překlady dorazí do Zendesk jako nepublikované koncepty. Vaši zákazníci nic neuvidí, dokud je někdo v Zendesk nezkontroluje a nepublikuje. Je to bezpečné výchozí nastavení a doporučujeme ho ponechat, dokud vyhodnocujete kvalitu překladu.
Když tuto možnost vypnete, překlady se publikují hned po zapsání.
To můžete později změnit v Settings -> Integrations -> Zendesk spolu s vaším engine a cílovými jazyky.
Odpojení#
Odpojením se odstraní připojení, jeho historie běhů i záznam u jednotlivých článků o tom, co už bylo přeloženo. Překlady, které už byly zapsány, ale v Zendesk zůstávají — patří vašemu Centru nápovědy, ne nám.
Po opětovném připojení začínáte od nuly
Protože se ztratí stav synchronizace u jednotlivých článků, první synchronizace po opětovném připojení považuje celý váš rozsah za nový a přeloží ho celý znovu — se všemi souvisejícími náklady. Odpojujte se tehdy, když chcete opravdu přestat, ne když jen řešíte potíže.
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 připojení |
| Cílové jazyky | Než do nich bude moct spuštění zapisovat, musí být aktivní ve vašem Centru nápovědy Zendesk |
Řešení problémů#
Připojení selže hned po kliknutí na Povolit. Ve většině případů jde o nesoulad jazyků: zdrojový jazyk, který jste vybrali, v Centru nápovědy neexistuje. Otevřete https://<subdomain>.zendesk.com/api/v2/help_center/locales.json, poznamenejte si přesný kód, který je tam uvedený, a znovu se připojte s ním.
V rozbalovací nabídce chybí cílový jazyk. Nejdřív ho aktivujte v Zendesk v části Knowledge -> Settings -> Language settings a pak znovu otevřete nastavení v Lingo.dev.
Synchronizace hlásí, že není nic k překladu. Buď je váš uložený rozsah prázdný — vyberte obsah na kartě Obsah a klikněte na Uložit — nebo je v něm už všechno aktuální.
Překlady se v Centru nápovědy nezobrazují. Zkontrolujte, jestli je připojení v režimu konceptů. Koncepty v Zendesk existují, ale zákazníkům zůstávají neviditelné, dokud nejsou publikované.
