# Telefon z systemem Android jako bramka SMS (Beta) Używaj własnego telefonu z systemem Android jako nadawcy wiadomości SMS. Zamiast łączyć konto Twilio, zainstaluj niewielką aplikację open-source na telefonie z Androidem, sparuj ją ze swoim obszarem roboczym, a wiadomości będą wysyłane i odbierane za pośrednictwem numeru i planu taryfowego tego telefonu. > **Kanał Beta.** Bramka SMS dla systemu Android jest już dostępna dla wszystkich użytkowników posiadających plan z limitem kanałów, ale jest to rozwiązanie nowe — należy spodziewać się sporadycznych niedociągnięć i pamiętać, że zachowanie oraz limity mogą ulec zmianie w miarę rozwoju kanału. Jeśli coś nie działa zgodnie z opisem, prosimy o kontakt z działem wsparcia. --- ## Dlaczego warto z tego korzystać Bramka Android jest przeznaczona do **wysyłania niewielkiej liczby wiadomości SMS w ramach konwersacji** — odpowiadania na zapytania, prowadzenia rozmów z AI oraz komunikacji jeden na jeden. Jest to dobre rozwiązanie, gdy: - Chcesz nadal wysyłać wiadomości ze swojego **istniejącego numeru osobistego lub firmowego**. - Twilio jest **zbyt skomplikowane lub nieopłacalne** w Twoim kraju lub przy Twoim wolumenie wiadomości. - Wolisz korzystać z **istniejącego pakietu SMS u swojego operatora** niż płacić opłaty za każdą wiadomość. - Chcesz **uniknąć formalności związanych z rejestracją u operatora** (A2P 10DLC i podobne), których wymaga Twilio. Rozwiązanie to **nie** jest przeznaczone do masowej wysyłki wiadomości — zobacz [Ograniczenia](#limitations) poniżej. > **Wybierz Twilio, jeśli zależy Ci na skali i niezawodności.** Jeśli wysyłasz dużą liczbę wiadomości, potrzebujesz gwarantowanego czasu pracy bez przestojów lub prowadzisz masowe kampanie SMS, połącz numer Twilio — zobacz [Wiadomości SMS](sms.md). Oba rozwiązania to alternatywne sposoby przesyłania wiadomości SMS; wiadomości, kontakty, sztuczna inteligencja i skrzynka odbiorcza działają tak samo w obu przypadkach. --- ## Czego potrzebujesz - **Telefonu z systemem Android** z aktywną kartą SIM i planem SMS (zdecydowanie zalecany jest nielimitowany lub bardzo duży pakiet SMS). - **Darmowej aplikacji open-source "SMS Gateway for Android"** ze strony [sms-gate.app](https://sms-gate.app) — pobierz ją ze strony lub z [wydań w serwisie GitHub](https://github.com/capcom6/android-sms-gateway/releases/latest). Nie jesteśmy twórcami tej aplikacji — jest to projekt zewnętrzny. - **Telefonu, który jest włączony, ma dostęp do sieci i nie posiada ograniczeń** — zobacz [Zapewnienie niezawodności telefonu](#keeping-the-phone-reliable). - **Płatnego planu** — bramka Android jest uwzględniona w Twoim limicie kanałów. Nie ma **żadnej opłaty platformowej za wiadomość** ani rachunku z Twilio — korzystasz z własnego planu taryfowego telefonu. Jeśli sztuczna inteligencja wygeneruje odpowiedź, ta odpowiedź nadal zużywa kredyty AI, tak samo jak w przypadku każdego innego kanału. --- ## Konfiguracja aplikacji bramki 1. Zainstaluj **SMS Gateway for Android** ze strony [sms-gate.app](https://sms-gate.app) na telefonie, którego numeru chcesz używać. 2. Otwórz aplikację. 3. Włącz tryb **Cloud Server** (najprostsza opcja — przesyła dane przez serwer hostowany przez projekt, dzięki czemu telefon nie musi mieć publicznego adresu). 4. Aplikacja wygeneruje **nazwę użytkownika** i **hasło** na ekranie głównym. Wkleisz je do platformy w następnej sekcji. 5. (Zalecane) W aplikacji otwórz **Ustawienia → Webhooki**. Webhook to automatyczne powiadomienie, które aplikacja wysyła do platformy, gdy coś się wydarzy — w tym przypadku, gdy nadejdzie wiadomość. 6. Skopiuj **Klucz podpisu (Signing Key)**. Wklejenie go do platformy dodaje dodatkową weryfikację podpisu dla przychodzących wiadomości. > **Tryb lokalny (zaawansowane).** Jeśli wolisz, aby telefon komunikował się z platformą bezpośrednio przez Twoją własną sieć zamiast przez przekaźnik w chmurze, aplikacja obsługuje również tryb Local Server. Będziesz musiał udostępnić telefon pod dostępnym adresem HTTPS i wprowadzić ten adres jako bazowy URL podczas łączenia. Tryb chmurowy jest zalecany dla większości użytkowników. --- ## Łączenie telefonu z platformą 1. Na lewym pasku bocznym kliknij **Ustawienia** (Settings) w pobliżu dołu ekranu. 2. W lewym panelu ustawień, w sekcji **Kanały** (Channels), kliknij **Kanały** (Channels). 3. Znajdź kartę **Bramka SMS Android** (Android SMS Gateway) i kliknij **Połącz** (Connect). 4. Wprowadź **Numer telefonu** — własny numer telefonu w formacie międzynarodowym (E.164), np. `+14155551234`. 5. Wprowadź **Nazwę użytkownika bramki** (Gateway username) oraz **Hasło bramki** (Gateway password) z ekranu głównego aplikacji bramki. 6. Opcjonalnie wklej **Klucz podpisywania webhooka** (Webhook signing key) (zalecane) z ustawień Webhooków w aplikacji. 7. Kliknij **Połącz** (Connect). Platforma weryfikuje dane uwierzytelniające, rejestruje webhooki wiadomości i dostarczeń w bramce oraz zmienia status na **Połączono** (Connected). Nie ma potrzeby kopiowania i wklejania adresów URL webhooków do aplikacji — rejestracja odbywa się automatycznie. ### Sprawdzanie statusu Po połączeniu przycisk na karcie zmienia się z **Połącz** (Connect) na **Zarządzaj** (Manage). Kliknij go, aby ponownie otworzyć panel bramki, gdzie w dowolnym momencie znajdziesz opcję **Odśwież status** (Refresh status). Sprawdza ona ponownie, czy bramka jest osiągalna i pokazuje, czy telefon jest aktualnie **online**. Jeśli telefon jest w trybie uśpienia lub offline, zobaczysz wyraźny wskaźnik offline, dzięki czemu będziesz wiedzieć, że wiadomości nie będą wysyłane, dopóki telefon nie wróci do sieci. ### Rozłączanie Kliknij **Zarządzaj** (Manage) na karcie, aby ponownie otworzyć panel bramki, a następnie kliknij **Rozłącz** (Disconnect). Platforma usunie webhooki zarejestrowane w bramce i wyczyści połączenie. Twoje wiadomości SMS będą wtedy ponownie obsługiwane przez Twilio, jeśli masz podłączony numer SMS Twilio, lub funkcja SMS zostanie wyłączona, jeśli go nie masz. --- ## Jak przepływają wiadomości ### Przychodzące 1. Ktoś wysyła SMS na numer Twojego telefonu. 2. Aplikacja bramki na telefonie wykrywa SMS i powiadamia platformę. 3. Platforma tworzy kontakt (jeśli jest nowy), umieszcza wiadomość w Twojej skrzynce odbiorczej i — jeśli odpowiedni Agent AI jest aktywny — odpowiada na nią. ### Wychodzące 1. Ty lub AI wysyłacie odpowiedź z platformy. 2. Platforma przekazuje wiadomość do Twojej bramki. 3. Telefon wysyła ją jako zwykły SMS z Twojego numeru, za pośrednictwem Twojego operatora. 4. Gdy operator przekaże informację zwrotną, status wiadomości zmieni się na **Wysłano** (Sent), a następnie **Dostarczono** (Delivered) (lub **Niepowodzenie** (Failed)). > **Bramka Android ma priorytet przy wysyłaniu.** Gdy jest połączona, odpowiedzi indywidualne oraz odpowiedzi AI przechodzą przez Twój telefon. Jeśli masz również podłączony numer SMS Twilio, rozłącz bramkę Android, aby ponownie wysyłać wiadomości przez Twilio. Jeden wyjątek w obie strony: **kampanie i masowe wysyłki SMS zawsze przechodzą przez Twój numer Twilio**, nigdy przez telefon z Androidem — masowe wysyłanie z osobistego urządzenia jest dokładnie tym, co powoduje oznaczanie numerów jako spam, dlatego platforma tego nie robi. --- ## Ograniczenia Bramka Android zależy od fizycznego telefonu, który kontrolujesz, więc wiąże się z ograniczeniami, których nie spotkasz w Twilio. Zapoznaj się z nimi, zanim zaczniesz polegać na tym rozwiązaniu w ważnej komunikacji. - **Telefon musi pozostać włączony i mieć połączenie z siecią.** Brak telefonu oznacza brak wiadomości. Dbaj o to, aby był naładowany, połączony z Wi-Fi lub danymi komórkowymi oraz wykluczony z optymalizacji baterii. - **Tylko mała liczba wiadomości.** Operatorzy oznaczają i ograniczają telefony, które nagle wysyłają dużą liczbę SMS-ów. Ten kanał służy do rozmów i odpowiedzi jeden na jednego — **nie do masowych wysyłek**. - **Masowe wysyłki SMS nie są obsługiwane w tym kanale.** Masowe wysyłki SMS wymagają podłączonego numeru Twilio; platforma poinformuje Cię o tym, jeśli spróbujesz uruchomić taką wysyłkę bez Twilio. Wysyłaj komunikaty masowe przez Twilio, a bramkę Android zachowaj do konwersacyjnych odpowiedzi. - **Tylko tekst.** Wysyłanie i odbieranie MMS (multimediów) nie jest obsługiwane w tym kanale. - **Obowiązują limity operatora.** Twój plan taryfowy, limity uczciwego użytkowania oraz wszelkie opłaty za wiadomość są kwestią między Tobą a Twoim operatorem. - **Potwierdzenie dostarczenia zależy od operatora.** Niektórzy operatorzy raportują dostarczenie niezawodnie, inni nie. Status "Wysłano" oznacza, że telefon wysłał wiadomość. - **Ryzyko związane z kontem / numerem.** Używanie numeru osobistego do zautomatyzowanej komunikacji biznesowej może naruszać regulamin operatora i prowadzić do ograniczenia lub zawieszenia numeru w przypadku nadużyć. Korzystaj z niego odpowiedzialnie, uzyskaj zgodę i dołącz instrukcje rezygnacji z subskrypcji. --- ## Zapewnienie niezawodności telefonu Aby zapewnić nieprzerwane przesyłanie wiadomości: - **Wyłącz optymalizację baterii** dla aplikacji SMS Gateway (Ustawienia Androida → Aplikacje → SMS Gateway → Bateria → Bez ograniczeń). W przeciwnym razie system Android może zamknąć ją w tle. - **Zadbaj o to, aby ekran był dostępny / aplikacja mogła działać w tle.** Najlepiej sprawdza się dedykowany telefon podłączony do zasilania. - **Utrzymuj stabilne połączenie Wi-Fi lub komórkowe.** Jeśli telefon straci łączność, kolejka wysyłania zostanie wstrzymana do czasu przywrócenia połączenia. - **Utrzymuj kartę SIM w aktywnym stanie** i dbaj o jej poprawne działanie u operatora. --- ## Rozwiązywanie problemów ### „Nie udało się zweryfikować danych logowania bramki” - Sprawdź ponownie **nazwę użytkownika** i **hasło** na ekranie głównym aplikacji bramki — są one generowane ponownie w przypadku reinstalacji lub resetowania aplikacji. - Upewnij się, że telefon ma dostęp do Internetu, a tryb **Cloud Server** jest włączony w aplikacji. ### Status wskazuje tryb offline / wiadomości nie są wysyłane - Otwórz aplikację na telefonie i potwierdź, że działa oraz jest połączona z serwerem w chmurze. - Sprawdź, czy telefon nie jest w trybie Doze / oszczędzania baterii oraz czy aplikacja jest wykluczona z optymalizacji baterii. - Po przywróceniu połączenia z Internetem dotknij **Odśwież status** na karcie. ### Przychodzące wiadomości nie pojawiają się - Potwierdź, że połączenie nadal ma status **Połączono** (dotknij **Odśwież status**). - Wyślij testową wiadomość na numer telefonu z innego urządzenia. - Upewnij się, że domyślna aplikacja Wiadomości w telefonie nie blokuje ani nie filtruje nadawcy. ### Wiadomość ma status „Niepowodzenie” - Operator odrzucił wiadomość — sprawdź, czy numer odbiorcy jest poprawny i podany w formacie międzynarodowym. - Potwierdź, że na karcie SIM pozostał limit wiadomości SMS i numer nie jest zawieszony. - Bardzo wysokie tempo wysyłania może spowodować ograniczenia ze strony operatora; zwolnij tempo i utrzymuj niski wolumen. --- ## Potrzebujesz pomocy? Bramka SMS dla systemu Android jest w fazie **Beta**. Jeśli napotkasz problem nieopisany tutaj, skontaktuj się z hi@youraiconnector.com, podając: - Numer telefonu, który został podłączony (nie hasło). - Informację, czy aplikacja bramki pokazuje status online na telefonie. - Opis problemu oraz czas jego wystąpienia. Przyjrzymy się sprawie tak szybko, jak to możliwe.