Como enviar SMS a partir de PHP
A maneira mais simples de enviar SMS a partir de 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 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.
SendSMS.cs
namespace Ozeki_PHP_Rest
{
require 'MessageApi/MessageApi.php';
$configuration = new Configuration();
$configuration -> Username = "http_user";
$configuration -> Password = "qwe123";
$configuration -> ApiUrl = "http://192.168.0.113:9509/api";
$msg = new Message();
$msg -> ToAddress = "+36201111111";
$msg -> Text = "Olá, Mundo!";
$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 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.
Baixar SendSMS.php
O código-fonte explicado neste artigo pode ser baixado, usado e modificado gratuitamente.
Download: SendSMS.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 SendSMS 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 de PHP:
- Instale o Ozeki SMS Gateway
- Conecte o Ozeki SMS Gateway à rede móvel
- Envie um SMS de teste a partir da interface gráfica do Ozeki
- Crie um usuário de API HTTP de SMS
- Inicie o servidor Wamp
- Baixe o exemplo acima
- Crie o SMS criando um novo objeto Message
- Use o método SendSingle para enviar sua mensagem
- Leia a resposta HTTP
- Verifique os logs no gateway de SMS
Para poder enviar SMS a partir de 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 de API HTTP de SMS. Crie um usuário com o nome "http_user" e senha "qwe123" para que o exemplo funcione sem modificações.
Após a configuração do ambiente, você pode executar seu código PHP.
URL da API HTTP para enviar SMS a partir de PHPPara enviar SMS a partir de 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 cabeçalho de tipo de conteúdo e um cabeçalho de Autorização.
Content-Type: application/json Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Para enviar o SMS, seu aplicativo PHP enviará uma requisição HTTP semelhante à mostrada abaixo. Observe que esta requisiçã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:62101
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": "f259f9de-bc27-4794-8d2b-691af76b551b",
"from_connection": null,
"from_address": null,
"from_station": null,
"to_connection": null,
"to_address": "+36201111111",
"to_station": null,
"text": "Olá, Mundo!",
"create_date": "2021-06-15 15:10:16",
"valid_until": "2021-06-22 15:10:16",
"time_to_send": "2021-06-15 15:10:16",
"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 a solicitação de envio de SMS foi bem-sucedida ou não. 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": "a451446c-db80-4009-b51d-31d0675e28c4",
"from_station": "%",
"to_address": "+36201111111",
"to_station": "%",
"text": "Olá, Mundo!",
"create_date": "2021-06-15 15:10:16",
"valid_until": "2021-06-22 15:10:16",
"time_to_send": "2021-06-15 15:10:16",
"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 de 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
Após o envio do SMS, é 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 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 enviada.
Para ativar o registro no http_user, você deve seguir as mesmas instruções.
Considerações finais
Este guia forneceu todas as informações necessárias sobre como enviar mensagens SMS a partir de PHP com a API REST HTTP do Ozeki SMS Gateway. Esta solução requer uma conexão de usuário HTTP no Ozeki SMS Gateway, que é como oferece uma conexão muito confiável e com velocidade incrível. Este serviço pode tornar sua organização mais eficiente, pois permite entregar informações-chave disponíveis em e-mail para telefones móveis, acelerando os fluxos de trabalho.
Há muitos outros artigos para ajudá-lo, então certifique-se de lê-los. Comece com o artigo chamado Como enviar vários SMS a partir de PHP e multiplique suas oportunidades.
Comece a usar o Ozeki SMS Gateway agora! Tudo está pronto para configurá-lo e executá-lo em poucos minutos.