Como agendar um SMS em PHP

A maneira mais simples de enviar SMS a partir do PHP é usar a API HTTP/Rest de SMS integrada do Ozeki SMS Gateway. Ao usar esta API, você enviará mensagens SMS fazendo uma requisição HTTP Post para o gateway de SMS. A requisição HTTP Post conterá uma mensagem formatada em formato json. O gateway de SMS enviará este SMS para o telefone do destinatário e retornará uma resposta HTTP 200 OK para a sua requisição.

O exemplo de código PHP para SMS abaixo demonstra como você pode enviar SMS usando a API HTTP Rest de SMS do Ozeki SMS Gateway com a biblioteca PHP Ozeki.Libs.Rest. Esta biblioteca é fornecida gratuitamente, e você pode usá-la e modificá-la em qualquer um dos seus projetos.

namespace Ozeki_PHP_Rest
{
require 'MessageApi/MessageApi.php';

		$configuration = new Configuration();
		
		$configuration -> Username = "http_user";
		$configuration -> Password = "qwe123";
		$configuration -> ApiUrl = "http://127.0.0.1:9509/api";
		
		$msg = new Message();
		
		$msg -> ToAddress = "+36201111111";
		$msg -> Text = "Olá, Mundo!";
		$msg -> TimeToSend = "2021-06-23 16:18:00";
			
		$api = new MessageApi($configuration);
		
		$result = $api -> SendSingle($msg);	
		
		echo strval($result);
}		

Como usar o exemplo de SMS em PHP:

Este exemplo de SMS em PHP pode ser usado em qualquer aplicação PHP. Para usá-lo, você deve adicionar a pasta MessageApi ao seu projeto. Você pode usar a classe Message para criar o SMS e pode usar a classe MessageApi para enviar o SMS para o gateway de SMS. O gateway de SMS encaminhará sua mensagem para a rede móvel através de uma conexão sem fio ou pela Internet.

O código-fonte explicado neste artigo pode ser baixado, usado e modificado gratuitamente.
Download: Send-schedule-SMS.zip (5.9Kb)

O arquivo SendSMS.zip contém a biblioteca Ozeki.Libs.Rest.Php, que fornece todas as ferramentas necessárias para enviar e receber mensagens SMS. Você também encontrará o projeto SendScheduleSms no zip, que contém o código de exemplo para mostrar como enviar um SMS. Este código de exemplo está listado abaixo.

Para enviar SMS a partir do PHP:

1. Instale o Ozeki SMS Gateway
2. Conecte o Ozeki SMS Gateway à rede móvel
3. Envie um SMS de teste a partir da interface gráfica do Ozeki
4. Crie um usuário da API HTTP de SMS
5. Inicie o servidor Wamp
6. Baixe o exemplo acima
7. Crie o SMS criando um novo objeto Message
8. Use o método SendSingle para enviar sua mensagem
9. Leia a resposta HTTP
10. Verifique os logs no gateway de SMS

Para poder enviar SMS a partir do PHP, primeiro você precisa instalar o Ozeki SMS Gateway. O gateway de SMS pode ser instalado no mesmo computador onde você desenvolve seu código PHP. Após a instalação, o próximo passo é conectar o Ozeki SMS Gateway à rede móvel. Você pode enviar um SMS de teste a partir da interface gráfica do Ozeki para verificar se sua conexão com a rede móvel está funcionando. O passo final para preparar seu ambiente é criar um usuário da API HTTP de SMS. Crie um usuário com o nome de usuário "http_user" e senha "qwe123" para fazer o exemplo funcionar sem modificações.

Após a configuração do ambiente, você pode executar seu código PHP.

Para enviar SMS a partir do PHP, seu PHP terá que fazer uma requisição HTTP para o gateway de SMS. A URL da API é mostrada abaixo. Observe que o endereço IP (127.0.0.1) deve ser substituído pelo endereço IP do seu gateway de SMS. Se o Ozeki SMS Gateway estiver instalado no mesmo computador onde o aplicativo de SMS em C# está sendo executado, pode ser 127.0.0.1. Se estiver instalado em um computador diferente, deve ser o endereço IP desse computador.

http://127.0.0.1:9509/api?action=rest

Para enviar as mensagens SMS, você precisa incluir as seguintes linhas como cabeçalhos na requisição HTTP. Observe que incluímos um tipo de conteúdo e um cabeçalho de Autorização.

Content-Type: application/json
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==

Solicitação HTTP para enviar SMS a partir do PHP

Para enviar o SMS, sua aplicação PHP enviará uma solicitação HTTP semelhante à mostrada abaixo. Observe que esta solicitação contém uma parte de cabeçalho HTTP e uma parte de corpo HTTP. O corpo HTTP é uma string de dados codificada em JSON. Ela contém o número do destinatário e o texto da mensagem.

HTTP request received from 192.168.0.113:57045
POST /api?action=sendmsg HTTP/1.1
Content-Length: 433
Content-Type: application/json
Accept: */*
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 192.168.0.113:9509

{
  "messages": [
    {
      "message_id": "75ce6646-0a84-48d6-996a-02b632eef83a",
      "from_connection": null,
      "from_address": null,
      "from_station": null,
      "to_connection": null,
      "to_address": "+36201111111",
      "to_station": null,
      "text": "Hello, World!",
      "create_date": "2021-06-16 15:48:03",
      "valid_until": "2021-06-23 15:48:03",
      "time_to_send": "2021-06-23 16:18:00",
      "submit_report_requested": true,
      "delivery_report_requested": true,
      "view_report_requested": true,
      "tags": []
    }
  ]
}

Resposta HTTP recebida pelo exemplo de SMS em PHP

Assim que o gateway SMS receber esta solicitação, ele gerará uma resposta HTTP. A resposta HTTP conterá um código de status, para indicar se o envio do SMS foi bem-sucedido ou não. Ela também retornará uma estrutura codificada em JSON para fornecer detalhes úteis sobre o envio da mensagem.

HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.118 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Mon, 14 Jun 2021 07:43:45 GMT
Server: 10/10.3.118
Transfer-Encoding: chunked

{
  "http_code": 200,
  "response_code": "SUCCESS",
  "response_msg": "Mensagens enfileiradas para entrega.",
  "data": {
    "total_count": 1,
    "success_count": 1,
    "failed_count": 0,
    "messages": [
      {
        "message_id": "38585421-3260-4bf9-9daa-2b39ec16961a",
        "from_station": "%",
        "to_address": "+36201111111",
        "to_station": "%",
        "text": "Hello, World!",
        "create_date": "2021-06-16 15:48:03",
        "valid_until": "2021-06-16 15:48:03",
        "time_to_send": "2021-06-23 16:18:00",
        "submit_report_requested": true,
        "delivery_report_requested": true,
        "view_report_requested": false,
        "tags": [
          {
            "name": "Type",
            "value": "SMS:TEXT"
          }
        ],
        "status": "SUCCESS"
      }
    ]
  }
}

Como enviar SMS a partir do PHP usando a API de SMS em PHP (Tutorial em vídeo)

Este vídeo mostra como baixar e usar o projeto SendSMS em PHP. Depois de adicionar os arquivos necessários ao seu projeto, você pode notar que há um arquivo chamado MessageApi.php. Este é o arquivo que contém a MessageApi e tudo o que você precisa para enviar um SMS usando PHP.

Exemplo de SMS em PHP: Send_Message.php

Como verificar se o SMS foi aceito pelo usuário HTTP

Depois que o SMS for enviado, é uma boa ideia verificar seu gateway SMS para ver o que foi recebido. Você pode verificar o log abrindo os detalhes do usuário HTTP no console de gerenciamento do Ozeki SMS Gateway. O vídeo a seguir mostra o que procurar.

Como verificar se o SMS foi enviado para a rede móvel

O passo final para verificar o procedimento é dar uma olhada nos logs da conexão com a rede móvel. Você pode precisar ativar o registro no log na configuração da conexão antes de enviar a mensagem para ver os logs. Se o registro estiver ativado, você verá o número de telefone e o texto da mensagem que enviou.

Resumindo

Com este guia, você pode adquirir o conhecimento para enviar mensagens SMS agendadas com a API REST HTTP do Ozeki SMS Gateway a partir do PHP. Usar esta API de SMS em PHP ajuda você a cumprir seu cronograma e administrar seu negócio de forma muito mais profissional. Este serviço é fácil de configurar, vem com o código-fonte completo e você pode usá-lo e modificá-lo sem quaisquer limitações.

As informações que você obteve são valiosas, vamos coletar mais! A Ozeki tem muitos outros artigos para ajudá-lo, continue com o tutorial da API de SMS em PHP no GitHub.

Agora, a próxima coisa a fazer é baixar o Ozeki SMS Gateway e configurar esta solução imediatamente!