Řešení problémů

Tato stránka je technická reference — popisuje, jak aplikace zpracovává jména, co způsobí, že jméno nelze skloňovat, a jaké jsou předpoklady správného fungování. Nemáme historii support ticketů, abychom mohli identifikovat „nejčastější problémy” — pokud narazíte na něco, co zde nenajdete, napište nám přímo.

Pravidla validace jmen

Aplikace přijme jméno ke skloňování pouze tehdy, pokud projde regex kontrolou (/^[\wá-ž]{2,}$/i). Jména, která touto kontrolou neprojdou, jsou označena jako nevyskloňovatelná a původní hodnota je zachována jako fallback — jde o záměrné chování, nikoliv chybu.

Jména, která projdou (přijata ke skloňování):

• Standardní česká a latinská písmena (a–z, á–ž, A–Ž)
• Číslice a podtržítka

Jména, která neprojdou (nevyskloňovatelná, původní hodnota zachována):

Znak	Příklad
Pomlčka	Jan-Pavel
Mezera	María José
Apostrof	O'Brien
Nelatiková abeceda	李偉, محمد
Méně než 2 znaky	A

Pokud jméno neprojde validací, metapole addressing a last-name-addressing obdrží původní jméno beze změny a gender je nastaven na unknown.

Klíče metapolí

Aplikace zapisuje do tří metapolí v namespace czech-names-app, typ single_line_text_field:

Klíč	Obsah
czech-names-app.addressing	Skloňované křestní jméno (např. „Jano”)
czech-names-app.last-name-addressing	Skloňované příjmení (např. „Nováková”)
czech-names-app.gender	male, female, nebo unknown

Ověření hodnot v administraci Shopify: otevřete zákazníka, sjeďte dolů na sekci Metapole, klikněte na „Zobrazit vše” a nahoře klikněte na tlačítko „Zobrazit nestrukturovaná metapole” a hledejte metapole v namespace czech-names-app.

Upozornění

Při přístupu k metapolím v Liquid vždy používejte hranaté závorky — pomlčka v názvu namespace rozbije tečkovou notaci:

{{ customer.metafields['czech-names-app'].addressing }}  {# správně #}
{{ customer.metafields.czech-names-app.addressing }}     {# nefunguje — pomlčka je interpretována jako odečtení #}

Předpoklad: aktivní fakturace

Pokud fakturace není aktivní, aplikace tiše přeskočí veškeré zpracování webhooků. Pokud se metapole vůbec nezobrazují, zkontrolujte nejprve stav předplatného. V administraci Shopify: Nastavení → Aplikace → Skloňování jmen. Dashboard aplikace zobrazuje hlášku „Billing is not enabled”, pokud předplatné není aktivní.

Pokud předplatné vypršelo nebo nebylo při instalaci odsouhlaseno, obnovte ho. Poté budou noví zákazníci zpracováváni automaticky. U stávajících zákazníků může pomoci ruční uložení jejich profilu v administraci.

Časování a omezení synchronizace do Klaviyo

Synchronizace do Klaviyo proběhne jednou za každou zákaznickou událost (vytvoření nebo aktualizace). Automaticky se neopakuje.

Klaviyo potřebuje 3–5 minut po vytvoření zákazníka, než je jeho profil dostupný přes Klaviyo API. Pokud synchronizace proběhne dříve, než profil v Klaviyo existuje, je pro tuto událost trvale přeskočena. Jediný způsob, jak ji znovu spustit, je následná aktualizace zákazníka v Shopify.

Vlastnosti zapisované do Klaviyo:

• Czech addressing
• Czech last name
• Gender

Nastavení API klíčů a potřebná oprávnění jsou popsána na stránce Integrace Klaviyo.

Detekce pohlaví

Pohlaví je detekováno externím API sklonovani-jmen.cz na základě českých jazykových pravidel. Aplikace nemá vlastní logiku detekce pohlaví — výsledek API je uložen tak, jak přijde.

• male nebo female — API přiřadilo gramatický rod s jistotou
• unknown — jméno neodpovídá českým jazykovým vzorům (časté u cizích jmen)

Tato hodnota vyjadřuje gramatický rod sloužící výhradně pro oslovení (Pane / Paní / neutrální). Nastavení pro přepsání výsledku detekce neexistuje.

UI Extensions nezobrazují nic během načítání

Extensions zobrazují prázdný obsah, dokud se data načítají, a také zobrazují prázdný obsah, pokud metapole czech-names-app u zákazníka ještě neexistují. Zákazníci vytvořeni před instalací aplikace nemusí mít metapole ihned k dispozici — pokud je u zákazníka nevidíte, zkuste jeho profil upravit a uložit.

Potřebujete pomoc?

Napište nám na integrace@soundsgood.agency. Uveďte prosím:

• URL vašeho obchodu
• Křestní jméno a příjmení zákazníka, u kterého problém nastává
• Co jste očekávali a co se skutečně stalo
• Screenshot sekce Metapole na zákaznickém profilu (pokud je relevantní)