Enviar SMS do MySQL no seu Website

Como usar o código

O script PHP

Aqui você pode encontrar mais detalhes sobre o script de exemplo disponível para download.

O script precisa conhecer as credenciais do usuário para o seu banco de dados MySQL. A principal função do script é inserir a nova mensagem na tabela de mensagens de saída. Esta tabela é chamada 'ozekimessageout' no exemplo atual.

O Usuário de Banco de Dados do Ozeki SMS Gateway verifica periodicamente a tabela em busca de novos registros e, se o status da mensagem for 'Enviar', ele tentará enviá-la. Em caso de sucesso, o Usuário de Banco de Dados alterará o status da mensagem para 'Enviado'.

Esta é a estrutura do código-fonte:

sqlsmshandling.php:

Contém elementos ASP de construção de mensagens. Por exemplo, rótulos, caixas de texto e o botão 'Enviar'. O botão 'Enviar' chama as funções 'connectToDatabase()', 'insertMessage(...)' e 'closeConnection()' do arquivo sqlsmshandling_functions.php. sqlsmshandling.php lida não apenas com mensagens SMS, mas também com exceções. Por exemplo, campos vazios.

sqlsmshandling_functions.php:

Este arquivo PHP contém todas as funções internas usadas pelos 3 arquivos.

- connectToDatabase(): Conecta-se a um banco de dados do servidor MySQL.
- closeConnection(): Fecha a conexão, que foi criada em connectToDatabase().
- insertMessage(recipient, messageType, messageText): Executa a instrução INSERT no banco de dados. Esta instrução insere o registro da mensagem na tabela de mensagens de saída.
- showOutgoingMessagesInTable(): Seleciona mensagens da tabela SQL de mensagens de saída e constrói uma tabela HTML com elas no seu navegador web.
- showIncomingMessagesInTable(): Seleciona mensagens da tabela SQL de mensagens de entrada e constrói uma tabela HTML com elas no seu navegador web.

sqlsmshandling_inoutmessages.php:

Constrói tabelas HTML. Usa as funções connectToDatabase(), showOutgoingMessagesInTable(), showIncomingMessagesInTable() e closeConnection() para regenerar as tabelas. Estas funções estão disponíveis em sqlsmshandling_functions.php.

A descrição detalhada do processo na Figura 1 acima:

Passo 1: Criar formulário de entrada

sqlsmshandling.php cria um formulário (Figura 3) para solicitar dados de SMS do usuário. O formulário consiste em Rótulos e Caixas de Texto, além de um botão 'Enviar'. O usuário da internet preenche os campos de destinatário e mensagem e clica em 'Enviar'.

sqlsmshandling.php

...
<form action="" method="post">
<table border="0" align="centre">
    <tr>
        <td colspan="2" align="centre">
            <font style="font-weight: bold; font-size: 16px;">Compor mensagem</font>
            <br /><br />
        </td>
    </tr>
    <tr>
        <td valign="top">Destinatário: </td>
        <td>
            <textarea name="textAreaRecipient" cols="40" rows="2">...</textarea>
        </td>
    </tr>
    <tr>
        <td valign="top">Texto da mensagem: </td>
        <td>
            <textarea name="textAreaMessage" cols="40" rows="10">...</textarea>
        </td>
    </tr>
    <tr>
        <td colspan="2" align="centre">
            <input type="submit" value="Enviar">
        </td>
    </tr>
    <tr><td colspan='2' align='centre'>
    ...
    </td></tr>
</table>
</form>
...

Figura 3 - Constrói formulário HTML

Se o usuário da internet clicar em 'Enviar', o seguinte script será executado:

...

<?php

    if (isset($_POST["textAreaRecipient"]) && $_POST["textAreaRecipient"] == "")
    {
        echo "O campo destinatário não pode estar vazio!";
    }
    else if (isset($_POST["textAreaRecipient"]) && $_POST["textAreaRecipient"] != "")
    {
    try
    {
        connectToDatabase();
        if (insertMessage($_POST["textAreaRecipient"],"SMS:TEXT",$_POST["textAreaMessage"]))
        {
            echo "Inserção bem-sucedida!";
        }
        closeConnection();
    }
    catch (Exception $exc)
    {
        echo "Erro: " . $exc->getMessage();
    }
}
?>
...

Figura 4 - Faz login e insere a mensagem na tabela do banco de dados chamando a função insertMessage(...)

Passo 2: Processamento dos dados nas caixas de texto HTML

Se ambas as caixas de texto estiverem preenchidas, os dados serão processados e inseridos na tabela de mensagens de saída do banco de dados SQL. A função insertMessage(…) (Figura 5) pode realizar isso.

Lembre-se de que o registro da mensagem será inserido no banco de dados MySQL pelo script que fez login anteriormente (Figura 4 acima).

sqlsmshandling_functions.php

...
function insertMessage ($recipient, $messageType, $messageText)
{
    $query = "insert into ozekimessageout (receiver,msgtype,msg,status) ";
    $query .= "values ('" . $recipient . "', 
    	'" . $messageType . "', '" . $messageText . "', 'send');";
    $result = mysql_query($query);
    if (!$result)
    {
        echo (mysql_error() . "
");
        return false;
    }

    return true;
}
...

Figura 5 - função insertMessage(...)

Passo 3: Criação de tabelas de mensagens de saída e entrada

Se você pressionar F5 ou clicar em atualizar no seu navegador, as tabelas de mensagens de saída e entrada serão atualizadas lendo informações do banco de dados MySQL. Como exemplo, você pode ver showOutgoingMessagesInTable() abaixo (Figura 6).

sqlsmshandling_functions.php

function showOutgoingMessagesInTable()
{
    $query = "select id,sender,receiver,senttime,receivedtime,operator,status,msgtype,
    			msg from ozekimessageout;";
    $result = mysql_query($query);
    if (!$result)
    {
        echo (mysql_error() . "<br>");
        return false;
    }

    try
    {
        echo "<table border='1'>";
        echo "<tr><td>ID</td><td>Remetente</td><td>Destinatário</td>
        <td>Hora de envio</td><td>Hora de recebimento</td><td>Operadora</td>";
        echo "<td>Status</td><td>
        Tipo de mensagem</td><td>Texto da mensagem</td></tr>";
        while ($row = mysql_fetch_assoc($result))
        {
            echo "<tr>";

            echo "<td>" . $row["id"] . "</td>";
            echo "<td>" . $row["sender"] . "</td>";
            echo "<td>" . $row["receiver"] . "</td>";
            echo "<td>" . $row["senttime"] . "</td>";
            echo "<td>" . $row["receivedtime"] . "</td>";
            echo "<td>" . $row["operator"] . "</td>";
            echo "<td>" . $row["status"] . "</td>";
            echo "<td>" . $row["msgtype"] . "</td>";
            echo "<td>" . $row["msg"] . "</td>";

            echo "</tr>";
        }
        echo "</table>";
        mysql_free_result($result);
    }
    catch (Exception $exc)
    {
        echo (mysql_error() . "<br>");
        return false;
    }

    return true;
}
...

Figura 6 - função showOutgoingMessagesInTable(): Gera uma tabela HTML a partir de mensagens de saída

Pergunta: Posso enviar outro tipo de mensagem além de 'SMS:TEXT'?
Resposta: Sim. Por exemplo, uma mensagem Wap push ao chamar a função insertMessage(...) (Figura 7).

insertMessage ($_POST["textAreaRecipient"], "SMS:WAPPUSH", $_POST["textAreaMessage"])

No formulário, o seguinte deve ser escrito na caixa de texto 'Texto da mensagem':

<si>
<indication href="http://target_address" action="signal-high">
texto de descrição
</indication>
</si>

Figura 7 - SMS:TEXT alterado para SMS:WAPPUSH

O parâmetro 'action' da tag 'indication' pode ser um dos seguintes:
signal-high, signal-medium, signal-low, signal-none, signal-delete.

Pergunta: O servidor HTTP com PHP habilitado pode rodar em um computador diferente do servidor MySQL e do Ozeki SMS Gateway?
Resposta: Sim, pode. No script PHP, defina o endereço IP e as credenciais de login atuais para o seu banco de dados MySQL.

Pergunta: Posso mostrar ao destinatário o número de telefone do remetente?
Resposta: Sim, você pode. Crie uma caixa de texto para o número de telefone do remetente ou modifique a função insertMessage(...) (Figura 8). Lembre-se de que isso só funciona se você tiver uma conexão com um provedor de serviço de SMS por IP.

function insertMessage($sender, $recipient, $messageType, $messageText)
{
...
$query = "insert into ozekimessageout (sender,receiver,msgtype,msg,status) ";
$query .= "values ('".$sender."','".$recipient."',".
"'".$messageType."','".$messageText."','send');";
$result = mysql_query($query);
...
}

Figura 8 - Função insertMessage(...) modificada Resumo

Este artigo trata de uma solução para gerenciar mensagens SMS com MySQL usando o Ozeki SMS Gateway e como configurar esse sistema. Se você implementar esta solução seguindo o tutorial passo a passo, poderá controlar seu sistema de mensagens com instruções SQL através de sua aplicação PHP. Além da organização e simplicidade no envio de SMS que esta adição oferece, há outra grande vantagem: a segurança avançada do site que você pode alcançar ao adicionar login por SMS.

O site da Ozeki está repleto de artigos que recomendo a leitura, aproveite a oportunidade e visite esses sites. Comece com o guia sobre como usar seu site para enviar SMS.

Faça o download do Ozeki SMS Gateway agora e deixe-nos ajudá-lo a alcançar seus objetivos!