przegląd API

RealSender umożliwia wysyłanie wiadomości e-mail za pomocą API (Application Programming Interface).

W ten sposób możesz wysyłać e-maile bezpośrednio z aplikacji, bez korzystania z protokołu SMTP (Simple Mail Transfer Protocol). Obecnie obsługujemy tylko żądania POST.

Adres serwera:
https://rsXXX-api.realsender.com/mail/send

Parametry wymagane/obowiązkowe:

Jeśli wszystko jest w porządku, wiadomość zostanie wysłana i otrzymasz pozytywną odpowiedź JSON:
{"success":true}

W przypadku błędów pojawi się coś takiego:
{"success":false,"errorMsgs":["Podaj wartość 'subject'."]}

szczegóły API

Treść musi zostać wysłana z użyciem międzynarodowego zestawu znaków UTF-8.
Aby to sprawdzić, dodaj „€uro” w temacie wiadomości i prześlij ją. Jeśli zestaw znaków jest nieprawidłowy, otrzymasz następujące ostrzeżenie JSON:

{"success":false,"errorMsgs":["Wartość „subject” nie jest poprawnie zakodowana. Musi być zakodowana w UTF-8."]}

W zależności od tego, czy wypełniłeś jedno, czy oba pola „text” i „html”, wiadomości będą wysyłane przy użyciu jednego z poniższych „Content-Type”:

Parametry nieobowiązkowe/opcjonalne:

Pola „Do”, „DW” i „UDW” mogą zawierać pojedynczy adres e-mail lub listę adresów e-mail rozdzielonych przecinkami.
W ramach RealSender całkowita liczba odbiorców każdej wiadomości e-mail jest ograniczona do 25 (może zostać zwiększona do 100).

Odpowiedzi serwera są w formacie JSON (JavaScript Object Notation):

przykłady API

Żądanie POST z
metodą CURL-less w PHP

<?php $url = 'https://rsXXX-api.realsender.com/mail/send'; $data = array('apiuser' =>'ten, który Ci podaliśmy', 'apipass' => 'ten, który Ci podaliśmy', 'from' => 'sender@example.com', 'to' => 'recipient@example.com', 'subject' => 'temat wiadomości', 'text' => 'treść wiadomości e-mail w postaci zwykłego tekstu', 'html' => 'treść wiadomości e-mail w formacie HTML'); // użyj klucza 'http', nawet jeśli żądanie wysyłasz do https://... $options = array( 'http' => array( 'header' => "Content-type: application/x-www-form-urlencoded\r\n", 'method' => 'POST', 'content' => http_build_query($data), ), ); $context = stream_context_create($options); $result = file_get_contents($url, false, $context); var_dump($result); ?>

Metoda CURL
żądania POST

curl -d 'apiuser=ten, który Ci przekazaliśmy&apipass=ten, który Ci przekazaliśmy&from=sender@example.com&to=recipient@example.com&subject=temat wiadomości&text=treść wiadomości e-mail w postaci zwykłego tekstu&html=treść wiadomości e-mail w formacie HTML'https://rsXXX-api.realsender.com/mail/send

przykłady API z załącznikami

Żądanie POST z załącznikami (maks. 5: attach1, attach2, …)
Metoda bez CURL z PHP

<?php require_once 'HTTP/Request2.php'; $config = array('use_brackets' =>false, ); $request = new HTTP_Request2('https://rsXXX-api.realsender.com/mail/send', HTTP_Request2::METHOD_POST, $config); $data = array('apiuser' => 'ten, który Ci podaliśmy', 'apipass' => 'ten, który Ci podaliśmy', 'from' => 'sender@example.com', 'to' => 'recipient@example.com', 'subject' => 'temat wiadomości', 'text' => 'treść wiadomości e-mail w postaci zwykłego tekstu', 'html' => 'treść wiadomości e-mail w formacie HTML'); foreach ($data as $k => $d) { $request->addPostParameter($k, $d); }; $request->addUpload('attach1', './sample.pdf', 'sample.pdf', 'application/pdf'); $request->addUpload('attach2', './sample.txt', 'sample.txt', 'text/plain'); $result = $request->send(); var_dump($result); ?>

Żądanie POST z załącznikami
metoda CURL

curl -F 'apiuser=ten, który Ci podaliśmy' \ -F 'apipass=ten, który Ci podaliśmy' \ -F 'from=sender@example.com' \ -F 'to=recipient@example.com' \ -F 'subject=temat wiadomości' \ -F 'text=treść wiadomości e-mail w postaci zwykłego tekstu' \ -F 'html=treść wiadomości e-mail w formacie HTML' \ -F 'attach=@sample.pdf;type=application/pdf' \ -F 'attach=@sample.txt;type=text/plain' \ https://rsXXX-api.realsender.com/mail/send

przegląd

RealSender umożliwia łatwe przesyłanie żądań HTTP, takich jak zawartość formularzy internetowych, za pośrednictwem wiadomości e-mail.
W ten sposób wyniki ankiet otrzymasz bezpośrednio do swojej skrzynki pocztowej.

Nie ma potrzeby żadnej specjalnej konfiguracji.
Formularze można opublikować na dowolnej stronie HTML lub dodać bezpośrednio do wiadomości e-mail.

Adres skryptu:
<form action="https://rsXXX.realsender.com/script/form.pl" method="post" accept-charset="utf-8">

Parametry wymagane/obowiązkowe (pola ukryte):

Parametry wymagane/obowiązkowe (pola nieukryte):

bliższe dane

Parametry nieobowiązkowe/opcjonalne (pola ukryte):

Parametry nieobowiązkowe/opcjonalne (pola nieukryte):

Do przesłania formularza zostanie użyte kodowanie UTF-8 w formacie międzynarodowym.
Aby je przetestować, dodaj „€uro” w dowolnym polu, wyślij formularz i sprawdź otrzymaną wiadomość e-mail.

przykład formularza internetowego

Oto prosty przykład formularza internetowego w formacie HTML
z dwoma opcjonalnymi parametrami: „realname” i „notes”

<form action="https://rsXXX.realsender.com/script/form.pl" method="post" accept-charset="utf-8"><input type="hidden" name="recipient" value="email_address-or-alias" /><input type="hidden" name="required" value="email" /><input type="hidden" name="redirect" value="/form/thankyou.html" /><input type="hidden" name="missing_fields_redirect" value="/form/error.html" /> Nazwa:<br /><input name="realname" /><br /> E-mail:<br /><input name="email" /><br /> Uwagi:<br /><textarea cols="40" rows="2" name="notes"></textarea><br /><input type="submit" /></form>

Strony docelowe „redirect” i „missing_fields_redirect” mogą znajdować się na Twoim serwerze.
Możesz dodać dowolną liczbę pól, bez konieczności konfiguracji na poziomie serwera.

przykład sms do http

Aby otrzymywać wiadomości SMS bezpośrednio do skrzynki pocztowej,
routery Teltonika oferują opcję „Konfiguracja przekazywania wiadomości SMS do protokołu HTTP”.

Znajdziesz go w interfejsie internetowym Teltonika: Usługi > Narzędzia mobilne > Bramka SMS.
Domena odbiorcy (twojadomena.com) musi zostać wstępnie autoryzowana przez RealSender!

Nazwa wartości liczbowej: e-mail Metoda: Wyślij adres URL: https://rsXXX.realsender.com/script/sms.pl Nazwa wartości wiadomości: wiadomość Dodatkowa para danych 1: odbiorca | nazwa@twojadomena.com Dodatkowa para danych 2: temat | Wiadomość tekstowa

Opcja 1 – korzystanie z DANYCH MOBILNYCH

!! Do poprawnego działania RealSender wymagane jest połączenie 4G (LTE) !!
Możesz je skonfigurować w interfejsie Teltonika WebUI: Sieć > Telefon komórkowy > Ustawienia karty SIM

Typ sieci: tylko 4G (LTE)

Opcja 2 – korzystanie z DANYCH BRAMY LAN

Możesz ustawić bramę internetową tak, aby przechodziła przez Twoją sieć LAN.
Teltonika WebUI: Sieć > Sieć LAN > INTERFEJSY SIECIOWE > [edytuj]

Wystarczy skonfigurować bramę IPv4 i serwery DNS,
patrz przykład poniżej (zmodyfikuj go, używając własnych parametrów):

INTERFEJSY: LAN ... Brama IPv4: 192.168.1.1 Serwery DNS: 8.8.8.8 !! obowiązkowe !!

Połączenie danych mobilnych można wyłączyć na kilka sposobów, patrz: Wyłączanie danych mobilnych.
Po wyłączeniu danych mobilnych wiadomości SMS nadal działają.

Najprostszym sposobem na wyłączenie danych mobilnychjest wysłanie SMS-a na numer telefonu komórkowego: <router_password> mobileoff
Możesz sprawdzić zmiany w ten sam sposób, używając polecenia „status”: <router_password> status

Przykład otrzymanej wiadomości e-mail

Temat: Wiadomość tekstowa (+41790000000) Poniżej znajduje się otrzymana wiadomość tekstowa. Została ona wysłana przez (+41790000000) w poniedziałek, 26 czerwca 2023 r. o godzinie 08:31:29 CEST --------------------------------------------------------------------------- Wiadomość testowa ---------------------------------------------------------------------------

alerty Google News

Google News to usługa agregująca wiadomości opracowana i utrzymywana przez Google.
Oferuje ona stały przepływ linków do artykułów pochodzących od tysięcy wydawców i czasopism.
Usługa jest oferowana w ponad 60 krajach i w ponad 35 językach.

Strona internetowa Google News automatycznie generuje listę wiadomości
z największych gazet internetowych (w kraju, w którym się znajduje)
i grupuje je według podobnej treści, sortując je według tematu i daty publikacji artykułu.
Wiadomości są zawsze publikowane w formie krótkich streszczeń.

Przepływ „Alerty Google News” dla aplikacji emailconnect
wyodrębnia kanał RSS i wysyła powiadomienia e-mail
w żądanych odstępach czasu, na określony temat, do powiązanego odbiorcy:

Wystarczy zduplikować przepływ, edytować pierwszy i ostatni węzeł, a otrzymasz
wiele alertów dla różnych tematów, wysłanych do wielu odbiorców.

Jeśli w ciągu ostatnich 24 godzin nie pojawiły się żadne wiadomości, wiadomość nie zostanie wysłana.
Przycisk po lewej stronie „pierwszego tematu” umożliwia ręczne wymuszenie wykonania.

sprawdzenie statusu smtp

Kontrola statusu SMTP weryfikuje dostępność, bezpieczeństwo i funkcjonalność serwera pocztowego.
Zapewnia ona akceptację połączeń TCP, prawidłowe uwierzytelnianie i przetwarzanie wiadomości e-mail przez serwer.

Kontrola jest skonfigurowana tak, aby uruchamiać się w regularnych odstępach czasu, co dziesięć minut.
Użytkownik może samodzielnie zmienić predefiniowany interwał.

Przepływ „sprawdzania statusu SMTP” w aplikacji emailconnect
weryfikuje, czy usługa SMTP działa prawidłowo, wysyłając rzeczywiste wiadomości.
Tylko w przypadku awarii system wysyła wiadomość e-mail z ostrzeżeniem:

Wystarczy zduplikować przepływ, edytować pierwszy i ostatni węzeł, a otrzymasz
wiele alertów dla różnych serwerów SMTP, wysyłanych do wybranych odbiorców.

Użytkownik i hasło są ustawiane na poziomie systemu jako „zmienne środowiskowe”, których użytkownik nie może odczytać.
Przycisk po lewej stronie pierwszego węzła „companyname” umożliwia ręczne wymuszenie wykonania
i wyświetlenie wyniku w obszarze debugowania, po prawej stronie ekranu:

sprawdzenie statusu witryny

Kontrola statusu witryny weryfikuje jej dostępność, bezpieczeństwo SSL i funkcjonalność.
Monitoruje działanie serwera WWW, ważność certyfikatów SSL oraz odpowiedź strony internetowej.

Kontrola jest skonfigurowana tak, aby uruchamiać się w regularnych odstępach czasu, co dziesięć minut.
Użytkownik może samodzielnie zmienić predefiniowany interwał.

Przepływ „sprawdzania stanu witryny” w aplikacji emailconnect
wysyła żądanie HTTP na adres witryny i analizuje odpowiedź.
System wysyła alert e-mail tylko w przypadku awarii:

Wystarczy zduplikować przepływ, edytować pierwszy i ostatni węzeł, a otrzymasz
wiele alertów dla różnych witryn internetowych, wysłanych do wybranych odbiorców.

Przycisk po lewej stronie pierwszego https://example.com umożliwia ręczne wymuszenie wykonania
i zobaczenie wyniku w obszarze debugowania, po prawej stronie ekranu:

odwrotny serwer proxy dla serwerów SMTP

Główne korzyści:

• Bezpieczeństwo Może blokować złośliwe żądania, szyfrować ruch
  i chronić serwery zaplecza przed bezpośrednimi atakami.
• Wydajność Rozprasza ruch przychodzący na wiele serwerów, zapobiegając przeciążeniu
  pojedynczego serwera i zapewniając większą dostępność.
• Skalowalność Umożliwia dodawanie i usuwanie serwerów zaplecza bez przerywania świadczenia usług,
  oferując możliwość obsługi rosnącego ruchu.

certyfikowana bramka poczty e-mail

Certyfikowana poczta elektroniczna to poczta elektroniczna, która umożliwia potwierdzenie wysłania i doręczenia wiadomości oraz dostarczanie potwierdzeń, które można wykorzystać przeciwko osobom trzecim.

Istnieją trzy tryby pracy, które można również łączyć, aby umożliwić wysyłanie wiadomości e-mail za pośrednictwem poczty certyfikowanej:

• odbiorcy z predefiniowanymi rozszerzeniami domeny (np. pec.it, legalmail.it, pec.poste.it)
• adresy e-mail docelowe z rozszerzeniem „.xx” (np. nazwa_domeny.com.xx),
  wówczas rozszerzenie „.xx” zostanie automatycznie usunięte
• określonych nadawców (np. faktury@…)

Wiadomości e-mail są przesyłane do innego serwera, który uwierzytelnia się za pomocą certyfikowanej usługi poczty e-mail SMTP klienta (takiej jak Aruba, Legalmail, Register, żeby wymienić tylko kilka).

Nadawca zostaje automatycznie zmieniony na certyfikowany adres e-mail klienta.

Wiadomości niedostarczone (np. użytkownik nieznany lub skrzynka pełna) zostaną wysłane na certyfikowany adres e-mail wskazany jako nadawca.

Nieprawidłowe lub nieaktualne adresy e-mail należy ręcznie poprawić lub usunąć, aby zapobiec dalszemu wysyłaniu wiadomości, gdyż mogą one uruchomić ochronę przed spamem w skrzynkach odbiorczych wiadomości e-mail.

wiadomości e-mail z jednym wierszem tekstu

Aplikacja „plainmail” redukuje Twoje wiadomości e-mail do pojedynczej linijki tekstu,
sprawia, że ​​załączniki e-mail znikają, a zamiast nich wysyłane są linki:

• Ściśnij swoje e-maile
• Konwertuj załączniki e-mail na linki

Ściśnij swoje e-maile

Wystarczy, że dodasz „.plain” do domeny e-mail odbiorcy, a
otrzyma on tylko temat:

Odbiorca: email@example.com.plain Temat: Twoja krótka wiadomość, dozwolone są emotikony

Dodatkowa treść wiadomości e-mail i załączniki zostaną zignorowane.
W ich miejsce pojawi się następujący komunikat:

< PlainMail > Cała treść oprócz tematu została usunięta.

» powrót na górę

Konwertuj załączniki e-mail na linki

Wystarczy wpisać „[A]” w temacie wiadomości i dodać załącznik.
Aplikacja „plainmail” automatycznie przekształci go w link.

Domena w linku może być dowolną dedykowaną domeną lub subdomeną, której chcesz używać.
Plik zostanie USUNIĘTY po sześciu miesiącach.

» powrót na górę

powiadomienia do aplikacji ntfy

Czym jest ntfy?

ntfy (czyt. „notify”) działa na zasadzie usługi powiadomień typu „publish-subscribe”, w której wysyłasz wiadomość do „tematu”. Smartfon lub komputer z aplikacją ntfy i subskrybujący ten sam temat otrzymuje wiadomość w formie powiadomienia push w czasie rzeczywistym.

Umożliwia to dostarczanie natychmiastowych alertów generowanych przez skrypty, serwery lub dowolną inną usługę, dzięki czemu użytkownicy mogą otrzymywać powiadomienia bez skomplikowanej konfiguracji.

Jak to działa z RealSender:

• Publikujący:
  możesz publikować wiadomości na dany temat za pośrednictwem poczty e-mail, wysyłając wiadomość na określony adres. Na przykład, możesz opublikować wiadomość, wysyłając wiadomość na adres topic@ntfy.youremaildomain.com.
  Treść wiadomości jest zgodna z tematem wiadomości.
  Tylko użytkownicy RealSender są upoważnieni do wysyłania wiadomości e-mail na ten adres.

• Subskrybenci:
  otrzymują powiadomienia za pośrednictwem smartfona lub komputera,
  mając zainstalowaną aplikację ntfy i temat, który subskrybują

• Tematy:
  pomyśl o tematach jak o kanałach z unikalnymi nazwami i strumieniami wydarzeń, które są w nich publikowane.
  Nie musisz tworzyć tematów wprost; po prostu wybierz nazwę i jej używaj.
  Nazwy tematów są publiczne, dlatego warto wybrać coś, czego nie da się łatwo odgadnąć.

Po wysłaniu wiadomości e-mail serwer ntfy odbiera ją i przechowuje dla subskrybentów danego tematu.
Subskrybent (za pośrednictwem aplikacji ntfy) łączy się z tematem i otrzymuje wiadomość w czasie rzeczywistym.

To „system odseparowany” – wydawcy nie muszą znać swoich subskrybentów i odwrotnie.
Upraszcza to korzystanie z systemu i zarządzanie nim, zarówno dla wydawcy, jak i subskrybenta.

» powrót na górę

Konwertuj załączniki e-mail na linki

Wystarczy wpisać „[A]” w temacie wiadomości i dodać załącznik.
Aplikacja „plainmail” automatycznie przekształci go w link.

Domena w linku może być dowolną dedykowaną domeną lub subdomeną, której chcesz używać.
Plik zostanie USUNIĘTY po sześciu miesiącach.

» powrót na górę

wiadomości na numery komórkowe

Połącz swoją pocztę e-mail ze światem mobilnym,
zmaksymalizuj możliwości komunikacji biznesowej,
nie zmieniając przyzwyczajeń zawodowych:

• Wysyłaj wiadomości tekstowe ze swojej poczty e-mail
• Odbieraj wiadomości tekstowe na swój adres e-mail
• Odpowiadaj na wiadomości tekstowe z poczty e-mail
• Konwertuj załączniki e-mail na linki

Wysyłaj wiadomości tekstowe ze swojej poczty e-mail

Powiadomienia push to najskuteczniejszy sposób na szybkie dotarcie do klientów.
Zapewniają one wyjątkowo wysoki wskaźnik otwarć (do 95%) i najwyższy wskaźnik odpowiedzi (do 45%).
– źródło: badanie Gartnera dotyczące wiadomości tekstowych, rok 2019.

Odbiorca: mobilenumber@text.yourdomain.com Temat: treść wiadomości tekstowej, dozwolone są emotikony (dodatkowa treść wiadomości e-mail i załączniki są ignorowane)

Dostarczymy Ci router przemysłowy wstępnie skonfigurowany dla Twojego operatora komórkowego.

Kontrola nad wysyłaniem i dostarczaniem wiadomości tekstowych musi być realizowana za pośrednictwem operatora, z którego usług korzystasz.
Nasz system co dziesięć minut sprawdza, czy router odpowiada (sprawdza zasilanie i połączenie z internetem).

Aby uniknąć nadużyć, wiadomości muszą być wysyłane za pośrednictwem RealSender, przez wcześniej autoryzowanych nadawców,
z zachowaniem „ścisłego” poziomu zabezpieczeń SPF i DKIM. Dowiedz się więcej o uwierzytelnianiu poczty e-mail – zaawansowane.

» powrót na górę

Odbieraj wiadomości tekstowe na swój adres e-mail

Odpowiedzi w formie wiadomości tekstowych będą dostarczane bezpośrednio do wybranej przez Ciebie skrzynki pocztowej,
w postaci wiadomości e-mail, takiej jak ta:

Temat: Wiadomość tekstowa (+41790000000) Poniżej znajduje się otrzymana wiadomość tekstowa. Została ona wysłana przez (+41790000000) w poniedziałek, 29 lipca 2025 r. o godzinie 10:57:00 CEST --------------------------------------------------------------------------- Wiadomość testowa ---------------------------------------------------------------------------

» powrót na górę

Odpowiadaj na wiadomości tekstowe z poczty e-mail

Aplikacja „plainmail” firmy RealSender umożliwia wysyłanie wiadomości tekstowych bezpośrednio z konta E-MAIL.

Możesz więc odpowiedzieć ze swojej ulubionej aplikacji e-mail.
Adres odbiorcy jest już uzupełniony o numer oryginalnego nadawcy:

Odbiorca: mobilenumber@text.twojadomena.com Temat: treść odpowiedzi (dodatkowa treść wiadomości e-mail i załączniki są ignorowane)

Dzięki temu możliwa jest kontynuacja komunikacji między aplikacją pocztową i urządzeniem mobilnym.

» powrót na górę

Konwertuj załączniki e-mail na linki

Wystarczy wpisać „[A]” w temacie wiadomości i dodać załącznik.
Aplikacja „plainmail” automatycznie przekształci go w link.

Domena w linku może być dowolną dedykowaną domeną lub subdomeną, której chcesz używać.
Plik zostanie automatycznie USUNIĘTY po sześciu miesiącach.

» powrót na górę