FAQ
Pytania i odpowiedzi dotyczące Bulk SMS API
39 odpowiedzi na temat kont, wysyłania, cen, raportów dostaw i API, sprawdzonych pod kątem limitów w kodzie. Szczegóły dotyczące endpointów i pól znajdują się w Dokumentacja API.
Usługa
Co to jest BulkSMSAPI?
API Bulk SMS dla developerów: wyślij jeden tekst lub partię do 10 000 numerów na żądanie do 227 krajów przez REST, śledź każdą wiadomość za pomocą podpisanych webhooków i płać za wiadomość z przedpłaconego salda. Konsola internetowa wysyła kampanie z wklejonej listy lub CSV bez kodu.
Kto korzysta z API Bulk SMS?
Zespoły produktowe i inżynieryjne, które wysyłają teksty z własnych systemów: kody logowania i rejestracji, aktualizacje zamówień i dostaw, przypomnienia o spotkaniach, alerty płatności, powiadomienia o usługach i kampanie marketingowe. Każdy, kto może wykonać żądanie HTTPS, może z tego skorzystać.
Do których krajów mogę wysyłać?
227 krajów i terytoriów, wymienionych z ich cenami na stronie cen i stronach krajów. Jedno żądanie może mieszać kraje: każdy numer jest wyceniany według kraju, do którego należy.
Czy jest miesięczna opłata lub umowa?
Nie. Płacisz za segment wiadomości z przedpłaconego salda, i nie ma miesięcznej opłaty, opłaty za konfigurację ani minimalnej ilości. Saldo nie ma terminu ważności.
Czy jest darmowa wersja próbna?
Konta zaczynają z zerowym saldem, a pierwsze doładowanie otwiera wszystko. Pierwsze doładowanie dodaje bonus do 40%, więc pierwsze wiadomości kosztują mniej. Ceny są publiczne, a punkt końcowy szacowania i konsola pokazują dokładny koszt przed wysłaniem czegokolwiek.
Konto i klucze API
Jak utworzyć konto?
Otwórz Get API key. Twoja przeglądarka tworzy klucz konta zaczynający się od acct_; skopiuj go lub zapisz jako plik tekstowy, potwierdź, że go zapisałeś, a konto jest gotowe. Klucz konta jest jedynym loginem: nie ma e-maila ani hasła do zarządzania.
Co się stanie, jeśli zgubię klucz konta?
Przechowujemy tylko zahaszowaną wersję klucza, więc nikt nie może go ponownie pokazać, w tym nasz zespół wsparcia. Przechowuj go w menedżerze haseł. Dopóki jesteś zalogowany, konsola nadal działa, a Ty możesz skontaktować się z pomocą z niej.
Jak uzyskać klucz API?
Na stronie kluczy API w konsoli, po zaksięgowaniu pierwszego doładowania. Nadaj kluczowi nazwę, utwórz go i skopiuj raz: zaczyna się od bsa_live_. Konto może posiadać 10 aktywnych kluczy, każdy z własną nazwą i licznikiem limitu żądań.
Czy mogę używać różnych kluczy do produkcji i środowiska testowego?
Tak. Utwórz jeden klucz na aplikację lub środowisko i nadaj mu nazwę. Każdy klucz pokazuje, kiedy był ostatnio używany, a odwołanie jednego pozostawia pozostałe działające.
Ile kont mogę utworzyć?
Maksymalnie 3 konta na adres sieciowy. Większość zespołów potrzebuje jednego konta z kilkoma kluczami API.
Wysyłanie wiadomości
Ile numerów może przyjąć jedno żądanie?
POST /v1/batches przyjmuje do 10 000 numerów na żądanie, jedną wiadomość dla wszystkich lub osobny tekst na numer. Konsola przyjmuje 50 000 numerów na kampanię. Większe listy są dzielone na kilka żądań.
Jak szybko wysyłane są wiadomości?
Kolejka działa co dwie sekundy i przekazuje do sieci do 1200 wiadomości na minutę na konto, w kolejności ich przyjęcia. Pojedyncza wiadomość zazwyczaj opuszcza system w ciągu kilku sekund od żądania.
W jakim formacie powinny być numery telefonów?
Międzynarodowy E.164: znak plus, kod kierunkowy i numer krajowy, np. +14155550123. Spacje, myślniki, nawiasy i prefiks 00 są automatycznie usuwane; duplikaty i numery, których nie można odczytać, są pomijane i nie są naliczane.
Jak długa może być wiadomość?
Do 10 segmentów: 1530 znaków w GSM-7 lub 670 w Unicode. Jeden segment zawiera 160 znaków GSM-7 lub 70 znaków Unicode; dłuższe teksty są dzielone na części po 153 lub 67 znaków i ponownie łączone na telefonie.
Dlaczego moja wiadomość użyła więcej segmentów niż się spodziewałem?
Jeden znak spoza alfabetu GSM-7, taki jak kręcony cudzysłów, emoji lub litera jak á czy ç, przełącza cały tekst na Unicode z 70 znakami na segment. Kompozytor w konsoli wskazuje te znaki, a POST /v1/estimates zwraca kodowanie przed wysłaniem.
Czy mogę zaplanować wiadomości?
Tak. Dodaj send_at do żądania API lub wybierz czas w konsoli, od 2 minut do 45 dni w przód. Zaplanowana partia może zostać anulowana do momentu jej rozpoczęcia, a jej pełny koszt wraca na saldo.
Czy każdy odbiorca może otrzymać inny tekst?
Tak. Przez API wyślij partię z wiadomościami, jeden {to, text} na odbiorcę. W konsoli wklej lub prześlij listę z dodatkowymi kolumnami i użyj pól scalających {{1}} do {{9}} w tekście.
Czy do moich wiadomości dodawana jest linia rezygnacji?
Ustaw swoje sformułowanie rezygnacji raz w Ustawieniach, np. link lub adres e-mail, a konsola doda je do tekstów kampanii, gdy zaznaczysz pole. Przez API kontrolujesz cały tekst, więc sam dodaj tę linię do wiadomości marketingowych. Numery na liście „nie wysyłaj” są pomijane przez konsolę i API i nie są naliczane.
Czy mogę najpierw wysłać wiadomość testową?
Tak. Konsola ma funkcję wysłania testowego do jednego numeru przed kampanią, a przez API możesz wysłać pojedynczą wiadomość na swój telefon za pomocą POST /v1/messages.
Ceny i płatności
Ile kosztuje jedna wiadomość SMS?
Zależy to od kraju numeru: każdy kraj ma jedną cenę za segment w dolarach amerykańskich, od $0.00247 (Brazylia). Strona cen i GET /v1/pricing zawierają listę wszystkich krajów.
Jak obliczany jest koszt partii?
Dla każdego odbiorcy: cena za segment w jego kraju razy liczba segmentów jego tekstu. Suma jest pobierana z salda, gdy żądanie zostanie zaakceptowane, a odpowiedź pokazuje ją w kosztach.
Jaka jest minimalna kwota doładowania?
$40. Doładowanie może wynosić od $40 do $5,000. Pierwsze doładowanie dodaje bonus do 40%, pokazywany przy każdej kwocie przed płatnością.
Jak mogę zapłacić?
W konsoli, sekcja Billing otwiera hostowaną stronę płatności w oknie nad stroną. Wybierasz kwotę i płacisz kryptowalutą, a strona płatności pokazuje dokładną kwotę i adres. Strona płatności listuje każdy krok.
Czy nieudane wiadomości są zwracane?
Tak. Gdy wiadomość nie powiedzie się, jej koszt automatycznie wraca do salda w tej samej transakcji, jako wpis zwrotu w księdze. Anulowana zaplanowana partia jest zwracana w całości.
Czy mogę wypłacić swoje saldo?
Saldo jest używane do opłacania wiadomości i pozostaje na koncie bez terminu ważności. Zwroty za nieudane lub anulowane wiadomości również wracają do salda.
Czy ceny się zmieniają?
Ceny mogą się zmieniać, gdy zmieniają się koszty sieci. Aktualna lista jest datowana, API zwraca datę przy każdej cenie, a wiadomości już zaakceptowane zachowują cenę, za którą zostały naliczone.
Dostawa i raporty
Skąd wiem, że wiadomość została dostarczona?
Każda wiadomość przechodzi z kolejki przez wysłaną do dostarczonej lub nieudanej. Dodaj URL webhooka w konsoli, aby otrzymywać podpisane zdarzenia dla każdego końcowego statusu, lub odczytaj GET /v1/messages/{id} i GET /v1/batches/{id}.
Jak są podpisywane webhooki?
W formacie Standard Webhooks: nagłówki webhook-id, webhook-timestamp i webhook-signature, gdzie podpis jest HMAC-SHA256 z id, timestamp i surowego ciała z twoim sekretem whsec_. Dokumentacja zawiera kod weryfikacyjny dla Node.js, Python, PHP i Go.
Co jeśli mój endpoint webhooka jest niedostępny?
Każde zdarzenie otrzymuje 10 prób w ciągu około 24 godzin, a każda próba jest listowana w konsoli z jej statusem HTTP. Możesz również odpytywać endpointy wiadomości w dowolnym momencie.
Dlaczego wiadomość mogłaby się nie powieść?
Telefon może być wyłączony zbyt długo, numer może już nie być w użyciu, lub sieć może odrzucić wiadomość. Status nieudany zawiera kod błędu, a cena jest zwracana.
Jak długo przechowywane są rekordy wiadomości?
Partie, wiadomości i księga salda pozostają na twoim koncie i w API. Log żądań przechowuje ostatnie 500 wywołań API, a log webhooków ostatnie 500 dostaw.
Dla developerów
Czy jest SDK?
API to zwykły JSON przez HTTPS, więc standardowa biblioteka dowolnego języka wystarczy. Dokumentacja zawiera kompletne przykłady w curl, Node.js, Python, PHP i Go, a specyfikacja OpenAPI pod /openapi.json generuje typowanego klienta w większości języków.
Jakie są limity zapytań?
600 zapytań na minutę na klucz API. Każda odpowiedź zawiera nagłówki X-RateLimit-Limit, X-RateLimit-Remaining i X-RateLimit-Reset, a odpowiedź 429 zawiera Retry-After.
Jak bezpiecznie ponowić próbę po przekroczeniu czasu?
Wysyłaj żądania POST z nagłówkiem Idempotency-Key i ponawiaj próbę z tym samym kluczem. Przez 24 godziny ten sam klucz i ciało zwracają pierwszą odpowiedź zamiast wysyłać ponownie.
Czy mogę sprawdzić ceny bez klucza API?
Tak. GET /v1/pricing i GET /v1/pricing/{country} są publiczne, więc strona płatności lub panel mogą pokazywać aktualne ceny.
Gdzie mogę zobaczyć, co wysłał mój kod?
Konsola posiada dziennik żądań z metodą, ścieżką, statusem i czasem ostatnich 500 wywołań API, obok partii, wiadomości i dziennika webhooków.
Konsola
Czy mogę wysyłać bez pisania kodu?
Tak. W konsoli wklej numery lub prześlij plik CSV z maksymalnie 50,000 wierszy, napisz tekst z polami scalającymi, sprawdź podgląd dla każdego odbiorcy i koszt w poszczególnych krajach, a następnie wyślij teraz lub o ustalonym czasie.
Co pokazuje konsola?
Saldo, ostatnie partie z aktualnymi licznikami, każda partia z jej wiadomościami i statusami, doładowania i księga, klucze API, ustawienia webhooków i dostawy, dziennik żądań, lista cen, zgłoszenia wsparcia i ustawienia.
Jak skontaktować się z pomocą techniczną?
Ze strony Pomocy w konsoli. Pytania dotyczące płatności można zadawać od pierwszego dnia; pozostałe tematy są dostępne po zaksięgowaniu pierwszego doładowania.
Nadal masz pytanie?
Zalogowane konta mogą otworzyć zgłoszenie wsparcia z konsoli. Pytania dotyczące płatności można zadawać od pierwszego dnia.