Como enviar uma mensagem SMS agendada usando a API HTTP

Este guia ajuda você a entender como enviar mensagens SMS agendadas usando a API HTTP. Com esta solução, você pode definir a data exata em que deseja enviar a mensagem. O documento contém um tutorial em vídeo e um guia passo a passo onde cada etapa consiste em uma breve descrição do passo atual e uma captura de tela para demonstrar o que você precisa fazer. Para completar este guia, você não precisa ter nenhum conhecimento específico e não leva mais de dez minutos para concluir. Então, vamos começar agora mesmo!

Tutorial em vídeo

Vídeo 1 - Como enviar uma mensagem SMS agendada usando a API HTTP (Tutorial em vídeo)

Passo 1 - Criar usuário HTTP

No primeiro passo, você precisa criar a conexão do usuário HTTP. Para isso, abra o menu Aplicativos na barra de ferramentas e, aqui, na seção Usuários de rede, clique no botão Instalar do usuário HTTP. Para começar a configurar um usuário HTTP, forneça um nome de usuário e uma senha para o usuário da API HTTP, como você pode ver na Figura 1. Essas informações podem ser usadas para acessar o sistema através da API HTTP.

criar usuário http ozeki sms gateway
Figura 1 - Criar usuário HTTP do Ozeki SMS Gateway

Passo 2 - Requisição HTTP para enviar mensagem

Depois de criar a conexão do usuário HTTP, basta abrir a conexão para ver a página de detalhes da conexão. Aqui, você precisa navegar até a aba Teste, onde pode enviar uma requisição HTTP para enviar uma mensagem SMS através do Ozeki SMS Gateway. Adicione à requisição o parâmetro sendondate, onde você pode definir quando a mensagem será enviada pelo Ozeki SMS Gateway, como demonstra a Figura 2. Para iniciar a requisição HTTP, basta clicar no botão Enviar. Você pode encontrar este comando aqui:

command=SendMessage&Username=HTTP_User_1&Password=qwe123&Recipient=06203105366&
MessageType=SMS:TEXT&MessageData=Hello+World&sendondate=2020-08-26 08:31:00

enviar mensagem requisição http
Figura 2 - Requisição HTTP para enviar mensagem

Passo 3 - Mensagem aceita pelo Ozeki SMS Gateway

Depois de clicar no botão Enviar e iniciar a requisição HTTP, você poderá ver a mensagem de resposta do Ozeki SMS Gateway, como mostra a Figura 3 abaixo. Esta mensagem de resposta contém o código de status e a mensagem de status. Esta mensagem deve indicar que a mensagem foi aceita para entrega. Se a mensagem for aceita, ela será colocada na pasta de saída.

mensagem aceita
Figura 3 - Mensagem aceita

Passo 4 - Mensagem na pasta de saída

A mensagem aceita é armazenada na pasta de saída da conexão do usuário HTTP. Antes da data de envio, ela pode ser encontrada na lista da aba Adiadas, como você pode ver na Figura 4. Neste ponto, ela aguarda para atingir a data de envio e ser entregue.

mensagem na pasta de saída
Figura 4 - Mensagem na pasta de saída

Passo 5 - Tags da mensagem

Na lista de mensagens adiadas, você pode clicar na mensagem selecionada para ver os detalhes dela. Aqui, você pode selecionar a aba Tags, como mostra a Figura 5. Esta aba fornece as principais tags que descrevem os detalhes da mensagem. Aqui, você pode ver a tag sendondate, que mostra a data em que a mensagem será enviada pelo SMS Gateway.

tags da mensagem
Figura 5 - Tags da mensagem

Passo 6 - Mensagem enviada na data selecionada

Assim que a data de envio chegar, a conexão do usuário HTTP envia a mensagem para o destinatário especificado. Se você quiser verificar se a entrega foi bem-sucedida, pode verificar o menu Eventos da conexão do usuário HTTP. Para isso, selecione o menu Eventos como na Figura 6, e aqui, você poderá ver os eventos da mensagem. Cada evento contém um timestamp e uma descrição simples sobre o evento em si.

mensagem enviada na data
Figura 6 - Mensagem enviada na data

More information