Wszystko, co musisz wiedzieć o użytkownikach SMS

Pokaż jako Markdown

Dowiedz się, jak tworzyć, konfigurować i zarządzać użytkownikami API do wysyłania wiadomości SMS, w tym ustawiać uprawnienia i ograniczenia

Wprowadzenie

Z tego przewodnika dowiesz się, jak tworzyć użytkowników API i jak nimi zarządzać.

Wymagania początkowe

aktywne konto SMS OVHcloud

Dostęp do Panelu klienta OVHcloud

Link bezpośredni: SMS
Ścieżka nawigacji: Telecom > SMS > Wybierz konto SMS

W praktyce

Użytkownik API SMS może być przydatny z kilku powodów:

Umożliwia właścicielowi konta SMS zabezpieczenie dostępu podczas wysyłania wiadomości SMS za pośrednictwem zewnętrznego API. Skrypt wywołujący zna jedynie identyfikator i hasło użytkownika, a nie sesję powiązaną z identyfikatorem właściciela konta.
Utworzenie kilku użytkowników API może być przydatne w firmie, zwłaszcza w celu zapewnienia lepszej identyfikowalności. Właściciel konta może wówczas wykryć użytkownika API, który wysyła wiadomości SMS w nadmiernych ilościach.
Na użytkownika API można również nałożyć ograniczenia (kwoty) dotyczące zasileń SMS. Dzięki temu właściciel konta SMS może rozdzielić swoje zasilenia między różne konta użytkowników API.

Aby lepiej zarządzać zasileniami swoich kont SMS, możesz ustawić limit i kwotę dla użytkowników API.

Kwota to liczba zasileń SMS dostępnych dla każdego użytkownika API.
Limit to minimalny próg zasileń SMS, jaki użytkownik API musi posiadać, zanim otrzyma alert o konieczności doładowania stanu tych zasileń.

Etap 1: Utworzenie użytkownika API

Kliknij kartę Użytkownicy API. Aby dodać użytkownika, kliknij Operacje, a następnie Dodaj.

Możesz nadać użytkownikowi API nazwę. Hasło użytkownika API musi składać się z 8 znaków alfanumerycznych.

Etap 2: Ustawianie kwoty dla użytkownika API

Kwotami możesz zarządzać na karcie Użytkownicy API. Obok wybranego użytkownika kliknij ..., a następnie Limit.

Możesz wówczas wykonać dwie czynności.

Aktywować limit? Pozwala określić, czy dany użytkownik podlega kwocie.
Nowy limit. Określa kwotę użytkownika. Po osiągnięciu tej kwoty użytkownik nie będzie mógł wysyłać wiadomości SMS.

Info

Przypisanie kwoty użytkownikowi API zmniejszy całkowity stan zasileń konta SMS o tę samą wartość.

Przykład: konto SMS ma łącznie 200 zasileń. Przypisanie 150 zasileń użytkownikowi API spowoduje odliczenie 150 zasileń z konta SMS. Pozostanie na nim wówczas 50 zasileń.

Etap 3: Ustawianie limitu dla użytkownika API

Aby skonfigurować limit dla użytkownika, pozostań w tym samym menu, kliknij ..., a następnie Limit.

Dostępne są teraz następujące parametry:

Aktywować alert? Pozwala aktywować alert o osiągnięciu limitu.
Próg alertu. Określa poziom pozostałych zasileń SMS, po osiągnięciu którego wysyłane jest powiadomienie.
Powiadomienie. Pozwala wybrać rodzaj powiadomienia. Dostępne opcje to: e-mail (podaj swój adres e-mail), SMS (podaj swój numer w formacie międzynarodowym) lub obie formy.

Warning

Powiadomienie wysłane za pośrednictwem wiadomości SMS jest odliczane od Twojego stanu zasileń SMS.

Etap 4: Określanie ograniczenia według adresu IP dla funkcji http2sms

Funkcję http2sms możesz zabezpieczyć, stosując ograniczenia adresów IP dla każdego użytkownika API.

Aby ją aktywować, po prawej stronie użytkownika kliknij ..., a następnie Ograniczenia.

Możesz wprowadzić do 5 różnych adresów IP, z których wysyłane będą zapytania HTTPS.

Aby uzyskać więcej informacji na temat funkcji http2sms, zapoznaj się z naszym przewodnikiem Wysyłanie wiadomości SMS za pośrednictwem adresu URL.

Etap 5: Określanie adresu URL wywołania zwrotnego

Aby skonfigurować niestandardowe monitorowanie dostarczania wiadomości SMS (Delivery reporting lub DLR), możesz określić adres URL wywołania zwrotnego, klikając ... po prawej stronie użytkownika, a następnie Callback.

Gdy status wysyłki wiadomości SMS zostanie zaktualizowany, wywołujemy określony adres URL. Poniższe wartości są automatycznie wstawiane do ciągu zapytania:

id: numer identyfikacyjny wiadomości SMS.
ptt: kod odpowiadający statusowi wiadomości SMS. Poszczególne kody ptt zostały opisane w poniższej tabeli.
date: data raportu DLR.
description: identyfikator raportu DLR. Poszczególne kody ptt zostały opisane w poniższej tabeli.
descriptionDlr: opis statusu raportu DLR.

Kody ptt

Aby uzyskać opis konkretnego kodu ptt, możesz użyć następującego API:

🇪🇺GET/sms/ptts

Aby uzyskać więcej informacji na temat korzystania z API OVHcloud, zapoznaj się z naszym przewodnikiem Pierwsze kroki z API OVHcloud.

Poniższa tabela zawiera niewyczerpującą listę głównych kodów ptt.

Kod	Opis
1	Status pośredni informujący, że trwa ponowna próba wysłania wiadomości z powodu problemu związanego z telefonem.
2	Wskazuje, że wiadomość nie została jeszcze dostarczona z powodu problemu związanego z operatorem, ale w sieci podejmowana jest ponowna próba dostarczenia.
3	Wskazuje, że wiadomość została zaakceptowana przez operatora.
4	Wiadomość została dostarczona.
5	Wiadomość została potwierdzona jako niedostarczona, ale brak szczegółowych informacji o przyczynie niepowodzenia.
6	Nie można ustalić, czy wiadomość została dostarczona, czy też wysyłka się nie powiodła, z powodu braku informacji o ostatecznym statusie dostarczenia od operatora.
8	Stosowane, gdy wiadomość wygasła (nie mogła zostać dostarczona w czasie życia wiadomości) w ramach SMSC operatora, ale nie jest powiązana z przyczyną niepowodzenia.
20	Stosowane, gdy wiadomość w jej obecnej formie nie może zostać dostarczona.
21	Stosowane wyłącznie wtedy, gdy operator akceptuje wiadomość przed sprawdzeniem stanu zasileń abonenta. Jeśli abonent nie ma wystarczających zasileń, operator ponawia próbę wysłania wiadomości do momentu doładowania zasileń lub wygaśnięcia wiadomości. Jeśli wiadomość wygaśnie, a ostatnia przyczyna niepowodzenia jest związana ze stanem zasileń, użyty zostanie ten kod błędu.
23	Stosowane, gdy wiadomość nie może zostać dostarczona z powodu nieprawidłowego / nieważnego / znajdującego się na czarnej liście / trwale zablokowanego numeru MSISDN dla tego operatora. Tego numeru MSISDN nie należy ponownie używać do wysyłania wiadomości do tego operatora.
24	Stosowane, gdy wiadomość nie może zostać dostarczona, ponieważ abonent jest chwilowo nieobecny, np. jego telefon jest wyłączony lub nie można go zlokalizować w sieci.
25	Stosowane, gdy wysyłka wiadomości nie powiodła się z powodu tymczasowego stanu w sieci operatora. Może to być związane z warstwą SS7, SMSC lub bramą.
26	Stosowane, gdy wysyłka wiadomości nie powiodła się z powodu tymczasowego błędu związanego z telefonem, np. pełna karta SIM, zajęte SME, przekroczona pamięć itp. Nie oznacza to, że telefon nie jest w stanie odebrać tego rodzaju wiadomości / treści (patrz kod błędu 27).
27	Stosowane, gdy telefon jest trwale niekompatybilny lub nie jest w stanie odbierać tego rodzaju wiadomości.
28	Stosowane, gdy wysyłka wiadomości nie powiodła się lub wiadomość została odrzucona z powodu podejrzenia SPAM-u w sieci operatora. W niektórych regionach może to oznaczać, że operator nie posiada rejestru obowiązkowej wiadomości MO wymaganej dla wiadomości MT.
29	Stosowane, gdy ta konkretna treść nie jest dozwolona w sieci / dla danego krótkiego kodu.
33	Stosowane, gdy abonent nie może odbierać treści dla dorosłych z powodu blokady rodzicielskiej.
39	Nowa awaria operatora.
73	Wysyłka wiadomości nie powiodła się z powodu nieosiągalności przeniesionych kombinacji.
74	Wysyłka wiadomości nie powiodła się, ponieważ numer MSISDN jest w roamingu.
76	Wysyłka wiadomości nie powiodła się, ponieważ przeniesione kombinacje są zablokowane dla klienta (klient został umieszczony na czarnej liście przeniesionej lokalizacji docelowej).
202	Wysyłka wiadomości nie powiodła się, ponieważ przeniesione kombinacje są zablokowane dla klienta. Skontaktuj się z obsługą klienta, aby uzyskać dodatkowe informacje.

Identyfikatory raportu DLR

Status	Opis
0	W trakcie tworzenia lub oczekujące
1	Powodzenie
2	Niepowodzenie
4	Oczekujące
8	Buforowane
16	Błąd / niezafakturowane

Sprawdź również

Dołącz do grona naszych użytkowników.

Czy ta strona była pomocna?