Sprievodca a pomoc MarketHub

🚀 Rýchly štart (5 minút na prvú kampaň)

1. Skontrolujte e-mail — po registrácii dostaneš potvrdzovací odkaz. Klikni naň (odkaz vyprší za 3 dní).
2. Pridať SMTP účet — Bočné nastavenia: Účty → +Pridať. Zobraziť podrobný sprievodca účtami.
3. Získaj prvých leadov — či už scrapingom z Zdroje → Hľadať firmy, alebo import CSV z Kontakty → Import.
4. Vytvoriť šablónu — Šablóny → +Nová alebo "Generovať s AI".
5. Spustiť kampaň — Kampane → +Nová: 4 kroky (šablóna, príjemcovia, účty+načasovanie, kontrola).

📊 Dashboard

Domovská stránka po prihlásení — zobrazuje stav vášho CRM + živú aktivitu.

4 hlavných KPI (klikateľné)

• 👥 Kontakty celkom — všetky leady z CRM. Kliknite → filtrujte Kontakty na "všetky".
• ✉️ S e-mailom — iba tie s platnou e-mailovou adresou. Kliknutím → zobrazíte "outreach-able leads".
• 🌐 S webstránkou — leady s detegovanou URL (používa ich AI pri výskume kontaktov).
• ⭐ Priemerné hodnotenie — skóre kvality vypočítané z úplnosti údajov.

Sekundárne karty

• Ďalšie čísla: Bez webstránky, Bez e-mailu, Aktívne zdroje
• Živá aktivita: real-time prehľad aktivít AI asistentov naprieč všetkými kampaňami
• Rýchly prístup: 4 rýchle spustenie — AI Agent, Video AI, Social Publish, SMS

Pozdrav + čo je nové

"Ahoj, [Meno]" + emoji podľa dennej doby. Automatické obnovenie každých 90 sekúnd — nie je potrebné manuálne načítanie.

👥 Kontakty (CRM)

Riadiace centrum pre tvoje leady. Všetky importované alebo scrapované osoby/firmy sa zobrazia tu.

Rozloženie stránky

• KPI pás hore (6 klikateľných kariet): Celkom / S e-mailom / S telefónom / S webstránkou / Na zoznamoch / Blacklist
• Ľavý bočný panel (3 skladateľných sekcií):
  • Zoznamy — tvoje vlastné zoznamy (statické segmenty). Špeciálne tlačidlo Blacklist (icon ban červený) — vylúčiť zo všetkých kampaní.
  • Segmenty — dynamické segmenty generované AI (napr.: "B2B stredné", "Retail Bratislava")
  • Tagy — voľné štítky, ktoré si vytvoríš sám
• Centrálna tabuľka — 8 zoraditeľné stĺpce: ☑ checkbox / Meno / Email / Telefón / Web / Kategória / Štítky / Hodnotenie

Panel filtrov (nad tabuľkou)

• Webová stránka: Všetky / S webom / Bez webu
• Email: Všetky / S e-mailom / Bez e-mailu
• Kategória: rozbaľovací zoznam dynamicky načítaný z vašich kontaktov
• Poloha: výňatok z údajov
• Kraj: všetkých 41 krajov + Bukurešť
• Vyhľadávacie pole: vyhľadáva v reálnom čase podľa Mena, E-mailu, Adresy, Telefónu

Hromadné akcie (zobrazia sa pri výbere kontaktov)

Panel akcií sa zobrazí nad tabuľkou, keď zaškrtneš aspoň 1 kontakt:

• Pridať do zoznamu — vybereš zoznam z rozbaľovacieho menu
• Pridať tag — výber tagov (viacnásobný výber)
• Blacklist — pridať na blacklist (nebudú dostávať nič)
• Odstrániť — úplne odstrániť z CRM

Tlačidlá v záhlaví sekcie

• 🤖 AI Insights — Claude analyzuje tvoju databázu, navrhuje nové segmenty, dedup, normalizácie
• 📥 Import — CSV (drag&drop), Mailchimp, Substack
• 📤 Export — stiahne aktuálny pohľad ako CSV
• 🖨️ Správa — Tlačiteľný PDF s KPI + top kategórie + top kraje
• 🧬 Duplikovať — detektor duplikátov s sprievodcom zlúčenia (kombinuje poznámky, tagy, zoznamy)
• + Manuál — pridať kontakt jeden po druhom (Meno + Email sú povinné)

Panel kontaktu (po kliknutí na meno)

Otvára sa pravý panel s:

• E-mail, Telefón, Webstránka, Kategória, Hodnotenie
• Poznámky s časovou pečiatkou — pridávaš/upravuješ/mažeš poznámky
• Priradené tagy — pridať/odstrániť
• História kampaní — v ktorých kampaniach bol príjemcom + stav (sent / replied / bounced / unsubscribed)
• Prepnúť Blacklist na kontakt
• Vlastné polia — tvoje ďalšie polia

Uložené filtre (predvoľby)

Uložte si zložité kombinácie filtrov (napr. "S e-mailom + Cluj + Stavebníctvo"). Kliknutie na predvoľbu = okamžité použitie.

Limity

• Hromadná akcia sa vzťahuje na aktuálnu stránku (predvolene 50 kontaktov/stránka)
• Max 500 kontaktov na zobrazenie stránky
• Vyhľadávanie nie je obmedzené, ale UI je optimalizované pre ~100 znakov

Chybové správy

"Vyplň lokalitu!" — pri uložení kontaktu bez lokality
"Nič na zlúčenie" — pri zlučovaní duplicít bez zhôd
"Zlúčenie zlyhalo: [detail]" — podrobná chyba zlúčenia

🌍 Zdroje (Databáza Google Maps)

Scrapingový modul, ktorý nachádza nové firmy z Google Maps Places API. Pracuje v 2 krokoch: vyhľadá firmy → extrahuje ich e-maily.

Krok 1: Hľadanie firiem

Polia vyhľadávania

• Krajina: iba 🇷🇴 Rumunsko momentálne (hardcoded)
• Poloha: mesto ("Cluj-Napoca"), kraj ("Bihor"), krajina ("Romania" pre celoštátne vyhľadávanie), alebo viacnásobné hľadanie oddelené čiarkou ("restaurant, cafenea, bar"). Pre veľké mestá systém automaticky rozširuje na okolité štvrte.
• Typ podnikania / odvetvie: voliteľné ("advokát", "zubár"). Prázdne = všetky firmy.
• Maximálny počet výsledkov: 1–500, predvolené 60. Pro tip: začnite s 60,, zvýšte ak je oblasť veľká.

Vyčerpávajúci režim (🚀 checkbox)

Aktivuj ho + vyber balík širokých kategórií (nie jednotlivé kľúčové slová). Dostupné balíky: Food & Beverage, Professional Services, Construction, Healthcare, atď. Vyhľadá všetky firmy v danej kategórii pre zadanú lokalitu — pomalšie, ale dôkladné.

Voliteľné auto-akcie

• Automaticky použiť štítky — tagy použité iba pre nové firmy (deduplikované)
• Automaticky pridať do zoznamu — pridá výsledky do existujúceho zoznamu

Užitočné tlačidlá

• Pro tipy — AI navrhuje niky pre tvoju lokalitu (používa Claude)
• Predvoľba — uložíš aktuálne vyhľadávanie ako opakovane použiteľný preset

Priebeh

• Panel "Vyhľadáva sa..." s tlačidlom ⏹ Zrušiť
• Scrape beží na pozadí — môžete zmeniť sekciu, pokračuje
• Výsledky vstupujú do CRM v reálnom čase, nie na konci

Krok 2: Extrahovanie e-mailov

Selektor režimu

• Štandard (~30–40% úspešnosť) — navštívi homepage + /contact. Rýchle, vhodné pre veľké dávky.
• Deep Scan (~70–80% úspešnosť) — pridáva de-obfuskáciu Cloudflare, Facebook /About, vyhľadávanie WHOIS. Pomalšie, ale nachádza skryté e-maily.

Firmy na dávku

25 / 50 / 100 / 200 / 500. Vyššia hodnota = rýchlejšie globálne, ale vyššie riziko blokovania IP. 50 je ideálna hodnota.

Konečné tlačidlo

"Extrahovať e-maily" (zelená, veľká). Ukazovateľ priebehu s odhadovaným časom. Platné e-maily sa automaticky pridajú do Kontakty → segment "Platné e-maily". Neplatné/znečistené e-maily sú filtrované (interný blocklist 60+ domén: Sentry, Wix, errors, atď.)

História a predvoľby

📋 História vyhľadávania

• Všetky minulé vyhľadávania s dátumom, lokalitou, typom, počtom výsledkov
• Tlačidlo Znovu načítať — znova spusti rovnaké vyhľadávanie
• Tlačidlo Vyprázdniť — vymazať históriu (NEmaže scrapované firmy)

⭐ Uložené vyhľadávania

Zbaliteľný panel s uloženými vyhľadávaniami. Klik = okamžité opätovné spustenie.

Rozšírené nastavenia (rozbaľte "Rozšírené nastavenia")

1. 🧹 Vyčistiť znečistené e-maily — odstráni nesprávne e-maily ("error-lite@duckduckgo.com" atď.), aby si mohol znovu scrapovať tieto firmy
2. 🔓 Odomkni tlačidlo exportu — odblokuje tlačidlo "Extrahovať e-maily" ak je zablokované po reštarte servera
3. ⚠ Vymazať všetky firmy — NEZVRATNÉ. Vyžaduje zadanie "STERGE TOT" pre potvrdenie. Vymaže všetky scrapované firmy + tagy + zoznamy.

Limity

• Podporované krajiny: iba Rumunsko (hardcoded)
• Max. výsledkov na vyhľadávanie: 500
• Časový limit deep scanu: ~30s na firmu

Chybové správy

"Vyplň lokalitu!" — povinné pole
"Vyčerpávajúco, vyber širokú kategóriu" — bundle povinný keď je Exhaustive zapnutý
"Chyba pri spúšťaní scrapingu: [detail]" — API/pripojenie

✍️ E-mailové šablóny (s AI Copywriterom)

Editor e-mailov s 2 režimami (Text / Design Studio) + integrovaný AI asistent.

Zoznam šablón

• Záložky: Všetky / Moje / Galéria
• Hotová galéria — vzorové šablóny pripravené na použitie
• "Generovať pomocou AI" (sparkle violet) — modál generovania AI
• "Nová šablóna" (+) — prázdny editor

Režim 1: Text Editor (📝)

Pole predmetu

• Max 200 znakov (pevný limit) — počítadlo "0 / 50 znakov" odporúčaný limit
• Podporuje premenné: {{firma}}, {{nume}}, {{oras}}, {{website}}, {{poza_logo}}
• Panel premenných — rýchle vloženie jedným kliknutím na pozíciu kurzora

Editor tela správy (Quill WYSIWYG)

• Počet slov v reálnom čase
• Formátovanie: Tučné / Kurzíva / Odkazy / Zoznamy / Nadpisy

Prílohy

• Obrázky a PDF súbory (max 10 MB / súbor)
• "Pridať prílohu" — výber súboru, automatické nahranie

Panel skóre spamu

• Skóre 0–100 (červená/žltá/zelená)
• Zoznam problémov: "Too many caps", "Spammy words: FREE, URGENT", "Missing unsubscribe link"
• Automatická kontrola pri každej zmene textu

Režim 2: Design Studio (🎨)

Zvislé rozdelenie rozloženia:

• Hore: náhľad iframe — prepínač Desktop / Mobile / Tmavý režim + rozbaľovací zoznam Produkt (kontext AI)
• Dole: AI chat dock — história konverzácie, drag&drop obrázky (max 5MB), rýchle čipy:
  • "+ testimonial" — pridaj skutočný testimonial s autorom + spoločnosťou
  • "+ pricing" — pridaj pricing s 3 úrovňami
  • "+ kroky" — pridaj číslované kroky ako to funguje
  • "+ stats" — veľké čísla + krátke popisky
  • "kratší" / "priateľskejší" / "tmavý" / "iný názov"

Bočné tlačidlá (všetky režimy)

• Copywriter ✨ — chat: "Prepíš predmet pútavejšie", "Pridaj silný hook", "Skontroluj chyby"
• AI Design ✨ (iba Design Studio) — modal brief: URL + produkt + pokyny
• Subject Lab — vygeneruje 5 variantov predmetu, vyberieš jeden
• Critique — AI hodnotí tón, štruktúru, zrozumiteľnosť CTA
• Náhľad — pozri, ako to vyzerá v Gmail/Outlook
• Preklady 🌍 — viacjazyčné varianty (EN, FR, DE, ES)
• Verzie 🕒 — história verzií (auto-save), obnovenie starých verzií
• Test — pošli test do svojej schránky
• Uložiť (modrá) — potrebné pred použitím v kampani

Limity

• Predmet: 200 znakov max
• Telo: prakticky neobmedzené, ale >5000 znakov = e-mailoví klienti skracujú
• Prílohy: 10MB / súbor, povolené viaceré

Chybové správy

"Najprv niečo napíš" — telo správy je povinné
"Poznámka nemôže byť prázdna" — poznámky v zásuvke kontaktu

📤 E-mailové kampane (sprievodca 4 krokov + monitoring)

Sprievodca krok za krokom na spustenie kampane.

Krok 1: Šablóna

• Názov kampane (interný, napr.: "Restaurante Cluj — Aprilie")
• Vyberte šablónu zo svojho zoznamu (s náhľadom)
• "Pokračovať" → krok 2

Krok 2: Príjemcovia

Výber režimu (radio)

• "Všetky kontakty s e-mailom" (predvolené)
• "Konkrétny zoznam" — vyberieš z rozbaľovacieho menu
• "Podľa tagov" — viacnásobný výber (logika OR)

Tlačidlo "Vypočítať príjemcov": zobrazuje "200 z 5000" s rozpisom.

Krok 3: Účty + nastavenia doručenia

SMTP účty

Zaškrtávacie políčka pre každý prepojený účet. Rotácia: e-maily rovnomerne rozdelené medzi vybrané účty.

Obmedzenie rýchlosti (⏱)

• Prednastavenia: 🐢 Pomaly (60s) / 🚶 Stredne (30s, odporúčané) / 🏃 Rýchlo (10s, iba malé zoznamy)
• Vlastné: 5–600 sekúnd
• Odhadovaný čas: "~2 hodín 15 minút pre 450 kontaktov pri 30s"

Naplánovať (📅)

• "Spustiť ihneď" (predvolené)
• "Uložiť koncept" (spustiť manuálne neskôr)
• "Naplánovať na konkrétny dátum" + časové pásmo
• Pro tipy: tlačidlá Utorok 09:00 / Streda 10:00 / Štvrtok 11:00 (B2B najlepšie časy)

A/B test (🧪)

Toggle ON → zadáš variant B predmetu. Split 50/50, sleduje otvorenia na variant. Odznak "ODPORÚČANÉ".

AI Options

• 🔗 Drip / Viacstupňová sekvencia: prepni ON → definuješ follow-up-y (e-mail 2, 3) pre tých, čo neodpovedali. Krok 1 = e-mail uvedený vyššie. Kroky 2+ sa odošlú len ak lead neodpovedal. Tlačidlo "+ Pridať krok".
• ⏰ AI vyberie optimálny čas pre každého príjemcu: AI zistí, kedy každý lead zvyčajne otvára e-maily (z histórie) a odošle v tom čase. Očakávaný nárast: +3–5% open rate.

Krok 4: Skontrolovať + odoslať

Súhrn: Šablóna / Príjemcovia / Účty / Throttle / Plán / A/B / Drip.

Dve záverečné tlačidlá: "Uložiť koncept" (sivá) alebo "Spustiť teraz" (modrá).

Živé monitorovanie (po spustení)

• Stavový odznak: "Odosiela sa" / "Pozastavené" / "Dokončené" / "Zlyhalo"
• KPI: "150 odoslaných / 5000 plánovaných" + progress bar
• Zobrazený throttle, časová pečiatka poslednej aktualizácie
• Tlačidlá: Pozastaviť / Zopakovať / Zastaviť / Správy

AI kontrola na kontakt

Ak aktivuješ personalizáciu AI: samostatná obrazovka "Personalizácia AI". Zoznam variantov vľavo, detail vpravo. Na kontakt: AI výskum + telo e-mailu. Akcie: Schváliť ✓ / Odmietnuť ✗ / Upraviť / Regenerovať. Tlačidlo "Schváliť všetkých".

Limity

• Throttle: 5–600 sekúnd (hard)
• Max príjemcov: závisí od plánu
• AI na kontakt: limit plánu
• Drip: max 5 krokov follow-up
• A/B: iba 2 varianty (A a B)

Chybové správy

"Vyber zoznam" — režim zoznamu bez výberu
"Zaškrtni aspoň jeden tag" — režim tag bez výberu
"Musíte zadať VYMAZAŤ VŠETKO pre potvrdenie" — pri zrušení kampane
"Limit plánu prekročený. Upgradujte v Nastaveniach."

📧 Účty SMTP/IMAP

Prepojenie e-mailových účtov — kľúčové pre doručiteľnosť.

Zoznam účtov

Karty s: Email / Provider / SMTP host / Stav (✓ pripojené / ✗ zlyhané). Tlačidlá na karte: Test SMTP / Test IMAP / DNS / Odstrániť.

Pridať účet (modál)

Test SMTP / Test IMAP

Odoslať testovacie pripojenie. Výsledky: ✓ OK alebo ✗ "Auth failed" / "Connection timeout".

DNS check

Zobrazuje stav SPF / DKIM / DMARC. Každý ✓ (platný) alebo ⚠️ (chýba). Návod: "Pridaj tento SPF záznam do svojho DNS: v=spf1 include:smtp.hostinger.com ~all".

Setup Hostinger Email

1. Login hPanel → Emails → Email Accounts
2. Kopírovať SMTP/IMAP nastavenia:
   • SMTP host: smtp.hostinger.com
   • SMTP port: 465 (SSL)
   • IMAP host: imap.hostinger.com
   • IMAP port: 993 (SSL)
3. Používanie rovnakých prihlasovacích údajov ako pre webmail

Setup Gmail (Google Workspace)

1. Aktivuj 2FA na účte Google
2. Generovať heslo aplikácie: myaccount.google.com/apppasswords
3. V MarketHub:
   • SMTP host: smtp.gmail.com
   • Port: 465 (SSL)
   • Používateľ: váš e-mail
   • Password: heslo aplikácie
4. Kliknite Test SMTP pred uložením

DNS záznamy pre doručiteľnosť

• SPF: TXT v=spf1 include:{provider} ~all
• DKIM: poskytovateľ ti dá selektor + TXT verejný kľúč
• DMARC: TXT v=DMARC1; p=quarantine; rua=mailto:dmarc@tau-domeniu

Limity

• Hostinger: ~300–500 e-mailov/deň
• Gmail: ~500/deň
• Warmup ramp: 10 → 20 → 40 → 100/deň za ~4 týždňov
• Nové účty (<30 dní): warmup povinný

Chybové správy

"Chýbajú povinné polia: [host, port, ...]" — vyplňte ich
"Auth failed" — nesprávne heslo/používateľ
"Connection timeout" — host nedostupný
"DNS check failed: SPF record invalid"

📈 Správy

KPI, lievik, doručiteľnosť, heatmapy.

Typy správ

1. Správy o kampaniach (predvolené):
   • KPI mriežka: Otvorenia / Kliknutia / Odpovede / Nedoručené / Odhlásenia
   • Lievik: Odoslané → Doručené → Otvorené → Kliknuté → Odpovedané (% za krok)
   • Time-series chart: kumulatívne otvorenia/kliknutia počas trvania kampane
   • Top leads: kto otvoril, klikol, odpovedal (zoraditeľná tabuľka)
2. Doručiteľnosť:
   • Bounce rate podľa domény (gmail.com 2%, yahoo.com 4%)
   • Prehľad hard vs. soft odrazov
   • Automaticky zaradené domény na čiernu listinu (miera >15%)
3. Sledovanie otvorení/kliknutí:
   • Mapa kliknutí (ktoré odkazy sa klikajú najčastejšie)
   • Heatmapa otvorení (hodina otvorenia vs hodina odoslania)
   • Jedinečné vs. opakované otvorenia
4. Záznam odhlásení: časová pečiatka, email, dôvod (voliteľné). Export CSV.
5. Porovnanie: vyberiete 2–5 kampaní, KPI grid side-by-side

Časové obdobie

Posledných 30 dní (predvolené). Vyberateľné: 1, 7, 14, 30, 60, 90 dní.

Tlačidlá

• 📥 CSV — export dát z dashboardu
• 📄 Tlač — generuje tlačiteľné PDF
• 🖨️ Správa — úplná správa v novom okne

Limity

• Spätný pohľad: 2 rokov
• Porovnanie: max 5 kampaní
• Export: prvých 5000 riadkov

🍎 Apple Search Ads — AI autopilot

Prepojíte účet Apple Search Ads + AI vygeneruje plán + denne optimalizuje.

Pripojenie

Prázdny stav: "Pripojiť účet Apple Search Ads" → tlačidlo "Sign in with Apple" (OAuth). Ak máte viacero MCC, vyberte z rozbaľovacieho zoznamu.

Dashboard (po pripojení)

KPI mriežka

Zobrazenia 👁 → Kliknutia → CTR → Výdavky 💰 → Konverzie 🎯 → Priem. CPC

Časové obdobie

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

Tlačidlá

• + Pridať účet — prepojenie ASA
• 📖 Návod — sprievodca nastavením
• ℹ️ Ako to funguje — vysvetlenie AI Blueprint + Auto-Pilot
• 🤖 AI Optimizer — spustiť manuálne
• 🎯 Konverzie — sledovanie konverzií
• 🩺 Diagnostika — skontrolovať API endpoints
• 🏥 Account Health — kontrola opt skóre + pozastavení
• 🤖 AI automatizácie — auto-negative loop, daily summary
• 🔓 Odpojiť

AI Brief karta

Týždenný súhrn: top akcie, označené problémy. "🔄 Obnoviť" znovu spustí AI (spotrebuje kvótu). "Zobraziť všetko →" otvorí úplný AI Pro Brief.

Akcie AI Optimizer

1. AI Blueprint: URL aplikácie → AI vygeneruje 3–4 ad groups + 15 headlines/skupina + 4 popisy + sitelinks/callouts. Vy aktivujete.
2. Daily optimizer (automaticky): extrahuje vyhľadávacie výrazy → identifikuje odpad → navrhuje "Pridaj negatívne kľúčové slovo: X" alebo "Pozastaviť Y". Zaznamenané s možnosťou vrátenia.
3. Auto-Pilot: bezpečné akcie aplikované automaticky (negatívne kľúčové slová). Rizikové vyžadujú schválenie 1-kliknutím.

Grafy

• Náklady & Konverzie/deň (časový rad)
• Prehľad vyhľadávaných výrazov (najlepšie výsledky)
• Prehľad konkurencie (ak je dostupné z ASA API)

Limity

• Účty: 1 aktívnych na používateľa (prepnutie z rozbaľovacieho menu)
• Aktualizácia: denne (overnight)
• História vyhľadávaných výrazov: posledných 90 dní

Chybové správy

"Chýba Developer Token" — administrátor musí nastaviť ASA API key
"Účet nie je pripojený" — OAuth vypršal alebo bol odvolaný

🔍 Google Ads — AI autopilot

Rovnaký postup ako Apple Ads, ale pre Google.

Pripojenie

"Sign in with Google direct" (OAuth). Návod v "📖 Sprievodca krok za krokom". Vyžaduje sa nastavenie adminom: OAuth Client ID/Secret + Developer Token.

Dashboard

Navrchu: rozbaľovací zoznam customer account ID + tlačidlá: + Pridať účet, 📖 Návod, ℹ️ Ako to funguje, 🤖 AI Optimizer, 🎯 Konverzie, 🩺 Diagnostika, 🏥 Account Health, 🤖 AI automatizácie, 🔓 Odpojiť. Rozsah dátumov 1–90 dní.

AI Brief + KPI

👁 Zobrazenia / 👆 Kliknutia / 📊 CTR / 💰 Výdavky / 🎯 Konverzie / 💵 Priem. CPC. Grafy: Náklady a konverzie, CTR podľa kampane, Prieskum vyhľadávacích výrazov.

AI Blueprint workflow

1. Zadajte URL webstránky/vstupnej stránky
2. 1 veta o ponuke
3. AI generuje 3–4 ad groups + 15 headlines/skupina + 4 popisov + sitelinks/callouts/structured snippets (viac jazykov)
4. Skontrolujte → aktivujte kampane

Daily Optimizer + AI automatizácie

• Auto-Negative Loop — automatické pridávanie negatívnych kľúčových slov pre nízke ROAS
• Daily Summary — e-mailový prehľad KPI + AI insights
• Smart Bidding odporúčanie — "Switch to Target CPA" ak je sledovanie konverzií dobré
• Time-of-day optimization — úprava ponuky podľa hodiny

Limity

• Účty: 1 aktívnych na reláciu
• Vyhľadávané výrazy: posledných 90 dní
• Aktualizácia: denne
• Google API: 10000 ops/deň, 60 ops/min

Chybové správy

"Chýba Google OAuth Client ID + Secret" — administrátor Platform Keys
"Developer Token nie je schválený spoločnosťou Google" — proces schválenia 24–72h
"Účet nemá conversion tracking" — upozornenie Account Health

💬 SMS modul

SMS kampane s validáciou GSM-7, drip, automatický opt-out.

SMS účty (iba admin)

• Gateway SMS (RO): Connection ID + Password
• Gateway SMS (medzinárodný): prihlasovacie údaje API + telefónne číslo
• Webhook STOP replies: auto-blacklist keď príjemca odpovie "STOP" (právne povinné)

SMS šablóny

Limity znakov (CRITICAL)

• GSM-7 (bez diakritiky): 160 znakov = 1 SMS, 153 znakov/segment pre viacdielne správy
• Unicode (s á/ä/č/ô/ž): 70 znakov = 1 SMS, 67 znakov/segment
• Validácia UI: counter v reálnom čase zobrazuje "153 znakov zostáva (1 SMS)" alebo upozornenie "S diakritikou: 67 znakov (UCS-2)"

Premenné: {{nume}} / {{firma}} / {{oras}} / {{telefon}}

Knižnica: 16 hotových šablón (príklady pre RO trh).

SMS kampane

• Režimy príjemcov: všetky s telefónom / zoznamom / tagmi
• Obmedzenie: 5–60s odporúčané (predchádza blokovaniu operátora)
• Plán: okamžite alebo naplánované (NIE pred 08:00, NIE po 22:00 — právny súlad)
• A/B test: voliteľná varianta B (split 50/50)
• Drip: follow-up ak bez odpovede (menej často ako e-mail)

SMS Drip sekvencie

Max 5 follow-up. Spúšťač: "Bez odpovede po 3 dňoch" → SMS2. Automatické zastavenie pri odpovedi alebo odhlásení.

SMS Reports

• Stav pre každého príjemcu (sent / delivered / failed / bounced)
• Rozdelenie: blokovania operátorom / neplatné čísla / opt-outy
• Celkový objem, debounce rate

Limity a obmedzenia

• Denne: ~1000 SMS/účet (limit poskytovateľa + plán)
• Sender name: max 11 alfanumerických znakov (vyžaduje schválenie 1–2 dní)
• Opt-in: POVINNÉ v EÚ (RO zahrnuté)
• Odhlásenie: každá SMS musí obsahovať "STOP" alebo podobné

Chybové správy

"Správa prekračuje limit GSM-7" — diakritika → UCS-2 multi-part
"Vyberte zoznam"
"SMS Gateway nie je pripojená"

💳 Plán & Predplatné

Nastavenia → Plán. Stripe spravuje platbu; kartu u nás neukladáme.

Karta aktuálneho plánu

• Tier (Free / Starter / Pro / Business / Enterprise)
• Mesačné náklady (pre platiacich)
• Zahrnuté funkcie (zoznam so zaškrtnutím)
• Dátum obnovenia / koniec aktuálneho obdobia

Prehľad využitia aktuálny mesiac

• Odoslané e-maily / Mesačný limit
• Odoslané SMS / Limit
• Konverzácie AI / Limit
• Agent calls / Limit
• Schválené správy agenta

Akcie

• Upgrade / Downgrade — kedykoľvek. Rozdiel sa automaticky pomerovo prepočíta v Stripe.
• Pozastaviť — až na 3 mesiacov. Počas pauzy neplatíte, ale nemôžete odosielať.
• Zrušiť — na konci plateného obdobia. Dáta zostanú 30 dní, potom sa vymažú.
• Spravovať v Stripe Portal — zmeniť kartu, stiahnuť faktúry

Limity úrovne (orientačne)

Chybové správy

"Limit plánu prekročený. Upgradujte v Nastaveniach."
"Plán pozastavený — obnovte platbu"

⚙️ Nastavenia (všetky záložky)

Profil

• KPI pás: "Členom X dní" / "Posledné prihlásenie" / "Aktívne relácie" / "Rola"
• Avatar URL alebo automatické iniciály
• Celé meno (používa sa v pozdrave + AI podpisoch)
• Jazyk: 🇷🇴 Română / 🇬🇧 English (prepnúť UI)
• Časové pásmo: Europe/Bucharest predvolené + 7 ďalších možností

Bezpečnosť

• Zmeniť heslo (aktuálne + nové + potvrdenie)
• Stav overenia e-mailu
• 2FA — prepínač (coming soon)
• Zmazať účet: "Žiadosť o trvalé vymazanie" → 30 dní odkladu (zrušiteľné) → vymazanie

Aktívne relácie

• Aktuálna relácia: zariadenie + poloha + posledná aktivita
• Ostatné relácie: úplný zoznam s fingerprints
• Zrušiť reláciu na riadok (X)
• Odhlásiť všetkých ostatných — jediné tlačidlo

Aktivita účtu (audit log)

Časová os udalostí: Login / Campaign started / Template created / Password changed. Na záznam: timestamp / akcia / IP / User-Agent. Filter podľa dátumu. Max 100/stránku.

Notifikácie

• Prepínač upozornení prehliadača
• Tabuľka preferencií podľa udalosti:
  • Stĺpce: In-app / Email / Browser (zaškrtávacie políčka)
  • Podľa typu udalosti: Campaign started, Reply received, AI draft pending, atď.
• Automaticky uložené pri zmene

Spoločnosť (na používateľa, GDPR + CAN-SPAM)

• Názov spoločnosti — zobrazuje sa v päte e-mailov
• Webová stránka spoločnosti — klikateľný odkaz
• Adresa sídla — GDPR povinné
• Text odhlásenia — voľný formát + link na odhlásenie
• Predvolený podpis — použité AI, ak neurčíte inak

Google Kalendár

• Connect Google Calendar (OAuth)
• Predvolená dĺžka stretnutia (15 / 30 / 60 min)
• Výber kalendára — vybrať jeden z vašich kalendárov

Plán & fakturácia

Zobraziť Plán & Predplatné.

Export GDPR

• Veľké tlačidlo: "📥 Stiahnuť export ZIP"
• Obsahuje CSV súbory: businesses.csv / campaigns.csv / campaign_recipients.csv / email_templates.csv / products.csv / audit_log.csv / profile.csv + metadata.json
• Heslá/tokeny sú [REDACTED]
• Automaticky zaznamenané v audite (každý export sa zobrazí v Aktivite účtu)

Záložky len pre admina (iba is_admin=1)

• Odoslanie — limity rýchlosti poskytovateľa, predvolené obmedzenia
• Systém — DB health, queue, error logs

📈 Doručiteľnosť — ako sa vyhnúť priečinku Spam

1. SPF + DKIM + DMARC nakonfigurované (pozri SMTP účty)
2. Automatický warm-up: nový účet začína s 10 e-mailmi/deň, postupne rastie na 100 (~30 dní)
3. Hygiena zoznamu: hard bounces sa automaticky potlačia. Tí, ktorí neotvorili 10+ e-mailov, sú vylúčení.
4. Denný limit na účet: 50–100 e-mailov/deň/účet na začiatku
5. Vyhradený priečinok: samostatná doména/subdoména (outreach.firma.ro) aby ste nepoškodili reputáciu hlavnej domény
6. Obsah: vyhýbajte sa CAPS LOCK, mnohým odkazom, "FREE!!!", "URGENT". Skutočná personalizácia znižuje spam skóre.

V Správy → Deliverability sleduj bounce rate podľa domény. Pod 2% je OK, nad 5% — pauza + vyšetrovanie.

🔒 GDPR & Odhlásenie

Zabudovaný súlad s predpismi

• List-Unsubscribe header (RFC 8058) — Gmail/Outlook zobrazuje natívne tlačidlo "Unsubscribe"
• Päta s odkazom na odhlásenie v každom automatickom e-maile
• Stránka odhlásenia jedným kliknutím (GET alebo POST), bez potvrdenia
• Rozsah per-tenant: odhlásenie od používateľa A nezastaví kampane používateľa B
• Re-subscribe k dispozícii — používateľ sa môže vrátiť
• Nezmeniteľný záznam súhlasu pre audit

Vaše práva (ako používateľ MarketHub)

• Export GDPR (čl. 20): Nastavenia → Export GDPR → ZIP s CSV súbormi
• Vymazanie účtu (čl. 17): Nastavenia → Zabezpečenie → 30 dní odkladu, zrušiteľné
• Prístup k audit logu: Nastavenia → Aktivita účtu

🛠 Riešenie problémov

"Test SMTP" zlyháva

• Pre Gmail — je potrebné heslo aplikácie, nie heslo účtu (myaccount.google.com/apppasswords)
• Port 465 vs 587 — skúste iný port
• Firewall poskytovateľa — niektoré hostingy blokujú 25/465 odchádzajúce spojenia

Kampaň sa zastavila bez chyby

• Pravdepodobne dosiahnutý limit plánu — Nastavenia → Plán
• Alebo všetky SMTP kontá na dennom limite — automatické obnovenie o 00:00 UTC

E-maily končia v Spame

• Overte SPF/DKIM/DMARC na doméne (Účty → DNS)
• Používajte vyhradenú doménu pre cold outreach
• Znížiť objem na 30–50 e-mailov/účet počas prvých 14 dní
• Personalizujte obsah — identické šablóny = signál spamu

Nedostávam odpovede v UI, hoci mám odpovede v inboxe

• IMAP nakonfigurovaný a otestovaný OK?
• Účty → Test IMAP → spustiť manuálne
• Polling vyžaduje zhodu Message-ID — ak lead odpovedá bez "Reply" (nový e-mail), fuzzy matching môže byť preskočený

"Failed: connection timeout" pri odosielaní cez SMTP

• Poskytovateľ zablokoval IP adresu (rate limit) — počkajte 1h
• Nesprávny SMTP host (skontrolujte v nastaveniach e-mailového konta)

SMS nedoručené

• Skontrolujte SMS kredit (admin)
• Meno odosielateľa schválené?
• Diakritika zdvojuje cenu (UCS-2 = 70 znakov/SMS)

Apple/Google Ads — "Developer Token chýba"

Admin musí nakonfigurovať Developer Token + OAuth Client ID/Secret v Admin → Platform Keys. Pre Google si token vyžaduje schválenie 24–72h.

❓ Často kladené otázky

📞 Kontakt a podpora

• 📧 Email: office@caiostudio.eu
• 🌐 Webstránka: markethub.dev
• 🩺 Stav platformy: /status

Priemerný čas odozvy: 4–12h v pracovné dni.