API WEBSERVICE SMS

Download documentação API LusoSMS
Download documentação API LusoSMS

Código HTTP GET que pode usar na sua programação para enviar SMS´s.

Deve substituir com os seus dados:
telefonedeorigem
telefonededestino
mensagemaenviar
seuusername
suapassword
mensagemlonga (0 até 155 caracteres, 1 até 300 caracteres)
tipo (normal ou flash)

NOTA: Os espaços da mensagem devem ser substituídos pelo sinal + e a mensagem não deve exceder 155 caracteres se “mensagemlonga=0” ou 300 caracteres se “mensagemlonga=1”, se a mensagem tiver mais de 155 caracteres serão cobrados os créditos relativos a 2 sms’s. O parâmetro “tipo” refere-se ao tipo de mensagem a enviar, pode ser normal ou flash, a mensagem flash é uma mensagem que aparece aberta no telemóvel do destinatário, mas só será guardada se o destinatário assim entender.

Exemplo:
http://www.lusosms.com/enviar_sms_get.php?
username=seuusername&password=suapassword
&origem=telefonedeorigem&destino=telefonededestino
&mensagem=mensagem+a+enviar&mensagemlonga=0&tipo=normal


Código HTTP GET que pode usar na sua programação para verificar o seu crédito.

Deve substituir com os seus dados:
seuusername
suapassword

Mensagens de retorno:

autenticacao_invalida
sintaxe_invalida
x (x será o crédito)

Exemplo:
http://www.lusosms.com/ver_credito_get.php?username=seuusername
&password=suapassword


Exemplo de uma função que pode usar na sua programação PHP para enviar SMS´s.

Click aqui para fazer o download


Exemplo de um formulário em php que pode usar no seu site para enviar SMS´s (faz uso da função acima).

Click aqui para fazer o download


Instruções para utilização de HTTP POST.

URL: http://www.lusosms.com/enviar_sms_post.php

Variáveis HTTP POST:
username
password
mensagem
origem
destino
mensagemlonga (1 ou 0)
tipo (normal ou flash)

Click aqui para fazer download de form simples em html

NOTA: A mensagem não deve exceder 155 caracteres se “mensagemlonga=0” ou 300 caracteres se “mensagemlonga=1”, se a mensagem tiver mais de 155 caracteres serão cobrados os créditos relativos a 2 sms’s. O parâmetro “tipo” refere-se ao tipo de mensagem a enviar, pode ser normal ou flash, a mensagem flash é uma mensagem que aparece aberta no telemóvel do destinatário, mas só será guardada se o destinatário assim entender.


Mensagens de retorno HTTP GET ou HTTP POST.

erro_comunicacao
credito_insuficiente
autenticacao_invalida
sintaxe_invalida
caracteres_excedidos
mensagem_enviada


Sintaxe HTTP GET para agendar o envio de SMS´s.

Deve substituir com os seus dados:
telefonedeorigem
telefonededestino
mensagemaenviar
seuusername
suapassword
mensagemlonga (0 até 155 caracteres, 1 até 300 caracteres)
tipo (normal ou flash)
dataenvio (AAAA|MM|DD|HH|MM)

Exemplo:
http://www.lusosms.com/agendar_sms_get.php?username=seuusername
&password=suapassword&origem=telefonedeorigem&destino=telefonededestino
&mensagem=mensagem+a+enviar&mensagemlonga=0&tipo=normal
&dataenvio=AAAA|MM|DD|HH|MM

NOTA: Os espaços da mensagem devem ser substituídos pelo sinal + e a mensagem não deve exceder 155 caracteres se “mensagemlonga=0” ou 300 caracteres se “mensagemlonga=1”, se a mensagem tiver mais de 155 caracteres serão cobrados os créditos relativos a 2 sms’s. O parâmetro “tipo” refere-se ao tipo de mensagem a enviar, pode ser normal ou flash, a mensagem flash é uma mensagem que aparece aberta no telemóvel do destinatário mas só será guardada se o destinatário assim entender.
O parâmetro “dataenvio” indica o dia e a hora em que a mensagem será enviada, este parâmetro deverá ter o seguinte formato “AAAA|MM|DD|HH|MM” em que AAAA é o ano, MM é o mês, DD é o dia, HH é a hora e MM são os minutos. Exemplo: para enviar a 2014/04/01 às 18 horas e 26 minutos o parametro “dataenvio” ficará com o seguinte formato “dataenvio=2014|04|01|18|26”. Só é possível agendar o envio de sms’a para uma data anterior ao final do ano seguinte do corrente ano.

Mensagens de retorno HTTP GET ao agendar o envio de SMS´s.

mensagem_agendada
autenticacao_invalida
sintaxe_invalida
caracteres_excedidos
data_invalida

Uma destas mensagens aparece em texto simples após agendar ou tentativa de agendar um envio da sms por HTTP GET.

Gestão das SMS´s agendadas.

Pode gerir as sms’s agendadas através do seguinte endereço:

http://www.lusosms.com/gerir_agendados.php?username=seuusername&password= suapassword