--- title: "FAQ dotyczące OVHcloud SMS" description: "Znajdź odpowiedzi na najczęściej zadawane pytania dotyczące usługi OVHcloud SMS" url: https://docs.ovhcloud.com/pl/guides/web-cloud/messaging/sms/faq-sms lang: pl lastUpdated: 2026-03-27 --- # FAQ dotyczące OVHcloud SMS ## Wprowadzenie Znajdź tutaj najczęściej zadawane pytania dotyczące usługi OVHcloud SMS. ## FAQ ### Konto i kredyty Jak utworzyć konto OVHcloud SMS? Aby utworzyć konto OVHcloud SMS, przejdź na [stronę ofert OVHcloud SMS](https://www.ovhcloud.com/pl/sms/) i wybierz pakiet kredytów odpowiadający Twoim potrzebom. Zamówienie automatycznie utworzy konto SMS dostępne z poziomu Panelu klienta OVHcloud, w sekcji SMS. Każde konto SMS jest identyfikowane unikalną nazwą (np. `sms-xx12345-1`). Możesz posiadać wiele kont SMS na tym samym identyfikatorze klienta OVHcloud, co pozwala na rozdzielenie zastosowań (transakcyjne, marketingowe, powiadomienia wewnętrzne) i budżetów. Jak działa system kredytów SMS? Usługa OVHcloud SMS działa w systemie przedpłaconym. Jeden kredyt odpowiada standardowemu SMS-owi o długości 160 znaków (kodowanie GSM 7-bit) wysłanemu na numer francuski. Koszt kredytu zależy od: - **Miejsca docelowego:** SMS na Francję metropolitalną zużywa 1 kredyt. Kierunki międzynarodowe zużywają więcej kredytów (patrz [cennik OVHcloud](https://www.ovhcloud.com/pl/sms/prices/)). - **Długości wiadomości:** SMS przekraczający 160 znaków jest automatycznie dzielony na kilka połączonych wiadomości SMS. Wiadomość o długości 300 znaków zużywa 2 kredyty. - **Kodowania:** jeśli Twoja wiadomość zawiera znaki specjalne lub akcenty nieobsługiwane przez GSM 7-bit, stosowane jest kodowanie Unicode (UCS-2), ograniczające każdy SMS do 70 znaków. Stan kredytów można sprawdzić w czasie rzeczywistym z poziomu Panelu klienta OVHcloud lub za pośrednictwem API. Więcej informacji znajdziesz w przewodniku "[Zarządzanie kredytami SMS i włączanie automatycznego doładowania](/pl/guides/web-cloud/messaging/sms/activer-la-recharge-automatique-du-credit-sms.md)". Jak włączyć automatyczne doładowanie kredytów SMS? Automatyczne doładowanie pozwala na automatyczne uzupełnienie konta SMS, gdy saldo spadnie poniżej określonego progu. Przejdź do sekcji SMS w Panelu klienta OVHcloud, wybierz konto SMS, a następnie przejdź do Opcje > Automatyczne ładowanie. Ustaw próg uruchomienia i kwotę doładowania. Na koncie musi być zarejestrowany ważny sposób płatności. Opcja ta jest niezbędna w przypadku wysyłania transakcyjnych SMS-ów, gdzie brak kredytów spowodowałby zablokowanie krytycznych powiadomień. Więcej informacji znajdziesz w przewodniku "[Zarządzanie kredytami SMS i włączanie automatycznego doładowania](/pl/guides/web-cloud/messaging/sms/activer-la-recharge-automatique-du-credit-sms.md)". Jak wyświetlić historię wysłanych i odebranych SMS-ów? Przejdź do sekcji SMS w Panelu klienta OVHcloud, wybierz konto SMS, a następnie zakładkę Wiadomość SMS i kampania > Zarządzanie SMS-ami > Historia wysyłki lub Otrzymane wiadomości SMS. Historię można filtrować według daty, nadawcy, odbiorcy lub wiadomości. Historia jest przechowywana przez 6 miesięcy. Można ją również wyeksportować w formacie CSV do analizy. Więcej informacji znajdziesz w przewodniku "[Zarządzanie historią SMS](/pl/guides/web-cloud/messaging/sms/sms-history.md)". Jak skonfigurować alerty o progu kredytów? Dla **użytkowników API**: przejdź do sekcji SMS, wybierz konto, a następnie Użytkownicy API. Kliknij ... > Limit dla odpowiedniego użytkownika i skonfiguruj: - **Próg alertu:** pozostała liczba kredytów, poniżej której wysyłane jest powiadomienie. - **Typ powiadomienia:** e-mail, SMS lub oba. Dla **konta globalnego** automatyczne doładowanie oferuje alternatywę: automatycznie doładowuje konto, gdy saldo spadnie poniżej progu. Oba mechanizmy są komplementarne. Więcej informacji znajdziesz w przewodniku "[Wszystko o użytkownikach SMS](/pl/guides/web-cloud/messaging/sms/sms-users.md)". ### Wysyłanie SMS-ów Jak wysłać SMS z Panelu klienta OVHcloud? Przejdź do sekcji SMS w Panelu klienta OVHcloud, wybierz konto SMS, a następnie kliknij Wyślij SMS. Wypełnij: - **Nadawca:** numer krótki (umożliwiający odpowiedzi, tylko Francja), niestandardowy nadawca alfanumeryczny lub wirtualny numer komórkowy. - **Odbiorca/odbiorcy:** wpisz jeden lub więcej numerów w formacie międzynarodowym (np. `+33612345678`) lub wybierz książkę adresową/listę odbiorców. - **Wiadomość:** napisz tekst (licznik pokazuje liczbę znaków i zużywanych wiadomości SMS). Możesz zaplanować wysyłkę na późniejszą datę/godzinę. Przed wysłaniem wyświetlany jest podgląd kosztu w kredytach. Więcej informacji znajdziesz w przewodniku "[Wysyłanie SMS-ów z Panelu klienta OVHcloud](/pl/guides/web-cloud/messaging/sms/send-sms-control-panel.md)". Jak wysłać SMS przez URL (http2sms)? Funkcja http2sms umożliwia wysyłanie SMS-a za pomocą prostego wywołania HTTP GET lub POST, bez SDK ani uwierzytelniania OAuth. Jest idealna do prostych integracji ze skryptu, narzędzia automatyzacji lub aplikacji biznesowej. Adres URL wywołania ma postać: `https://www.ovh.com/cgi-bin/sms/http2sms.cgi?account=sms-xx12345-1&login=user&password=password&from=sender&to=+33612345678&message=Your+message` Wymagane parametry to: `account` (nazwa konta SMS), `login` i `password` (dane logowania użytkownika API), `from` (nadawca), `to` (odbiorca w formacie międzynarodowym), `message` (treść SMS). Aby zabezpieczyć dostęp, skonfiguruj ograniczenia IP dla używanego użytkownika API. Zalecana jest metoda POST z protokołem HTTPS. Więcej informacji znajdziesz w przewodniku "[Wysyłanie SMS-ów z adresu URL - http2sms](/pl/guides/web-cloud/messaging/sms/send-sms-http2sms.md)". Jak wysłać SMS z adresu e-mail? OVHcloud umożliwia wysyłanie SMS-ów z dowolnego adresu e-mail, niezależnie od nadawcy. Wyślij wiadomość e-mail na adres `numer_odbiorcy@email2sms.ovh.net` (np. `0033612345678@email2sms.ovh.net`). Treść wiadomości e-mail staje się treścią SMS-a. Temat wiadomości e-mail musi zawierać dane logowania w formacie: `account:login:password`. Metoda ta jest szczególnie przydatna w przypadku automatycznych alertów z systemów obsługujących jedynie wysyłanie wiadomości e-mail (serwery monitoringu, aplikacje biznesowe). Więcej informacji znajdziesz w przewodniku "[Wysyłanie SMS-ów z adresu e-mail](/pl/guides/web-cloud/messaging/sms/send-sms-email.md)". Jak efektywnie wysyłać masowe SMS-y za pośrednictwem API? Aby optymalnie wysyłać masowe SMS-y za pośrednictwem API OVHcloud: - **Używaj wysyłania wsadowego:** endpoint `POST /sms/{serviceName}/jobs` akceptuje tablicę odbiorców. Wysyłaj SMS-y w partiach (np. 500 odbiorców na wywołanie API), zamiast jednego wywołania API na SMS. - **Obsługuj błędy i ponawiaj próby:** zaimplementuj logikę ponawiania prób z wykładniczym wycofywaniem dla błędów tymczasowych (HTTP 429 Too Many Requests, HTTP 500). - **Używaj callbacków DLR:** skonfiguruj URL callbacku dla użytkownika API zamiast odpytywać API o każdy status. - **Planuj wysyłki:** API obsługuje wysyłanie odroczone (`differedPeriod`). - **Dla bardzo dużych wolumenów:** użyj protokołu SMPP. Monitoruj zużycie kredytów podczas wysyłek masowych i upewnij się, że automatyczne doładowanie jest włączone. Jak utworzyć pierwszą kampanię SMS? Przejdź do sekcji SMS w Panelu klienta OVHcloud, wybierz konto SMS, a następnie kliknij Wyślij SMS. Kroki są następujące: 1. **Wybierz nadawcę:** wybierz numer krótki, nadawcę alfanumerycznego lub VLN. 2. **Zdefiniuj odbiorców:** dodaj ręcznie, zaimportuj listę CSV lub wybierz istniejącą książkę adresową. 3. **Napisz wiadomość:** skomponuj tekst. Możesz użyć zmiennych personalizacji, jeśli zaimportowałeś listę z dodatkowymi kolumnami (imię, nazwisko itp.). 4. **Zaplanuj wysyłkę:** wybierz wysyłkę natychmiastową lub zaplanowaną na konkretną datę/godzinę. 5. **Potwierdź i wyślij:** sprawdź podsumowanie (liczba odbiorców, koszt w kredytach) i potwierdź. Śledzenie kampanii jest dostępne w Wiadomość SMS i kampania > Zarządzanie kampaniami > Statystyki i historia. Więcej informacji znajdziesz w przewodniku "[Moja pierwsza kampania SMS](/pl/guides/web-cloud/messaging/sms/ma-premiere-campagne-sms.md)". Jak zarządzać listami odbiorców SMS? Przejdź do sekcji SMS w Panelu klienta OVHcloud, wybierz konto SMS, a następnie przejdź do Kontakty > Utwórz listę kontaktów. Możesz: - **Utworzyć listę** importując plik CSV zawierający kolumnę `number` z numerami w formacie międzynarodowym. - **Wyczyścić listę** z deduplikacją i weryfikacją składni. - **Usunąć** przestarzałą listę. Więcej informacji znajdziesz w przewodniku "[Listy odbiorców SMS](/pl/guides/web-cloud/messaging/sms/liste-de-destinataire-sms.md)". Jak zarządzać książkami adresowymi SMS? Książki adresowe SMS oferują bogatsze zarządzanie kontaktami (imię, nazwisko, numer). Przejdź do sekcji SMS, wybierz konto SMS, a następnie przejdź do Kontakty > Książka adresowa. Możesz: - Utworzyć nową książkę adresową i dodać kontakty ręcznie. - Zaimportować plik CSV z kolumnami: nazwisko, imię, numer (format międzynarodowy). - Edytować lub usuwać kontakty pojedynczo. - Użyć książki adresowej jako listy odbiorców podczas wysyłania SMS-ów. Książka adresowa jest idealna do regularnych wysyłek do stałej grupy kontaktów. Do jednorazowych wysyłek na zmienne listy lepiej nadają się listy odbiorców. Więcej informacji znajdziesz w przewodniku "[Zarządzanie książkami adresowymi SMS](/pl/guides/web-cloud/messaging/sms/sms-address-books.md)". Jaka jest różnica między standardowym SMS-em (160 znaków) a długim SMS-em? Standardowy SMS w kodowaniu GSM 7-bit może zawierać do **160 znaków**. Jeśli wiadomość przekracza ten limit, jest dzielona na kilka połączonych wiadomości SMS (długi SMS), które są składane na telefonie odbiorcy. Limity wynoszą: - **1 SMS:** do 160 znaków. - **2 SMS-y:** od 161 do 306 znaków (153 użyteczne znaki na segment, pozostałe 7 bajtów służy jako nagłówek konkatenacji). - **3 SMS-y:** od 307 do 459 znaków. - I tak dalej, maksymalnie do 6 połączonych wiadomości SMS (918 znaków). Jeśli wiadomość używa kodowania **Unicode (UCS-2)** (wymaganego dla emoji, alfabetów niełacińskich), każdy SMS jest ograniczony do **70 znaków** (67 na segment w trybie połączonym). Każdy segment zużywa 1 kredyt SMS. Które znaki specjalne powodują przełączenie SMS-a na kodowanie Unicode? Kodowanie GSM 7-bit (standardowe) obsługuje ograniczony zestaw znaków. Następujące znaki powodują przełączenie na kodowanie Unicode (UCS-2), zmniejszając pojemność SMS-a ze 160 do 70 znaków: - Wszystkie **emoji** (bez wyjątku). - **Znaki akcentowane nieobsługiwane przez GSM:** niektóre akcenty są obsługiwane (é, è, ê, ù, à itp.), ale inne nie (ő, ű, ā itp.). - **Znaki alfabetów niełacińskich:** cyrylica, arabski, chiński, japoński, koreański itp. - Niektóre **symbole typograficzne:** cudzysłowy typograficzne "", pauza — itp. Interfejs Panelu klienta OVHcloud automatycznie wyświetla pozostałą liczbę znaków i liczbę wiadomości SMS, które zostaną użyte. Jaki jest czas dostarczenia SMS-a wysłanego przez OVHcloud? W normalnych warunkach SMS jest dostarczany w ciągu kilku sekund (zazwyczaj **poniżej 10 sekund** do operatorów francuskich). Czas ten może się różnić w zależności od: - **Miejsca docelowego:** SMS-y międzynarodowe mogą mieć dłuższy czas dostarczenia (do 30-60 sekund). - **Obciążenia sieci:** w godzinach szczytu (Nowy Rok, wydarzenia krajowe) operatorzy komórkowi mogą wprowadzać dodatkowe opóźnienia. - **Statusu telefonu odbiorcy:** jeśli telefon jest wyłączony lub poza zasięgiem, SMS jest przechowywany przez operatora i dostarczany, gdy telefon stanie się ponownie dostępny (okres przechowywania: od 48 do 72 godzin w zależności od operatora). - **Wysyłek masowych:** kampanie składające się z kilku tysięcy wiadomości SMS są wysyłane stopniowo, aby zachować zgodność z limitami przepustowości operatorów. Raporty dostarczenia (DLR) pozwalają potwierdzić faktyczne dostarczenie wiadomości do odbiorcy. Moje wiadomości SMS nie są dostarczane — jak zdiagnozować problem? Wykonaj następujące kontrole: 1. **Sprawdź stan kredytów:** zerowe saldo natychmiast blokuje wszystkie wysyłki. 2. **Sprawdź historię wysyłek:** w Wiadomość SMS i kampania > Zarządzanie SMS-ami > Historia wysyłki sprawdź status każdego SMS-a. Kod PTT wskazuje przyczynę niepowodzenia. 3. **Sprawdź format numeru:** wszystkie numery muszą być w formacie międzynarodowym (`+33...`). Format lokalny (`06...`) spowoduje niepowodzenie. 4. **Sprawdź nadawcę:** nadawca alfanumeryczny oczekujący na walidację nie pozwoli na wysyłanie. 5. **Sprawdź czarną listę:** jeśli odbiorca odpowiedział STOP, jego numer znajduje się na czarnej liście. 6. **Sprawdź limit użytkownika API:** jeśli wysyłasz przez API, sprawdź, czy limit nie został wyczerpany. 7. **Sprawdź treść:** wiadomości SMS zawierające adresy URL wysyłane za pomocą numeru krótkiego są blokowane. ### Nadawcy i odpowiedzi Jakich typów nadawców SMS mogę używać? OVHcloud oferuje trzy typy nadawców: - **Numer krótki umożliwiający odpowiedzi:** domyślny nadawca, losowo przypisany 5-cyfrowy numer krótki. Odbiorca może odpowiedzieć na SMS. Uwaga: nie jest możliwe wysłanie SMS-a zawierającego URL za pomocą numeru krótkiego. :::info Numer krótki umożliwiający odpowiedzi jest dostępny wyłącznie dla kont OVHcloud we Francji, z wyłączeniem francuskich departamentów i terytoriów zamorskich. ::: - **Nadawca alfanumeryczny:** niestandardowa nazwa wyświetlana jako nadawca (np. `MojaFirma`). Maksymalnie 11 znaków. Odbiorca nie może odpowiedzieć. Utworzenie wymaga dokumentów uzasadniających i jest walidowane średnio w ciągu 72 godzin. - **Wirtualny numer komórkowy (VLN):** francuski numer komórkowy w formacie 06/07 przypisany do Twojego konta SMS. Umożliwia odpowiedzi i daje wrażenie standardowego numeru komórkowego. Więcej informacji znajdziesz w przewodniku "[Wszystko o nadawcach SMS](/pl/guides/web-cloud/messaging/sms/sms-senders.md)". Jak dodać niestandardowego nadawcę alfanumerycznego? Przejdź do sekcji SMS w Panelu klienta OVHcloud, wybierz konto SMS, a następnie kliknij zakładkę Nadawcy. Kliknij Operacje > Dodaj i wybierz "Dodaj nadawców ręcznie". Wypełnij: - **Żądany nadawca:** maksymalnie 11 znaków alfanumerycznych (litery i cyfry, bez znaków specjalnych). - **Opis** do użytku wewnętrznego. - **Uzasadnienie:** wyjaśnij związek między Twoją tożsamością a żądanym nadawcą. - **Dokumenty potwierdzające:** papier firmowy, wypis z rejestru handlowego lub dowolny dokument potwierdzający Twoje prawo do używania tej nazwy. Walidacja jest przeprowadzana przez zespoły OVHcloud, zazwyczaj w ciągu 72 godzin. Możesz również utworzyć nadawcę na podstawie danych osobowych OVHcloud lub nazw domen OVHcloud, bez dodatkowej dokumentacji. Więcej informacji znajdziesz w przewodniku "[Wszystko o nadawcach SMS](/pl/guides/web-cloud/messaging/sms/sms-senders.md)". Dlaczego nie mogę wysłać SMS-a zawierającego URL za pomocą numeru krótkiego? W celu zwalczania spamu i phishingu OVHcloud blokuje wiadomości SMS zawierające adresy URL (linki http/https), gdy nadawcą jest numer krótki umożliwiający odpowiedzi. Jeśli musisz umieścić URL w wiadomości SMS, użyj zwalidowanego **nadawcy alfanumerycznego**. Ponieważ Twój niestandardowy nadawca został poddany weryfikacji tożsamości, wysyłanie wiadomości SMS zawierających adresy URL jest dozwolone z tym typem nadawcy. Więcej informacji znajdziesz w przewodniku "[Wszystko o nadawcach SMS](/pl/guides/web-cloud/messaging/sms/sms-senders.md)". Co to jest wirtualny numer komórkowy (VLN) i jak go uzyskać? Wirtualny numer komórkowy (VLN — Virtual Long Number) to francuski numer komórkowy w formacie 06 lub 07, przypisany do Twojego konta OVHcloud SMS. Oferuje on kilka zalet: - Odbiorca widzi standardowy numer komórkowy jako nadawcę, co budzi większe zaufanie. - Odbiorca może **odpowiedzieć** na SMS, a odpowiedzi można przeglądać w Panelu klienta OVHcloud lub pobierać za pośrednictwem API. - Można go używać do wysyłek zawierających adresy URL. VLN wymaga specjalnego planu SMS, który obejmuje wirtualny numer komórkowy. Nie można go dodać do istniejącego konta SMS: należy zamówić nowe konto SMS na [stronie dedykowanej wirtualnym numerom komórkowym](https://www.ovhcloud.com/pl/sms/virtual-numbers). VLN jest przypisywany na czas związany z subskrypcją i nie jest przenośny do innego operatora. Jak działa usługa odpowiedzi SMS? Usługa odpowiedzi SMS umożliwia wysłanie SMS-a, na który odbiorca może odpowiedzieć. Działa w następujący sposób: 1. Wysyłasz SMS, używając "Numeru krótkiego umożliwiającego odpowiedzi" jako nadawcy. 2. Odbiorca otrzymuje SMS z 5-cyfrowym numerem krótkim jako nadawcą. 3. Odbiorca może odpowiedzieć na ten numer krótki w ciągu **48 godzin**. 4. Odpowiedź można wyświetlić w Panelu klienta OVHcloud (Wiadomość SMS i kampania > Zarządzanie SMS-ami > Otrzymane wiadomości SMS). 5. Opcjonalnie możesz skonfigurować **automatyczną odpowiedź** (predefiniowany tekst) lub **skrypt CGI** wywoływany przy każdej otrzymanej odpowiedzi. Usługa ta jest dostępna wyłącznie dla kont OVHcloud we Francji (z wyłączeniem francuskich departamentów i terytoriów zamorskich), a odpowiedzi są możliwe tylko od francuskich operatorów komórkowych. Każda otrzymana odpowiedź i każda wysłana automatyczna odpowiedź zużywa kredyty SMS. Jak skonfigurować automatyczną odpowiedź na odebrane SMS-y? Przejdź do sekcji SMS w Panelu klienta OVHcloud, wybierz konto SMS, a następnie przejdź do Opcje > Opcje odpowiedzi. W sekcji "Działanie po otrzymaniu wiadomości" wybierz "Odpowiedź przy użyciu wcześniej przygotowanego tekstu" lub "Wywołanie CGI" (URL skryptu webowego wywoływanego przy każdej otrzymanej odpowiedzi, umożliwiającego dynamiczne przetwarzanie). Możesz również skonfigurować powiadomienia o otrzymaniu (e-mailem lub SMS-em). Jak zarządzać żądaniami rezygnacji (STOP)? Gdy odbiorca odpowie "STOP" na jedną z Twoich wiadomości SMS, jego numer zostaje automatycznie dodany do czarnej listy przez OVHcloud. Przyszłe wiadomości SMS wysyłane na ten numer z Twojego konta będą blokowane. Czarną listę możesz przeglądać i zarządzać nią w Panelu klienta OVHcloud, w zakładce Opcje > Zarządzaj adresatami czarnej listy. Możesz: - Wyświetlić numery, które wysłały STOP. - Sprawdzić, czy dany numer jest na czarnej liście przed wysłaniem. :::warning Usunięcie numeru z czarnej listy bez ponownej zgody odbiorcy jest sprzeczne z RODO i zasadami antyspamowymi. ::: Zarządzanie STOP jest obowiązkowe w przypadku marketingowych SMS-ów. W przypadku transakcyjnych SMS-ów mechanizm STOP nie ma zastosowania. ### Integracja techniczna Jak tworzyć użytkowników API SMS i zarządzać nimi? Użytkownicy API SMS umożliwiają delegowanie wysyłki SMS-ów przez API lub funkcję http2sms bez ujawniania danych logowania klienta OVHcloud. Przejdź do sekcji SMS w Panelu klienta OVHcloud, wybierz konto SMS, a następnie kliknij Użytkownicy API. Dodaj nowego użytkownika, definiując nazwę użytkownika i hasło. Każdemu użytkownikowi można przypisać: - **Limit kredytów** odliczany od globalnego salda konta. - **Alert progowy** wysyłający powiadomienie, gdy saldo użytkownika spadnie poniżej zdefiniowanego progu. - **Ograniczenia IP** (do 5 adresów IP) w celu zabezpieczenia dostępu do funkcji http2sms. - **URL callbacku** do odbierania raportów dostarczenia (DLR) na niestandardowym endpoincie. Więcej informacji znajdziesz w przewodniku "[Wszystko o użytkownikach SMS](/pl/guides/web-cloud/messaging/sms/sms-users.md)". Jak wysłać SMS za pośrednictwem API OVHcloud w PHP? API OVHcloud umożliwia programowe wysyłanie SMS-ów. W PHP użyj oficjalnego SDK OVHcloud: 1. **Utwórz klucze API** na [stronie tworzenia tokenów API OVHcloud](https://auth.eu.ovhcloud.com/api/createToken) autoryzując endpointy `/sms/*`. 2. **Zainstaluj SDK** przez Composer: `composer require ovh/ovh`. 3. **Wyślij SMS** za pomocą endpointu `POST /sms/{serviceName}/jobs`, podając: wiadomość, odbiorców (tablica numerów w formacie międzynarodowym), nadawcę i opcje. API zwraca identyfikator zadania umożliwiający śledzenie statusu wysyłki. Biblioteki są dostępne również w Python, Node.js, Java i C#. Pełna dokumentacja API SMS jest dostępna w [konsoli API OVHcloud](https://eu.api.ovh.com/console/?section=%2Fsms\&branch=v1#/sms). Więcej informacji znajdziesz w przewodniku "[Wysyłanie SMS-ów za pomocą API OVHcloud w PHP](/pl/guides/web-cloud/messaging/sms/send-sms-api-php.md)". Jakie endpointy API są dostępne dla usługi OVHcloud SMS? API OVHcloud udostępnia liczne endpointy do programowego zarządzania usługą SMS. Główne z nich to: - `GET /sms`: lista Twoich kont SMS. - `GET /sms/{serviceName}`: szczegóły konta SMS (pozostałe kredyty, opcje). - `POST /sms/{serviceName}/jobs`: wysłanie SMS-a. - `GET /sms/{serviceName}/jobs`: lista wysyłek. - `GET /sms/{serviceName}/outgoing`: historia SMS-ów wychodzących. - `GET /sms/{serviceName}/incoming`: historia SMS-ów przychodzących. - `GET /sms/{serviceName}/users`: lista użytkowników API. - `GET /sms/{serviceName}/senders`: lista nadawców. - `GET /sms/{serviceName}/phonebooks`: lista książek adresowych. - `GET /sms/ptts`: opis kodu PTT (status dostarczenia). Pełna interaktywna dokumentacja jest dostępna w [konsoli API OVHcloud](https://eu.api.ovh.com/console/?section=%2Fsms\&branch=v1#/sms). Uwierzytelnianie odbywa się za pomocą kluczy API (Application Key, Application Secret, Consumer Key). Jak odbierać raporty dostarczenia (DLR) SMS-ów za pomocą callbacku? Raporty dostarczenia (Delivery Reports / DLR) potwierdzają pomyślne dostarczenie SMS-a. Aby otrzymywać je automatycznie, skonfiguruj URL callbacku dla użytkownika API. Przejdź do sekcji SMS, następnie Użytkownicy API, kliknij ... > Callback dla odpowiedniego użytkownika. Wprowadź adres URL Twojego endpointu webowego. Przy każdej aktualizacji statusu OVHcloud wywoła ten URL z następującymi parametrami: - `id`: identyfikator SMS. - `ptt`: kod statusu dostarczenia (np. 1 = w toku, 4 = dostarczono, 5 = niepowodzenie). - `date`: data DLR. - `description`: opisowy identyfikator DLR. Twój endpoint musi odpowiedzieć kodem HTTP 200, aby potwierdzić pomyślne odebranie callbacku. Więcej informacji znajdziesz w przewodniku "[Wszystko o użytkownikach SMS](/pl/guides/web-cloud/messaging/sms/sms-users.md)". Jak korzystać z protokołu SMPP w OVHcloud? SMPP (Short Message Peer-to-Peer) to protokół branżowy do wysyłania i odbierania SMS-ów masowo. Przejdź do sekcji SMS w Panelu klienta OVHcloud, wybierz konto, a następnie przejdź do Opcje > Parametry SMPP. Uzyskasz parametry połączenia: adres serwera SMPP, port, system\_id i hasło. Protokół SMPP oferuje trwałe połączenie, wyższą przepustowość wysyłki i natywną obsługę DLR w trybie push. Więcej informacji znajdziesz w przewodniku "[Zarządzanie kontem SMS SMPP](/pl/guides/web-cloud/messaging/sms/smpp-control-panel.md)". Jakie są specyfikacje techniczne usługi OVHcloud SMPP? Usługa OVHcloud SMPP jest zgodna ze specyfikacją SMPP v3.4. Główne cechy techniczne to: - **Tryb połączenia:** Transceiver (wysyłanie i odbieranie w tej samej sesji) lub oddzielny Transmitter/Receiver. - **Port połączenia:** podawany przy aktywacji usługi SMPP. - **Szyfrowanie:** TLS obsługiwany i zalecany. - **Enquire Link:** zalecany interwał 30 sekund w celu utrzymania aktywnej sesji. - **Okno wysyłki (window size):** konfigurowalne, zazwyczaj od 1 do 10 w zależności od pożądanej przepustowości. - **Obsługiwane kodowanie:** GSM 7-bit (data\_coding=0) i UCS-2 (data\_coding=8). - **Maksymalna długość:** 160 znaków w GSM 7-bit, 70 w UCS-2, z obsługą konkatenacji przez UDH. - **DLR:** raporty dostarczenia przesyłane w trybie push w tej samej sesji SMPP. Połączenie SMPP jest ograniczone do określonej liczby jednoczesnych sesji zgodnie z warunkami umowy. Więcej informacji znajdziesz w przewodniku "[Specyfikacje techniczne SMPP](/pl/guides/web-cloud/messaging/sms/smpp-specification.md)". Jak zintegrować wysyłkę OVHcloud SMS z moją aplikacją biznesową lub CRM? Integrację OVHcloud SMS można przeprowadzić na kilka sposobów: - **http2sms (najprostszy):** proste wywołanie HTTP GET/POST uruchamia wysyłkę SMS-a. Idealne do podstawowych skryptów, narzędzi automatyzacji przemysłowej lub aplikacji biznesowych obsługujących jedynie wywołania HTTP. - **API REST OVHcloud:** pełna integracja z bezpiecznym uwierzytelnianiem (OAuth), zarządzaniem kontaktami, historią, statystykami. Dostępne SDK w PHP, Python, Node.js, Java i C#. - **SMPP:** trwałe połączenie o wysokiej przepustowości dla platform komunikacyjnych. - **Email2SMS:** wysyłanie e-mailem, przydatne dla systemów obsługujących jedynie wysyłanie wiadomości e-mail (alerty monitoringu, ERP). W przypadku popularnych systemów CRM (Salesforce, HubSpot itp.) na odpowiednich marketplace'ach dostępne są konektory zewnętrzne korzystające z API OVHcloud. Jakie są limity szybkości wysyłania SMS-ów? OVHcloud stosuje limity szybkości wysyłania w celu zagwarantowania jakości usługi: - **Za pośrednictwem Panelu klienta OVHcloud:** brak wyraźnego limitu, ale duże kampanie są rozkładane w czasie przez platformę. - **Za pośrednictwem API REST:** przepustowość zależy od wolumenu konta i historii użytkowania. - **Za pośrednictwem http2sms:** ograniczone do liczby żądań HTTP na sekundę akceptowanych przez infrastrukturę (zazwyczaj kilkadziesiąt na sekundę). - **Za pośrednictwem SMPP:** przepustowość jest określona umownie i może osiągać kilkaset SMS-ów na sekundę. Jeśli planujesz bardzo duże kampanie (ponad 100 000 SMS-ów), skontaktuj się z pomocą techniczną OVHcloud, aby zaplanować wysyłkę. Czy mogę wysyłać wiadomości SMS zawierające zmienne niestandardowe? Tak, OVHcloud obsługuje personalizację SMS-ów ze zmiennymi dynamicznymi. Z poziomu Panelu klienta, importując listę odbiorców w formacie CSV, możesz dołączyć dodatkowe kolumny (np. `first_name`, `surname`, `appointment_date`). W treści SMS-a użyj zmiennych w postaci `{first_name}`, `{surname}`, `{appointment_date}` itp. Każdy SMS zostanie automatycznie spersonalizowany danymi z odpowiedniego kontaktu. Za pośrednictwem API możesz użyć parametru `message` z placeholderami i podać dane personalizacji w ładunku wysyłki. ### Zgodność i dostarczalność Jakie są obowiązki prawne dotyczące wysyłania marketingowych SMS-ów we Francji? Wysyłanie marketingowych SMS-ów we Francji podlega przepisom RODO i francuskiemu Kodeksowi pocztowemu i łączności elektronicznej. Główne obowiązki to: - **Uprzednia zgoda (opt-in):** odbiorca musi wyraźnie wyrazić zgodę na otrzymywanie komercyjnych SMS-ów. - **Prawo do rezygnacji (opt-out):** każdy marketingowy SMS musi zawierać informację umożliwiającą odbiorcy rezygnację (np. "STOP na 36xxx" lub "Odpowiedz STOP"). - **Godziny wysyłki:** komercyjne SMS-y nie mogą być wysyłane między **20:00 a 8:00** w dni powszednie ani w **niedziele i święta**. - **Identyfikacja nadawcy:** tożsamość reklamodawcy musi być rozpoznawalna. - **Rejestr zgód:** musisz być w stanie udowodnić zgodę każdego odbiorcy w przypadku kontroli CNIL. Nieprzestrzeganie tych obowiązków naraża na sankcje CNIL i kary w wysokości do 4% obrotu. Jaka jest różnica między transakcyjnym SMS-em a marketingowym SMS-em? - **Transakcyjny SMS:** wysyłany w odpowiedzi na konkretną akcję odbiorcy (potwierdzenie zamówienia, kod weryfikacyjny, powiadomienie o dostawie, przypomnienie o spotkaniu). Nie wymaga uprzedniej zgody marketingowej, nie podlega ograniczeniom czasowym i nie wymaga informacji o STOP. - **Marketingowy SMS:** wysyłany w celach promocyjnych (oferty promocyjne, wyprzedaże, newslettery). Wymaga uprzedniej zgody opt-in, musi zawierać informację o rezygnacji (STOP) i podlega ograniczeniom czasowym. Nie mieszaj obu typów wysyłek na tym samym koncie SMS, aby ułatwić zarządzanie zgodnością. Jak zoptymalizować wskaźnik dostarczalności SMS-ów? Wskaźnik dostarczalności to procent wiadomości SMS faktycznie dostarczonych do odbiorców. Aby go zoptymalizować: - **Czyść bazy kontaktów:** usuwaj nieprawidłowe, nieaktywne lub stacjonarne numery. - **Używaj formatów międzynarodowych:** wszystkie numery muszą być w pełnym formacie międzynarodowym (np. `+33612345678`). - **Kontroluj długość wiadomości:** krótkie SMS-y (1 segment, maksymalnie 160 znaków) mają lepszy wskaźnik dostarczenia niż długie połączone SMS-y. - **Unikaj treści przypominających spam:** słowa pisane wielkimi literami, nadmierna interpunkcja, podejrzane skrócone adresy URL. - **Używaj zwalidowanego nadawcy:** zweryfikowani nadawcy alfanumeryczni budzą zaufanie. - **Przestrzegaj godzin wysyłki:** SMS-y wysyłane w godzinach pracy mają lepszy wskaźnik otwarć. - **Monitoruj swoje DLR:** analizuj kody PTT nieudanych SMS-ów, aby zidentyfikować powtarzające się przyczyny. Jak wysyłać SMS-y do Stanów Zjednoczonych? Wysyłanie SMS-ów do Stanów Zjednoczonych (kod kraju +1) podlega specjalnym zasadom ze względu na amerykańskie przepisy antyspamowe (TCPA / 10DLC). W przypadku OVHcloud wysyłanie do Stanów Zjednoczonych wymaga: - Zwalidowanego **nadawcy alfanumerycznego** lub numeru krótkiego OVHcloud (użycie francuskiego wirtualnego numeru komórkowego nie jest możliwe w przypadku USA). - Zgodności z zasadami dotyczącymi treści: SMS nie może zawierać niezamówionej treści reklamowej. - Kosztu w kredytach wyższego niż krajowy SMS (dokładna stawka w [cenniku](https://www.ovhcloud.com/pl/sms/prices/)). Wskaźnik dostarczalności może się różnić w zależności od amerykańskich operatorów i ich filtrów antyspamowych. Więcej informacji znajdziesz w przewodniku "[Wysyłanie SMS-ów do Stanów Zjednoczonych](/pl/guides/web-cloud/messaging/sms/envoi-de-sms-aux-etats-unis.md)". Jakie są ograniczenia geograficzne wysyłki SMS-ów OVHcloud? Usługa OVHcloud SMS umożliwia wysyłanie do zdecydowanej większości kierunków międzynarodowych. Jednakże: - **Zablokowane kierunki:** niektóre kierunki o wysokim ryzyku oszustw mogą być domyślnie zablokowane. - **Zmienne ceny:** koszt w kredytach zależy od kierunku. Stawki można sprawdzić w Panelu klienta OVHcloud lub na [stronie z cenami OVHcloud](https://www.ovhcloud.com/pl/sms/prices/). - **Stany Zjednoczone:** wysyłanie do USA podlega specjalnym zasadom (patrz dedykowane FAQ powyżej). - **SMS z odpowiedzią:** funkcja odpowiedzi SMS (numer krótki) jest dostępna wyłącznie we Francji metropolitalnej. - **Wirtualny numer komórkowy:** francuski VLN może być używany jako nadawca wyłącznie dla kierunków francuskich. Przed uruchomieniem kampanii międzynarodowej sprawdź cennik i dostępność kierunku w Panelu klienta OVHcloud. ## Sprawdź również Dołącz do [grona naszych użytkowników](https://community.ovhcloud.com/).