C# eliminar SMS de la pasarela SMS

La forma más sencilla de enviar SMS desde C# es utilizar la API HTTP/Rest de SMS integrada de Ozeki SMS Gateway. Cuando uses esta API, enviarás mensajes SMS mediante una solicitud HTTP Post a la pasarela SMS. La solicitud HTTP Post contendrá un mensaje formateado en formato json. La pasarela SMS enviará este SMS al teléfono del destinatario y devolverá una respuesta HTTP 200 OK a tu solicitud.

cómo eliminar sms de la pasarela sms usando c
Figura 1 - Cómo eliminar SMS de la pasarela SMS usando C#

Código C# para recibir SMS desde un móvil

El ejemplo de código C# para SMS a continuación demuestra cómo puedes recibir SMS usando la API HTTP Rest de SMS de Ozeki SMS Gateway con la biblioteca Ozeki.Libs.Rest de C#. Esta biblioteca se te proporciona gratuitamente y puedes usarla y modificarla en cualquiera de tus proyectos.

Program.cs 

using System;
using Ozeki.Libs.Rest;

namespace DeleteSms.cs
{
    class Program
    {
        static void Main(string[] args)
        {
            var configuration = new Configuration()
            {
                Username = "http_user",
                Password = "qwe123",
                ApiUrl = "http://127.0.0.1:9509/api"
            };

            var msg = new Message()
            {
                ID = "a85d6e16-f888-4306-bd2a-8f8a119d8abf"
            };

            var api = new MessageApi(configuration);

            var result = api.Delete(Folder.Inbox, msg);

            Console.WriteLine(result);
            Console.ReadKey();
        }
    }
}

Cómo usar el ejemplo de SMS en C#:

Este ejemplo de SMS en C# puede usarse en cualquier aplicación .NET o .NET core. Para usarlo, debes agregar el archivo DLL de Ozeki.Libs.Rest como referencia a tu proyecto. Después de agregar la referencia del proyecto, debes incluir la directiva using Ozeki.Libs.Rest; en la sección de encabezado de tu código fuente en C#. Esto te permitirá usar las clases proporcionadas por la biblioteca Ozeki.Libs.Rest. Puedes usar la clase MessageApi para recibir el SMS de la pasarela SMS. La pasarela SMS reenviará el mensaje a ti ya sea mediante una conexión inalámbrica o a través de Internet.

Descargar Delete-SMS.cs

El código fuente explicado en este artículo puede descargarse, usarse y modificarse gratuitamente.
Descargar: DeleteSms.cs.zip (47.6Kb)

¿Qué contiene el archivo Delete-SMS.cs.zip?

El archivo Delete-SMS.cs.zip contiene la biblioteca Ozeki.Libs.Rest, que te proporciona todas las herramientas necesarias para enviar, recibir y eliminar mensajes SMS. También encontrarás el proyecto DeleteSms en el zip, que contiene el código de ejemplo para mostrarte cómo eliminar un SMS. Este código de ejemplo se muestra a continuación.

directorio delete sms cs
Figura 2 - Qué hay dentro de Recive-SMS.cs.zip

Cómo eliminar SMS usando C# (Pasos rápidos)

Para eliminar SMS usando C#:

  1. Configura Visual Studio Community
  2. Descarga el archivo DeleteSms.cs.zip
  3. Extrae el archivo .zip de la carpeta de Descargas
  4. Abre el archivo DeleteSms.cs.sln en Visual Studio
  5. Inicia Ozeki SMS Gateway
  6. Selecciona http_user en la pestaña Usuarios y aplicaciones
  7. Verifica los detalles del mensaje en la Bandeja de entrada
  8. Inserta el ID del mensaje SMS en el código Program.cs
  9. Ejecuta Program.cs para eliminar SMS con C#

Instalar Ozeki SMS Gateway y crear un usuario HTTP API

Para poder enviar SMS desde C#, primero necesitas instalar Ozeki SMS Gateway. La pasarela SMS puede instalarse en la misma computadora donde desarrollas tu código C# en Visual Studio. Después de la instalación, el siguiente paso es conectar Ozeki SMS Gateway a la red móvil. Puedes enviar un SMS de prueba desde la interfaz gráfica de Ozeki para verificar que tu conexión a la red móvil funcione. El paso final para preparar tu entorno es crear un usuario de API HTTP para SMS. Crea un usuario con el nombre de usuario "http_user" y la contraseña "qwe123" para que el ejemplo funcione sin modificaciones.

Una vez configurado el entorno, puedes ejecutar tu código C#.

URL de la API HTTP para enviar SMS desde C#

Para enviar SMS desde C#, tu código C# tendrá que realizar una solicitud HTTP a la pasarela SMS. La URL de la API se muestra a continuación. Ten en cuenta que la dirección IP (127.0.0.1) debe reemplazarse por la dirección IP de tu pasarela SMS. Si Ozeki SMS Gateway está instalado en la misma computadora donde se ejecuta la aplicación de SMS en C#, puede ser 127.0.0.1. Si está instalado en una computadora diferente, debe ser la dirección IP de esa computadora. 

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

Autenticación HTTP para recibir SMS desde C#

Para autenticar el cliente de SMS en C#, necesitas enviar el nombre de usuario y la contraseña en una cadena codificada en base64 al servidor en una solicitud HTTP. El formato utilizado es: base64(nombre de usuario+":"+contraseña). En C# puedes usar el siguiente código para hacer esta codificación: 

var encoding = Encoding.GetEncoding("iso-8859-1");
var usernamePassword = username + ":" + password;
var usernamePasswordEncoded = Convert.ToBase64String(encoding.GetBytes(usernamePassword));

Por ejemplo, si codificas el nombre de usuario 'http_user' y la contraseña 'qwe123', obtendrás la siguiente cadena codificada en base64: aHR0cF91c2VyOnF3ZTEyMw==. Para enviar

Solicitud HTTP para eliminar SMS con C#

Para eliminar SMS, tu aplicación en C# enviará una solicitud HTTP similar a la que se muestra a continuación. Ten en cuenta que esta solicitud contiene una parte de encabezado HTTP y una parte de cuerpo HTTP. El cuerpo HTTP es una cadena de datos codificada en JSON. Contiene el número del destinatario y el texto del mensaje. 

POST /api?action=deletemsg HTTP/1.1
Connection: Keep-Alive
Content-Length: 73
Content-Type: application/json
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
 
{
	"folder":  "inbox",
	"message_ids":
	[
		"3a922414-458f-4866-a8ee-f053d1132a6b"
	]
}

Encabezado de la solicitud HTTP para eliminar SMS desde C#

Para enviar los mensajes SMS, necesitas incluir las siguientes líneas como encabezados en la solicitud HTTP. Ten en cuenta que incluimos un tipo de contenido y un encabezado de Autorización. 

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

Respuesta HTTP recibida por el ejemplo de SMS en C#

Una vez que la pasarela SMS recibe esta solicitud, generará una respuesta HTTP. La respuesta HTTP contendrá un código de estado para indicar si la solicitud de envío de SMS fue exitosa o no. También devolverá una estructura codificada en JSON para proporcionarte detalles útiles sobre el envío del mensaje. 

HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.116 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Mon, 07 Jun 2021 14:10:25 GMT
Server: 10/10.3.116
Transfer-Encoding: chunked
{
	"http_code": 200,
	"response_code": "SUCCESS",
	"response_msg": "",
	"data": {
		"folder": "inbox",
		"message_ids": [
			"3a922414-458f-4866-a8ee-f053d1132a6b"
		]
	}
}

Cómo eliminar SMS con C# usando la API de SMS en C# (Tutorial en video)

Este video te muestra cómo crear un nuevo proyecto de consola .Net core en Visual Studio, cómo nombrarlo como DeleteSms.sln. Una vez que el solución está creada, puedes notar que se agrega un DeleteSms.csproj a la solución y, por defecto, se abre el archivo Program.cs. Puedes renombrar el archivo Program.cs a Program.cs si lo deseas. También verás en el video cómo el código de ejemplo a continuación puede copiarse en el archivo Program.cs y cómo puede compilarse y ejecutarse.

Ejemplo de SMS en C#: DeleteSms.sln


Cómo descargar el archivo del proyecto (Tutorial en video)

En este video, aprenderás cómo descargar y ejecutar el proyecto de ejemplo DeleteSms.sln. El video comenzará con la página de descarga y terminará con el editor de código abierto. Aprenderás cómo descargar y qué hacer con el archivo del proyecto. Te mostraremos qué software necesitas usar. Este video solo dura 1 minuto pero es muy detallado, por lo que no tendrás problemas para seguir los pasos.

Video 1 - Cómo descargar y ejecutar la solución de ejemplo (Tutorial en video)

El código de ejemplo a continuación es parte de la Solución de Visual Studio DeleteSms.sln. Una solución de Visual Studio puede contener múltiples proyectos y múltiples archivos. En esta solución solo hay dos proyectos: DeleteSms.csproj, Ozeki.Libs.Rest.csproj y un archivo: Program.cs.

Figura 3 - DeleteSms.sln

Cómo usar el proyecto (Tutorial en video)

En el siguiente video, aprenderás cómo ejecutar el código de ejemplo y cómo verificar el registro del proceso. Comenzará con el lanzamiento de Ozeki SMS Gateway y te llevará hasta la bandeja de entrada vacía después de eliminar el SMS. Aprenderás cómo obtener el ID del mensaje y cómo usar el código para eliminar un mensaje. El video solo dura 1:38 y contiene toda la información que necesitas para eliminar un mensaje usando este proyecto.

Video 2 - Cómo eliminar SMS con el código C# anterior (Tutorial en video)

Ejecutando el ejemplo de SMS en C# en Windows

Cuando usas Windows para ejecutar este ejemplo de SMS escrito en C#, notarás que obtienes un rendimiento ligeramente mejor que cuando lo ejecutas en Linux. Para entender por qué sucede esto, debes tener en cuenta que C# usa el framework .NET para la ejecución del código. Esto se debe a que la implementación de .NET en Windows está optimizada para el rendimiento, mientras que mono, la implementación de .NET en Linux, tiene algo de trabajo por hacer en este campo.

Resumen

La guía explicó los pasos para eliminar SMS de Ozeki SMS Gateway usando C#. Si el artículo se leyó con atención, eliminar mensajes de Ozeki SMS Gateway parece realmente fácil con un código en C#. Esta solución muestra perfectamente lo simple que es controlar y configurar Ozeki SMS Gateway con comandos en C#. Ozeki SMS Gateway te permite gestionar los costos de SMS y mantener un seguimiento del tráfico de mensajes. Con esta función de eliminación, puedes eliminar mensajes no deseados rápidamente.

Para continuar leyendo, visita las páginas de tutoriales de Ozeki, donde puedes encontrar información sobre temas similares, como programación de SMS en C#.

Lo único que tienes que hacer ahora es descargar Ozeki SMS Gateway y ¡que comience el trabajo!

More information