Script SMS em C#.Net

No Ozeki SMS Gateway, você pode escrever um script que permite executar código C# .NET quando uma mensagem SMS é recebida. Este script pode implementar qualquer lógica para realizar diversas tarefas com as mensagens recebidas e, opcionalmente, enviar respostas por SMS.

Passo 1 - Adicionar novo usuário/aplicativo...

Você pode simplesmente instalar o Usuário de script C# no console de Gerenciamento clicando em Adicionar novo usuário/aplicativo... no painel Usuários/Aplicativos (Figura 1).

Passo 2 - Adicionar script C#

Uma interface será aberta com dois painéis. O painel esquerdo contém os usuários e aplicativos já instalados. O painel direito contém os usuários e aplicativos que você pode instalar, com uma breve descrição ao lado de cada um. Procure pelo Usuário de script C# e clique no botão azul 'instalar' ao lado dele (Figura 2).

Passo 3 - Fornecer o script

O painel 'Configuração' possui uma aba 'Geral' que contém as configurações básicas. Primeiro, forneça um Nome único. Na seção Script da aba, você encontrará o código-fonte do script que deseja executar (Figura 3).

Passo 4 - Habilitar usuário

Habilite o usuário com o interruptor de Conexão e, na aba Eventos, verifique se o Script foi compilado e o usuário foi inicializado com sucesso (Figura 4).

Passo 5 - Mensagem recebida

Finalmente, você pode verificar se uma mensagem é recebida por este usuário. O script será executado e, como este exemplo funciona, a mensagem SMS de resposta é enviada ao remetente original (Figura 5).

Guia de programação ASP C#

Crie uma classe chamada 'Program' no namespace 'Ozeki'. Você também pode incluir as diretivas using necessárias.

using System;
​
namespace Ozeki
{ 
    public class Program 
    {
    }
}

Implemente a função 'Receive' dentro da classe 'Program'. Esta função será chamada quando sua conexão receber uma mensagem. O parâmetro da função 'Receive' será um objeto do tipo 'Message'.

using System;
​
namespace Ozeki
{ 
    public class Program 
    {
        public void Receive(Message msg)
        {
        }
    }
}

Enviar uma mensagem de resposta

Ao receber uma mensagem, você pode enviar uma resposta para notificar o remetente sobre o recebimento bem-sucedido. Para isso, você pode usar a função embutida 'Reply'.

using System;
​
namespace Ozeki
{ 
    public class Program 
    {
        public void Receive(Message msg)
        {
            Reply(msg, "Obrigado pela mensagem!");
        }
    }
}

Encaminhamento de mensagens

Você também pode encaminhar a mensagem recebida para outra conexão usando a função 'Send'.

using System;
​
namespace Ozeki
{ 
    public class Program 
    {
        public void Receive(Message msg)
        {
            Send("admin@localhost", msg.Text);
        }
    }
}

Compor sua mensagem

Compor uma mensagem é mais fácil do que você imagina. Basta usar o tipo embutido 'Message' para criar um novo objeto de mensagem. No exemplo a seguir, quando uma mensagem for recebida, criaremos e enviaremos uma nova mensagem para a conexão do administrador.

using System;
​
namespace Ozeki
{ 
    public class Program 
    {
        public void Receive(Message msg)
        {
            var message = new Message();
            message.Text = "Olá Mundo!";
            message.ToAddress = "+4412345678910";
            message.ToConnection = "admin@localhost";
            message.FromAddress = "+448888999910";
          
            Send(message);
        }
    }
}

Registro de logs

Usar mensagens de log tornará a depuração do seu script muito mais fácil. Ao chamar a função 'Log', você pode implementar um registro adequado em seu script, se necessário.

using System;
​
namespace Ozeki
{ 
    public class Program 
    {
        public void Receive(Message msg)
        {
            Log("Mensagem recebida: " + msg.Text);
        }
    }
}

Resumo

No artigo acima, você aprendeu coisas importantes sobre como executar um código C# .NET usando o Ozeki SMS Gateway. Combinar o poder do Ozeki SMS Gateway com um script em C#.NET resultará em um sistema de mensagens útil e versátil. Se você pode executar um código C#.NET quando uma mensagem SMS é recebida, pode implementar lógicas para realizar qualquer tarefa. Por exemplo, uma boa tarefa seria enviar uma resposta scriptada à mensagem recebida. Outro bom exemplo é enviar mensagens de notificação dentro da sua organização em caso de recebimento de uma mensagem.

Para obter mais informações sobre a API de SMS em C#, siga o link para o artigo sobre este tópico no site da Ozeki: SMS HTTP em C#.

Para começar a trabalhar, tudo o que você precisa fazer é baixar o Ozeki SMS Gateway agora!