
# Telegram (Beta)

Połącz swoje istniejące konto Telegram z platformą, aby rozmowy z Telegrama trafiały bezpośrednio do aplikacji, a agent AI mógł na nie odpowiadać. Połączenie odbywa się poprzez podanie numeru telefonu i kodu logowania — w ten sam sposób, w jaki dodajesz Telegram na nowym urządzeniu.


> **Beta.** Telegram jest teraz dostępny dla wszystkich, ale to wciąż nowość — podczas dopracowywania funkcji mogą zdarzać się drobne niedociągnięcia. Jeśli coś nie działa zgodnie z opisem, daj znać naszemu wsparciu.

---

## Czym jest integracja z Telegramem?

Integracja z Telegramem łączy Twoje osobiste konto Telegram z platformą przy użyciu standardowego procesu logowania Telegrama. Nie musisz tworzyć bota ani kupować osobnego numeru telefonu — logujesz się za pomocą konta, którego już używasz, a Twoje czaty 1 na 1 stają się dostępne wewnątrz aplikacji.

Jest to idealne rozwiązanie dla firm, które już komunikują się z klientami przez Telegram i chcą korzystać z agenta AI, transmisji oraz współdzielonej skrzynki odbiorczej w ramach swojego istniejącego konta.

> **Ważne — przeczytaj przed połączeniem.** Jest to **nieoficjalna** integracja, która automatyzuje **osobiste konto Telegram**. Zasady Telegrama zniechęcają do automatyzacji oraz masowego lub niezamówionego wysyłania wiadomości. Konta naruszające te zasady mogą zostać **ograniczone lub trwale zablokowane** (w niektórych przypadkach sam numer telefonu może zostać zablokowany przed ponowną rejestracją). Używaj tego kanału tylko do wysyłania wiadomości do osób, które **już się z Tobą skontaktowały lub są zapisanymi kontaktami**, utrzymuj niską liczbę wiadomości i pozwól AI odpowiadać w naturalnym tempie. **Nie** używaj go do masowej wysyłki typu „cold outreach”.

---

## Telegram a WhatsApp Web

Obie opcje łączą konto, które już posiadasz, bez korzystania z oficjalnego API biznesowego.

| Funkcja | Telegram | WhatsApp Web |
|---|---|---|
| **Konfiguracja** | Podaj numer telefonu + kod logowania | Sparuj telefon (kod QR lub kod parowania) |
| **Typ konta** | Twoje osobiste konto Telegram | Twój osobisty/biznesowy WhatsApp |
| **Koszt za wiadomość** | Bezpłatnie | Bezpłatnie |
| **Wiadomości szablonowe** | Nie dotyczy | Nieobsługiwane |
| **Wskaźniki pisania** | Obsługiwane | Obsługiwane |
| **Media (przychodzące)** | Zdjęcia, dokumenty, notatki głosowe | Zdjęcia, dokumenty, notatki głosowe |
| **Oficjalne wsparcie** | Nieoficjalna integracja | Nieoficjalna integracja |
| **Najlepsze dla** | Firm aktywnych na Telegramie, ciepłych/istniejących kontaktów | Firm korzystających z WhatsApp, szybki start |

> **Ten sam numer w obu usługach?** Tak. Jeśli ten sam numer telefonu jest używany zarówno w Telegramie, jak i WhatsApp (Web), możesz połączyć go jako **oba** kanały — działają one jako dwa oddzielne połączenia na stronie Kanały, każde z własnym statusem, rozgrzewką i limitami. Połączenie jednego nie wpływa na drugie ani go nie zastępuje.

---

## Konfiguracja Telegrama

### Krok 1: Otwórz proces łączenia

1. W lewym pasku bocznym kliknij **Ustawienia** (Settings) w dolnej części.
2. W lewym panelu ustawień, w sekcji **Kanały** (Channels), kliknij **Kanały** (Channels).
3. Znajdź kartę **Telegram** — posiada ona oznaczenie **Beta** — i kliknij **Połącz** (Connect).


### Krok 2: Wprowadź swój numer telefonu

1. Wpisz numer telefonu konta Telegram, które chcesz połączyć, uwzględniając kod kraju (na przykład `555 123 4567`).
2. Włącz opcję **Importuj istniejące czaty**, jeśli chcesz przenieść swoje ostatnie prywatne rozmowy z Telegrama jako kontakty, aby nie zaczynać od pustej skrzynki odbiorczej. (Włączenie tej opcji pozwala również kontrolować ustawienie **Wstrzymaj AI dla zaimportowanych czatów** — zalecane i domyślnie włączone, dzięki czemu importowanie historii nigdy nie wywoła automatycznych odpowiedzi na stare wiadomości. Możesz je wyłączyć dla poszczególnych kontaktów później, gdy będziesz gotowy).
3. Kliknij **Wyślij kod logowania**.
4. Telegram wyśle kod logowania **do Twojej aplikacji Telegram** (zazwyczaj przychodzi on jako wiadomość z oficjalnego czatu serwisowego „Telegram”, nie zawsze jako SMS).


### Krok 3: Wprowadź kod logowania

1. Otwórz Telegram na swoim telefonie.
2. Odczytaj kod logowania z czatu serwisowego **Telegram**.
3. Wpisz kod w aplikacji.
4. Kliknij **Weryfikuj kod**.

> **Kod wygasa szybko.** Miej telefon pod ręką przed kliknięciem **Wyślij kod logowania** i wprowadź kod niezwłocznie. Jeśli wygaśnie, rozpocznij proces łączenia ponownie, aby otrzymać nowy.

### Krok 4: Hasło dwuetapowe (jeśli je posiadasz)

Jeśli Twoje konto Telegram ma włączoną **weryfikację dwuetapową**, aplikacja poprosi o **hasło 2FA** po wprowadzeniu kodu. Wpisz je, a następnie kliknij **Weryfikuj hasło**. Twoje hasło jest używane wyłącznie do zakończenia bezpiecznego logowania i nigdy nie jest przechowywane w czytelnej formie.

Po zweryfikowaniu Twoje konto pojawi się na stronie Kanały jako **Połączone**. Twoje rozmowy na Telegramie są teraz dostępne za pośrednictwem platformy, a agent AI przypisany do tego kanału może odpowiadać na przychodzące wiadomości.

### Importowanie istniejących czatów

Jeśli w kroku 2 włączono opcję **Importuj istniejące czaty**:

- Importowane są tylko ostatnie prywatne czaty (jeden na jednego). Czaty grupowe nie są uwzględniane, a z każdego czatu pobierana jest tylko ograniczona ilość najnowszej historii.
- Import uruchamia się jednorazowo w tle, zaraz po połączeniu. W przypadku większych kont wyświetlenie wszystkich danych może chwilę potrwać.
- Zaimportowane wiadomości uzupełniają konwersację w czatach, ale nie są wliczane do statystyk ani wykresów w Twoim [Panelu](../get-started/dashboard.md). Mierzone jest tam tylko to, co wysyłasz i otrzymujesz po nawiązaniu połączenia.

Jeśli połączysz się bez importowania, nowe rozmowy będą nadal napływać normalnie od tego momentu — pominięta zostanie tylko starsza historia.

---

## Zarządzanie sesją

### Sprawdzanie statusu połączenia

Stan połączenia z Telegramem jest widoczny na karcie **Telegram** na stronie **Kanały**:

| Status | Znaczenie |
|---|---|
| **Połączono** | Aktywne, wysyłanie i odbieranie wiadomości działa |
| **Kod wysłany** | Oczekiwanie na wprowadzenie kodu logowania |
| **Wymagana weryfikacja dwuetapowa** | Oczekiwanie na hasło weryfikacji dwuetapowej |
| **Nie połączono** | Brak aktywnej sesji |

### Ponowne łączenie

Jeśli sesja zostanie przerwana, otwórz **Ustawienia → Kanały → Kanały**, znajdź kartę Telegram i użyj akcji połączenia/zarządzania. Jeśli sesji nie można przywrócić automatycznie (na przykład po zakończeniu jej w telefonie), zostaniesz poproszony o ponowne zalogowanie się za pomocą nowego kodu.

### Rozłączanie

Otwórz kartę **Telegram** i kliknij **Rozłącz**. Spowoduje to wylogowanie platformy z Twojego konta Telegram i usunięcie sesji. Możesz również zakończyć sesję bezpośrednio w aplikacji Telegram: **Ustawienia → Urządzenia → Aktywne sesje**, a następnie zakończ sesję platformy.

---

## Bezpieczeństwo na Telegramie

Ponieważ automatyzujesz konto osobiste, to Ty odpowiadasz za ochronę przed blokadami. Platforma dostosowuje tempo pracy AI i wysyłek, aby wyglądały naturalnie, ale przestrzegaj poniższych zasad:

- **Wysyłaj wiadomości tylko do znanych kontaktów.** Odpowiadaj osobom, które napisały do Ciebie pierwsze lub są zapisane w Twoich kontaktach. Unikaj masowego wysyłania wiadomości do nieznajomych — to najszybsza droga do otrzymania flagi spamu od Telegrama.
- **Utrzymuj niskie wolumeny**, zwłaszcza na nowo podłączonym koncie. Zwiększaj je powoli przez kilka dni, nie wszystko na raz.
- **Unikaj wysyłania linków do osób, które Cię nie znają** — wiadomości z dużą liczbą linków wysyłane do nieznajomych są częstą przyczyną blokad.
- **Pozwól AI odpowiadać w naturalnym tempie.** Wbudowane opóźnienia i wskaźnik pisania mają na celu utrzymanie ludzkiego charakteru rozmowy — nie próbuj ich wyłączać.
- **Używaj prawdziwego numeru, do którego masz dostęp.** Numery tymczasowe/wirtualne (VoIP — numery internetowe, a nie fizyczne karty SIM) są znacznie częściej oznaczane jako spam.

> **Ostrzeżenie.** Jeśli Telegram oznaczy konto jako spam, wysyłanie zostanie wstrzymane do momentu zmiany zachowania — samo czekanie nie usunie blokady. Powtarzające się naruszenia mogą doprowadzić do trwałego zablokowania konta i numeru telefonu.

---

## Limity wysyłania, rozgrzewka i kontrola działań następczych

Telegram korzysta z tych samych ochronnych limitów wysyłania, automatycznej rozgrzewki i wyłącznika działań następczych dla każdego konta, co WhatsApp Web. Funkcje te istnieją, aby konto osobiste nie wyglądało jak farma spamu i nie zostało zablokowane. Na stronie **Kanały**, po podłączeniu konta Telegram, zobaczysz:

- Kartę **Limity wysyłania i rozgrzewka** z tymi samymi miernikami co w WhatsApp Web — wiadomości wysłane dzisiaj, nowe kontakty dzisiaj oraz bieżący dzień rozgrzewki.
- Przełącznik **Automatyczne działania następcze** — dla nowo podłączonego numeru jest on domyślnie **włączony**, więc wyłącz go samodzielnie, dopóki numer się rozgrzewa. Pozostaje on interaktywny, ale pokazuje, które etapy rozgrzewki (wiek numeru, zwiększanie aktywności, niedawne zaangażowanie kontaktów) nie zostały jeszcze zaliczone.

### Automatyczna rozgrzewka (ramp)

Świeżo podłączone konto Telegram jest celowo ograniczane, a jego możliwości zwiększają się z czasem. Konto zalicza "dzień kwalifikujący" tylko wtedy, gdy w danym dniu wyśle co najmniej 75% swojego aktualnego limitu — dni bezczynności nie liczą się, więc konto nie może awansować bez rzeczywistego, stałego użytkowania.

- **Dzienny limit wiadomości** = `50 + 8 × (day − 1)`, z ograniczeniem do **500/dzień** (osiąganym w 58. dniu).
- **Dzienny limit nowych kontaktów** = `floor((day − 1) × 5 / 6)` (zaokrąglony w dół do liczby całkowitej), z ograniczeniem do **50/dzień** (osiąganym w 61. dniu).

Na nowym koncie zaczynasz więc od 50 wiadomości dziennie i 0 nowych kontaktów dziennie, stopniowo zwiększając te wartości do pełnego limitu w ciągu około dwóch miesięcy. Strona Kanałów pokazuje bieżący dzień, dzisiejsze wykorzystanie limitu oraz pozostały czas do jego osiągnięcia.

::: tip
**Wskazówka:** Jeśli podłączysz konto, które **już** ma wielomiesięczną, autentyczną historię w Telegramie, panel rozgrzewki pozwoli Ci przesunąć dzień rozgrzewki do przodu, aby limity zostały natychmiast podniesione. Używaj tego uczciwie — tylko w przypadku kont, które naprawdę mają organiczną historię. Zupełnie nowe konto, które pominie rozgrzewkę, jest znacznie bardziej narażone na zablokowanie.
:::


### Ręczne obejście po zakończeniu rozgrzewki

Gdy konto zakończy pełną 58-dniową rozgrzewkę, opcjonalne obejście pozwala zwiększyć dzienny limit wiadomości powyżej 500 (od 750 do 5000, w krokach co 250 wiadomości). Nie ma „bezpiecznej” oficjalnej liczby dla Telegrama — zachowaj ostrożność, obserwuj flagi spamu i wycofaj się, gdy tylko zauważysz problemy. Obejście jest dostępne tylko dla w pełni rozgrzanych kont; nowe konto nie może w ten sposób pominąć rozgrzewki.

### Wyłącznik automatycznych wiadomości uzupełniających dla konta

Przełącznik **Automatyczne wiadomości uzupełniające** steruje tylko tym kontem. Gdy jest wyłączony, z tego konta **nie są wysyłane żadne automatyczne wiadomości uzupełniające**, niezależnie od ustawień transmisji lub kampanii. Na nowym koncie (poniżej ok. 30 dni rozgrzewki) najbezpieczniej jest wyłączyć wiadomości uzupełniające i wysyłać tylko początkową odpowiedź — to właśnie wiadomości uzupełniające najczęściej sprawiają, że konto o niskim poziomie zaufania zostaje zaklasyfikowane jako „bot”. Włącz je ponownie, gdy konto będzie rozgrzane i stabilne.

Po osiągnięciu dziennego limitu wiadomości zaplanowane wiadomości uzupełniające są automatycznie przenoszone na następny dzień, zamiast kończyć się niepowodzeniem.

---

## Wiadomości multimedialne

Przychodzące zdjęcia, dokumenty i notatki głosowe są pobierane do czatu, aby sztuczna inteligencja mogła je zrozumieć (notatki głosowe są transkrybowane automatycznie). W tej wersji odpowiedzi AI są **tylko tekstowe**. Długie odpowiedzi są automatycznie przycinane do limitu 4096 znaków w Telegramie.

---

## Status odczytania w telefonie

Gdy AI odpowiada na czat w Telegramie lub otwierasz ten czat w sekcji Czaty, czat jest oznaczany jako przeczytany również w Twojej aplikacji Telegram — dzięki temu licznik nieprzeczytanych wiadomości w telefonie pozostaje zsynchronizowany i nie gromadzą się setki nieprzeczytanych czatów.

Czaty, na które bot **nie** odpowiada (na przykład gdy jest wyłączony, poza godzinami pracy lub zdecydował się nie odpowiadać), są celowo pozostawiane jako **nieprzeczytane**, abyś mógł je samodzielnie zauważyć i obsłużyć.

---

## Ograniczenia

- **Tylko prywatne czaty 1 na 1.** Wiadomości grupowe i kanałowe nie są obsługiwane w tej wersji.
- **Brak przycisków wbudowanych.** Interaktywne menu przycisków nie są obsługiwane.
- **Wysyłanie tylko tekstu.** AI odpowiada tekstem; wysyłanie multimediów jest planowane w późniejszej aktualizacji.
- **Nieoficjalna integracja.** Opiera się na logowaniu klienta Telegrama i nie jest przez niego wspierana; zmiany na platformie mogą mieć na nią wpływ.
- **Ryzyko dla konta.** Nadmierna lub niechciana automatyzacja może doprowadzić do ograniczenia lub zablokowania konta — postępuj zgodnie z powyższymi wskazówkami dotyczącymi bezpieczeństwa.

---

## Rozwiązywanie problemów

### Kod logowania nie przychodzi

- Sprawdź czat serwisowy **Telegram** w aplikacji Telegram — kod jest zazwyczaj dostarczany tam, a nie przez SMS.
- Upewnij się, że wprowadzono numer telefonu z poprawnym kodem kraju.
- Telegram ogranicza liczbę kodów dla kont/numerów, które uznaje za podejrzane. Odczekaj kilka minut i spróbuj ponownie.

### „Kod wygasł” lub „Nieprawidłowy kod”

- Kod jest ważny tylko przez krótki czas. Rozpocznij połączenie ponownie, aby poprosić o nowy kod i wprowadź go niezwłocznie.

### Nieoczekiwana prośba o hasło

- Twoje konto ma włączoną weryfikację dwuetapową. Wprowadź swoje hasło do Telegrama, aby zakończyć logowanie. Jeśli je zapomniałeś, zresetuj je w **Ustawienia → Prywatność i bezpieczeństwo → Weryfikacja dwuetapowa** w aplikacji Telegram.

### Wiadomości nie są wysyłane

- Sprawdź, czy status połączenia na stronie Kanały wskazuje **Połączono**.
- Upewnij się, że kontakt jest osobą, do której możesz wysyłać wiadomości na Telegramie.
- Jeśli konto zostało niedawno oznaczone jako spam, zmniejsz liczbę wysyłanych wiadomości i ogranicz się do istniejących kontaktów.

### Wylogowano z konta

- Twoja sesja została zakończona (przez Ciebie, z innego urządzenia lub przez Telegram). Przejdź do **Ustawienia → Kanały → Kanały**, kliknij **Rozłącz**, a następnie zaloguj się ponownie.

---

## Dobre praktyki

- **Połącz konto, które już komunikuje się z klientami na Telegramie**, a nie zupełnie nowe, tymczasowe konto.
- **Zacznij od niskiego poziomu automatyzacji** i zwiększaj go stopniowo.
- **Odpowiadaj na przychodzące wiadomości i kontaktuj się z osobami, które Cię znają**, zamiast wysyłać wiadomości do nieznajomych.
- **Dbaj o kondycję swojego konta** — prawdziwy numer, normalne użytkowanie i zachowawcze tempo znacząco zmniejszają ryzyko blokady.
