Como enviar um SMS a partir da API LWS

Procédure

O que é uma API e porquê utilizá-la?

API significa "Application Programming Interface" (Interface de Programação de Aplicações). Trata-se de um conjunto de meios utilizados por uma aplicação e/ou plataforma de software para dar acesso a algumas das suas funcionalidades.

Atualmente, as API são muito utilizadas na Internet, nomeadamente pelos fornecedores de serviços ou de dados, como o serviço SMS.

Graças às API, pode utilizar o seu próprio script para enviar um SMS instantaneamente ou num momento posterior.

Como enviar um SMS utilizando a API LWS

Enviar um SMS através de uma simples chamada:

Para enviar um SMS de forma rápida e simples, basta enviar um pedido HTTPS com os seus parâmetros para o seguinte endereço:

https://sms.lws.fr/sms/api?action=send-sms&api_key=SMS_API_KEY=&to=DESTINATAIRE&from=SenderID&sms=VOTRE_MESSAGE

Os dados a substituir são os seguintes:

• SMS_API_KEY: É a sua chave API, à qual pode aceder na secção "API SMS" do seu espaço SMS.
• RECIPIENTE: É o número de telefone do destinatário em formato internacional
• SenderID: é o seu identificador de remetente
• YOUR_MESSAGE: conteúdo do SMS

Utilizar a API PHP:

Pode enviar um SMS utilizando uma API PHP:

<?php /* Preparar as variáveis */ /* Url da API */ $gateway_url = "https://sms.lws.fr/sms/api"; /* Ação chamada através da API */ $action = "send-sms"; /* Chave da API */ $apiKey = "A sua chave da API"; /* Número para o qual o SMS será enviado * Formato internacional - exemplo 33600000000 */ $to = "33600000000"; /* SenderID que será apresentado no telemóvel. */ $senderID = "Your SenderID"; /* Codifica a mensagem na versão SMS que será enviada */ $message = urlencode("This is a test message"); // Prepara a matriz de dados para o pedido API $data = matriz('action' => $action, 'api_key' => $apiKey, 'to' => $to, 'from' => $senderID, 'sms' => $message, ); // Enviar o pedido API via cURL $ch = curl_init($gateway_url); curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); curl_close($ch); $get_data = json_decode($response, true); /* O retorno é processado.
 * get_data['code'] recupera um código de acordo com o sucesso ou o erro da API get_data['Message'] recupera a mensagem Success ou a explicação do erro.
 */ if($get_data['code'] === 'ok'){ echo 'O SMS foi enviado com sucesso'; } else { echo 'Código de erro : '.$get_data['code'].' -- '.$get_data['message']; } ?>

• A sua chave API: Esta deve ser a chave API que gerou na plataforma SMS.
• O número de telefone do destinatário: Este é o número do destinatário da mensagem SMS.
• O seu nome de remetente: é o seu SenderID, que pode ser criado na plataforma SMS
• A sua mensagem: A mensagem que vai enviar por SMS

Códigos de erro possíveis :

100: Problema com o operador;
103 : Número de telefone inválido;
105 : Utilização de uma palavra proibida;
106 : SenderID inválido ou não validado;
107 : Problema de digitação do SMS;
112: Número colocado na lista negra ou API não disponível;

Como enviar um SMS diferido a partir da API LWS

Enviar um SMS através de uma simples chamada:

https://sms.lws.fr/sms/api?action=send-sms&api_key=SMS_API_KEY=&to=DESTINATAIRE&from=SenderID&sms=VOTRE_MESSAGE&schedule=DATE_HEURE

• SMS_API_KEY: Deve ser substituída pela sua chave API
• DESTINATORY: deve ser substituído pelo número do destinatário da mensagem
• SenderID: deve ser substituído pelo nome do remetente
• YOUR_MESSAGE: deve ser substituído pela sua mensagem
• DATE_TIME: deve ser substituído pela data e hora de envio. Pode converter a data e a hora visitando o sítio Timestamp.

Apresentação das funções da API LWS ligadas à plataforma SMS

Conclusão

Pode agora criar a sua própria API utilizando a plataforma SMS do LWS. Pode usar uma API para enviar um SMS instantaneamente ou num momento posterior. A API também lhe permitirá ver quanto crédito ainda tem na sua conta.

Não hesite em partilhar os seus comentários e perguntas!