Wysyłaj powiadomienia push do pojedynczych użytkowników

Zaktualizowano 20. grudnia 2023 przez Jan Bunk


Funkcje opisane na tej stronie wymagają planu z powiadomieniami push.

Podstawowa koncepcja wysyłania powiadomień push do pojedynczych użytkowników Twojej aplikacji wygląda następująco:

W tym poradniku "użytkownik" zawsze oznacza osobę, która ma konto użytkownika na Twojej stronie.
  1. Twój użytkownik Jan otwiera aplikację.
  2. Twoja strona wywołuje funkcję javascript getNotificationToken, która zwraca token powiadomień push tej instancji aplikacji.
  3. Twoja strona zapisuje ten token (na przykład w bazie danych użytkownika Jana).
  4. Gdy chcesz wysłać powiadomienie do Jana, wywołujesz API webtoapp.design z tym tokenem, a my dostarczymy powiadomienie.

Korzystanie z funkcji JavaScript

Możesz sprawdzić funkcję executeWhenAppReady() w naszym pomocniczym skrypcie aplikacji. Zapewnia, że Twoja strona nie próbuje komunikować się z aplikacją zanim będzie gotowa lub gdy strona jest otwarta w zwykłej przeglądarce (ReferenceError, funkcja nie jest zdefiniowana).

Gdy chcesz uzyskać token powiadomień push instancji aplikacji, po prostu wywołaj funkcję getNotificationToken.


<script>
    try {
        var token = (await getNotificationToken())["token"];
    }
    catch (e) {
        // Can occur if:
        // - the app couldn't connect to the native code. Should be very unlikely.
        // - the app couldn't get the push notification token, maybe because of connection issues. Should be very unlikely.
        // - push notifications are not included in your current plan
        console.log(e);
    }
</script>
    

O czym warto pamiętać:

  • Token to długi ciąg znaków, na przykład:
  • Token użytkownika może się zmienić,
    • gdy ten sam użytkownik korzysta z aplikacji na innym urządzeniu
    • gdy aplikacja zostanie odinstalowana i ponownie zainstalowana
    • gdy dane aplikacji zostaną wyczyszczone
    To oznacza, że stare tokeny powiadomień użytkownika mogą już nie być ważne, więc powinieneś regularnie je zapisywać. Jeśli chcesz, aby ten sam użytkownik mógł korzystać z aplikacji na wielu urządzeniach, musisz przechowywać wiele tokenów dla każdego użytkownika.
  • Trzymaj tokeny powiadomień push w tajemnicy.

Dokumentacja endpointów API

Pobierz swój indywidualny klucz API z panelu aplikacji.

Wyślij swój klucz API jako zapytanie w URL oraz w treści żądania w formacie JSON.