email – E-mail del cliente
tpl_id – Identificativo univoco del profilo assegnato
contact – Campo libero “Contatto”
ref_id – Campo libero “Riferimento”
reseller – Può essere impostato a 0 (cliente finale) o 1 (rivenditore, default)
vhost – Dominio associato al rivenditore, sul quale dovranno loggarsi gli eventuali clienti

Il server risponderà con “OK <id>”, ove <id> è l'identificativo numerico assegnato al nuovo cliente, in caso di successo. In caso di errore la risposta del server sarà “KO <testo_errore>”.

N.B. L'accesso è limitato ai soli indirizzi IP o subnet abilitati al servizio back-office.

Assegnazione crediti tramite richiesta POST HTTP

[top]

URL: http://sms.host.tld/backoffice/credit-add.php

Parametri autenticazione:

smsusername – Login amministratore
smspassword – Password amministratore

Parametri obbligatori:

u_id – Identificativo univoco cliente
bill_id – Identificativo univoco tariffa

Parametri opzionali:

credit – Credito, nel formato 12,3456 o 12.3456

Il server risponderà con “OK <id>”, ove <id> è l'identificativo numerico assegnato al nuovo credito, in caso di successo. In caso di errore la risposta del server sarà “KO <testo_errore>”.

N.B. L'accesso è limitato ai soli indirizzi IP o subnet abilitati al servizio back-office.

Controllo crediti tramite richiesta POST HTTP

[top]

[esempio]

URL: http://sms.host.tld/backoffice/credit-get.php

Parametri autenticazione:

smsusername – Login amministratore
smspassword – Password amministratore

Parametri obbligatori:

u_id – Identificativo univoco cliente

Il server risponderà con “OK <credito>”, ove <credito> è il corrispettivo in euro del credito disponibile per il cliente, con 4 cifre decimali e il carattere “.” (punto) come separatore dei decimali (ad es. 123.4567). In caso di errore la risposta del server sarà “KO <testo_errore>”.

N.B. L'accesso è limitato ai soli indirizzi IP o subnet abilitati al servizio back-office.

Controllo operazioni back-office tramite richiesta POST HTTP

[top]

URL: http://sms.host.tld/backoffice/userlog-get.php

Parametri autenticazione:

smsusername – Login amministratore
smspassword – Password amministratore

Parametri obbligatori:

type – Tipologia di operazione (“credits” è l'unica operazione attualmente supportata)

Parametri opzionali:

u_id – Identificativo univoco utente
from – Data inizio report
to – Data fine report

Il server risponderà con un report in cui la prima riga contiene l'intestazione dei campi e le successive i dati. I campi sono a lunghezza variabile separati da tabulazione e le righe sono terminate dai caratteri <CR><LF>. In caso di errore la risposta del server sarà “KO <testo_errore>”.

N.B. L'accesso è limitato ai soli indirizzi IP o subnet abilitati al servizio back-office.

Creazione e assegnazione ricezione tramite richiesta POST HTTP

[top]

URL: http://sms.host.tld/backoffice/recv-add.php

Parametri autenticazione:

smsusername – Login amministratore
smspassword – Password amministratore

Parametri obbligatori:

u_id – Identificativo univoco cliente
dest – Numero di telefono ricezione

Parametri opzionali:

num – Numero di codici da creare (max 20, default 1)

Il server risponderà con “OK <codici>”, ove <codici> è l'elenco dei codici di condivisione creati separati da una virgola. In caso di errore la risposta del server sarà “KO <testo_errore>”.

N.B. L'accesso è limitato ai soli indirizzi IP o subnet abilitati al servizio back-office.

Attivazione / Disattivazione clienti tramite richiesta POST HTTP

[top]

URL: http://sms.host.tld/backoffice/client-status.php

Parametri autenticazione:

smsusername – Login amministratore
smspassword – Password amministratore

Parametri obbligatori:

u_id – Identificativo univoco utente
active – 0 = disattivato / 1 = attivo

l server risponderà con “OK <stato>”, ove <stato> è l'operazione eseguita (Attivato o Disattivato). In caso di errore la risposta del server sarà “KO <testo_errore>”.

N.B. L'accesso è limitato ai soli indirizzi IP o subnet abilitati al servizio back-office.

Invio singolo SMS tramite richiesta POST/GET HTTP

[top]

URL: http://sms.host.tld/sms/send.php

Parametri autenticazione:

user – Login cliente
pass – Password cliente

Parametri obbligatori:

rcpt – Numero destinatario nel formato internazionale +XXYYYZZZZZZZ
data – Testo del messaggio (max 160 caratteri)
sender – Mittente del messaggio (max 11 caratteri alfanumerici o numero +XXYYYZZZZZZZ)
qty – Qualità del messaggio: (ll, h, n – bassa, alta, notifica)

Parametri opzionali:

operation - Tipo di messaggio che si intende spedire ("TEXT" messaggio di testo default, "WAPPUSH" messaggio WapPush)
url - Indirizzo URL al quale si dovrà collegare il cellulare che riceve il messaggio WAPPUSH.
return_id - Se impostato uguale a 1 verrà restituito l'identificativo della spedizione da utilizzare nel caso si richieda lo stato della spedizione tramite post/get http (es. HTTP00000000111).

Il server risponderà con “OK <costo>”, ove <costo> è il credito scalato per l'invio del messaggio. In caso di errore la risposta del server sarà “KO <testo_errore>”.

N.B. L'accesso è limitato ai soli indirizzi IP o subnet abilitati al servizio di invio sms tramite richiesta HTTP.

Invio multiplo SMS tramite richiesta POST/GET HTTP

[top]

URL: http://sms.host.tld/sms/batch.php

Parametri autenticazione:

user – Login cliente
pass – Password cliente

Parametri obbligatori:

rcpt – Elenco numeri nel formato internazionale +XXYYYZZZZZZ, separati da virgola.
data – Testo del messaggio (max 160 caratteri)
sender – Mittente del messaggio (max 11 caratteri alfanumerici o numero +XXYYYZZZZZZZ)

Parametri opzionali:

qty – Qualità del messaggio: (ll, h, n – bassa, alta, notifica)

Il server risponderà con “OK”. In caso di errore la risposta del server sarà “KO <testo_errore>”.

N.B. L'accesso è limitato ai soli indirizzi IP o subnet abilitati al servizio di invio sms tramite richiesta HTTP.

Controllo credito / SMS rimanenti tramite richiesta POST/GET HTTP

[top]

URL: http://sms.host.tld/sms/credit.php

Parametri autenticazione:

user – Login cliente
pass – Password cliente

Parametri opzionali:

type – Tipo di controllo (“credit” credito residuo – default –, “lqs” messaggi bassa qualità, “hqs” messaggi alta qualità)

Il server risponderà con “OK <valore>”, ove <valore> è il numero di sms o il credito residuo in euro, a seconda del parametro type specificato. In caso di errore la risposta del server sarà “KO <testo_errore>”.

N.B. L'accesso è limitato ai soli indirizzi IP o subnet abilitati al servizio di invio sms tramite richiesta HTTP.

Controllo messaggi ricevuti tramite Web Service SOAP

[top]

I file da utilizzare sono due:

lib-nusoap.inc.php (scarica)
ws.php (scarica)

Ambedue i file vanno messi sotto la stessa path e il primo viene richiamato all'interno del secondo. Il primo fiel (lib-nusoap.inc.php) non é altro che una libreria php che permette di effettuare la chiamata soap. Il secondo (ws.php) é lo script contenente i paramentri per la chiamata.

Riportiamo di seguito il codice del secondo file (ws.php) :

<?php
$host = 'sms1.consultingweb.it'; // Host
$user = ''; // Username
$pass = ''; // Password
$rcpt = '+393202043297'; // Numero
$code = 'xxxx'; // Cod. condivisione
$mess = 10; // N. messaggi

require('./lib-nusoap.inc.php');

$client = new soapclient('http://'.$host.'/wsdl/?wsdl', true);

$err = $client->getError();
if ($err)
{
echo '<h2>Constructor error</h2><pre>' . $err . '</pre>';
exit;
}

$result = $client->call('receiveSms', array($user, $pass, $rcpt, $code, $mess));

if ($client->fault)
{
echo '<h2>Fault</h2><pre>';
print_r($result);
echo '</pre>';
}
else
{
$err = $client->getError();
if ($err)
{
echo '<h2>Error</h2><pre>' . $err . '</pre>';
exit;
}
}

echo '<h2>Result</h2><pre>';
print_r($result);
echo '</pre>';

?>

Verifica MNC tramite richiesta POST HTTP

[top]

I file da utilizzare sono tre:

lib-scriptsms.inc.php (scarica)
SendMNC.php (scarica)
Status.php (scarica)

Tutti e tre i file vanno messi sotto la stessa path e il primo viene richiamato all'interno del secondo e del terzo.
Il primo file (lib-scriptsms.inc.php) non é altro che una libreria php che permette di effettuare la verifica MNC.
Il secondo (SendMNC.inc.php) é lo script contenente i paramentri per la chiamata MNC.
Il terzo script verifica lo status.
Dato che la chiamata MNC è asicnrona è necessario salvare il risultato della verifica MNC su di un file testuale (mnc.txt) che poi verrà letto dal terzo script Status.php il quale darà in output il risultato.
Il file mnc.txt viene sovrascritto ogni volta che viene eseguita una verifica MNC in modo da memorizzare solo l'ultima ricerca (questo per semplicità) ma può anche essere scritto in append ovviamente si dovrà modificare a quel punto anche Status.php per la lettura.

Riportiamo di seguito il codice del secondo file (SendMNC.php) :

<?php
require('./lib-scriptsms.inc.php');
$sms = new mobytSms('username', 'password'); //credenziali del servizio sms
$sms->setDomain('http://sms1.consultingweb.it');
$result = $sms->sendMNC('+3933811111111,+393382222222',1);//numeri da verificare
if (substr($result, 0, 2) == 'OK') {
echo 'Richiesta inviata correttamente'.$result;
$file = "./mnc.txt";
$handle = fopen($file,"w+");
fwrite($handle, $result);
fclose($handle);
}
else
{ echo 'Richiesta NON inviata correttamente'.$result;}
?>

Nota: all'interno della funzione sendMNC(....) vanno messi tutti i numeri da verificare separati da virgola

Riportiamo di seguito il codice del terzo file (Status.php) :

<?php
// Verifica stato della spedizione
require('./lib-scriptsms.inc.php');
$sms = new mobytSms('userename', 'password');//credenziali del servizio sms
$sms->setDomain('http://sms1.consultingweb.it');
$file = "./mnc.txt";
$handle = fopen($file,"r+");
$contents = fread($handle, filesize($file));
$stato = trim(strstr($contents,' '));
$result = $sms->sendStatus($stato,'mnc');
if (substr($result, 0, 2) == 'KO')
echo 'Richiesta NON inviata correttamente'.$result;
else
echo $result;
?>

Controllo stato spedizioni tramite richiesta POST/GET HTTP

[top]

Ad oggi è possibile controllare lo stato delle spedizioni tramite script, di seguito riportiamo i parametri necessari:

URL da invocare:
http://sms.host.tld/sms/batch-status.php

Parametri autenticazione:
user Login cliente
pass Password cliente

Parametri obbligatori:
id Identificativo della spedizione (request_id specificato al momento dell'invio della richiesta)
type Tipo di report desiderato (queue = stato accodamento messaggi, notify = stato delle notifiche dei messaggi inviati, mnc = stato delle richieste MNC)
schema Schema del report (1 Ã¨ 'unico schema attualmente supportato).

Il server risponderà con i dati del report richiesto in formato CSV con i campi separati da virgola,
dove la prima riga conterrà i nomi delle colonne.
In caso di errore la risposta del server sarà KO <testo_errore>.

Codici errore:
- KO Accesso non consentito (Utente non abilitato).
- KO Accesso non consentito (IP non abilitato).
- KO Parametro <nome parametro> non impostato.
- KO Parametro <nome parametro> non corretto.
- KO Errore interno.
- KO Accesso non consentito.
- KO Parametri non corretti.

Di seguito riportiamo il codice di esempio:

<?php
var_dump(httpPost(array(
'user' => 'xxx',
'pass' => 'xxx',
'id' => 'xxxxxxxx',
'type' => 'notify',
'schema' => '1'
),
'sms.suodominio'
));
function httpPost($fields, $host = 'sms.suodominio', $url = '/sms/batch-status.php')
{
$qs = array();
foreach ($fields as $k => $v)
$qs[] = $k.'='.urlencode($v);
$qs = join('&', $qs);
$errno = $errstr = '';
if ($fp = @fsockopen('sms.suodominio', 80, $errno, $errstr, 30))
{
fputs($fp, "POST ".$url." HTTP/1.0\r\n");
fputs($fp, "Host: ".$host."\r\n");
fputs($fp, "User-Agent: PHP/".phpversion()."\r\n");
fputs($fp,
"Content-Type:application/x-www-form-urlencoded\r\n");
fputs($fp, "Content-Length: ".strlen($qs)."\r\n");
fputs($fp, "Connection: close\r\n");
fputs($fp, "\r\n".$qs);
$content = '';
while (!feof($fp))
$content .= fgets($fp, 1024);
fclose($fp);
return preg_replace("/^.*?\r\n\r\n/s", '', $content);
}
return false;
}
?>

NOTA: Il batch va copiato interamente senza alterare nulla tranne i tre parametri necessari:
'user' => 'xxx',
'pass' => 'xxx',
'id' => 'xxxxxxxx',

IMPORTANTE : l'id della spedizione è da intendersi nella forma : HTTP000xxxxxxxx
dove le cifre dopo la stringa 'HTTP' devono essere in tutto 11.
Quindi nel caso l'id di spedizione sia : 1342788, il parametro da specificare nello script sarà:
'id' => 'HTTP00001342788', (aggiungiamo quattro zeri dato che l'id e' di 7 cifre).

Invio singolo SMS - codice PHP

[top]

Esempio di script in linguaggio PHP per l'invio degli SMS dal sito:

Questo script in PHP permette di effettuare l'invio di SMS tramite comando POST HTTP. Se il dominio non è gestito da noi è necessario che ci venga comunicato l'IP del server da cui proverranno i POST. Questo IP non coincide necessariamente con il www.delsuodominio quindi le richiesta di informazione da inoltrare al vostro provider è :

Quale è l'IP con cui escono i POST fatti tramite script residenti sul mio spazio web ?

Una volta in possesso di tale IP lo comunicate a noi affinchè possiamo abilitarlo.

Dove trovate la riga "sms.suodominio" essa va sostituita con :

"sms1.consultingweb.it" se vengono utilizzati i dati reseller da noi inviati
"sms.nomedelsuodominio" se l'inoltro viene effettuato con utenti da lei creati tramite pannello sms1.consultingweb.it con i dati reseller da noi inviati.

E' disponibile anche un esempio in ASP.

<?php

var_dump(httpPost(array(
'user' => 'xxx',
'pass' => 'xxx',
'rcpt' => '+39xxxx',
'data' => 'testo del messaggio',
'sender' => 'mittente',
'qty' => 'h'
),
'sms.suodominio'
));

function httpPost($fields, $host = 'sms.suodominio', $url =
'/sms/send.php')
{
$qs = array();
foreach ($fields as $k => $v)
$qs[] = $k.'='.urlencode($v);
$qs = join('&', $qs);

$errno = $errstr = '';
if ($fp = @fsockopen('sms.suodominio', 80, $errno, $errstr,
30))
{
fputs($fp, "POST ".$url." HTTP/1.0\r\n");
fputs($fp, "Host: ".$host."\r\n");
fputs($fp, "User-Agent: PHP/".phpversion()."\r\n");
fputs($fp,
"Content-Type:application/x-www-form-urlencoded\r\n");
fputs($fp, "Content-Length: ".strlen($qs)."\r\n");
fputs($fp, "Connection: close\r\n");
fputs($fp, "\r\n".$qs);

$content = '';
while (!feof($fp))
$content .= fgets($fp, 1024);

fclose($fp);

return preg_replace("/^.*?\r\n\r\n/s", '', $content);
}

return false;
}

?>

Invio muliplo/singolo SMS - codice ASP

[top]

Esempio di script in linguaggio ASP per l'invio degli SMS dal sito:

Questo esempio contiene il codice necessario per creare una form in HTML ed uno script
in ASP (Active Server Pages) che effettua l'invio singolo o multiplo degli SMS tramite
comando HTTP POST.

Se il dominio non è gestito presso CONSULTINGWEB è necessario comunicare all'assistenza
tecnica CONSULTING l'indirizzo IP del server da cui proverranno i POST.

L'indirizzo IP da comunicare non coincide necessariamente con il www.delsuodominio
quindi la richiesta di informazione da inoltrare al vostro provider è :

Quale è l'IP con cui escono i POST fatti tramite script residenti sul mio spazio web ?

Una volta in possesso di tale IP lo comunicate a noi affinchè possiamo abilitarlo.

Dove trovate la riga "sms.suodominio" essa va sostituita con :

"sms1.consultingweb.it" se vengono utilizzati i dati reseller da noi inviati
"sms.nomedelsuodominio" se l'inoltro viene effettuato con utenti da lei creati tramite pannello sms1.consultingweb.it con i dati reseller da noi inviati.

E' disponibile anche un esempio in PHP.

FORM da denominare "form.htm" che invoca lo script ASP

SCRIPT ASP: invia.asp

Questo script insieme al form di cui sopra è testato per INVIO SINGOLO e per INVIO MULTIPLO a seconda di quello che viene immesso nel campo : 'Immetti N°dest' del form di cui sopra. Il campo rcpt per invio singolo - numero nel formato internazionale +XXYYYZZZZZZ. Esempio: +39-<prefisso>-<numero>
Il campo rcpt per invii multipli - Elenco numeri nel formato internazionale +XXYYYZZZZZZ, separati da virgola. La variabile SMSarray è un flag per vedere se si tratta di invio singolo o multiplo. rcptarr è lo split di rcpt nel caso il campo rcpt (cioè il campo che contiene il numero di destinazione) contiene più numeri. sms1.consultingweb.it è la url da usare in tutti quei casi in cui l'utente che sta effettuando l'invio è l'account rivenditore. Per utenti finali, creati dall'account rivenditore tramite il pannello sms1.consultingweb.it, la URL è: sms.miodominio.ext
Se non si rispettano l'uso delle URL a seconda dell'utente che invia, l'inoltro non avrà buon esito.

Controllo credito residuo SMS - codice PHP

[top]

Si puà controllare il credito residuo di SMS tramite script?

SI. Per avvalersi della possibilità di sfruttare il controllo crediti SMS tramite 'batch' ci occorre inanzitutto una richiesta via email da parte del cliente, e laddove il dominio non è gestito presso CONSULTINGWEB ci deve specificare anche l'IP da cui proverranno i POST dello script in questione (da domandare al proprio Provider, come specificato nella email di attivazione).

Ricevuta tale email diamo seguito all'abilitazione dell'utente a tale servizio.

### IMPORTANTE ###

Con tale script si possono controllare i crediti residui dei clienti creati dall'utente reseller (tramite pannello sms1.consultingweb.it o batch) e NON il credito del reseller stesso il quale DEVE avvalersi del pannello sms http://sms1.consultingweb.it per tale informazione.

###### ESEMPIO DI SCRIPT PER IL CONTROLLO DEL CREDITO ######

<?php
var_dump(httpPost(array(
'smsusername' => 'utente_reseller',
'smspassword' => 'password',
'u_id' => 'u_id del cliente creato',
),
'sms1.consultingweb.it'
));
function httpPost($fields, $host = 'sms1.consultingweb.it', $url =
'http://sms1.consultingweb.it/backoffice/credit-get.php')
{
$qs = array();
foreach ($fields as $k => $v)
$qs[] = $k.'='.urlencode($v);
$qs = join('&', $qs);
$errno = $errstr = '';
if ($fp = @fsockopen('sms1.consultingweb.it', 80, $errno, $errstr, 30))
{
fputs($fp, "POST ".$url." HTTP/1.0\r\n");
fputs($fp, "Host: ".$host."\r\n");
fputs($fp, "User-Agent: PHP/".phpversion()."\r\n");
fputs($fp,
"Content-Type:application/x-www-form-urlencoded\r\n");
fputs($fp, "Content-Length: ".strlen($qs)."\r\n");
fputs($fp, "Connection: close\r\n");
fputs($fp, "rn".$qs);
$content = '';
while (!feof($fp))
$content .= fgets($fp, 1024);
fclose($fp);
return preg_replace("/^.*?\r\n\r\n/s", '', $content);
}
return false;
}
?>

#################### FINE ESEMPIO ####################

NOTA: Il batch va copiato interamente senza alterare nulla a meno dei tre parametri necessari:

'smsusername' => 'utente_reseller',
'smspassword' => 'password',
'u_id' => 'u_id del cliente creato'

- smsusername e smspassword sono i dati di accesso al servizio sms comunicati nell'attivazione
- u_id lo si ricava entrando con i suddetti dati nel pannello : http://sms1.consultingweb.it cercando il cliente creato di cui si vuole effettuare il controllo crediti.

Una volta trovato cliccare sul link relativo: 'Dettagli'. A quel punto comparirà una pagina bianca con in alto una scritta del tipo:

>>clienti>>[idXXXXX] nome_utente>>Dettagli

dove le cinque cifre XXXXX rappresentano l' u_id

Ordina SMS: www.consultingweb.it/servizi/sms-mms.php

Assegnazione credito SMS - codice PHP

[top]

Si puo' assegnare un credito di SMS tramite script?

##### ESEMPIO DI SCRIPT PER ASSEGNAZIONE DEL CREDITO #####

<?php
var_dump(httpPost(array(
'smsusername' => 'username_reseller',
'smspassword' => 'password_reseller',
'u_id' => 'customer ID',
'bill_id' => 'sms-fee ID',
'credit' => 'credit_amount',

),
'sms1.consultingweb.it'
));
function httpPost($fields, $host = 'sms1.consultingweb.it', $url =
'http://sms1.consultingweb.it/backoffice/credit-get.php')
{
$qs = array();
foreach ($fields as $k => $v)
$qs[] = $k.'='.urlencode($v);
$qs = join('&', $qs);
$errno = $errstr = '';
if ($fp = @fsockopen('sms1.consultingweb.it', 80, $errno, $errstr, 30))
{
fputs($fp, "POST ".$url." HTTP/1.0rn");
fputs($fp, "Host: ".$host."rn");
fputs($fp, "User-Agent: PHP/".phpversion()."rn");
fputs($fp,
"Content-Type:application/x-www-form-urlencodedrn");
fputs($fp, "Content-Length: ".strlen($qs)."rn");
fputs($fp, "Connection: closern");
fputs($fp, "rn".$qs);
$content = '';
while (!feof($fp))
$content .= fgets($fp, 1024);
fclose($fp);
return preg_replace("/^.*?rnrn/s", '', $content);
}
return false;
}

?>

################### FINE ESEMPIO ###################

ESITO: Il server risponderà con "OK <id>", ove <id> è l'identificativo numerico assegnato al nuovo credito, in caso di successo. In caso di errore la risposta del server sarà "KO <testo_errore>".

Copyright © 1999-2010 © ALICOM SRL (Unipersonale) | Via Pietro Nenni, n.294 - 66020 S. Giovanni Teatino (CH)
P.IVA e C.F.: 01804720694 | Reg. delle Imprese di Chieti N° 01804720694 | Capitale Sociale Euro 10.002,00 i.v. | R.E.A. : 0129640

consultingweb-sms tramite script

DESTINATARI: programmatori/sistemisti utenti del servizio SMS

Elenco delle funzioni degli SMS richiamabili tramite richieste HTTP POST o GET

Esempi:

Creazione clienti tramite richiesta POST HTTP

Assegnazione crediti tramite richiesta POST HTTP

Controllo crediti tramite richiesta POST HTTP

Controllo operazioni back-office tramite richiesta POST HTTP

Creazione e assegnazione ricezione tramite richiesta POST HTTP

Attivazione / Disattivazione clienti tramite richiesta POST HTTP

Invio singolo SMS tramite richiesta POST/GET HTTP

Invio multiplo SMS tramite richiesta POST/GET HTTP

Controllo credito / SMS rimanenti tramite richiesta POST/GET HTTP

Controllo messaggi ricevuti tramite Web Service SOAP

Verifica MNC tramite richiesta POST HTTP

Controllo stato spedizioni tramite richiesta POST/GET HTTP

Invio singolo SMS - codice PHP

Invio muliplo/singolo SMS - codice ASP

Controllo credito residuo SMS - codice PHP

Assegnazione credito SMS - codice PHP