Simply Connect App

Użyj swojego telefonu jako bramki SMS!
Strona projektu »

Panel Użytkownika · Zgłoś problem · Zaproponuj zmiany · Autor

O projekcie

Założeniem aplikacji jest wykorzystanie własnych telefonów z androidem, które jakiś czas zalegają Ci w szufladzie i wysyłanie z nich SMS przez API czy z panelu administracyjnego. Oto dlaczego miałbyś wybrać to rozwiązanie:

• Korzysztasz ze starego telefonu, nie płacisz za drogie bramki SMS
• Wykorzystujsz własną kartę SIM, więc korzystasz z własnego numeru telefonu
• Aplikacja ciągle się rozwija i to Ty jako klient jesteś wyznacznikiem kolejnych funkcjonalności

Prócz podstawowe założenia wysyłki SMS w aplikacji znajdziesz również listę połączeń przychodzących na wypadek, gdyby ktoś dzwonił na Twój numer. Co do SMS, są również SMS i MMS przychodzące.

(back to top)

Użyte technologie

• 
• 
• 
• 

(back to top)

Od czego zacząć

Na początek upewnij się, że masz odpowiedni telefon z Androidem.

Warning

Uwaga! Aplikacja działa od wersji Android 6.0 w górę. Testowałem ją na Androidze 6.0.0, 6.0.1, 9.0 i 13.0 Niestety w wersji 13.0 są problemy z uprawnieniami i telefon nie uruchamia providera potwierdzającego wysyłkę SMS. Innymi slowy - w panelu na liście wysłanych SMS nie będziemy mieli informacji czy wiadomość została w ogóle wysłana, czy wystąpił jakiś błąd.

Panel zarządzania

Całe zarządzanie odbywa się z panelu, więc koniecznie utwórz swoje konto w https://panel.simply-connect.ovh

Instalacja aplikcji

Instalacja aplikacji na telefonie nie jest zbyt wygodna, ale pracuje nad tym.

1. Pobierz oficjlany plik .apk tutaj: https://download.simply-connect.ovh, lub zbuduj go sam z tego repozytorium.

2. Uruchom aplikacje i koniecznie wyraź zgodę na wszystkie komunikaty.

   Koniecznie wyszukaj w swoim telefonie wszystkie możliwe konfiguracje związane z oszczędzaniem energii i pozbądź się ich!
   Telefon będzie szybko wyłączał aplikację gdy tylko zablokujesz ekran by ograniczać zużycie energii.
   Najlepszym rozwiązaniem jest trzymanie telefonu ciągle pod ładowarką, ale zalecam również zrobić root'a, 
   przenieść apkę do aplikacji systemowych i dedykowanymi aplikacjami wyłączyć wszelkie ograniczenia energii, 
   a nawet zrobić skrypt do uruchamiania aplikacji od razu gdyby przypadkiem się wyłączyła. 
   Na to jednak nie mam jeszcze złotego środka i poradnika. Na testowanych przeze mnie urządzeniach jest raczej OK :)
   

3. Konfiguracja, połaczenie z kontrolerem

   Po uruchomieniu aplikacji w jej widoku nie ma nic ciekawego, prócz linka do lokalnego adresu...
   Tak, to była moja pierwsza aplikacja android, więc widok to nie moja bajka... :D
   Z tego powodu (na ten moment!) aplikacja ma webserwer, ponieważ początkowo chciałem tam zrobić znacznie więcej konfiguracji, informacji, itp.
   
   Wracając: wejdź z urządzenia używając dowolnej przeglądarki na adres http://localhost:8888/ lub z kompuera, jeśli urządzenie jest w tej samej sieci wifi.
   Aplikacja pokazuje Twoje ip lokalne, więc łatwo znajdziesz adres :)
   

4. Zaloguj się w web panelu urządzenia

Important

Domyślne hasło: lci123password

5. Przejdź do zakładki "Controller Configuration"

   

   Tutaj musisz wpisać token, który połączy urządzenie z Twoim kontem w panelu Simply Connect.
   W tym celu zaloguj się w panelu lub zrób konto jeśli tego nie zrobiłeś i przejdź do zakładki z listą udządzeń.
   Następnie kliknij "Dodaj nowe urządzenie"
   Wyświetlony token wklej konfiguracji swojego urządzenia.
   

   

   Spokojnie! Z czasem dodowanie będzie po np. skanowaniu kodu QR :D

(back to top)

Użycie

To wszystko. Teraz możesz używać aplikacji. Wysyłanie SMS z panelu nie jest na ten moment zbyt rozbudowane, więc jedynie w podglądzie urządzenia jest mały formularz na wpisanie treści SMS. W późniejszym etapie wysyłanie z panelu będzie znacznie bardziej rozwinięte - wybieranie wielu odbiorców, planowanie wysyłki, wysyłanie z wielu urządzeń na raz, a nawet MMS.

Aktualnie założonymi odbiorcami aplikacji są programiści, stąd stawiam na użycie API. W zakładce kluczy API możesz stworzyc klucz api, dodać uprawnienia do danego urządzenia. Znajdziesz tam również dokumentacje Swagger :)

Coś specjalnego dla programistów Laravel

W celu łatwiej implementacji dla aplikacji napisanych w Laravel 10/11 rozszerzyłem klasę Notifcations. Szczegóły znajdziesz tutaj Github - Simply Connect Laravel Notifications

(back to top)

Roadmap

• Wysyłanie SMS
• Odbieranie SMS
• Zapisywanie historii połączeń przychodzących
• Wysyłanie kodów USSD
• Odbieranie kodów USSD
• Wysyłanie MMS
• Odbieranie MMS
• Multi-language Support
  • Polski
  • Angielski
• Przekierowanie Emaili na SMS
• Przekierowanie SMS na Email
• Powiadomienia Email o statusie Offline urządzenia
• Powiadomienia Email o odebranym SMS przez urządzenie
• API dla Developerów
  • Wysyłka SMS
  • Wysyłka SMS do wielu odbiorców
  • Wysyłanie SMS z losowego/aktywnego urządzenia

(back to top)

Kontakt

Karol Sójka - @Linkedin.com - kontakt@letscode.it

Link do projektu: https://github.com/karlos1998/SimAppDeviceJava

(back to top)

TODO... :D