SMS z webu alebo SMS API
Chcem posielať SMS výhodne, ako mám postupovať?
Ako prvé sa treba zaregistrovať. Po registrácii vám príde na e-mail aktivačný link. Po kliknutí na uvedený link sa stáva vaše konto aktívne. Teraz sa môžete prihlásiť.Po registrácii a prihlásení
Chcem poslať SMS a odosielateľ má byť názov mojej firmy, ako mám postupovať?
V menu kliknite na položku Čísla/mená odosielateľov. Do kolonky Pridať odosielateľa vpíšte názov firmy (max 11 znakov) a kliknite na Pridať.Názov firmy, alebo iný alfanumerický názov vám aktivuje administrátor do 24 hod.
Ako si mám dobiť kredit?
Pre navýšenie kreditu kliknite v menu na odkaz Dobiť kredit a platby. Minimálna výška kreditu, ktorý si môžete dobiť je 10 EUR bez DPH. Na e-mail vám vzápäti prídu podklady pre prevodný príkaz, alebo vás web nasmeruje do systému na platbu kartou. Po pripísaní platby na náš účet vám administrátor kredit navýši o uhradenú čiastku do 24 hod. Faktúru vám pošleme najneskôr do 4 dní od prijatia platby.Viem si sledovať stav odoslaných SMS?
Áno, v menu kliknite na položku História poslaných SMS. Tu nájdete kompletný zoznam vami odoslaných SMS. SMS ostávajú v archíve dlhodobo, automaticky sa mažú až po roku.Je možné si naplánovať deň a čas odoslania SMS, alebo musim SMS odoslať ihneď?
Áno, odoslanie SMS sa dá veľmi jednoducho plánovať. Kliknite vľavo v menu na odkaz Poslať SMS. Následne v sekcii Rýchla SMS kliknite v kolonke Dátum na odkaz Nastaviť čas odoslania.Je nejaká možnosť si uložiť tel. kontakty?
Áno, v menu po kliknutí na položku Telefónny zoznam si môžete podobne ako v mobilnom telefóne vytvárať skupiny, pridávať tel. čísla, alebo poslať jednu a tú istú SMS naraz na zvolené kontakty.Mám možnosť rovnako ako v mobile vytvoriť si šablóny?
Áno, v menu po kliknutí na položku Moje šablóny si môžete vytvoriť ľubovoľný počet preddefinovaných šablón. Následne v sekcii Poslať SMS kliknite na Rýchla SMS pri kolonke Šablóna si zvoľte jednu z vami vytvorených šablón a tá sa automaticky načíta do políčka Správa.Nesledujem si výšku kreditu, upozorníte ma na nízky kredit?
Áno, v menu po kliknutí na položku Môj profil si v kolonke Upozornite ma, ak môj kredit bude nižší ako môžete zvoliť výšku ostávajúceho kreditu. Keď systém zaznamená nižšiu výšku kreditu, ako ste si navolili, tak vám pošle upozornenie e-mailom.Je možné vytvoriť si zvlášť účty pre mojich zamestnancov, či klientov?
Áno, v menu po kliknutí na položku Ďalší užívatelia a podužívatelia si môžete vytvoriť podužívateľov. Podužívatelia sa prihlasujú prihlasovacím menom a heslom, ktoré im v tejto sekcii vytvovríte. V tejto sekcii im môžete prideliť aj kredit a sledovať ich aktivity. Hlavnou výhodou je, že pridaní užívatelia nevidia váš aktuálny kredit, kontakty, vaše aktivity a všetky SMS máte na jednej faktúre a pod doľadom.Koľko znakov má 1 SMS, prípadne môžem spojiť viac SMS do jednej?
| SMS bez špeciálnych znakov | So špec. znakmi neodporúčame | ||
|---|---|---|---|
| Počet znakov | Počet SMS | Počet znakov | Počet SMS |
| 160 | 1 | 70 | 1 |
| 305 | 2 | 134 | 2 |
| 457 | 3 | 201 | 3 |
@£$¥èéùìòÇØøÅå_^{}\[~]|ÆæßÉ!"#¤%&'()*+,-./0-9:;<=>?A-ZÄÖÑܧ¿a-zäöñüà
Jednoznačne odporúčame vyhnúť sa diakritike, aby sa SMS správy zobrazovali správne na všetkých mobilných telefónoch.
Príklady posielania SMS správ cez API
Pozor dôležité
Heslo musí byť šifrované pomocou MD5Váš webhosting a nastavenie servera musí povolovať funkciu fopen
Odosielateľ musí byť aktivovany a polovelený (v sekcii Čísla/mená odosielateľov)
IP adresa servera, cez ktorý komunikujete, musí byť povolená (v sekcii API nastavenia)
Príklad č. 1 - SMS poslaná pomocou PHP
<?php
$username = "prihlasovacie meno";
$password = md5("heslo"); //heslo musi byt sifrovane v md5
$to = "prijimatel"; // napr.: 421904282649
$from = "odosielatel"; // odosielatel musi byt AKTIVOVANY
$message = urlencode("moja SMS sprava");
if ($username && $password && $to && $message) {
$data = "?username=$username&password=$password&to=$to&message=$message&from=$from";
$file = fopen('https://smartsms.sk/api/send.do' . $data, 'r');
$result = fread($file, 1024);
fclose($file);
echo $result;
}
?>Príklad č. 2 - SMS poslaná z HTML formuláru pomocou PHP
<?php
if (strlen($_POST['sms_from']) > 0 &&
strlen($_POST['sms_to']) >= 9 &&
strlen($_POST['sms_message']) > 0)
{
$username = 'prihlasovacie meno';
$password = md5('heslo'); // heslo musi byt sifrovane v md5
$from = $_POST['sms_from']; // odosielatel musi byt AKTIVOVANY
$to = $_POST['sms_to'];
$message = urlencode($_POST['sms_message']);
echo file_get_contents("https://smartsms.sk/api/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=utf-8">
</head>
<body>
<form name="sms" method="post" action="">
<table>
<tr>
<td>Odosielateľ:</td>
<td><input type="text" name="sms_from" value=""></td>
</tr>
<tr>
<td>Príjemca:</td>
<td><input type="text" name="sms_to" value=""></td>
</tr>
<tr>
<td>Správa:</td>
<td><textarea name="sms_message"></textarea></td>
</tr>
<tr>
<td colspan="2"><input type="submit" value="Odoslať"></td>
</tr>
</table>
</form>
</body>
</html>Príklad č. 3 - Hromadná SMS poslaná za použitia cURL library
<?php
$username = 'prihlasovacie meno';
$password = md5('heslo'); // heslo musi byt sifrovane v md5
$from = 'odosielatel'; // odosielatel musi byt AKTIVOVANY
$to = array('prijimatel1','prijimatel2');
$message = urlencode('moja SMS sprava');
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, 'https://smartsms.sk/api/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;
}
?>Posielanie SMS s plánovaným časom/dátumom odoslania
Pre poslanie SMS s plánovaným časom/dátumom odoslania, musíte použiť parameter &date
Dátum musí byť prevedený do timestamp (príklad: &date=1238757304)
Kódovanie SMS správ
Pre nastavenie iného kódovania (predvolené je UTF-8) použite parameter &encoding. (príklad: &encoding=iso-8859-7)
Povolené sú:
'iso-8859-1'
'iso-8859-2'
'iso-8859-3'
'iso-8859-4'
'iso-8859-5'
'iso-8859-7'
'windows-1250'
'windows-1251'
Status odoslanej SMS správy
&points=1 - pridaním parametru získate aktuálnu výšku kreditu
&status=ID - ID správy sa vráti po odoslaní SMS:
Požiadavka: http://smartsms.sk/api/send.do?username=username&password=password&status=17101000100860359
Odpoveď: OK: <NID> - (kód statusu, viď nižšie)
401 - NOT_FOUND - Nesprávne ID správy, alebo report už expiroval
402 - EXPIRED - SMS správa expirovala
403 - SENT - SMS správa bola úspešne poslaná
404 - DELIVERED - SMS správa bola doručená
405 - UNDELIVERED - SMS správu sa nepodarilo doručiť
406 - FAILED - Poslanie SMS správy zlyhalo
407 - REJECTED - Poslanie SMS správy bolo zamietnuté
408 - UNKNOWN - Status SMS správy je neznámy
409 - QUEUED - SMS správa čaká na odoslanie
Chybové hlášky
11 - Správa je príliš dlhá
13 - Nesprávne číslo príjemcu
14 - Nesprávne prihlasovacie meno odosielateľa
15 - Neoverený odosielateľ (tel. číslo)
16 - Neoverený odosielateľ (11 alfanumerických znakov)
17 - Flash SMS nemôžete odosielať so špeciálnymi znakmi
18 - Nesprávny počet parametrov
19 - Príliš veľa príjemcov (maximum je 100)
101Nesprávna autorizácia
102 - Nesprávne prihlasovacie meno alebo heslo
103 - Nedostatok kreditu
301 - ID SMS neexistuje
400 - Nesprávne ID SMS, ktorej zisťujete status
999 - Interná chyba (kontaktujte nás prosím
