Help Center Sprawdź status wiadomości

Sprawdź status wiadomości

Śledź status dostarczenia wiadomości za pomocą punktu końcowego sprawdzania stanu.

Punkt końcowy

KOD_BLOKU_0

Żądanie

Parametry adresu URL

ParametrWpiszWymaganeOpis
Identyfikator wiadomościciągTakUnikalny identyfikator wiadomości z odpowiedzi na wysłanie

Uwierzytelnianie

Użyj dowolnej z trzech metod uwierzytelniania:

=== „Nagłówek klucza API”

__KOD_BLOKU_1__

=== „Podstawowe uwierzytelnianie HTTP”

__KOD_BLOKU_2__

=== „Klucz API jako hasło”

__KOD_BLOKU_3__

Odpowiedź

Podstawowa odpowiedź

KOD_BLOKU_4

Pola odpowiedzi

PoleWpiszOpis
Identyfikator listy wiadomościliczba całkowitaIdentyfikator partii
Identyfikator wiadomościciągUnikalny identyfikator wiadomości
status dostawyciągAktualny status dostawy
liczba częściliczba całkowitaLiczba części wiadomości
„koszt”numerKoszt wiadomości w jednostkach walutowych

Rozszerzona odpowiedź (z rezerwą)

Jeśli skonfigurowano rezerwę, odpowiedź zawiera dodatkowe pola:

KOD_BLOKU_5

Wartości stanu dostawy

StanOpis
„zaplanowane”W kolejce do wysłania
„przetwarzanie”Obecnie wysyłane
„dostarczone”Dostarczono pomyślnie
„niedostarczalne”Dostawa nie powiodła się, wiadomość odrzucona
stały błądUsunięto z kolejki z powodu utrzymującego się błędu

Cykl życia stanu

KOD_BLOKU_6

Zaplanowane

Wiadomość została zaakceptowana i umieszczona w kolejce do dostarczenia:

KOD_BLOKU_7

Przetwarzanie

Wiadomość jest obecnie wysyłana do odbiorcy:

KOD_BLOKU_8

Dostarczono

Wiadomość pomyślnie dostarczona do odbiorcy:

KOD_BLOKU_9

Niemożliwe do dostarczenia

Wiadomość nie mogła zostać dostarczona (nieprawidłowy numer, błąd sieci):

KOD_BLOKU_10

Stały błąd

Wiadomość usunięta z kolejki z powodu utrzymujących się problemów z dostarczaniem:

KOD_BLOKU_11

Sprawdź wiele wiadomości

Sprawdź status wielu wiadomości w swojej aplikacji:

KOD_BLOKU_12

Odpytywanie o aktualizacje statusu

Odpytuj punkt końcowy stanu, aby śledzić dostawę:

KOD_BLOKU_13

Alternatywa dla webhooka

Zamiast odpytywać, używaj webhooków do aktualizacji statusu w czasie rzeczywistym:

KOD_BLOKU_14

Skontaktuj się ze swoim menedżerem konta, aby skonfigurować adres URL webhooka.

Przykłady implementacji

Pythona

KOD_BLOKU_15

PHP

KOD_BLOKU_16

Node.js

KOD_BLOKU_17

Najlepsze praktyki

Częstotliwość odpytywania

  • ✅ Ankieta co 5-10 sekund
  • ✅ Wprowadź wykładnicze wycofywanie
  • ✅ Ustaw rozsądny limit czasu (60-120 sekund)
  • ❌ Nie odpytuj częściej niż raz na sekundę
  • ❌ Nie odpytuj w nieskończoność

Obsługa błędów

KOD_BLOKU_18

Buforowanie

Wyniki stanu pamięci podręcznej w celu ograniczenia wywołań API:

KOD_BLOKU_19

Przetwarzanie wsadowe

Podczas sprawdzania wielu wiadomości żądania zbiorcze:

KOD_BLOKU_20

Przypadki użycia

Potwierdzenie zamówienia

Śledź dostarczanie wiadomości z potwierdzeniem zamówienia:

KOD_BLOKU_21

Uwierzytelnianie dwuskładnikowe

Sprawdź dostawę OTP przed upływem limitu czasu:

KOD_BLOKU_22

Kampanie marketingowe

Śledź współczynniki dostarczania komunikatów kampanii:

KOD_BLOKU_23

Następne kroki