Your AI Connector Docs

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 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. 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 — pobierz ją ze strony lub z wydań w serwisie GitHub. 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.
  • 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 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.