Cómo recibir SMS desde PHP

La forma más sencilla de enviar SMS desde PHP es utilizar la API HTTP/Rest de SMS integrada en Ozeki SMS Gateway. Cuando uses esta API, recibirás mensajes SMS mediante una solicitud HTTP Get al gateway de SMS. El gateway de SMS devolverá una respuesta HTTP 200 OK a tu solicitud.

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

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

SendSMS.cs


namespace Ozeki_PHP_Rest
{
require 'MessageApi/MessageApi.php';

		$configuration = new Configuration();
		
		$configuration -> Username = "http_user";
		$configuration -> Password = "qwe123";
		$configuration -> ApiUrl = "http://127.0.0.1:9509/api";
					
		$api = new MessageApi($configuration);
		
		$result = $api -> DownloadIncoming();	
			
		echo "Folder: " . $result -> Folder;
		echo "
";
		
		echo "Limit: " . $result -> Limit;
		echo "
";
		
		echo strval($result);
		echo "
";
		
		echo "Messages:";
		echo "
";
		
		foreach($result->Messages as $msg)
			{
				echo "From: ". $msg->FromAddress . " Text: " . $msg->Text;
				echo "
";				
			}
}

Cómo usar el ejemplo de SMS en PHP:

Este ejemplo de SMS en PHP puede usarse en cualquier aplicación PHP. Para usarlo, debes agregar la carpeta MessageApi a tu proyecto. Puedes usar la clase Message para crear el SMS y la clase MessageApi para enviar el SMS al gateway de SMS. El gateway de SMS reenviará tu mensaje a la red móvil ya sea mediante una conexión inalámbrica o a través de Internet.

Descargar ReceiveSMS.php

El código fuente explicado en este artículo se puede descargar, usar y modificar gratuitamente.
Descargar: ReceiveSMS.zip (5.9Kb)

¿Qué contiene el archivo ReceiveSMS.zip?

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

Figura 2 - Qué hay dentro de ReceiveSMS.zip

Cómo recibir SMS desde PHP (Pasos rápidos)

Para enviar SMS desde PHP:

Instala Ozeki SMS Gateway
Conecta Ozeki SMS Gateway a la red móvil
Recibe un SMS de prueba desde la GUI de Ozeki
Crea un usuario de API HTTP para SMS
Inicia el servidor Wamp
Descarga el ejemplo anterior
Crea la solicitud para recibir SMS
Usa el método Receive para recibir tu mensaje
Lee la respuesta HTTP
Verifica los registros en el gateway de SMS

Instala Ozeki SMS Gateway y crea un usuario de API HTTP

Para poder recibir SMS desde PHP, primero necesitas instalar Ozeki SMS Gateway. El gateway de SMS puede instalarse en la misma computadora donde desarrollas tu código PHP. 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 GUI de Ozeki para verificar que tu conexión a la red móvil funciona. El paso final para preparar tu entorno es crear un usuario de API HTTP para SMS. Crea un usuario con el nombre "http_user" y la contraseña "qwe123" para que el ejemplo funcione sin modificaciones.

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

URL de la API HTTP para recibir SMS desde PHP

Para enviar SMS desde PHP, tu PHP tendrá que realizar una solicitud HTTP al gateway de SMS. La URL de la API se muestra a continuación. Ten en cuenta que la dirección IP (127.0.0.1) debe ser reemplazada por la dirección IP de tu gateway de SMS. Si Ozeki SMS Gateway está instalado en la misma computadora donde se ejecuta la aplicación C# para SMS, 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

Encabezado de la solicitud HTTP para recibir SMS desde PHP

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==

Solicitud HTTP para recibir SMS desde PHP

Para enviar el SMS, tu aplicación PHP 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.

GET /api?action=receivemsg&folder=inbox HTTP/1.1
Content-Type: application/json
Accept: */*
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509

Respuesta HTTP recibida por el ejemplo de SMS en PHP

Una vez que el gateway de 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.120 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Thu, 17 Jun 2021 09:18:12 GMT
Server: 10/10.3.120
Transfer-Encoding: chunked

{
  "http_code": 200,
  "response_code": "SUCCESS",
  "response_msg": "",
  "data": {
    "folder": "inbox",
    "limit": "1000",
    "data": [
      {
        "message_id": "16673c81-0568-49af-a0fa-1e4b3d6bb500",
        "from_connection": "SMPP_client_1@localhost",
        "from_address": "+36301111111",
        "from_station": "%",
        "to_connection": "http_user@localhost",
        "to_address": "+36308888888",
        "to_station": "%",
        "text": "Hello World  1!",
        "create_date": "2021-06-17 10:01:55",
        "valid_until": "2021-06-24 10:01:55",
        "time_to_send": "2021-06-17 10:01:55",
        "submit_report_requested": true,
        "delivery_report_requested": false,
        "view_report_requested": false,
        "tags": [
          {
            "name": "PduCount",
            "value": "1"
          }
        ]
      },
      {
        "message_id": "8ed7f65b-d3b5-4b68-8b4d-25b63dad0cc8",
        "from_connection": "SMPP_client_1@localhost",
        "from_address": "+36302222222",
        "from_station": "%",
        "to_connection": "http_user@localhost",
        "to_address": "+36308888888",
        "to_station": "%",
        "text": "Hello World  2!",
        "create_date": "2021-06-17 10:02:03",
        "valid_until": "2021-06-24 10:02:03",
        "time_to_send": "2021-06-17 10:02:03",
        "submit_report_requested": true,
        "delivery_report_requested": false,
        "view_report_requested": false,
        "tags": [
          {
            "name": "PduCount",
            "value": "1"
          }
        ]
      },
      {
        "message_id": "56ad323c-b19b-4406-af2d-cf2eb365e725",
        "from_connection": "SMPP_client_1@localhost",
        "from_address": "+36303333333",
        "from_station": "%",
        "to_connection": "http_user@localhost",
        "to_address": "+36308888888",
        "to_station": "%",
        "text": "Hello World  3!",
        "create_date": "2021-06-17 10:02:27",
        "valid_until": "2021-06-24 10:02:27",
        "time_to_send": "2021-06-17 10:02:27",
        "submit_report_requested": true,
        "delivery_report_requested": false,
        "view_report_requested": false,
        "tags": [
          {
            "name": "PduCount",
            "value": "1"
          }
        ]
      }
    ]
  }
}

Cómo recibir SMS desde PHP usando la API de SMS en PHP (Tutorial en video)

Este video te muestra cómo descargar y usar el proyecto ReceiveSMS en PHP. Una vez que hayas agregado los archivos necesarios a tu proyecto, podrás notar que hay un archivo llamado MessageApi.php. Este es el archivo que contiene la MessageApi y todo lo que necesitas para enviar un SMS usando PHP.

Video 1 - Cómo descargar y ejecutar el proyecto de ejemplo (Tutorial en video)

Ejemplo de SMS en PHP: Receive_Message.php

Cómo verificar que el SMS ha sido aceptado por el usuario HTTP

Después de que el SMS haya sido enviado, es una buena idea verificar tu gateway de SMS para ver qué ha recibido. Puedes verificar el registro abriendo los detalles del usuario HTTP desde la consola de administración de Ozeki SMS Gateway. El siguiente video te muestra qué buscar.

Video 2 - Recibiendo SMS con el código PHP anterior (Tutorial en video)

En resumen

Este artículo explicó cómo recibir mensajes SMS con la API HTTP REST de SMS de Ozeki SMS Gateway en PHP. Si has seguido los pasos anteriores, ahora puedes crear un usuario de API HTTP de SMS en Ozeki SMS Gateway para recibir SMS con PHP. Este servicio puede ser utilizado en cualquier momento, por lo que tu sistema PHP existente podría ampliarse con capacidades de SMS.

Encontrarás más información sobre esta tecnología y Ozeki SMS Gateway aquí, asegúrate de seguir leyendo. Ozeki tiene otros artículos sobre este tema, como Cómo enviar SMS desde PHP, ¡échale un vistazo ahora!

Lo siguiente que debes hacer es descargar Ozeki SMS Gateway y disfrutar de sus beneficios.