Průvodce a nápověda MarketHub

🚀 Rychlý start (5 minut do první kampaně)

1. Ověřte e-mail — při registraci obdržíte potvrzovací odkaz. Klikněte na něj (odkaz vyprší za 3 dny).
2. Přidat SMTP účet — Boční nastavení: Účty → +Přidat. Zobrazit podrobný průvodce účty.
3. Získej první leady — nebo scrapování z Zdroje → Hledat firmy, nebo import CSV z Kontakty → Import.
4. Vytvořit šablonu — Šablony → +Nová nebo "Generovat pomocí AI".
5. Spustit kampaň — Kampaně → +Nová: 4 kroky (šablona, příjemci, účty+načasování, přehled).

📊 Dashboard

Úvodní stránka po přihlášení — zobrazuje stav vašeho CRM + živou aktivitu.

4 hlavní KPI (klikatelné)

• 👥 Kontakty celkem — všechny leady z CRM. Kliknutím vyfiltrujete Kontakty na "vše".
• ✉️ S e-mailem — pouze ty s platnou e-mailovou adresou. Klik → zobrazí "outreach-able leads".
• 🌐 S webem — leady s detekovanou URL (používá AI při výzkumu jednotlivých kontaktů).
• ⭐ Průměrné hodnocení — skóre kvality vypočítané z úplnosti dat.

Sekundární karty

• Další čísla: Bez webu, Bez e-mailu, Aktivní zdroje
• Živá aktivita: živý přehled aktivit AI asistentů napříč všemi kampaněmi
• Rychlý přístup: 4 rychlé spuštění — AI Agent, Video AI, Social Publish, SMS

Pozdrav + co je nového

"Ahoj, [Jméno]" + emoji podle denní doby. Automatické obnovení každých 90 sekund — není třeba mačkat reload.

👥 Kontakty (CRM)

Řídicí centrum pro vaše leady. Všechny importované nebo scrapované osoby/firmy se zobrazí zde.

Rozvržení stránky

• KPI pruh nahoře (6 klikatelných karet): Celkem / S e-mailem / S telefonem / S webem / Na seznamech / Blacklist
• Levý postranní panel (3 sbalitelné sekce):
  • Seznamy — vaše vlastní seznamy (statické segmenty). Speciální tlačítko Seznam vyloučení (ikona červeného zákazu) — vyloučit ze všech kampaní.
  • Segmenty — dynamické segmenty generované AI (např. "B2B střední firmy", "Retail București")
  • Štítky — volné štítky, které si sami vytvoříte
• Centrální tabulka — 8 řaditelných sloupců: ☑ zaškrtávací políčko / Jméno / E-mail / Telefon / Web / Kategorie / Štítky / Hodnocení

Panel filtrů (nad tabulkou)

• Webová stránka: Vše / S webem / Bez webu
• E-mail: Vše / S e-mailem / Bez e-mailu
• Kategorie: rozbalovací seznam dynamicky naplněný z tvých kontaktů
• Umístění: extrahováno z dat
• Kraj: všech 41 krajů + Bukurešť
• Vyhledávací pole: Vyhledávání v reálném čase podle Jména, E-mailu, Adresy, Telefonu

Hromadné akce (zobrazí se při výběru kontaktů)

Panel akcí se zobrazí nad tabulkou, jakmile zaškrtnete alespoň 1 kontakt:

• Přidat do seznamu — vyberte seznam z rozbalovací nabídky
• Přidat štítek — tag picker multi-select
• Seznam vyloučení — přidej na blacklist (již nedostávají nic)
• Smazat — trvale smazat z CRM

Tlačítka v záhlaví sekce

• 🤖 AI Insights — Claude analyzuje tvou databázi, navrhuje nové segmenty, dedup, normalizace
• 📥 Import — CSV (drag&drop), Mailchimp, Substack
• 📤 Export — stáhne aktuální zobrazení jako CSV
• 🖨️ Přehled — Tisknutelné PDF s KPI + top kategorie + top okresy
• 🧬 Duplikovat — detektor duplikátů s průvodcem sloučení (kombinuje poznámky, tagy, seznamy)
• + Manuálně — přidej kontakt jeden po druhém (Jméno + E-mail povinné)

Kontaktní panel (po kliknutí na jméno)

Otevře se pravý panel s:

• E-mail, Telefon, Web, Kategorie, Hodnocení
• Poznámky s časovým razítkem — přidej/uprav/smaž poznámky
• Přiřazené štítky — přidej/odeber
• Historie kampaní — v jakých kampaních byl příjemcem + stav (odesláno / odpověděno / nedoručeno / odhlášeno)
• Přepnout černou listinu za kontakt
• Vlastní pole — vaše vlastní dodatečná pole

Uložené filtry (přednastavení)

Ukládejte složité kombinace filtrů (např. "S e-mailem + Praha + Stavebnictví"). Kliknutím na předvolbu = okamžité použití.

Limity

• Hromadná akce se vztahuje na aktuální stránku (výchozí nastavení: 50 kontaktů/stránka)
• Max 500 kontaktů na zobrazení stránky
• Vyhledávání není omezeno, ale UI je optimalizováno pro ~100 znaků

Chybové zprávy

"Vyplňte lokalitu!" — při uložení kontaktu bez lokality
"Nic ke sloučení" — při slučování duplikátů bez shody
"Sloučení selhalo: [detail]" — podrobná chyba sloučení

🌍 Zdroje (databáze Google Maps)

Scrapingový modul, který nachází nové firmy přes Google Maps Places API. Pracuje ve 2 krocích: vyhledá firmy → extrahuje jejich e-maily.

Fáze 1: Hledej firmy

Vyhledávací pole

• Země: pouze 🇷🇴 Rumunsko prozatím (hardcoded)
• Umístění: město ("Cluj-Napoca"), kraj ("Bihor"), země ("Romania" pro celostátní hledání), nebo multi-search oddělený čárkou ("restaurant, cafenea, bar"). U velkých měst systém automaticky rozšiřuje na okolní čtvrti.
• Typ podnikání / obor: volitelné ("advokát", "zubař"). Prázdné = všechny firmy.
• Max výsledků: 1–500, výchozí 60. Pro tip: začněte s 60, zvyšte pokud je oblast velká.

Vyčerpávající režim (🚀 checkbox)

Aktivujte ho + vyberte Balíček širokých kategorií (ne jednotlivá klíčová slova). Dostupné bundle: Food & Beverage, Professional Services, Construction, Healthcare atd. Vyhledá všechny firmy z dané kategorie pro zadanou lokalitu — pomalejší, ale úplné.

Volitelné automatické akce

• Automaticky přiřadit štítky — štítky přiřazené pouze novým firmám (deduplikované)
• Automaticky přidat do seznamu — přidej výsledky do existujícího seznamu

Užitečná tlačítka

• Tipy pro pokročilé — AI navrhuje niky pro tvou lokalitu (používá Claude)
• Předvolba — uložíte aktuální vyhledávání jako opakovaně použitelnou předvolbu

Průběh

• Vyhledávací lišta "Hledá se..." s tlačítkem ⏹ Zrušit
• Scraping běží na pozadí — můžete přejít do jiné sekce, pokračuje dál
• Výsledky se zapisují do CRM v reálném čase, ne až na konci

Krok 2: Extrahovat e-maily

Výběr režimu

• Standard (~30–40% míra úspěšnosti) — navštíví homepage + /contact. Rychlé, vhodné pro velké dávky.
• Hloubková kontrola (~70–80% úspěšnost) — přidává deobfuskaci Cloudflare, Facebook /About, WHOIS lookup. Pomalejší, ale nachází skryté e-maily.

Firem na dávku

25 / 50 / 100 / 200 / 500. Větší = globálně rychlejší, ale vyšší riziko blokování IP. 50 je ideální bod.

Závěrečné tlačítko

"Extrahovat e-maily" (zelená, velká). Průběhová lišta s odhadovaným časem. Platné e-maily jsou automaticky přidány do Kontaktů → segment "Platné e-maily". Neplatné/znečištěné e-maily jsou filtrovány (interní blocklist 60+ domén: Sentry, Wix, errors atd.)

Historie a přednastavení

📋 Historie hledání

• Všechna předchozí vyhledávání s datem, polohou, typem a počtem výsledků
• Tlačítko Znovu načíst — znovu spustit stejné vyhledávání
• Tlačítko Vyprázdnit — smaže historii (NESMAŽE scrapované firmy)

⭐ Uložená hledání

Sbalitelný panel s uloženými vyhledáváními. Kliknutí = okamžité opětovné spuštění.

Pokročilá nastavení (rozbalte "Pokročilá nastavení")

1. 🧹 Vyčistit znečištěné e-maily — smazat chybně formátované e-maily ("error-lite@duckduckgo.com" apod.), aby bylo možné znovu načíst data těchto firem
2. 🔓 Odemknout tlačítko extrakce — odemkne tlačítko "Extrahovat e-maily", pokud je zablokováno po restartu serveru
3. ⚠ Smazat všechny firmy — NEVRATNÉ. Vyžaduje zadání "STERGE TOT" pro potvrzení. Smaže všechny scrapované firmy + tagy + seznamy.

Limity

• Podporované země: pouze Rumunsko (hardcoded)
• Max. výsledků na vyhledávání: 500
• Časový limit hloubkového skenování: ~30 s na firmu

Chybové zprávy

"Vyplňte lokalitu!" — povinné pole
"V režimu Exhaustive zvol širokou kategorii" — bundle povinný při zapnutém Exhaustive
"Chyba při spuštění scrapingu: [detail]" — API/připojení

✍️ E-mailové šablony (s AI Copywriterem)

Editor e-mailů se 2 režimy (Text / Design Studio) + integrovaný AI asistent.

Seznam šablon

• Záložky: Vše / Moje / Galerie
• Předpřipravená galerie — ukázkové šablony připravené k použití
• "Generovat pomocí AI" (fialová jiskra) — modal pro generování AI
• "Nová šablona" (+) — prázdný editor

Režim 1: Textový editor (📝)

Pole předmětu

• Max 200 znaků (pevný limit) — počítadlo "0 / 50 znaků" měkký pokyn
• Podporuje proměnné: {{firma}}, {{nume}}, {{oras}}, {{website}}, {{poza_logo}}
• Panel proměnných — rychlé vložení jedním kliknutím na pozici kurzoru

Editor těla zprávy (Quill WYSIWYG)

• Počet slov v reálném čase
• Formátování: Tučné / Kurzíva / Odkazy / Seznamy / Nadpisy

Přílohy

• Obrázky a PDF soubory (max 10 MB / soubor)
• "Přidat přílohu" — výběr souboru, automatické nahrání

Panel skóre spamu

• Skóre 0–100 (červená/žlutá/zelená)
• Seznam problémů: "Too many caps", "Spammy words: FREE, URGENT", "Missing unsubscribe link"
• Automatická kontrola při každé změně textu

Režim 2: Design Studio (🎨)

Vertikálně rozdělené rozvržení:

• Nahoře: náhled iframe — přepínání Desktop / Mobile / Dark mode + rozbalovací nabídka Produkt (kontext AI)
• Dole: Chat dock AI — historie konverzace, drag&drop obrázků (max 5MB), rychlé čipy:
  • "+ testimonial" — přidá skutečný testimonial s autorem + firmou
  • "+ pricing" — přidá pricing se 3 úrovněmi
  • "+ kroky" — přidá očíslované kroky jak to funguje
  • "+ stats" — velká čísla + krátké popisky
  • "kratší" / "přátelštější" / "dark" / "jiný nadpis"

Boční tlačítka (všechny režimy)

• Copywriter ✨ — chat: "Přepiš předmět chytlavěji", "Přidej silný hook", "Zkontroluj chyby"
• AI Design ✨ (pouze Design Studio) — modal brief: URL + produkt + instrukce
• Laboratoř předmětu — vygeneruje 5 variant předmětu, vyberete jednu
• Kritika — AI hodnotí tón, strukturu a srozumitelnost CTA
• Náhled — podívej se, jak to vypadá v Gmail/Outlook
• Překlady 🌍 — vícejazyčné varianty (EN, FR, DE, ES)
• Verze 🕒 — historie verzí (automatické ukládání), obnovení starých verzí
• Test — pošli test do své schránky
• Uložit (modrý) — nutné před použitím v kampani

Limity

• Předmět: max. 200 znaků
• Tělo: prakticky neomezené, ale >5000 znaků = e-mailoví klienti text oříznou
• Přílohy: 10 MB / soubor, více povoleno

Chybové zprávy

"Nejprve něco napište" — tělo zprávy je povinné
"Poznámka nemůže být prázdná" — poznámky v panelu kontaktu

📤 E-mailové kampaně (průvodce 4 kroky + monitoring)

Průvodce krok za krokem pro spuštění kampaně.

Krok 1: Šablona

• Název kampaně (interní, např.: "Restaurante Cluj — Aprilie")
• Vyberte šablonu ze svého seznamu (s náhledem)
• "Pokračovat" → krok 2

Krok 2: Příjemci

Výběr režimu (radio)

• "Všechny kontakty s e-mailem" (výchozí)
• "Konkrétní seznam" — vyberte z rozbalovací nabídky
• "Podle tagů" — vícenásobný výběr (logika OR)

Tlačítko „Vypočítat příjemce": zobrazuje "200 z 5000" s rozpisem.

Krok 3: Účty + Delivery settings

Účty SMTP

Zaškrtávací políčka pro každý připojený účet. Rotace: e-maily rovnoměrně rozloženy mezi vybrané účty.

Omezení rychlosti (⏱)

• Přednastavení: 🐢 Pomalé (60 s) / 🚶 Střední (30 s, doporučeno) / 🏃 Rychlé (10 s, pouze malé seznamy)
• Vlastní: 5–600 sekund
• Zobrazený odhad: "~2 hodiny 15 minut pro 450 kontaktů při 30s"

Plánování (📅)

• "Spustit okamžitě" (výchozí)
• "Uložit koncept" (spustit ručně později)
• "Naplánovat na konkrétní datum" + časová zóna
• Pro tipy: tlačítka Úterý 09:00 / Středa 10:00 / Čtvrtek 11:00 (nejlepší časy pro B2B)

A/B test (🧪)

Toggle ON → zadáš předmět varianty B. Split 50/50, sleduj otevření na variantu. Odznak "DOPORUČENO".

Možnosti AI

• 🔗 Drip / Víceúrovňová sekvence: toggle ON → definuješ follow-upy (email 2, 3) pro ty, kteří neodpověděli. Krok 1 = výše uvedený email. Kroky 2+ se odesílají pouze pokud lead neodpověděl. Tlačítko "+ Přidat krok".
• ⏰ AI vybere optimální čas pro každého příjemce: AI detekuje, kdy každý lead obvykle otevírá e-maily (z historie), a odesílá ve tu dobu. Očekávaný nárůst: +3–5 % open rate.

Krok 4: Kontrola + odeslání

Souhrn: Template / Recipients / Conturi / Throttle / Schedule / A/B / Drip.

Dvě závěrečná tlačítka: "Uložit koncept" (šedý) nebo "Spustit nyní" (modrý).

Live monitoring (po spuštění)

• Stavový odznak: "Odesílá se" / "Pozastaveno" / "Dokončeno" / "Selhalo"
• KPI: "150 odesláno / 5000 plánováno" + průběhový pruh
• Throttle zobrazen, časové razítko posledního aktualizace
• Tlačítka: Pozastavit / Obnovit / Zastavit / Přehledy

AI kontrola na kontakt

Pokud zapneš AI personalizaci: samostatná obrazovka „AI personalizace". Seznam variant vlevo, detail vpravo. Pro každý kontakt: AI research + tělo e-mailu. Akce: Schválit ✓ / Zamítnout ✗ / Upravit / Znovu vygenerovat. Tlačítko "Schválit vše".

Limity

• Throttle: 5–600 sekund (hard)
• Max příjemců: závisí na plánu
• AI na kontakt: limit plánu
• Drip: max 5 kroků follow-up
• A/B: pouze 2 varianty (A a B)

Chybové zprávy

"Vyberte seznam" — režim seznam bez výběru
"Vyberte alespoň jeden tag" — režim tag bez výběru
"Musíte napsat SMAZAT VŠE pro potvrzení" — při zrušení kampaně
"Limit plánu překročen. Upgradujte v Nastavení."

📧 Účty SMTP/IMAP

Propojení e-mailových účtů — klíčové pro doručitelnost.

Seznam účtů

Karty s: E-mail / Poskytovatel / SMTP hostitel / Stav (✓ připojeno / ✗ chyba). Tlačítka na kartě: Test SMTP / Test IMAP / DNS / Smazat.

Přidat účet (modal)

Test SMTP / Test IMAP

Odešle testovací připojení. Výsledky: ✓ OK nebo ✗ "Auth failed" / "Connection timeout".

Kontrola DNS

Zobrazuje stav SPF / DKIM / DMARC. Každý ✓ (platný) nebo ⚠️ (chybějící). Návod: "Přidej tento SPF záznam do svého DNS: v=spf1 include:smtp.hostinger.com ~all".

Nastavit Hostinger Email

1. Login hPanel → Emails → Email Accounts
2. Zkopírovat nastavení SMTP/IMAP:
   • SMTP host: smtp.hostinger.com
   • SMTP port: 465 (SSL)
   • IMAP host: imap.hostinger.com
   • IMAP port: 993 (SSL)
3. Používání stejných přihlašovacích údajů jako u webmailu

Nastavit Gmail (Google Workspace)

1. Aktivujte 2FA na účtu Google
2. Vygenerovat heslo aplikace: myaccount.google.com/apppasswords
3. V MarketHub:
   • SMTP host: smtp.gmail.com
   • Port: 465 (SSL)
   • Uživatel: váš e-mail
   • Password: heslo aplikace
4. Kliknutí Test SMTP před uložením

DNS záznamy pro doručitelnost

• SPF: TXT v=spf1 include:{provider} ~all
• DKIM: poskytovatel vám dá selektor + TXT veřejný klíč
• DMARC: TXT v=DMARC1; p=quarantine; rua=mailto:dmarc@tau-domeniu

Limity

• Hostinger: ~300–500 e-mailů/den
• Gmail: ~500/den
• Warmup ramp: 10 → 20 → 40 → 100/den za ~4 týdny
• Nové účty (<30 dní): warmup povinný

Chybové zprávy

"Chybí povinná pole: [host, port, ...]" — doplňte je
"Auth failed" — nesprávné heslo nebo uživatel
"Connection timeout" — host není dostupný
"DNS check failed: SPF record invalid"

📈 Reporty

KPI, funnel, deliverability, heatmapy.

Typy sestav

1. Přehledy kampaní (výchozí):
   • Přehled KPI: Otevření / Kliknutí / Odpovědi / Nedoručené / Odhlášení
   • Trychtýř: Odesláno → Doručeno → Otevřeno → Prokliknuto → Odpovězeno (% za krok)
   • Časový graf: kumulativní otevření/kliknutí za dobu trvání kampaně
   • Nejlepší kontakty: kdo otevřel, klikl, odpověděl (tříditelná tabulka)
2. Doručitelnost:
   • Bounce rate podle domény (gmail.com 2 %, yahoo.com 4 %)
   • Přehled hard vs. soft bounces
   • Automaticky blacklistované domény (míra >15 %)
3. Sledování otevření/kliknutí:
   • Mapa kliknutí (které odkazy jsou klikány nejčastěji)
   • Opens heatmap (hodina otevření vs. hodina odeslání)
   • Jedinečná vs. opakovaná otevření
4. Log odhlášení: časové razítko, e-mail, důvod (volitelné). Export CSV.
5. Srovnání: vyber 2–5 kampaní, KPI grid vedle sebe

Časové rozmezí

Posledních 30 dní (výchozí). Volitelně: 1, 7, 14, 30, 60, 90 dní.

Tlačítka

• 📥 CSV — export dat z dashboardu
• 📄 Tisk — vygeneruje tisknutelné PDF
• 🖨️ Sestava — úplná sestava v novém okně

Limity

• Zpětný pohled: 2 roky
• Comparison: max 5 kampaní
• Export: prvních 5000 řádků

🍎 Apple Search Ads — AI autopilot

Připojíš účet Apple Search Ads + AI vygeneruje blueprint + denně optimalizuje.

Připojení

Empty state: "Připoj účet Apple Search Ads" → tlačítko "Sign in with Apple" (OAuth). Pokud máš více MCC, vyber z rozbalovacího seznamu.

Nástěnka (po přihlášení)

Mřížka KPI

Impressions 👁 → Clicks → CTR → Spend 💰 → Conversions 🎯 → Avg CPC

Časové rozmezí

1 / 7 / 14 / 30 / 60 / 90 dní.

Tlačítka

• + Přidat účet — připojení ASA
• 📖 Průvodce — walkthrough setup
• ℹ️ Jak to funguje — vysvětlení AI Blueprint + Auto-Pilot
• 🤖 AI Optimizer — spustit ručně
• 🎯 Konverze — sledování konverzí
• 🩺 Diagnostika — ověř API endpointy
• 🏥 Stav účtu — opt score + holds check
• 🤖 AI automatizace — auto-negative loop, daily summary
• 🔓 Odpojit

AI Brief karta

Týdenní souhrn: nejdůležitější akce, označené problémy. "🔄 Obnovit" znovu spustí AI (spotřebuje kvótu). "Zobrazit vše →" Otevře kompletní AI Pro Brief.

Akce AI Optimizeru

1. AI Blueprint: URL aplikace → AI vygeneruje 3–4 ad groups + 15 headlines/skupina + 4 popisy + sitelinks/callouts. Ty je aktivuješ.
2. Denní optimalizátor (automaticky): Extrahuje vyhledávací výrazy → identifikuje plýtvání → navrhuje "Přidat negativní klíčové slovo: X" nebo "Pozastavit Y". Zaznamenáno s možností vrátit.
3. Auto-Pilot: bezpečné akce aplikované automaticky (záporná klíčová slova). Rizikové vyžadují schválení 1 kliknutím.

Grafy

• Náklady & Konverze/den (časová řada)
• Přehled vyhledávacích výrazů (nejlepší výkony)
• Přehledy konkurence (pokud jsou dostupné z ASO API)

Limity

• Účty: 1 aktivní na uživatele (přepínání z rozbalovací nabídky)
• Aktualizace: denně (přes noc)
• Search term history: posledních 90 dní

Chybové zprávy

"Chybí Developer Token" — admin musí nakonfigurovat ASA API key
"Účet není připojen" — OAuth vypršel nebo byl odebrán

🔍 Google Ads — AI autopilot

Stejný postup jako Apple Ads, ale pro Google.

Připojení

"Sign in with Google direct" (OAuth). Walkthrough v "📖 Průvodce krok za krokem". Vyžadováno nastavení admina: OAuth Client ID/Secret + Developer Token.

Ovládací panel

Nahoře: rozbalovací nabídka customer account ID + tlačítka: + Přidat účet, 📖 Průvodce, ℹ️ Jak to funguje, 🤖 AI Optimizer, 🎯 Konverze, 🩺 Diagnostika, 🏥 Stav účtu, 🤖 AI automatizace, 🔓 Odpojit. Rozsah dat 1–90 dní.

AI Brief + KPI

👁 Impressions / 👆 Clicks / 📊 CTR / 💰 Spend / 🎯 Conversions / 💵 Avg CPC. Grafy: Cost & Conversions, CTR per kampaň, Search term mining.

AI Blueprint workflow

1. Zadejte URL webu / landing page
2. 1 věta o nabídce
3. AI generuje 3–4 ad groups + 15 headlines/skupina + 4 popisy + sitelinks/callouts/structured snippets (vícejazyčně)
4. Zkontrolujete → aktivujete kampaně

Denní optimalizátor + AI automatizace

• Auto-Negative Loop — automatické přidání negativních klíčových slov pro nízké ROAS
• Daily Summary — email digest KPI + AI insights
• Doporučení Smart Bidding — "Přepnout na cílovou CPA" pokud je sledování konverzí v pořádku
• Optimalizace podle denní doby — úprava nabídky po hodinách

Limity

• Účty: 1 aktivní za relaci
• Search terms: posledních 90 dní
• Aktualizace: denně
• Google API: 10000 ops/den, 60 ops/min

Chybové zprávy

"Chybí Google OAuth Client ID + Secret" — admin Platform Keys
"Developer Token není schválen Google" — proces schválení 24–72 h
"Účet nemá conversion tracking" — upozornění Account Health

💬 SMS modul

SMS kampaně s validací GSM-7, drip sekvencemi a automatickým odhlášením.

SMS Accounts (admin-only)

• SMS gateway (RO): Connection ID + Password
• SMS gateway (mezinárodní): Přihlašovací údaje API + telefonní číslo
• Webhook STOP odpovědi: Automatický blacklist, když příjemce odpoví "STOP" (právně povinné)

SMS šablony

Limity znaků (CRITICAL)

• GSM-7 (bez diakritiky): 160 znaků = 1 SMS, 153 znaků/segment pro vícedílné zprávy
• Unicode (s ă/â/î/ş/ţ): 70 znaků = 1 SMS, 67 znaků/segment
• Validace UI: čítač v reálném čase zobrazuje "153 znaků zbývá (1 SMS)" nebo upozornění "S diakritikou: 67 znaků (UCS-2)"

Proměnné: {{nume}} / {{firma}} / {{oras}} / {{telefon}}

Knihovna: 16 předpřipravených šablon (příklady trhu RO).

SMS kampaně

• Režimy příjemců: všechny s telefonem / seznam / štítky
• Omezení: 5–60 s doporučeno (předejde blokacím u operátora)
• Plán: okamžitě nebo naplánovaně (NE před 08:00, NE po 22:00 — právní soulad)
• A/B test: volitelně varianta B (rozdělení 50/50)
• Drip: follow-up při absenci odpovědi (méně časté než e-mail)

SMS Drip sekvence

Max 5 follow-up zpráv. Spouštěč: "Bez odpovědi po 3 dnech" → SMS2. Automatické zastavení při odpovědi nebo odhlášení.

SMS Přehledy

• Stav na příjemce (odesláno / doručeno / selhalo / vráceno)
• Breakdown: blokování operátorem / neplatná čísla / opt-outy
• Celkový objem, debounce rate

Limity a omezení

• Denně: ~1000 SMS/účet (limit poskytovatele + plán)
• Název odesílatele: max 11 alfanumerických znaků (vyžaduje schválení za 1–2 dny)
• Opt-in: POVINNÉ v EU (RO zahrnuto)
• Odhlášení: každá SMS musí obsahovat "STOP" nebo podobné

Chybové zprávy

"Zpráva překračuje limit GSM-7" — diakritika → UCS-2 vícedílná zpráva
"Vyberte seznam"
"SMS Gateway není připojena"

💳 Plán & Předplatné

Nastavení → Plán. Stripe spravuje platbu; karta není u nás uložena.

Karta aktuálního plánu

• Tier (Free / Starter / Pro / Business / Enterprise)
• Měsíční náklady (u platících uživatelů)
• Zahrnuté funkce (seznam s zaškrtnutím)
• Datum obnovení / konec aktuálního období

Přehled využití v aktuálním měsíci

• Odeslané e-maily / Měsíční limit
• Odeslané SMS / Limit
• AI konverzace / Limit
• Agent calls / Limit
• Schválené zprávy agenta

Akce

• Upgrade / Downgrade — kdykoli. Rozdíl je automaticky poměrně vypočítán v Stripe.
• Pozastavit — až 3 měsíce. V pauze neplatíte, ale nemůžete odesílat.
• Zrušit — na konci placeného období. Data zůstanou 30 dní, poté budou smazána.
• Spravovat v Stripe Portal — změnit kartu, stáhnout faktury

Plán & kredit (orientační)

Předplatné ti dává měsíční kredit který utratíš jak chceš: SMS 0,10 € · email 0,01 €. Zakoupený kredit se hromadí a nevyprší (bez vrácení peněz).

Chybové zprávy

"Limit plánu překročen. Upgradujte v Nastavení."
"Plán pozastaven — obnovte platbu"

⚙️ Nastavení (všechny záložky)

Profil

• KPI pruh: "Člen po dobu X dní" / "Poslední přihlášení" / "Aktivní relace" / "Role"
• Avatar URL nebo automatické iniciály
• Celé jméno (použito v pozdravu + AI podpisech)
• Jazyk: 🇷🇴 Română / 🇨🇿 Čeština (přepnutí rozhraní)
• Časové pásmo: Europe/Bucharest výchozí + 7 dalších možností

Bezpečnost

• Změna hesla (stávající + nové + potvrzení)
• Stav ověření e-mailu
• 2FA — přepínač (již brzy)
• Smazat účet: "Žádost o trvalé smazání" → 30 dní odkladu (zrušitelné) → vymazání

Aktivní relace

• Aktuální relace: zařízení + poloha + naposledy aktivní
• Ostatní relace: úplný seznam otisků zařízení
• Zrušit relaci za řádek (X)
• Odhlásit všechny ostatní — jediné tlačítko

Aktivita účtu (audit log)

Časová osa událostí: Login / Campaign started / Template created / Password changed. Na záznam: timestamp / akce / IP / User-Agent. Filtr podle data. Max 100/stránku.

Oznámení

• Přepínač oznámení prohlížeče
• Tabulka preferencí podle události:
  • Sloupce: V aplikaci / E-mail / Prohlížeč (zaškrtávací políčka)
  • Podle typu události: Campaign started, Reply received, AI draft pending atd.
• Automaticky uloženo při změně

Společnost (per-user, GDPR + CAN-SPAM)

• Název společnosti — zobrazuje se v patičce e-mailů
• Firemní web — klikatelný odkaz
• Adresa sídla — GDPR povinné
• Text odhlášení — free-form + link unsubscribe
• Výchozí podpis — používá ji AI, pokud nezadáte jinou

Google Kalendář

• Připojit Google Calendar (OAuth)
• Výchozí délka schůzky (15 / 30 / 60 min)
• Výběr kalendáře — zvolte, který ze svých kalendářů

Plán a fakturace

Zobrazit Plán & Předplatné.

Export GDPR

• Velké tlačítko: "📥 Stáhnout export ZIP"
• Obsahuje CSV soubory: businesses.csv / campaigns.csv / campaign_recipients.csv / email_templates.csv / products.csv / audit_log.csv / profile.csv + metadata.json
• Hesla/tokeny jsou [REDACTED]
• Automaticky zaznamenáno v auditu (každý export se zobrazí v Aktivitě účtu)

Záložky pouze pro adminy (pouze is_admin=1)

• Odesílání — limity rychlosti poskytovatele, výchozí omezení průchodnosti
• Systém — DB health, queue, error logs

📈 Deliverability — jak se vyhnout složce Spam

1. SPF + DKIM + DMARC nakonfigurováno (viz Účty SMTP)
2. Automatický warm-up: nový účet začíná s 10 e-maily/den, postupně roste na 100 (~30 dní)
3. Čištění seznamu: Hard bounces jsou automaticky potlačeny. Ti, kdo neotevřou 10+ e-mailů, jsou vyloučeni.
4. Denní limit na účet: 50–100 e-mailů/den/účet na začátku
5. Vyhrazená složka: samostatná doména/subdoména (outreach.firma.ro) aby nedošlo k poškození reputace hlavní domény
6. Obsah: Vyhni se CAPS LOCK, mnoha odkazům, "FREE!!!", "URGENT". Skutečná personalizace snižuje spam skóre.

V Přehledy → Deliverability sledujte bounce rate podle domény. Pod 2 % je v pořádku, nad 5 % — pauza + šetření.

🔒 GDPR & Odhlášení

Vestavěný soulad s předpisy

• List-Unsubscribe header (RFC 8058) — Gmail/Outlook zobrazuje nativní tlačítko "Unsubscribe"
• Zápatí s odkazem na odhlášení v každém automatickém e-mailu
• Stránka pro odhlášení jedním kliknutím (GET nebo POST), bez potvrzení
• Rozsah na nájemce: odhlášení od uživatele A nezastaví kampaně uživatele B
• Opětovné přihlášení k odběru dostupné — uživatel se může vrátit
• Protokol souhlasů neměnný pro audit

Vaše práva (jako uživatel MarketHub)

• Export GDPR (čl. 20): Nastavení → Export GDPR → ZIP s CSV soubory
• Smazání účtu (Art. 17): Nastavení → Zabezpečení → 30 dní odkladu, zrušitelné
• Přístup k audit logu: Nastavení → Aktivita účtu

🛠 Řešení problémů

"Test SMTP" selže

• Pro Gmail — je vyžadováno heslo aplikace, nikoli heslo účtu (myaccount.google.com/apppasswords)
• Port 465 vs 587 — zkus jiný port
• Firewall poskytovatele — někteří hostingoví poskytovatelé blokují odchozí porty 25/465

Kampaň byla zastavena bez chyby

• Pravděpodobně dosažena kvóta plánu — Nastavení → Plán
• Nebo všechny SMTP účty na denním limitu — automatické obnovení ve 00:00 UTC

E-maily končí ve Spamu

• Ověřte SPF/DKIM/DMARC pro doménu (Účty → DNS)
• Používej vyhrazenou doménu pro cold outreach
• Snižte objem na 30–50 e-mailů/účet v prvních 14 dnech
• Přizpůsobte obsah — identické šablony = signál spamu

V UI se mi nezobrazují odpovědi, přestože v inboxu jsou

• IMAP nakonfigurován a otestován OK?
• Účty → Test IMAP → spustit ručně
• Polling vyžaduje shodu Message-ID — pokud lead odpoví bez funkce "Odpovědět" (nový e-mail), přibližné párování může být přeskočeno

"Failed: connection timeout" při odesílání SMTP

• Poskytovatel zablokoval IP adresu (rate limit) — počkejte 1 h
• Nesprávný SMTP hostitel (zkontrolujte v nastavení e-mailového účtu)

SMS nedorazí

• Zkontrolujte kredit SMS (admin)
• Schválený název odesílatele?
• Diakritika zdvojnásobuje náklady (UCS-2 = 70 znaků/SMS)

Apple/Google Ads — "Chybí Developer Token"

Administrátor musí nakonfigurovat Developer Token + OAuth Client ID/Secret v Admin → Platform Keys. Pro Google vyžaduje token schválení za 24–72 h.

❓ Časté dotazy

📞 Kontakt & podpora

• 📧 E-mail: office@caiostudio.eu
• 🌐 Web: markethub.dev
• 🩺 Stav platformy: /status

Průměrná doba odpovědi: 4–12 h v pracovní dny.