Cómo enviar SMS desde Ruby

Veamos cómo puedes usar Ruby para enviar mensajes SMS con solicitudes HTTP. El código de ejemplo demuestra que solo necesitas un par de líneas de código para configurar los detalles del mensaje y enviar una solicitud HTTP. Luego, la Pasarela SMS recibe la solicitud y entrega el SMS al destinatario. Por último, la Pasarela SMS envía la respuesta de vuelta al programa Ruby, que imprime esa respuesta en la consola.

¿Qué es la API SMS de Ruby?

La API SMS de Ruby (Ruby sms) te permite enviar mensajes SMS desde tu programa Ruby. La API SMS de Ruby inicia solicitudes HTTP y las envía a la Pasarela SMS, que entrega el mensaje al destinatario.

Requisitos previos

Enviar SMS desde Ruby

  1. Abre el Bloc de notas
  2. Crea un nuevo archivo
  3. Copia y pega el código de ejemplo a continuación
  4. Guarda el archivo como HttpApiTester.rb
  5. Abre el Símbolo del sistema
  6. Navega hasta la carpeta donde guardaste el archivo Ruby
  7. Escribe 'ruby HttpApiTester.rb' en el Símbolo del sistema
  8. Presiona Enter para ejecutar el programa Ruby
  9. Ruby Rails envía mensajes de texto SMS

Video 1 - Cómo enviar SMS desde Ruby (Tutorial en video)

Ejemplo de código fuente SMS en Ruby

Este sencillo ejemplo de código fuente a continuación, escrito en el lenguaje de programación Ruby, es de uso gratuito. Puedes implementarlo simplemente en tu proyecto, o modificar el código fuente para usarlo en otros proyectos o aplicaciones. Para ejecutar el código de ejemplo y ver cómo enviar solicitudes HTTP desde Ruby, solo necesitas crear un nuevo archivo Ruby y colocar este código de ejemplo en ese archivo. Para ejecutar el programa Ruby, solo ejecútalo desde el Símbolo del sistema. Estas operaciones se describen y demuestran en los pasos y las secciones de video. 

require 'uri'
require 'net/http'

username = "john"
password = "Xc3ffs"
messagetype = "SMS:TEXT"
httpUrl = "https://127.0.0.1:9508/"
recipient = URI.encode_www_form_component("+36201324567")
messagedata = URI.encode_www_form_component("TestMessage")

sendString = "#{httpUrl}api?action=sendmessage&username=#{username}&password="\
			 "#{password}&recipient=#{recipient}&messagetype="\
			 "#{messagetype}&messagedata=#{messagedata}"

puts("Sending http request #{sendString}")

OpenSSL::SSL.send(:remove_const, :VERIFY_PEER)
OpenSSL::SSL.const_set(:VERIFY_PEER, OpenSSL::SSL::VERIFY_NONE)
url = URI(sendString)
response = Net::HTTP.get(url)
puts("Http response received:")
puts(response)

Paso 1 - Abre un editor de texto

El primer paso para ejecutar el código de ejemplo SMS en Ruby es crear un archivo Ruby que contenga el código fuente. Para realizar esta operación, solo necesitas un editor de texto. Puedes descargar un editor de texto personalizado para hacer esto, pero la aplicación Bloc de notas predeterminada instalada en Windows también puede hacer el trabajo. Entonces, como puedes ver en la Figura 1, solo haz clic en el icono del Bloc de notas para abrirlo.

abrir un editor de texto
Figura 1 - Abrir un editor de texto

Paso 2 - Copia el código fuente de Ruby

El siguiente paso de la guía es obtener el código fuente de Ruby. Esto se puede hacer fácilmente, ya que el código se puede encontrar en esta página, por lo que solo necesitas copiarlo. Entonces, como muestra la Figura 2, solo ve a la sección del código de ejemplo, selecciona todo el código fuente y presiona Ctrl+C en tu teclado para copiar el código Ruby al portapapeles.

copiar código fuente desde el sitio web
Figura 2 - Copiar código fuente desde el sitio web

Paso 3 - Pega el código Ruby en tu editor de texto

Después de copiar el código Ruby de esta página, necesitas pegarlo en tu archivo de texto vacío. Para hacer eso, solo necesitas navegar al archivo de texto y presionar Ctrl+V en tu teclado. Al realizar esta acción, el código Ruby se pegará en tu archivo de texto como muestra la Figura 3.

pegar el código del programa en el editor de texto
Figura 3 - Pegar el código del programa en el editor de texto

Paso 4 - Guarda el archivo Ruby

Después de colocar el código fuente en el archivo de texto, el siguiente paso que necesitas hacer es guardar el archivo usando la extensión de archivo de Ruby, que es '.rb'. Entonces, solo selecciona la opción 'Guardar como' en el Bloc de notas, nombra el archivo y agrega la extensión '.rb' como puedes ver en la Figura 4, y finalmente, haz clic en Guardar.

guardar el archivo ruby httpapitester
Figura 4 - Guardar el archivo Ruby HttpApiTester

Paso 5 - Abre el Símbolo del sistema

El siguiente paso es ejecutar el archivo Ruby creado. Esta tarea se puede hacer fácilmente usando el Símbolo del sistema. Puedes abrirlo abriendo el Explorador de archivos, navegando hasta la carpeta donde guardaste el archivo Ruby y escribiendo 'cmd' en la barra de direcciones del Explorador de archivos como en la Figura 5. Si presionas Enter en este punto, el Símbolo del sistema aparecerá y estará listo para usar.

abrir símbolo del sistema
Figura 5 - Abrir el Símbolo del sistema

Paso 6 - Ejecuta el archivo Ruby

En el Símbolo del sistema, solo necesitas ejecutar un comando simple para poder ejecutar el ejemplo SMS en Ruby. El comando debe ser 'ruby *nombre del archivo*.rb'. Después de escribir ese comando, solo presiona Enter, y el comando ejecutará el programa Ruby. El programa de ejemplo imprime la solicitud HTTP y el mensaje de respuesta de la Pasarela SMS en el Símbolo del sistema. (Figura 6)

ejecutar archivo httpapitesterrb en cmd
Figura 6 - Ejecutar archivo HttpApiTester.rb en cmd

Paso 7 - Verifica el resultado del envío en el registro de Ozeki

En la Pasarela SMS Ozeki 10, puedes verificar fácilmente qué mensajes envió tu aplicación, ya que el servicio HTTP API registra cada evento que ocurre mientras está habilitado. Entonces, si abres la Pasarela SMS y seleccionas los detalles del servicio HTTP API, podrás ver los eventos. Como muestra la Figura 7, el servicio registró un evento, cuando el programa de ejemplo Ruby envió la solicitud HTTP al servicio.

verificar los registros del servicio http api
Figura 7 - Verificar los registros del Servicio HTTP API

El proceso del envío del mensaje también se puede ver a través de los eventos. Para eso, abre la conexión del Usuario HTTP API, que debiste configurar antes. La Figura 8 demuestra cómo la conexión maneja la solicitud HTTP y envía el mensaje al destinatario que especificaste en tu programa de ejemplo SMS en Ruby.

verificar los registros del usuario http api
Figura 8 - Verificar los registros del Usuario HTTP API

Resumen

Este artículo te explicó cómo puedes enviar mensajes SMS desde un proyecto escrito en Ruby. Enviar mensajes desde cualquier objeto Ruby significa que puedes ofrecer servicios SMS a tus clientes en cualquier solución Ruby. Esto hará que tu solución sea versátil y ampliamente utilizada. La solución se basa en la Pasarela SMS Ozeki. Este código que proporcionamos enviará solicitudes HTTP desde Ruby a la Pasarela SMS Ozeki y la Pasarela SMS Ozeki hará lo solicitado.

Para saber más sobre el sistema, no dudes en visitar el sitio web de Ozeki donde puedes encontrar más información sobre cualquier configuración que puedas construir usando la Pasarela SMS Ozeki. Comienza con el artículo sobre recibir mensajes SMS. O revisa otros lenguajes de programación con los que puede trabajar la Pasarela SMS Ozeki. Por ejemplo, PHP.

¡Lo siguiente que debes hacer es descargar la Pasarela SMS Ozeki y comenzar a trabajar ahora mismo!

More information