Script de SMS en C#.Net

En el Ozeki SMS Gateway puedes escribir un script que te permita ejecutar código C# .NET cuando llega un mensaje SMS. Este script puede implementar cualquier lógica para realizar diversas tareas con los mensajes entrantes y, opcionalmente, enviar mensajes SMS de respuesta.

Paso 1 - Añadir nuevo usuario/aplicación...

Puedes instalar fácilmente el Usuario de script C# en la consola de gestión haciendo clic en Añadir nuevo usuario/aplicación... en el panel Usuarios/Aplicaciones (Figura 1).

añadir nuevo usuario o aplicación
Figura 1 - Añadir nuevo usuario/aplicación...

Paso 2 - Añadir script C#

Se abrirá una interfaz compuesta por dos paneles. El panel izquierdo contiene los usuarios y aplicaciones ya instalados. El panel derecho contiene los usuarios y aplicaciones que puedes instalar con una breve descripción junto a ellos. Busca el Usuario de script C# y haz clic en el botón azul 'instalar' junto a él (Figura 2).

añadir script c sharp
Figura 2 - Añadir script C#

Paso 3 - Proporcionar el script

El panel 'Configuración' tiene una pestaña 'General' que contiene los ajustes básicos. Primero, proporciona un Nombre único. En la sección Script de la pestaña se encuentra el código fuente del script que deseas ejecutar (Figura 3).

proporcionar el script
Figura 3 - Proporcionar el script

Paso 4 - Habilitar usuario

Habilita al usuario con el interruptor de Conexión y en la pestaña Eventos verifica que el Script se compila y el usuario se inicializa correctamente (Figura 4).

habilitar usuario
Figura 4 - Habilitar usuario

Paso 5 - Mensaje recibido

Finalmente, puedes ver si un mensaje es recibido por este usuario, el script se ejecutará y, como funciona este ejemplo, el mensaje SMS de respuesta se envía al remitente original (Figura 5).

mensaje recibido
Figura 5 - Mensaje recibido

Guía de programación en ASP C#

Crea una clase llamada 'Program' en el espacio de nombres 'Ozeki'. También puedes incluir las directivas using necesarias.

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

Implementa la función 'Receive' dentro de la clase 'Program'. Esta función se llamará cuando tu conexión reciba un mensaje. El parámetro de la función 'Receive' será un objeto de tipo 'Message'.

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

Enviar un mensaje de respuesta

Al recibir un mensaje, puedes enviar una respuesta para notificar a tu remitente el éxito de la entrega. Para lograrlo, puedes usar la función integrada 'Reply'.

using System;
​
namespace Ozeki
{ 
    public class Program 
    {
        public void Receive(Message msg)
        {
            Reply(msg, "¡Gracias por el mensaje!");
        }
    }
}

Reenvío de mensajes

También puedes reenviar tu mensaje recibido a otra conexión usando la función 'Send'.

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

Componer tu mensaje

Componer un mensaje es más fácil de lo que piensas. Solo necesitas usar el tipo 'Message' integrado para crear un nuevo objeto de mensaje. En el siguiente ejemplo, cuando se recibe un mensaje, crearemos y enviaremos un nuevo mensaje a la conexión de administrador.

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

Registro de eventos

Usar mensajes de registro hará que depurar tu script sea mucho más fácil. Al llamar a la función 'Log' puedes implementar un registro adecuado en tu script si es necesario.

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

Resumen

En el artículo anterior, has aprendido cosas importantes sobre cómo ejecutar código C# .NET usando el Ozeki SMS Gateway. Combinar el poder del Ozeki SMS Gateway y un script en C#.NET resultará en un sistema de mensajería útil y versátil. Si puedes ejecutar código C#.NET cuando llega un mensaje SMS, puedes implementar lógicas para realizar cualquier tarea. Por ejemplo, una buena tarea sería enviar una respuesta automatizada al mensaje entrante. Otro buen ejemplo es enviar mensajes de notificación dentro de tu organización en caso de recibir un mensaje.

Para obtener más información sobre la API de SMS en C#, sigue el enlace al artículo sobre este tema en la página web de Ozeki: API de SMS en C#. Ozeki tiene otros artículos sobre este tema. Por ejemplo, SMS HTTP en C#.

Para empezar a trabajar, todo lo que necesitas hacer es descargar el Ozeki SMS Gateway ¡ahora!

More information