Przewodnik i pomoc MarketHub

🚀 Szybki start (5 minut do pierwszej kampanii)

1. Sprawdź email — otrzymujesz link potwierdzający przy rejestracji. Kliknij go (link wygasa po 3 dniach).
2. Dodaj konto SMTP — Ustawienia boczne: Konta → +Dodaj. Zobacz szczegółowy przewodnik po kontach.
3. Zbuduj pierwsze leady — lub scrapowanie z Źródła → Szukaj firm, lub import CSV z Kontakty → Import.
4. Utwórz szablon — Szablony → +Nowy lub "Generuj z AI".
5. Uruchom kampanię — Kampanie → +Nowa: 4 kroki (szablon, odbiorcy, konta+harmonogram, przegląd).

📊 Dashboard

Strona główna po zalogowaniu — pokazuje stan Twojego CRM + aktywność na żywo.

Główne 4 KPI (klikalne)

• 👥 Łączna liczba kontaktów — wszystkie leady z CRM. Kliknij → filtruj Kontakty do "wszystkie".
• ✉️ Z e-mailem — tylko te z prawidłowym adresem e-mail. Kliknij → pokaż "outreach-able leads".
• 🌐 Ze stroną internetową — leady z wykrytym URL (używane przez AI do badań per-kontakt).
• ⭐ Średnia ocena — wynik jakości obliczony na podstawie kompletności danych.

Karty pomocnicze

• Inne liczby: Bez strony www, Bez e-maila, Aktywne źródła
• Aktywność na żywo: feed w czasie rzeczywistym z działań asystentów AI we wszystkich kampaniach
• Szybki dostęp: 4 szybki start — AI Agent, Video AI, Social Publish, SMS

Powitanie + co nowego

"Cześć, [Imię]" + emoji zależny od godziny. Automatyczne odświeżanie co 90 sekund — nie musisz ręcznie przeładowywać strony.

👥 Kontakty (CRM)

Centrum zarządzania Twoimi leadami. Wszystkie zaimportowane lub pobrane osoby/firmy trafiają tutaj.

Układ strony

• KPI strip góra (6 klikalnych kart): Łącznie / Z e-mailem / Z telefonem / Ze stroną www / Na listach / Blacklist
• Lewy panel boczny (3 sekcje zwi jane):
  • Listy — Twoje niestandardowe listy (segmenty statyczne). Specjalny przycisk Blacklist (ikona czerwonego bana) — wyklucz ze wszystkich kampanii.
  • Segmenty — dynamiczne segmenty generowane przez AI (np. "B2B średnie", "Retail Bucureşti")
  • Tagi — dowolne etykiety tworzone przez Ciebie
• Tabela główna — 8 sortowalne kolumny: ☑ checkbox / Nazwa / Email / Telefon / Strona WWW / Kategoria / Tagi / Ocena

Pasek filtrów (nad tabelą)

• Strona internetowa: Wszystkie / Z witryną / Bez witryny
• E-mail: Wszystkie / Z emailem / Bez emaila
• Kategoria: lista rozwijana dynamicznie zasilana z Twoich kontaktów
• Lokalizacja: wyodrębnione z danych
• Województwo: wszystkie 41 województw + Bukareszt
• Pole wyszukiwania: wyszukiwanie w czasie rzeczywistym po Nazwie, E-mailu, Adresie, Telefonie

Akcje masowe (pojawiają się po zaznaczeniu kontaktów)

Pasek akcji wyświetla się nad tabelą po zaznaczeniu co najmniej 1 kontaktu:

• Dodaj do listy — wybierasz listę z menu rozwijanego
• Dodaj tag — wybór tagów z wielokrotnym zaznaczaniem
• Blacklist — dodaje do czarnej listy (nie otrzymują już nic)
• Usuń — usuwa całkowicie z CRM

Przyciski w nagłówku sekcji

• 🤖 AI Insights — Claude analizuje Twoją bazę, sugeruje nowe segmenty, dedup, normalizacje
• 📥 Importuj — CSV (drag&drop), Mailchimp, Substack
• 📤 Eksport — pobierz bieżący widok jako CSV
• 🖨️ Raport — Drukowalny PDF z KPI + top kategorie + top powiaty
• 🧬 Duplikuj — detektor duplikatów z kreatorem scalania (łączy notatki, tagi, listy)
• + Ręcznie — dodaje kontakt jeden po jednym (Imię + Email wymagane)

Panel kontaktu (po kliknięciu na nazwę)

Otwiera się panel po prawej stronie z:

• E-mail, Telefon, Strona internetowa, Kategoria, Ocena
• Notatki ze znacznikiem czasu — dodajesz/edytujesz/usuwasz notatki
• Powiązane tagi — dodaje/usuwa
• Historia kampanii — w jakich kampaniach był odbiorcą + status (sent / replied / bounced / unsubscribed)
• Przełącz czarną listę na kontakt
• Pola niestandardowe — Twoje dodatkowe pola

Zapisane filtry (ustawienia wstępne)

Zapisuj złożone kombinacje filtrów (np. "Z e-mailem + Cluj + Budownictwo"). Kliknięcie na preset = natychmiastowe zastosowanie.

Limity

• Akcja zbiorcza dotyczy bieżącej strony (domyślnie 50 kontaktów/strona)
• Maks. 500 kontaktów na wyświetlenie strony
• Wyszukiwanie nie jest ograniczone, ale UI jest zoptymalizowany dla ~100 znaków

Komunikaty błędów

"Uzupełnij lokalizację!" — przy zapisywaniu kontaktu bez lokalizacji
"Nic do scalenia" — przy scalaniu duplikatów bez dopasowań
"Scalanie nieudane: [detail]" — szczegółowy błąd scalania

🌍 Źródła (Baza Danych Google Maps)

Moduł scrapingowy, który znajduje nowe firmy z Google Maps Places API. Działa w 2 etapach: wyszukuje firmy → pobiera ich adresy e-mail.

Etap 1: Szukaj firm

Pola wyszukiwania

• Kraj: tylko 🇷🇴 Rumunia na razie (hardcoded)
• Lokalizacja: miasto ("Cluj-Napoca"), województwo ("Bihor"), kraj ("Romania" dla wyszukiwania krajowego) lub multi-wyszukiwanie oddzielone przecinkiem ("restaurant, cafenea, bar"). Dla dużych miast system automatycznie rozszerza na pobliskie dzielnice.
• Rodzaj działalności / branża: opcjonalne ("avocat", "dentist"). Puste = wszystkie firmy.
• Maksymalna liczba wyników: 1–500, domyślnie 60. Pro tip: zacznij od 60,, zwiększ jeśli obszar jest duży.

Tryb wyczerpujący (🚀 checkbox)

Włącz go + wybierz pakiet szerokich kategorii (nie pojedyncze słowa kluczowe). Dostępne bundle'e: Food & Beverage, Professional Services, Construction, Healthcare, itp. Wyszukuje wszystkie firmy z danej kategorii dla podanej lokalizacji — wolniej, ale kompletnie.

Opcjonalne auto-akcje

• Auto-stosuj tagi — tagi stosowane tylko do nowych firm (zdeduplikowane)
• Auto-dodaj do listy — dodaje wyniki do istniejącej listy

Przydatne przyciski

• Wskazówki pro — AI sugeruje nisze dla Twojej lokalizacji (używa Claude)
• Preset — zapisujesz bieżące wyszukiwanie jako wielokrotny preset

Postęp

• Pasek "Wyszukiwanie..." z przyciskiem ⏹ Cancel
• Scraping działa w tle — możesz zmienić sekcję, proces jest kontynuowany
• Wyniki trafiają do CRM w czasie rzeczywistym, nie na końcu

Etap 2: Wyodrębnij e-maile

Tryb selektora

• Standardowy (~30–40% skuteczności) — odwiedza homepage + /contact. Szybko, dobre do dużych partii.
• Deep Scan (~70–80% skuteczności) — dodaje deobfuskację Cloudflare, Facebook /About, lookup WHOIS. Wolniej, ale znajduje ukryte emaile.

Firm na partię

25 / 50 / 100 / 200 / 500. Większa wartość = szybciej globalnie, ale większe ryzyko blokad IP. 50 to sweet spot.

Przycisk końcowy

"Wyodrębnij adresy e-mail" (zielony, duży). Pasek postępu z szacowanym czasem. Prawidłowe emaile trafiają automatycznie do Kontakty → segment "Email valide". Nieprawidłowe/zaśmiecone emaile są filtrowane (wewnętrzna blocklista 60+ domen: Sentry, Wix, errors, itp.)

Historia i ustawienia wstępne

📋 Historia wyszukiwań

• Wszystkie poprzednie wyszukiwania z datą, lokalizacją, typem, liczbą wyników
• Przycisk Odśwież — ponownie uruchamia to samo wyszukiwanie
• Przycisk Wyczyść — usuwa historię (NIE usuwa zescrapowanych firm)

⭐ Zapisane wyszukiwania

Zwijany pasek z zapisanymi wyszukiwaniami. Kliknięcie = natychmiastowe ponowne uruchomienie.

Ustawienia zaawansowane (rozwiń "Ustawienia zaawansowane")

1. 🧹 Wyczyść zanieczyszczone adresy e-mail — usuwa nieprawidłowe adresy e-mail ("error-lite@duckduckgo.com" itp.), aby móc ponownie zescrapować te firmy
2. 🔓 Odblokuj przycisk ekstrakcji — odblokuj przycisk "Wyodrębnij e-maile" jeśli jest zablokowany po restarcie serwera
3. ⚠ Usuń wszystkie firmy — NIEODWRACALNE. Wymaga wpisania "STERGE TOT" w celu potwierdzenia. Usuwa wszystkie zescrapowane firmy + tagi + listy.

Limity

• Obsługiwane kraje: tylko Rumunia (hardcoded)
• Maks. wyników na wyszukiwanie: 500
• Timeout deep scan: ~30s na firmę

Komunikaty błędów

"Uzupełnij lokalizację!" — pole wymagane
"W trybie wyczerpującym wybierz szeroką kategorię" — bundle wymagany gdy Exhaustive ON
"Błąd podczas uruchamiania scrapingu: [detail]" — API/połączenie

✍️ Szablony e-mail (z AI Copywriter)

Edytor wiadomości e-mail z 2 trybami (Tekst / Design Studio) + wbudowany asystent AI.

Lista szablonów

• Zakładki: Wszystkie / Moje / Galeria
• Gotowa galeria — przykładowe szablony gotowe do użycia
• "Generuj za pomocą AI" (fioletowa iskierka) — modal generowania AI
• "Nowy szablon" (+) — pusty edytor

Tryb 1: Text Editor (📝)

Pole tematu

• Maks. 200 znaków (limit twardy) — licznik "0 / 50 znaków" wskazówka miękka
• Obsługuje zmienne: {{firma}}, {{nume}}, {{oras}}, {{website}}, {{poza_logo}}
• Pasek zmiennych — szybkie wstawianie jednym kliknięciem w miejscu kursora

Edytor treści (Quill WYSIWYG)

• Liczba słów w czasie rzeczywistym
• Formatowanie: Pogrubienie / Kursywa / Linki / Listy / Nagłówki

Attachments

• Obrazy i PDF-y (maks. 10MB / plik)
• "Dodaj załącznik" — wybór pliku, automatyczne przesyłanie

Panel oceny spamu

• Wynik 0–100 (czerwony/żółty/zielony)
• Lista problemów: "Too many caps", "Spammy words: FREE, URGENT", "Missing unsubscribe link"
• Auto-weryfikacja przy każdej zmianie tekstu

Tryb 2: Design Studio (🎨)

Układ podzielony pionowo:

• Góra: podgląd iframe — przełącznik Desktop / Mobile / Dark mode + menu rozwijane Produkt (kontekst AI)
• Dół: Dok czatu AI — historia rozmowy, przeciągnij i upuść obrazy (maks. 5MB), quick-chips:
  • "+ opinia" — dodaje prawdziwą opinię z autorem + firmą
  • "+ cennik" — dodaje cennik z 3 poziomami
  • "+ kroki" — dodaje ponumerowane kroki jak to działa
  • "+ statystyki" — duże liczby + krótkie etykiety
  • "krótszy" / "bardziej przyjazny" / "dark" / "inny tytuł"

Przyciski boczne (wszystkie tryby)

• Copywriter ✨ — czat: "Przepisz temat bardziej chwytliwie", "Dodaj mocny hook", "Sprawdź błędy"
• AI Design ✨ (tylko Design Studio) — modal brief: URL + produkt + instrukcje
• Laboratorium tematów — generuje 5 wariantów tematu, wybierasz jeden
• Ocena krytyczna — AI ocenia ton, strukturę, czytelność CTA
• Podgląd — podgląd wyglądu w Gmail/Outlook
• Tłumaczenia 🌍 — warianty wielojęzyczne (EN, FR, DE, ES)
• Wersje 🕒 — historia wersji (auto-zapis), przywracanie starych wersji
• Test — wysyła test do Twojej skrzynki odbiorczej
• Zapisz (niebieski) — wymagane przed użyciem w kampanii

Limity

• Subject: 200 znaki (limit stały)
• Treść: praktycznie nieograniczona, ale >5000 znaków = klienci pocztowi ucinają wiadomość
• Attachments: 10MB / plik, dozwolone wiele

Komunikaty błędów

"Najpierw coś napisz" — treść jest wymagana
"Notatka nie może być pusta" — notatki w panelu kontaktu

📤 Kampanie Email (kreator 4 kroków + monitoring)

Kreator krok po kroku do uruchomienia kampanii.

Krok 1: Szablon

• Nazwa kampanii (wewnętrzna, np. "Restaurante Cluj — Aprilie")
• Wybierz szablon z listy (z miniaturą)
• "Kontynuuj" → krok 2

Krok 2: Odbiorcy

Selektor trybu (radio)

• "Wszystkie kontakty z e-mailem" (domyślnie)
• "Konkretna lista" — wybierz z listy rozwijanej
• "Według tagów" — wielokrotny wybór (logika OR)

Przycisk "Oblicz odbiorców": wyświetla "200 z 5000" z podziałem.

Krok 3: Konta + Ustawienia dostarczania

Konta SMTP

Pola wyboru dla każdego połączonego konta. Rotacja: e-maile rozdzielane równomiernie między wybrane konta.

Throttling (⏱)

• Presety: 🐢 Wolno (60s) / 🚶 Średnio (30s, zalecane) / 🏃 Szybko (10s, tylko małe listy)
• Niestandardowy: 5–600 sekund
• Wyświetlony szacunek: "~2 godz. 15 min dla 450 kontaktów przy 30s"

Harmonogram (📅)

• "Uruchom natychmiast" (domyślnie)
• "Zapisz wersję roboczą" (ręczne uruchomienie później)
• "Zaplanuj na określoną datę" + strefa czasowa
• Wskazówki pro: wysyłaj we Wtorek 09:00 / Środę 10:00 / Czwartek 11:00 (najlepsze godziny B2B)

Test A/B (🧪)

Toggle ON → wprowadzasz wariant B tematu. Podział 50/50, śledzi otwarcia per wariant. Odznaka "ZALECANE".

Opcje AI

• 🔗 Drip / Sekwencja wieloetapowa: przełącz ON → definiujesz follow-up'y (email 2, 3) dla osób, które nie odpowiedziały. Krok 1 = powyższy email. Kroki 2+ są wysyłane tylko jeśli lead nie odpowiedział. Przycisk "+ Dodaj krok".
• ⏰ AI wybiera optymalną godzinę dla każdego odbiorcy: AI wykrywa, kiedy każdy lead zazwyczaj otwiera e-maile (na podstawie historii) i wysyła o tej porze. Oczekiwany wzrost: +3–5% open rate.

Krok 4: Przegląd + wysyłka

Podsumowanie: Szablon / Odbiorcy / Konta / Throttle / Harmonogram / A/B / Drip.

Dwa końcowe przyciski: "Zapisz wersję roboczą" (szary) lub "Uruchom teraz" (niebieski).

Monitorowanie na żywo (po uruchomieniu)

• Znacznik statusu: "Wysyłanie" / "Wstrzymano" / "Zakończono" / "Niepowodzenie"
• KPI: "150 wysłanych / 5000 zaplanowanych" + pasek postępu
• Throttle wyświetlony, znacznik czasu ostatniej aktualizacji
• Przyciski: Wstrzymaj / Wznów / Zatrzymaj / Raporty

AI – przegląd per kontakt

Jeśli włączysz personalizację AI: osobny ekran "Personalizacja AI". Lista wariantów po lewej, szczegóły po prawej. Na kontakt: research AI + treść e-maila. Akcje: Zatwierdź ✓ / Odrzuć ✗ / Edytuj / Regeneruj. Przycisk "Zatwierdź wszystkich".

Limity

• Throttle: 5–600 sekund (limit stały)
• Maks. odbiorców: zależy od planu
• AI per kontakt: limit planu
• Drip: maks. 5 kroków follow-up
• A/B: tylko 2 warianty (A i B)

Komunikaty błędów

"Wybierz listę" — tryb listy bez zaznaczenia
"Zaznacz co najmniej jeden tag" — tryb tagów bez zaznaczenia
"Musisz wpisać USUŃ WSZYSTKO, aby potwierdzić" — przy anulowaniu kampanii
"Limit planu przekroczony. Ulepsz w Ustawieniach."

📧 Konta SMTP/IMAP

Łączenie kont e-mail — kluczowe dla dostarczalności.

Lista kont

Karty z: Email / Dostawca / Host SMTP / Status (✓ połączono / ✗ błąd). Przyciski na karcie: Test SMTP / Test IMAP / DNS / Usuń.

Dodaj konto (modal)

Test SMTP / Test IMAP

Wyślij połączenie testowe. Wyniki: ✓ OK lub ✗ "Auth failed" / "Connection timeout".

DNS check

Wyświetla status SPF / DKIM / DMARC. Każdy ✓ (prawidłowy) lub ⚠️ (brak). Wskazówka: "Dodaj ten rekord SPF do swojego DNS: v=spf1 include:smtp.hostinger.com ~all".

Setup Hostinger Email

1. Login hPanel → Emails → Email Accounts
2. Skopiuj ustawienia SMTP/IMAP:
   • Host SMTP: smtp.hostinger.com
   • Port SMTP: 465 (SSL)
   • IMAP host: imap.hostinger.com
   • IMAP port: 993 (SSL)
3. Używanie tych samych danych logowania co w webmailu

Konfiguracja Gmail (Google Workspace)

1. Włącz 2FA na koncie Google
2. Generuj hasło aplikacji: myaccount.google.com/apppasswords
3. W MarketHub:
   • Host SMTP: smtp.gmail.com
   • Port: 465 (SSL)
   • Użytkownik: Twój email
   • Password: hasło do aplikacji
4. Kliknięcie Test SMTP przed zapisaniem

Rekordy DNS dla dostarczalności

• SPF: TXT v=spf1 include:{provider} ~all
• DKIM: dostawca udostępnia selektor + TXT klucz publiczny
• DMARC: TXT v=DMARC1; p=quarantine; rua=mailto:dmarc@tau-domeniu

Limity

• Hostinger: ~300–500 e-maili/dzień
• Gmail: ~500/dzień
• Warmup ramp: 10 → 20 → 40 → 100/dzień w ~4 tygodniach
• Nowe konta (< 30 dni): warmup obowiązkowy

Komunikaty błędów

"Brakujące wymagane pola: [host, port, ...]" — uzupełnij
"Auth failed" — błędne hasło/użytkownik
"Connection timeout" — host nieosiągalny
"DNS check failed: SPF record invalid"

📈 Raporty

KPI, lejek, dostarczalność, heatmapy.

Typy raportów

1. Campaign reports (domyślnie):
   • KPI grid: Otwarcia / Kliknięcia / Odpowiedzi / Odbicia / Rezygnacje
   • Lejek: Wysłane → Dostarczone → Otwarte → Kliknięte → Odpowiedzi (% na krok)
   • Wykres szeregów czasowych: otwarcia/kliknięcia skumulowane w czasie trwania kampanii
   • Najlepsze leady: kto otworzył, kliknął, odpowiedział (tabela sortowalna)
2. Dostarczalność:
   • Wskaźnik odrzuceń według domeny (gmail.com 2%, yahoo.com 4%)
   • Podział na hard i soft bounces
   • Domeny automatycznie na czarnej liście (wskaźnik >15%)
3. Śledzenie otwarć/kliknięć:
   • Mapa kliknięć (najczęściej klikane linki)
   • Heatmapa otwarć (godzina otwarcia vs godzina wysyłki)
   • Unikalne a ponowne otwarcia
4. Dziennik wypisań: znacznik czasu, email, powód (opcjonalnie). Eksport CSV.
5. Porównanie: wybierasz 2–5 kampanii, siatka KPI side-by-side

Zakres dat

Ostatnie 30 dni (domyślnie). Do wyboru: 1, 7, 14, 30, 60, 90 dni.

Przyciski

• 📥 CSV — eksport danych dashboardu
• 📄 Drukuj — generuje PDF do druku
• 🖨️ Raport — pełny raport w nowym oknie

Limity

• Lookback: 2 lat
• Porównanie: maks. 5 kampanii
• Eksport: pierwsze 5000 wierszy

🍎 Apple Search Ads — AI autopilot

Łączysz konto Apple Search Ads + AI generuje plan działania + optymalizuje codziennie.

Połączenie

Stan pusty: "Połącz konto Apple Search Ads" → przycisk "Sign in with Apple" (OAuth). Jeśli masz więcej kont MCC, wybierasz z listy rozwijanej.

Dashboard (po połączeniu)

KPI grid

Wyświetlenia 👁 → Kliknięcia → CTR → Wydatki 💰 → Konwersje 🎯 → Śr. CPC

Zakres dat

1 / 7 / 14 / 30 / 60 / 90 dni.

Przyciski

• + Dodaj konto — połączenie ASA
• 📖 Przewodnik — przewodnik konfiguracji
• ℹ️ Jak to działa — wyjaśnia AI Blueprint + Auto-Pilot
• 🤖 AI Optimizer — uruchamia ręcznie
• 🎯 Conversions — śledzenie konwersji
• 🩺 Diagnostyka — sprawdza API endpoints
• 🏥 Account Health — opt score + holds check
• 🤖 Automatyzacje AI — auto-negative loop, daily summary
• 🔓 Rozłącz

Karta AI Brief

Tygodniowe podsumowanie: najważniejsze działania, oznaczone problemy. "🔄 Odśwież" ponownie uruchamia AI (zużywa limit). "Zobacz wszystko →" otwiera pełny AI Pro Brief.

Działania AI Optimizer

1. AI Blueprint: URL aplikacji → AI generuje 3–4 ad groups + 15 headlines/grupę + 4 opisy + sitelinks/callouts. Ty aktywujesz.
2. Dzienny optymalizator (auto): wyodrębnia frazy wyszukiwania → identyfikuje marnotrawstwo → sugeruje "Dodaj wykluczające słowo kluczowe: X" lub "Wstrzymaj Y". Rejestrowane z możliwością cofnięcia.
3. Auto-Pilot: bezpieczne działania stosowane automatycznie (negative kw). Ryzykowne wymagają zatwierdzenia 1-kliknięciem.

Wykresy

• Koszt i konwersje/dzień (szereg czasowy)
• Zestawienie fraz wyszukiwania (najlepsze wyniki)
• Analiza konkurencji (jeśli dostępna z ASA API)

Limity

• Konta: 1 aktywnych na użytkownika (przełącznik w menu)
• Aktualizacja: codziennie (overnight)
• Historia wyszukiwanych fraz: ostatnie 90 dni

Komunikaty błędów

"Brak Developer Token" — administrator musi skonfigurować klucz API ASA
"Konto nie jest połączone" — OAuth wygasł lub został odwołany

🔍 Google Ads — AI autopilot

Ten sam schemat co Apple Ads, ale dla Google.

Połączenie

"Sign in with Google direct" (OAuth). Przewodnik w "📖 Przewodnik krok po kroku". Wymagana konfiguracja administratora: OAuth Client ID/Secret + Developer Token.

Dashboard

Góra: lista rozwijana ID konta klienta + przyciski: + Dodaj konto, 📖 Przewodnik, ℹ️ Jak to działa, 🤖 AI Optimizer, 🎯 Conversions, 🩺 Diagnostyka, 🏥 Account Health, 🤖 Automatyzacje AI, 🔓 Rozłącz. Zakres dat 1–90 dni.

AI Brief + KPI

👁 Impressions / 👆 Clicks / 📊 CTR / 💰 Spend / 🎯 Conversions / 💵 Avg CPC. Charts: Cost & Conversions, CTR per kampanię, Search term mining.

Przepływ pracy AI Blueprint

1. Wprowadź URL strony/landing page
2. 1 zdanie o ofercie
3. AI generuje 3–4 ad groups + 15 headlines/grupę + 4 opisy + sitelinks/callouts/structured snippets (wielojęzyczne)
4. Przeglądasz → aktywujesz kampanie

Daily Optimizer + Automatyzacje AI

• Auto-Negative Loop — automatyczne dodawanie negatywnych słów kluczowych dla niskiego ROAS
• Daily Summary — email digest KPI + AI insights
• Smart Bidding rec — "Switch to Target CPA" jeśli śledzenie konwersji działa poprawnie
• Time-of-day optimization — dostosuj stawkę co godzinę

Limity

• Konta: 1 aktywnych na sesję
• Frazy wyszukiwania: ostatnie 90 dni
• Aktualizacja: codziennie
• Google API: 10000 ops/dzień, 60 ops/min

Komunikaty błędów

"Brak Google OAuth Client ID + Secret" — klucze platformy administratora
"Developer Token nie jest zatwierdzony przez Google" — proces zatwierdzania 24–72h
"Konto nie ma śledzenia konwersji" — ostrzeżenie Account Health

💬 Moduł SMS

Kampanie SMS z walidacją GSM-7, drip, automatyczny opt-out.

SMS Accounts (admin-only)

• Gateway SMS (RO): Connection ID + Password
• Gateway SMS (międzynarodowy): dane uwierzytelniające API + numer telefonu
• Webhook STOP replies: automatyczna czarna lista gdy odbiorca odpowie "STOP" (wymóg prawny)

SMS Templates

Limity znaków (CRITICAL)

• GSM-7 (bez znaków diakrytycznych): 160 znaków = 1 SMS, 153 znaków/segment dla wiadomości wieloczęściowych
• Unicode (z ă/â/î/ş/ţ): 70 znaków = 1 SMS, 67 znaków/segment
• Walidacja UI: licznik w czasie rzeczywistym pokazuje "153 znaków pozostało (1 SMS)" lub ostrzeżenie "Ze znakami diakrytycznymi: 67 znaków (UCS-2)"

Zmienne: {{nume}} / {{firma}} / {{oras}} / {{telefon}}

Biblioteka: 16 gotowych szablonów (przykłady z rynku RO).

SMS Campaigns

• Tryby odbiorców: wszystkie z telefonem / listą / tagami
• Throttle: 5–60s zalecane (unika blokad operatora)
• Harmonogram: natychmiast lub zaplanowane (NIE przed 08:00, NIE po 22:00 — zgodność z przepisami)
• Test A/B: opcjonalny wariant B (split 50/50)
• Drip: follow-up przy braku odpowiedzi (rzadziej niż e-mail)

SMS Drip sequences

Maks. 5 follow-up. Wyzwalacz: "Brak odpowiedzi po 3 dniach" → SMS2. Automatyczne zatrzymanie po odpowiedzi lub wypisaniu.

SMS Reports

• Status dla odbiorcy (wysłano / dostarczono / nie udało się / odrzucono)
• Podział: blokady operatora / nieprawidłowe numery / rezygnacje
• Całkowity wolumen, debounce rate

Limity i ograniczenia

• Dziennie: ~1000 SMS/konto (limit dostawcy + plan)
• Nazwa nadawcy: maks. 11 znaków alfanumerycznych (wymaga zatwierdzenia 1–2 dni)
• Opt-in: OBOWIĄZKOWE w UE (RO w zestawie)
• Wypisanie: każdy SMS musi zawierać "STOP" lub podobne

Komunikaty błędów

"Wiadomość przekracza limit GSM-7" — znaki diakrytyczne → UCS-2 wieloczęściowy
"Wybierz listę"
"SMS Gateway nie jest podłączony"

💳 Plan & Abonament

Ustawienia → Plan. Stripe zarządza płatnością; karta nie jest przez nas przechowywana.

Karta bieżącego planu

• Poziom (Free / Starter / Pro / Business / Enterprise)
• Miesięczny koszt (dla płatników)
• Uwzględnione funkcje (lista z zaznaczeniami)
• Data odnowienia / koniec bieżącego okresu

Szczegółowe użycie w bieżącym miesiącu

• Wysłane e-maile / Miesięczny limit
• Wysłane SMS-y / Limit
• Rozmowy AI / Limit
• Agent calls / Limit
• Zatwierdzone wiadomości agenta

Akcje

• Upgrade / Downgrade — w dowolnym momencie. Różnica jest automatycznie naliczana proporcjonalnie w Stripe.
• Pause — do 3 miesięcy. W trakcie pauzy nie płacisz, ale nie możesz wysyłać.
• Cancel — po zakończeniu opłaconego okresu. Dane pozostają przez 30 dni, po czym są usuwane.
• Zarządzaj w Stripe Portal — zmień kartę, pobierz faktury

Limity poziomu (orientacyjne)

Komunikaty błędów

"Limit planu przekroczony. Ulepsz w Ustawieniach."
"Plan zawieszony — wznów płatność"

⚙️ Ustawienia (wszystkie zakładki)

Profil

• KPI strip: "Członek od X dni" / "Ostatnie logowanie" / "Aktywne sesje" / "Rola"
• Avatar URL lub inicjały automatyczne
• Imię i nazwisko (używane w powitaniu + podpisach AI)
• Język: 🇷🇴 Română / 🇬🇧 English (przełącz UI)
• Strefa czasowa: Europe/Bucharest domyślnie + 7 inne opcje

Bezpieczeństwo

• Zmień hasło (obecne + nowe + potwierdzenie)
• Status weryfikacji e-mail
• 2FA — przełącznik (wkrótce)
• Usuń konto: "Żądanie trwałego usunięcia" → 30 dni karencji (anulowalne) → czyszczenie

Aktywne sesje

• Bieżąca sesja: urządzenie + lokalizacja + ostatnia aktywność
• Inne sesje: pełna lista z fingerprintami
• Unieważnij sesję na wiersz (X)
• Wyloguj wszystkich innych — jeden przycisk

Aktywność konta (dziennik audytu)

Oś czasu zdarzeń: Login / Campaign started / Template created / Password changed. Na wpis: timestamp / akcja / IP / User-Agent. Filtr według daty. Maks. 100/stronę.

Powiadomienia

• Przełącznik powiadomień przeglądarki
• Tabela preferencji dla zdarzenia:
  • Kolumny: W aplikacji / E-mail / Przeglądarka (pola wyboru)
  • Według typu zdarzenia: Campaign started, Reply received, AI draft pending, itp.
• Automatyczny zapis przy zmianie

Firma (per użytkownik, GDPR + CAN-SPAM)

• Nazwa firmy — pojawia się w stopce maili
• Strona firmowa — klikalny link
• Adres siedziby — RODO obowiązkowe
• Tekst rezygnacji z subskrypcji — dowolna forma + link rezygnacji z subskrypcji
• Domyślny podpis — używana przez AI, jeśli nie określisz innej

Calendar Google

• Connect Google Calendar (OAuth)
• Domyślny czas spotkania (15 / 30 / 60 min)
• Calendar selection — wybierasz, który ze swoich kalendarzy

Plan i rozliczenia

Zobacz Plan i subskrypcja.

Eksport RODO

• Duży przycisk: "📥 Pobierz eksport ZIP"
• Zawiera pliki CSV: businesses.csv / campaigns.csv / campaign_recipients.csv / email_templates.csv / products.csv / audit_log.csv / profile.csv + metadata.json
• Hasła/tokeny są [REDACTED]
• Automatyczny zapis w dzienniku audytu (każdy eksport pojawia się w Aktywności konta)

Zakładki tylko dla admina (tylko is_admin=1)

• Wyślij — limity zapytań dostawcy, domyślne ograniczenia przepustowości
• System — DB health, queue, error logs

📈 Deliverability — jak nie trafić do Spamu

1. SPF + DKIM + DMARC skonfigurowane (zobacz Konta SMTP)
2. Automatyczny warm-up: nowe konto zaczyna od 10 maili/dzień, stopniowo wzrasta do 100 (~30 dni)
3. Higiena listy: twarde odbicia automatycznie pomijane. Osoby, które nie otwierają 10+ maili, są wykluczone.
4. Dzienny limit na konto: 50–100 e-maili/dzień/konto na początku
5. Dedykowany folder: oddzielna domena/subdomena (outreach.firma.ro) aby nie zniszczyć reputacji głównej domeny
6. Zawartość: unikaj CAPS LOCK, wielu linków, "FREE!!!", "URGENT". Prawdziwa personalizacja obniża wynik spamu.

W Raporty → Deliverability sprawdź bounce rate per domena. Poniżej 2% jest OK, powyżej 5% — pauza + analiza.

🔒 GDPR i wypisywanie

Wbudowana zgodność z przepisami

• List-Unsubscribe header (RFC 8058) — Gmail/Outlook wyświetla natywny przycisk "Unsubscribe"
• Stopka z linkiem do wypisania się w każdym automatycznym emailu
• Strona wypisania jednym kliknięciem (GET lub POST), bez potwierdzenia
• Zakres per-tenant: wypisanie się od użytkownika A nie zatrzymuje kampanii użytkownika B
• Re-subscribe dostępny — użytkownik może wrócić
• Niezmienialny dziennik zgód do audytu

Twoje prawa (jako użytkownik MarketHub)

• Eksport RODO (Art. 20): Ustawienia → Eksport RODO → ZIP z plikami CSV
• Usunięcie konta (Art. 17): Ustawienia → Bezpieczeństwo → 30 dni karencji, anulowalne
• Dostęp do dziennika audytu: Ustawienia → Aktywność konta

🛠 Rozwiązywanie problemów

"Test SMTP" nie powiódł się

• Dla Gmail — wymagane hasło do aplikacji, nie hasło do konta (myaccount.google.com/apppasswords)
• Port 465 vs 587 — spróbuj innego portu
• Firewall dostawcy — niektóre hostingi blokują 25/465 outbound

Kampania zatrzymała się bez błędu

• Prawdopodobnie osiągnięto limit planu — Ustawienia → Plan
• Lub wszystkie konta SMTP osiągnęły dzienny limit — automatyczne wznowienie o 00:00 UTC

E-maile trafiają do Spamu

• Sprawdź SPF/DKIM/DMARC dla domeny (Konta → DNS)
• Używaj dedykowanej domeny do cold outreach
• Ogranicz wolumen do 30–50 maili/konto przez pierwsze 14 dni
• Personalizuj treść — identyczne szablony = sygnał spamu

Nie otrzymuję odpowiedzi w UI, choć mam odpowiedzi w skrzynce odbiorczej

• IMAP skonfigurowany i przetestowany OK?
• Konta → Test IMAP → uruchom ręcznie
• Polling wymaga dopasowania Message-ID — jeśli lead odpowiada bez "Reply" (nowy mail), dopasowanie rozmyte może zostać pominięte

"Failed: connection timeout" przy wysyłaniu SMTP

• Dostawca zablokował adres IP (limit zapytań) — poczekaj 1h
• Nieprawidłowy host SMTP (sprawdź w ustawieniach konta e-mail)

SMS-y nie docierają

• Sprawdź kredyt SMS (admin)
• Nazwa nadawcy zatwierdzona?
• Znaki diakrytyczne podwajają koszt (UCS-2 = 70 znaków/SMS)

Apple/Google Ads — "Brak Developer Token"

Administrator musi skonfigurować Developer Token + OAuth Client ID/Secret w Admin → Platform Keys. W przypadku Google token wymaga zatwierdzenia w ciągu 24–72h.

❓ Często zadawane pytania

📞 Kontakt i wsparcie

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

Średni czas odpowiedzi: 4–12h w dni robocze.