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 dní).
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+č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 hodiny. Automatické obnovení za 90 sekund — není třeba ručně 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 strip 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 Blacklist (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é sloupce: ☑ checkbox / Název / 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
• Categorie: rozbalovací seznam dynamicky naplněný z tvých kontaktů
• Umístění: extrahováno z dat
• Kraj: všech 41 krajů + Bukurešť
• Search box: 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, když zaškrtneš alespoň 1 kontakt:

• Přidat do seznamu — vyberte seznam z rozbalovací nabídky
• Přidat štítek — tag picker multi-select
• Blacklist — 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)
• Toggle Blacklist per-contact
• Custom fields — 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ý vyhledává nové firmy přes Google Maps Places API. Pracuje ve 2 krocích: vyhledá firmy → extrahuje jejich e-maily.

Krok 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.
• Tip afacere / domeniu: 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

Butoane utile

• Pro tips — AI navrhuje niky pro tvou lokalitu (používá Claude)
• Preset — uložíte aktuální vyhledávání jako opakovaně použitelnou předvolbu

Progress

• Vyhledávací lišta "Hledá se..." s tlačítkem ⏹ Cancel
• 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: Extrahuj e-maily

Výběr režimu

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

Firem na dávku

25 / 50 / 100 / 200 / 500. Vyšší = globálně rychlejší, ale vyšší riziko blokace IP. 50 je sweet spot.

Buton final

"Extrahovat e-maily" (zelené, velké). Indikátor průběhu s odhadovaným časem. Platné e-maily automaticky vstupují 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ů
• Buton Znovu načíst — znovu spustit stejné vyhledávání
• Buton Vyprázdnit — smaže historii (NESMAŽE scrapované firmy)

⭐ Saved searches

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í "SMAZAT VŠE" pro potvrzení. Smaže všechny scrapované firmy + tagy + seznamy.

Limity

• Podporované země: pouze Rumunsko (hardcoded)
• Max výsledků na vyhledávání: 500
• Deep scan timeout: ~30s 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ů s 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: Text Editor (📝)

Pole předmětu

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

Body editor (Quill WYSIWYG)

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

Attachments

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

Spam score panel

• 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 — toggle Desktop / Mobile / Dark mode + dropdown Produs (context AI)
• Dole: Chat dock AI — historie konverzace, drag&drop obrázků (max 5MB), quick-chips:
  • "+ testimonial" — přidá skutečný testimonial s autorem + firmou
  • "+ pricing" — přidá pricing s 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
• Subject Lab — vygeneruje 5 variant předmětu, vyberete jednu
• Critique — AI hodnotí tón, strukturu a srozumitelnost CTA
• Náhled — podívej se, jak to vypadá v Gmail/Outlook
• Traduceri 🌍 — 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: 200 znaků (pevný limit)
• Tělo: prakticky neomezené, ale >5000 znaků = e-mailoví klienti text oříznou
• Attachments: 10 MB / soubor, povoleno více souborů

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 kroků + 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": Zobrazí "200 z 5000" s rozpisem.

Krok 3: Účty + nastavení doručení

Účty SMTP

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

Throttling (⏱)

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

Schedule (📅)

• "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 (🧪)

Přepni ON → zadáš předmět varianty B. Rozdělení 50/50, sleduje otevření na variantu. Odznak "DOPORUČENO".

Možnosti AI

• 🔗 Drip / Víceúrovňová sekvence: přepnutí ON → definujete follow-upy (e-mail 2, 3) pro ty, kdo neodpověděli. Krok 1 = výše uvedený e-mail. 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 zjistí, kdy každý lead obvykle otevírá e-maily (z historie) a odešle ve tu dobu. Očekávaný nárůst: +3–5% open rate.

Krok 4: Kontrola + odeslání

Souhrn: Šablona / Příjemci / Účty / Omezení / Plánování / 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" + progress bar
• Throttle zobrazen, časové razítko posledního aktualizace
• Butoane: 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 (pevný limit)
• Max příjemců: závisí na plánu
• AI na kontakt: limit plánu
• Drip: max 5 follow-up kroků
• 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".

DNS check

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

Setup 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

Setup 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. Click 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ýdnů
• 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. Campaign reports (výchozí):
   • KPI grid: Opens / Clicks / Replies / Bounces / Unsubscribes
   • Trychtýř: Odesláno → Doručeno → Otevřeno → Prokliknuto → Odpovězeno (% za krok)
   • Time-series chart: opens/clicks cumulate pe durata campaniei
   • Nejlepší kontakty: kdo otevřel, klikl, odpověděl (tříditelná tabulka)
2. Doručitelnost:
   • Bounce rate per domeniu (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í)
   • Unique vs repeat opens
4. Log odhlášení: časové razítko, e-mail, důvod (volitelné). Export CSV.
5. Comparison: Vybereš 2–5 kampaně, KPI grid side-by-side

Date range

Ultimele 30 zile (default). Selectabil: 1, 7, 14, 30, 60, 90 zile.

Butoane

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

Limity

• Lookback: 2 let
• Comparison: max 5 campanii
• Export: prvních 5000 řádků

🍎 Apple Search Ads — AI autopilot

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

Conexiune

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í)

KPI grid

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

Date range

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

Butoane

• + Přidat účet — připojení ASA
• 📖 Průvodce — walkthrough setup
• ℹ️ Jak to funguje — vysvětlení AI Blueprint + Auto-Pilot
• 🤖 AI Optimizer — spustit ručně
• 🎯 Conversions — tracking conversii
• 🩺 Diagnostics — ověř API endpointy
• 🏥 Account Health — 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 reklamních skupin + 15 nadpisů/skupinu + 4 popisů + sitelinks/callouts. Ty je aktivuješ.
2. Daily optimizer (auto): 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 aplikovány automaticky (negative kw). Rizikové vyžadují schválení 1-klikem.

Charts

• Náklady & Konverze/den (časová řada)
• Search terms breakdown (top performers)
• Přehledy konkurence (pokud jsou dostupné z ASO API)

Limity

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

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.

Conexiune

"Přihlásit se přes Google" (OAuth). Průvodce nastavením "📖 Průvodce krok za krokem". Vyžadováno nastavení admina: OAuth Client ID/Secret + Developer Token.

Dashboard

Top: dropdown customer account ID + butoane: + Přidat účet, 📖 Průvodce, ℹ️ Jak to funguje, 🤖 AI Optimizer, 🎯 Conversions, 🩺 Diagnostics, 🏥 Account Health, 🤖 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 vygeneruje 3–4 ad groups + 15 headlines/skupina + 4 popisy + sitelinks/callouts/structured snippets (více jazyků)
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ích na relaci
• Search terms: ultimele 90 zile
• 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 Templates

Limity znaků (CRITICAL)

• GSM-7 (bez diakritiky): 160 znaků = 1 SMS, 153 znaků/segment pro vícedílné zprávy
• Unicode (š ă/â/î/ş/ţ): 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}}

Library: 16 předpřipravených šablon (příklady pro trh RO).

SMS Campaigns

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

SMS Drip sequences

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

SMS Reports

• Status per recipient (sent / delivered / failed / bounced)
• Breakdown: carrier blocks / numere invalide / opt-outs
• Celkový objem, debounce rate

Limity a omezení

• Daily: ~1000 SMS/cont (limit provider + plan)
• Jméno odesílatele: max 11 alfanumerických znaků (vyžaduje schválení 1–2 dní)
• 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íce částí
"Vyberte seznam"
"SMS Gateway není připojena"

💳 Plán & Předplatné

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

Card plan curent

• Tier (Free / Starter / Pro / Business / Enterprise)
• Měsíční náklady (u platících uživatelů)
• Zahrnuté funkce (seznam s zaškrtnutím)
• Renew date / current period end

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.
• Pause — až na 3 měsíců. V pauze neplatíš, ale nemůžeš odesílat.
• Cancel — na konci placeného období. Data zůstanou 30 dní, poté budou smazána.
• Spravovat v Stripe Portal — change card, download invoices

Tier limits (orientativ)

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 strip: "Č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í

Securitate

• Změna hesla (stávající + nové + potvrzení)
• Email verify status
• 2FA — toggle (coming soon)
• Smazat účet: "Žádost o trvalé smazání" → 30 dní odkladu (zrušitelné) → vymazání

Sesiuni active

• Aktuální relace: zařízení + poloha + naposledy aktivní
• Ostatní relace: úplný seznam otisků zařízení
• Revoke session za řádek (X)
• Odhlásit všechny ostatní — un singur buton

Aktivita účtu (audit log)

Časová osa událostí: Přihlášení / Kampaň spuštěna / Šablona vytvořena / Heslo změněno. Na záznam: časové razítko / akce / IP / User-Agent. Filtr podle data. Max 100/stránku.

Oznámení

• Browser notifications toggle
• Tabulka preferencí podle události:
  • Sloupce: V aplikaci / E-mail / Prohlížeč (zaškrtávací políčka)
  • Per event-type: Campaign started, Reply received, AI draft pending, etc.
• Automaticky uloženo při změně

Companie (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

Calendar Google

• Connect 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 Plan & Abonament.

Export GDPR

• Buton mare: "📥 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 admina (pouze is_admin=1)

• Odesílání — provider rate limits, throttle defaults
• 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á na 10 e-mailech/den, postupně roste na 100 (~30 dní)
3. List hygiene: Hard bounce automaticky potlačeny. Příjemci, kteří neotevřou 10+ e-mailů, jsou vyloučeni.
4. Daily limit per cont: 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 zobrazte bounce rate per doménu. Pod 2% je v pořádku, nad 5% — pauza + proš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í
• Per-tenant scope: odhlášení od uživatele A nezastaví kampaně uživatele B
• Opětovné přihlášení k odběru dostupné — userul poate reveni
• Consent log immutable pro audit

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

• Export GDPR (čl. 20): Nastavení → Export GDPR → ZIP s CSV soubory
• Smazání účtu (čl. 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 providera — někteří hosteré blokují odchozí 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í v 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 prvních 14 dní
• 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) — čekejte 1h
• Nesprávný SMTP hostitel (zkontrolujte v nastavení e-mailového účtu)

SMS nedorazí

• Zkontrolujte kredit SMS (admin)
• Sender name aprobat?
• Diakritika zdvojuje cenu (UCS-2 = 70 znaků/SMS)

Apple/Google Ads — "Chybí Developer Token"

Admin 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
• 🌐 Website: markethub.dev
• 🩺 Stav platformy: /status

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