Simply ConnectPrzejdź do panelu
IntegracjeSpring Boot

Starter JVM · v0.1.0

Simply Connect
dla Spring Boot.

Instalujesz starter, ustawiasz properties i od razu wstrzykujesz SimplyConnectClient. Panel do testów, wiadomości i kolejki połączeń pozostaje domyślnie wyłączony.

Pobierz starter v0.1.0 Pokaż instrukcję
Gotowa integracja · v0.1.0

Dla kogo jest ta integracja

Najpierw sprawdź, czy to rozwiązanie dla Ciebie.

Dla aplikacji Spring Boot 3.5 i 4.x w Javie lub Kotlinie. Do czystej Javy i Kotlina bez Springa służy lżejszy moduł opisany w osobnych poradnikach.

Co dostajesz

Mniej ręcznej pracy.
Więcej pewności.

01

Auto-konfiguracja SimplyConnectClient

02

Dependency injection w Javie i Kotlinie

03

SMS-y, historia i bramki

04

Flow IVR i kolejka połączeń

05

Opcjonalny panel pod własną ścieżką

Instalacja krok po kroku

Bez zgadywania. Zrobisz to po kolei.

Każdy krok mówi, gdzie wejść i czego oczekiwać. Najpierw uruchom podstawową wysyłkę, dopiero potem włącz kolejne automatyzacje.

  1. 1

    Dodaj publiczne repozytorium

    W settings.gradle dodaj JitPack obok Maven Central. Artefakt jest publiczny i nie wymaga tokenu GitHub.

    dependencyResolutionManagement {
    repositories {
        mavenCentral()
        maven { url = uri("https://jitpack.io") }
    }
}
  2. 2

    Zainstaluj starter Spring Boot

    Starter zawiera klienta bazowego i integrację ze Spring Boot. Nie dodawaj simply-connect-java drugi raz.

    implementation("com.github.karlos1998.simply-connect-jvm:simply-connect-spring-boot-starter:v0.1.0")
  3. 3

    Utwórz klucz API

    W panelu Simply Connect otwórz Developer → API keys. SMS_SEND odpowiada za endpointy i wysyłkę; historia oraz kolejka połączeń mają osobne zakresy.

    Otwórz panel Simply Connect
  4. 4

    Skonfiguruj application.yml

    Sekrety podawaj przez zmienne środowiskowe. Starter utworzy bean SimplyConnectClient podczas startu aplikacji.

    simply-connect:
  api-key: ${SIMPLY_CONNECT_API_KEY}
  default-sms-endpoint-id: ${SIMPLY_CONNECT_SMS_ENDPOINT_ID}
  5. 5

    Wstrzyknij klienta

    Wstrzyknij SimplyConnectClient do własnego serwisu. Ten sam bean działa w klasach Java i Kotlin.

    @Service
class OrderNotifications {
    private final SimplyConnectClient client;

    OrderNotifications(SimplyConnectClient client) {
        this.client = client;
    }
}
  6. 6

    Opcjonalnie włącz panel

    Panel jest domyślnie wyłączony. Ustaw osobne hasło mające co najmniej 12 znaków i świadomie zabezpiecz ścieżkę także w Spring Security.

    simply-connect:
  panel:
    enabled: true
    path: /simply-connect
    password: ${SIMPLY_CONNECT_PANEL_PASSWORD}

Test po instalacji

Po czym poznasz, że wszystko działa?

Nie zaczynaj od masowej wysyłki. Przejdź tę krótką listę na jednym kontrolowanym numerze.

  1. 1Aplikacja startuje z beanem SimplyConnectClient.
  2. 2Kontrolny SMS zwraca identyfikator i pojawia się w Simply Connect.
  3. 3Panel pod /simply-connect wymaga osobnego hasła.
  4. 4Panel pokazuje wyłącznie sekcje dozwolone przez zakresy klucza.
  5. 5Demo z profilem demo działa na mock API bez ruchu do operatora.

Gdy coś nie ruszy

Najczęstsze problemy

Najpierw sprawdź poniższe rzeczy — zwykle rozwiązanie jest tutaj.

Aplikacja nie tworzy beana

Sprawdź, czy zainstalowany jest starter, a nie sam moduł simply-connect-java, oraz czy simply-connect.api-key jest dostępny podczas startu.

Panel nie uruchamia aplikacji

Hasło panelu musi mieć co najmniej 12 znaków i różnić się od klucza API. Panel pozostaw wyłączony, jeżeli go nie potrzebujesz.

Panel zwraca 401 lub 403

Sprawdź osobne hasło panelu oraz reguły Spring Security dla skonfigurowanej ścieżki. Starter nie osłabia zabezpieczeń aplikacji gospodarza.

Gotowe do uruchomienia

Połącz Spring Boot z własnym numerem.

Integracja jest otwarta i wersjonowana. Kod możesz sprawdzić przed instalacją, a w razie pytania napisać do nas.

Nazwy i znaki należą do ich właścicieli. Integracja nie oznacza partnerstwa ani certyfikacji przez właściciela danego narzędzia.
Pobierz starter v0.1.0 Zobacz kod na GitHubiePotrzebujesz pomocy?