Czy Hermesmail integruje się z Google Sheets?

Po co Google Sheets w cold mailingu?

Google Sheets w Hermesmail służy 3 celom:

1. Backup bazy leadów — niezależnie od tego co stanie się z Hermesmail (np. sieć, hosting), Twoje dane masz w Google.
2. Praca zespołowa — udostępniasz arkusz handlowcom / asystentom, którzy mogą oznaczać leady, dopisywać notatki, segregować.
3. Analityka — pivot tables, charts, custom raporty którymi nie zarządza Hermesmail. Twoja swoboda.

Jak działa integracja

Auto-provisioning

Po rejestracji Hermesmail automatycznie tworzy nowy arkusz Google Sheet w folderze klienta (Google Drive). Adres URL jest zapisany w profilu jako gsheet_id. Klient dostaje link mailem.

Sync co 10 minut

Scheduler co 10 minut robi run_pull (z Sheets do CSV) i run_push (z CSV do Sheets):

• Pull — pobiera zmiany ręczne (np. dodanie leada, zmiana statusu) z Sheets do CSV roboczego;
• Push — wysyła nowe wiersze (z prospektora) i aktualizacje statusów (z auto_sender) do Sheets.

Sanity gate (zabezpieczenie)

Jeśli sheet ma 0 wierszy ale lokalny CSV ma 100+ — Hermesmail nie nadpisuje bazy (sanity gate). To chroni przed przypadkowym wykasowaniem danych.

Struktura arkusza

Arkusz ma 1+ zakładek (tabs):

• Hermes — domyślna zakładka z całą bazą (zsumowane wszystkie skany);
• 2026-04-30_betoniarnia_wielkopolskie — osobna zakładka dla każdego skanu prospektora;
• 2026-04-27_wspólnota_mieszka — kolejna zakładka.

Każda zakładka ma identyczną strukturę kolumn:

1. miasto_bazowe — miasto z którego startował skan
2. miasto — konkretne miasto firmy
3. ocena — Google Maps rating
4. zapytanie — fraza skanu
5. nazwa_firmy
6. adres
7. telefon
8. www — strona WWW
9. email
10. scoring — punkty AI 0-10
11. hook — fragment AI hook (wzmianka kontekstowa)
12. hermes_lead_id — unikalne ID
13. hermes_status — NEW/QUEUED/SENT/REPLIED/SKIP/UNSUBSCRIBED
14. hermes_sent_at — timestamp wysyłki
15. hermes_subject — temat wysłanego maila
16. hermes_email_body — treść wysłanego maila
17. hermes_replied_at — timestamp odpowiedzi
18. hermes_reply_classification — positive/neutral/negative/bounce
19. hermes_reply_snippet — fragment odpowiedzi
20. hermes_followup_count — ile follow-upów wysłano
21. hermes_source_account_id — z którego konta wysłane (multi-account)

Co możesz robić ręcznie w Sheets?

• Dodawać leady — własna baza CSV → wklej do Sheets → Hermesmail przy następnym pull załaduje;
• Edytować emaile — jeśli prospektor znalazł zły adres, popraw ręcznie;
• Zmieniać statusy — np. ręcznie ustawić REPLIED dla leada do którego rozmawiałeś po telefonie;
• Dodawać notatki — kolumna hermes_note przyjmie dowolny tekst;
• Filtrować i sortować — Google Sheets standard;
• Tworzyć pivots — np. „ile odpowiedzi per branża per miesiąc".

Co Hermesmail NIE pobiera z Sheets

• Wyłącznie kolumny standardowe — własne kolumny które dodasz są ignorowane przez Hermesmail (ale zostają w Sheets);
• Formuły — Hermesmail czyta wartości obliczone, nie same formuły;
• Wykresy i pivot tables — to są elementy Sheets niezależne od Hermesmail.

Bezpieczeństwo

Hermesmail tworzy arkusz przez Service Account (gsheets_sa.json) z uprawnieniami:

• read/write tylko na arkusze które sam stworzył;
• brak dostępu do innych Twoich plików w Drive;
• klient ma uprawnienia owner (może usuwać, share'ować, edytować).

Możesz w każdej chwili odebrać Hermesmail dostęp do arkusza w Google Drive → Share → Remove access. Wtedy automatyczny sync przestaje działać, ale dane zostają.