HTTP API - ação 'sendmessage'

Este comando da API HTTP pode ser usado para enviar uma mensagem SMS através do Gateway SMS. O comando pode ser usado para enviar mensagens SMS de texto ou outros tipos de mensagens, como mensagens SMS binárias, logos de operadora, toques, WAP PUSH, etc... Ao usar este comando, você deve utilizar um nome de usuário e senha da API HTTP, deve especificar o número de telefone do destinatário e o texto da mensagem.

Para enviar um SMS, use o seguinte formato de URL:

https://127.0.0.1:9508/api?action=sendmessage&username=UUUUU&password=PPPPP&
recipient=NNNNN&messagetype=MMMMM&messagedata=DDDDD

127.0.0.1 é um IP local, portanto, substitua-o pelo endereço IP ou nome do computador com o Ozeki SMS Gateway instalado. (Observação: 127.0.0.1 é um endereço de loopback local que pode ser usado quando você está se conectando ao Gateway SMS a partir do mesmo computador.) 9508 é a porta padrão da API HTTP do Ozeki SMS Gateway. Este número de porta pode ser visualizado e editado na interface do usuário do Ozeki 10 SMS Gateway, clicando no botão Avançado na barra de ferramentas.

"UUUUU" e "PPPPP" devem ser substituídos pelo nome de usuário e senha do usuário que você criou no gateway SMS.

Substitua "NNNNN" pelo número de telefone para o qual deseja enviar a mensagem SMS. Você pode usar o formato de número de telefone local, bem como formatos de número de telefone internacionais (números de telefone formatados de acordo com o formato internacional sempre começam com um sinal '+'). Se o formato de número de telefone internacional for usado, observe que você deve substituir '%2B' pelo caractere '+', devido às regras de codificação de URL.

Substitua "MMMMM" pelo tipo de mensagem. O tipo de mensagem "SMS:TEXT" deve ser usado para mensagens de texto.

Os dados da mensagem contêm a mensagem que você deseja enviar. Coloque os dados da mensagem no lugar de "DDDDD". Os dados da mensagem devem estar em caracteres UTF-8 e devem ser codificados em URL.

Outros parâmetros também podem ser adicionados à solicitação.
Para uma lista completa dos parâmetros disponíveis, consulte a tabela 'Parâmetros da solicitação' abaixo:

https://127.0.0.1:9508/api?action=sendmessage&username=admin&password=abc123&
recipient=06203105366&messagetype=SMS:TEXT&messagedata=Hello+World

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 246

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE smsapi PUBLIC "-//OZEKI//DTD XML 1.0//EN" "http://www.ozekisms.com/DTD/smsapi.xml">
<response>
   <action>sendmessage</action>
   <data>
      <acceptreport>
         <statuscode>0</statuscode>
         <statusmessage>Mensagem aceita para entrega</statusmessage>
         <messageid>ERFAV23D</messageid>
         <recipient>06203105366</recipient>
      </acceptreport>
   </data>
</response>

Parâmetros de requisição HTTP

Parâmetros de resposta
(formato de resposta xml)

<acceptreport>
   <statuscode>0</statuscode>
   <statusmessage>Mensagem aceita para entrega</statusmessage>
   <messageid>ERFAV23D</messageid>
   <recipient>06203105366</recipient>
</acceptreport>

Este artigo foi sobre a ação 'sendmessage' da API HTTP. Com esta ação, você pode enviar mensagens de texto SMS e muitos outros tipos de mensagens para qualquer destinatário através do Ozeki SMS Gateway. Você viu exemplos de respostas e algumas requisições HTTP adicionais com descrição, valores possíveis e exemplos.

Se você gostaria de saber mais sobre o status de entrega de suas mensagens, sinta-se à vontade para clicar na página sobre status de entrega de SMS. Se você gostaria de obter um modelo de URL, visite a página correspondente.

Se você gostaria de usar esta solução em situações reais, baixe o Ozeki SMS Gateway e comece a usá-lo agora!