Pomoc - smsAPI.pl - Wysyłka SMS i MMS oraz obsługa Premium SMS.

Spis treści

1. Dodawanie własnej nazwy w polu nadawcy wiadomości SMS.
2. Szybka wysyłka wiadomości SMS.
3. Masowa wysyłka wiadomości SMS (numery telefonów pobierane z pliku csv).
4. Masowa wysyłka spersonalizowanych wiadomości SMS (numery telefonów i treści wiadomości pobierane z pliku).
5. Masowa wysyłka wiadomości SMS do osób zapisanych w książce telefonicznej.
6. Wysyłka wiadomości MMS.
7. Zarządzanie podużytkownikami.
8. Tabela naliczania ilości SMSów.

1. Dodawanie własnej nazwy w polu nadawcy wiadomości SMS.

Aby dodać własną nazwę należy wejść do zakładki "Ustawienia" -> "Pola nadawcy" i wpisąć ją w polu "Dodaj nadawcę". Zakładka dostępna jest po zalogowaniu się do serwisu. Nazwa może zawierac maksymalnie 11 znaków (bez znaków specjalnych w tym polskich). Nazwa zostanie aktywowana w ciągu kilku godzin (w dni robocze). W przypadku wątpliwości co do możliwości jej użycia serwis smsAPI skontaktuje się z Państwem telefonicznie bądź przez adres e-mail. Nazwa nadawcy wykorzystywana jest do wysyłania wiadomości proSMS.

[Powrót do spisu treści]

2. Szybka wysyłka wiadomości SMS.

W celu wysłania wiadomości SMS należy wejść do zakładki "Bramka SMS" -> "Wysyłka SMS". W polu wyboru "Od:" należy wybrać aktywną nazwę nadawcy (dodaną według punktu 1). W polu "Do:" należy podać po przecinkach numery telefonów do których jest adresowany SMS (maksymalnie 100 numerów). W "Treść:" należy wpisać treść wiadomości. Koszt wysyłki zależy od ilości części z których składa się wiadomość (sprawdź punkt 8. Tabela pobierania punktów).

[Powrót do spisu treści]

3. Masowa wysyłka wiadomości SMS (numery telefonów pobierane z pliku csv).

Należy wejść do podstrony "Masowa bramka SMS" -> "Masowy SMS" i zaznaczyć zakładkę Numery z CSV. W polu wyboru "Od:" należy wybrać aktywną nazwę nadawcy (dodaną według punktu 1). W polu "Do:" należy kliknąć "Przeglądaj" i wybrać z dysku plik CSV według przygotowanego wzoru:

- przyklad1.csv -

48500500500
48500500501
48500500502
48500500503

Istnieje możliwość nie podawania prefixu "48" (zostanie on automatycznie dopisany).
Znak nowej lini (<ENTER>) może zostać zastąpiony przecinkiem lub średnikiem, tak jak w poniższym przykładzie:

- przyklad2.csv -

500500500;500500501;500500502;500500503

W treści wiadomości należy podać treść jaka ma zostać wysłana do wszystkich odbiorców znajdujących się w pliku. W tej metodzie nie można personalizować treści. Koszt wysyłki zależy od ilości części z których składa się wiadomość (sprawdź punkt 8. Tabela pobierania punktów).

[Powrót do spisu treści]

4. Masowa wysyłka spersonalizowanych wiadomości SMS (numery telefonów i treści wiadomości pobierane z pliku).

Należy wejść do podstrony "Masowa bramka SMS" -> "Masowy SMS" i zaznaczyć zakładkę Numery i treść z CSV. W polu wyboru "Od:" należy wybrać aktywną nazwę nadawcy (dodaną według punktu 1). W polu "Do:" należy kliknąć przeglądaj i wybrać plik CSV z dysku według przygotowanego wzoru:

- przyklad3.csv -

48500500500;To jest dowolna indywidualna wiadomość SMS. Kod 1213.
48500500501;To jest dowolna indywidualna wiadomość SMS. Kod 4321.
48500500502;To jest dowolna indywidualna wiadomość SMS. Kod 5436.

Istnieje możliwość nie podawania prefixu "48" (zostanie on automatycznie dopisany).

Parametry:
Jeżeli są dostępne parametry w dalszych kolumnach należy je podać w zmiennych:

[%1%]	odpowiadający 3 kolumnie
[%2%]	odpowiadający 4 kolumnie
[%3%]	odpowiadający 5 kolumnie
[%4%]	odpowiadający 6 kolumnie

- przyklad4.csv -

48500500500;To jest dowolna indywidualna wiadomość. Kod [%1%];1213
48500500501;To jest dowolna indywidualna wiadomość. Kod [%1%];4321
48500500502;To jest dowolna indywidualna wiadomość. Kod [%1%];5436

- przyklad5.csv -

500500500;To jest [%2%] indywidualny SMS. Kod [%1%];1213;dowolny;
500500501;[%3%] dowolny indywidualny SMS. Kod [%1%];4321;;To jest;
500500502;To jest dowolny [%1%] [%2%] [%3%];indywidualny;SMS;5436;

Kliknij tutaj, aby ściągnąć przykład pliku CSV.

UWAGA! Pliki CSV powinny być wykonywane poprzez opcję "Zapisz jako" w programach generujących pliki CSV (np. Open Office, MS Excel, itp). Jeżeli jednak istnieje potrzeba utworzenia pliku ręcznie należy pamiętać, aby w przypadku użycia znacznika separacji kolumn (np. średnik) w tekście wiadomości użyć cudzysłowiów dla każdego wiersza. Operacja ta jest automatycznie wykonywana przez programy do tego celu przeznaczone. Koszt wysyłki zależy od ilości części z których składa się wiadomość (sprawdź punkt 8. Tabela pobierania punktów).

[Powrót do spisu treści]

5. Masowa wysyłka wiadomości SMS do osób zapisanych w książce telefonicznej.

Należy wejść do podstrony "Masowa bramka SMS" -> "Masowy SMS" i zaznaczyć zakładkę Numery z Książki Telefonicznej. W polu wyboru "Od:" należy wybrać aktywną nazwę nadawcy (dodaną według punktu 1). W polu "Do:" należy wybrać grupę osób, do której ma zostać wysłana wiadomość SMS. Domyślnie jest wybierana opcja "Do wszystkich". Aby utworzyć nową grupę należy przejść do zakładki "Książka telefoniczna", upewnić się czy na środkowym ekranie jest aktywna opcja "Grupa", a następnie utworzyć nowe grupy. Przypisywanie klientów do poszczególnych grup odbywa się z zakładki "Książka".
W "Treść:" należy wpisać treść wiadomości SMS. Koszt wysyłki zależy od ilości części z których składa się wiadomość (sprawdź punkt 8. Tabela pobierania punktów).

[Powrót do spisu treści]

6. Wysyłka wiadomości MMS.

W celu wysłania wiadomości MMS należy wejść do zakładki "Bramka MMS" -> "Wysyłka MMS".

W polu "Wyślij do:" kliknąć

i ręcznie wpisać numery telefonów do których ma być wysłana wiadomość, kliknąć

aby pobrać bazę numerów z pliku CSV lub

wybrać jedną z grup dostępnych w książce telefonicznej.

Każda wiadomość MMS może skłądać się z kilku slajdów. Standardowo widoczny jest tylko pierwszy slajd, a pozostałe dodaje/usówa się klikając w odpowiednią ikonę

.

W polu "Temat:" należy podać temat wiadomości MMS.

Następnie dodajemy plik graficzny (zdjęcie obrazek), tresć wiadomości i w razie potrzeby plik dźwiękowy, pamiętajac iż maksymalny rozmiar całej wiadomości MMS to 100kB.

W celu dodania pliku należy kliknąć "Przeglądaj" i wybrać plik z komputera. Plik może zostać usunięty po wciśnieciu

.

Ponieważ MMSy nie mają ograniczeń co do długości treści (mieści się około 4000 znaków), tekst również wgrywany jest jako plik. Aby to zrobić należy z notatniku wpisać treść i koniecznie zapisać plik poprzez opcję "zapisz jako" a następnie w okienku które się pojawi na samym dole w opcji "Kodowanie" wybrać "UTF-8". Tak przygotowany plik wgrać jako załącznik.

Umieszczenie w jedym slajdzie więcej niż jednego pliku graficznego w niektórych telefonach może skutkować pojawieniem się ikony prezentacji którą trzeba otworzyć dlatego prosimy umieszczać po jednym zdjęciu/obrazku w każdym slajdzie.

Wiadomość MMS może składać się z kilku slajdów, z różnym czasem ich wyświetlania który definiujemy w polu "Czas trwania slajdu:". Kolejny slajd dodać można po załadowaniu przynajmniej jednego pliku w poprzednim korzystając z opcji

Po przygotowaniu wiadomości należy kliknąć "Dalej" a następnie zapoznać się z podsumowaniem i nacisnąć "Wyślij". Historia wysłanych wiadomości MMS znajduje się w zakładce Historia MMS.

[Powrót do spisu treści]

7. Zarządzanie podużytkownikami.

Zarządzanie podużytkownikami dokonuje się w zakładce "Ustawienia" -> "Podużytkownicy". Można tu dodawać, usuwać podużytkowników oraz zarządzać ich ustawieniami.

a) Dodawanie/usuwanie podużytkownika.

W celu dodania nowego podużytkownika należy wpisać jego nazwę w polu login (przykładowa nazwa: login_poduzyt) oraz wpisać hasło dla podużytkownika a następnie wcisnąć Dodaj. Zaznaczenie checkbox'u skopiuj nazwy nadawców pozwala na przepisanie wszystkich pól nadawcy konta głównego do podużytkownika.

b) Ustawianie limitu punktów do wykorzystania przez podużytkownika.

Aby umożliwić wysyłanie wiadomości przez podużytkownika należy ustawić mu limit punktów do wykorzystania. W tym celu należy wpisać w polu Limit pkt. ile punktów z konta głównego może on wykorzystać następnie zaznaczyć Potwierdź zmianę i wcisnąć Zapisz.
Uwaga! Jeżeli konto główne nie będzie posiadało odpowiedniej liczby punktów podużytkownik nie będzie w stanie wysyłać wiadomości. W momencie wysłania wiadomości przez podużytkownika odejmowana jest odpowiednia liczba punktów z konta głównego oraz z ustalonego limitu dla podużytkownika.

c) Udostępnianie podużytkownikowi "Grup" z Książki Telefonicznej.

Aby umożliwić wysyłanie wiadomości do Grup z Książki Telefonicznej głównego użytkownika należy zaznaczyć przy podużytkowniku pole Grupy następnie zaznaczyć Potwierdź zmianę i wcisnąć Zapisz.

[Powrót do spisu treści]

8. Tabela naliczania ilości SMSów.

Bez znaków specjalnych		Ze znakami specjalnymi (w tym PL)
Ilość znaków	Ilość SMSów	Ilość znaków	Ilość SMSów
160	1 SMS	70	1 SMS
305	2 SMS	134	2 SMS
457	3 SMS	201	3 SMS

[Powrót do spisu treści]

Spis treści

1. Najnowższa specyfikacja smsAPI.
2. Przykłady wysyłania SMSa w PHP.
3. Opis korzystania z usługi mailtosms.
4. Wysyłanie wiadomości WAP PUSH.
5. Wysyłanie wiadomości vCard.
6. Wysyłanie wiadomości o określonej godzinie/dacie.

1. Specyfikacja smsAPI.

Specyfikacja smsAPI zawiera opis m.in.:

Wysyłki SMS poprzez http, https, mail2SMS, Web Services(SOAP),

odbiór SMS, MMS,

wysyłka WAP PUSH, vCard, wiadomości zaplanowanych oraz spresonalizowanych.

Ściągnij najnowszą specyfikację smsAPI 2.9 (08.07.2010)

2. Przykłady wysyłania SMSa w PHP.

UWAGA! Hasło należy podać w formie zaszyfrowanej algorytmem MD5! W celu wygenerowania hasła md5 należy użyć narzędzia dostępnego w zakładce Narzędzia.

Przykład nr 1 - bezpośrednie wysyłanie sms z poziomu PHP.

<?php

$username = "uzytkownik";
$password = md5("haslo"); //lub $password="ciąg md5"
$to = "48505605705";
$from= urlencode("nadawca");	//nazwa nadawcy musi być aktywna 
$message= urlencode("moja wiadomosc");

if ($username && $password && $to && $message) {
	$data = "?username=$username&password=$password"
	."&to=$to&message=$message&from=$from";
	$plik = fopen('http://api.smsapi.pl/send.do'.$data,'r');
	$wynik = fread($plik,1024);
	fclose($plik);
	
	echo $wynik;
}

?>

Przykład nr 2 - wysyłanie sms z formularza HTML z poziomu PHP.

<?php
	if (strlen($_POST['sms_from'])>0 &&
		strlen($_POST['sms_to'])>=9 &&
		strlen($_POST['sms_message'])>0) 
	{
		$username = "login";
		$password = md5("haslo"); //lub $password="ciąg md5"
		$from = urlencode($_POST['sms_from']);
		$to = $_POST['sms_to'];
		$message= urlencode($_POST['sms_message']);
		echo file_get_contents("http://api.smsapi.pl/send.do?".
			"username=$username&password=$password&to=$to&".
			"message=$message&from=$from",FALSE,NULL,0,100);
	}
?>
<html>
<head>
	<meta http-equiv="Content-type" content="text/html; charset=windows-1250">
</head>
<body>
	<form name="sms" method="POST" action="">
	<table>
	<tr>
		<td>Od:</td>
		<td><input type="text" name="sms_from" value=""></td>
	</tr>
	<tr>
		<td>Do:</td>
		<td><input type="text" name="sms_to" value=""></td>
	</tr>
	<tr>
		<td>WiadomoĹ›Ä‡:</td>
		<td><textarea name="sms_message"></textarea></td>
	</tr>
	<tr>
		<td colspan="2"><input type="submit" value="wyślij"></td>
	</tr>
	</table>
	</form>
</body>
</html>

Przykład nr 3 - wysyłanie sms do wielu odbiorców przy wykorzystaniu biblioteki cURL.

<?php

$username = 'login';
$password = md5('haslo'); //lub $password='ciąg md5'
$from = urlencode('nazwa nadawcy');
$to = array('numer1','numer2');
$message = urlencode('Tresc wiadomosci');

echo send_sms($username,$password,$from,$to,$message);


function send_sms($username,$password,$from,$to,$message) {

	$to_full = null;
	foreach ($to as $k=>$v) $to_full.=$v.',';
	$to_full = substr($to_full,0,-1);

	$c = curl_init();
	curl_setopt($c, CURLOPT_URL, 'http://api.smsapi.pl/send.do');
	curl_setopt($c, CURLOPT_POST, 1);
	curl_setopt($c, CURLOPT_SSL_VERIFYPEER,false);
	curl_setopt($c, CURLOPT_POSTFIELDS, 'username='.$username.'&password='.$password.'&from='.$from.' &to='.$to_full.'&message='.$message);
	curl_setopt($c, CURLOPT_RETURNTRANSFER, 1);
	curl_setopt($c, CURLOPT_USERAGENT, "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1)");
	curl_getinfo($c);
	$result = curl_exec($c);
	curl_close($c);
	return $result;
}

?>

[Powrót do spisu treści]

3. Opis korzystania z usługi mailtosms.

Aby wysłać smsa za pomocą maila należy wysłać maila według schematu:

ADRES: send.do@smsapi.pl
TEMAT: login@haslo(32_znaki_w_md5)
TREŚĆ: from=nadawca&to=numer&raport=(0/1)&eco=(0/1)&message=tresc wiadomści

Przykład:

ADRES: send.do@smsapi.pl
TEMAT: login@8456fkty567gb3bg37b357b3457b3457
TREŚĆ: from=606606***&to=606605***&raport=1&eco=1&message=TEKST WIADOMOSCI

Dostępne parametry:

from= - pole nadawcy wiadomości
to= - adresat wiadomości
raport=1 - spowoduje odsyłanie maila z raportem czy udało się wysłać wiadomość (ID wiadomości lub numer błędu):
eco=1 - spowoduje wysłanie wiadomości ecoSMS"
message= - treść wiadmości, musi występować jako ostatni parametr!

Wiadomości mogą być wysyłane w kodowaniu: plain / quotedprintable / base64.

Ważne! Numer telefonu nie może zawierać znaku plus "+" na początku. Nazwa nadawcy (zmienna &from=) musi być aktywna. Treść wiadomość musi wystąpować jako ostatni parametr. Hasło należy podać w formie zaszyfrowanej algorytmem MD5!

[Powrót do spisu treści]

4. Wysyłanie wiadomości WAP PUSH.

Aby wysłać wiadomość WAP PUSH w zapytaniu należy użyć parametrów &udh=0605040b8423f0, &datacoding=bin a treść z linkiem zakodować do postaci binarnej. W celu przekonwertowania treści do postaci binarnej należy użyć narzędzia dostępnego w zakładce Narzędzia.

Przykład:

uzytkownik&password=haslo&from=nazwa&to=48501000000
&udh=0605040b8423f0&datacoding=bin&message=860601ae02056a0045c60c037777772E736D73617069
2E706C000701035A61707261737A616D7920646F20736D734150492E706C000101

[Powrót do spisu treści]

5. Wysyłanie wiadomości vCard.

Aby wysłać wiadomość vCard w zapytaniu należy użyć parametrów &udh=06050423F40000, &datacoding=bin a dane kontaktu zakodować do postaci binarnej. W celu przekonwertowania treści do postaci binarnej należy użyć narzędzia dostępnego w zakładce Narzędzia.

Przykład:

uzytkownik&password=haslo&from=nazwa&to=48501000000
&udh=06050423F40000&datacoding=bin &message=424547494E3A56434152440D0A56455253494F4E3A322E310D0A464E3A736D7
3617069206D61736F776120777973796C6B610D0A4E3A6D61736F776120777973796C6B613B736D736170693
B3B3B0D0A54454C3B505245463B43454C4C3A3332373530353838390D0A454D41494C3B494E5445524E45543
A696E666F40736D736170692E706C0D0A55524C3A7777772E736D736170692E706C0D0A454E443A5643415244

[Powrót do spisu treści]

6. Wysyłanie wiadomości o określonej godzinie/dacie.

Aby wysłać wiadomość o określonej godzinie w zapytaniu należy użyć parametru &date=data, data powinna być podana w postaci timestamp. W celu wygenerowania timestamp z podanego czasu należy użyć narzędzia dostępnego w zakładce Narzędzia.

Przykład:

http://api.smsapi.pl/send.do?username=uzytkownik&password=haslo&from=nazwa&to=48501000000
&date=1237383500&message=tresc wiadomosci

[Powrót do spisu treści]

Informacje

Produkty

Narzędzia

Zaufali nam: