Envío de SMS en PHP: Biblioteca API para integración

Envío de SMS en PHP: Biblioteca API para integración rápida

El envío de mensajes SMS sigue siendo una de las formas más fiables de notificar a los usuarios: confirmación de pedidos, autenticación de dos factores, recordatorios de eventos. Para PHP existen muchas bibliotecas listas que simplifican el trabajo con proveedores de SMS a través de su API. En este artículo, analizaremos soluciones populares, sus métodos de instalación y ejemplos de código para enviar mensajes.

¿Por qué usar una biblioteca para enviar SMS?

Trabajar manualmente con solicitudes HTTP a la API de la pasarela SMS requiere escribir una gran cantidad de código repetitivo: formación de encabezados, manejo de errores, trabajo con JSON/XML, verificación de estados. Una biblioteca lista asume estas tareas, proporcionando una interfaz orientada a objetos limpia. Esto acelera el desarrollo y reduce la probabilidad de errores.

Bibliotecas populares para enviar SMS en PHP

La elección de la biblioteca depende del proveedor de SMS utilizado. Consideremos dos opciones populares:

• Twilio PHP SDK – biblioteca oficial para trabajar con Twilio. Admite envío de SMS, llamadas de voz, verificación de número.
• SMS Aero PHP SDK – biblioteca para el servicio ruso SMS Aero. Permite enviar mensajes, verificar saldo, obtener estadísticas.

Instalación mediante Composer

La mayoría de las bibliotecas PHP modernas se instalan a través de Composer. Ejecute en la terminal:

composer require twilio/sdk

Para SMS Aero:

composer require sms-aero/sms-aero-php

Después de la instalación, incluya el cargador automático en su script:

require_once 'vendor/autoload.php';

Ejemplo de envío de SMS a través de Twilio

Para trabajar con Twilio necesitará Account SID y Auth Token (se encuentran en la consola de Twilio). Ejemplo de código:

<?phprequire_once 'vendor/autoload.php';

use Twilio\\Rest\\Client;

$sid    = "su_account_sid";$token  = "su_auth_token";$twilio = new Client($sid, $token);

$message = $twilio->messages    ->create(        "+71234567890", // número del destinatario        [            "from" => "+12345678901", // número del remitente (comprado en Twilio)            "body" => "¡Hola! Este es un SMS de prueba desde PHP."        ]    );

echo "Mensaje enviado. ID: " . $message->sid;?>

En caso de éxito, el método create() devuelve un objeto con información del mensaje. En caso de error, se lanza una excepción TwilioException.

Ejemplo de envío de SMS a través de SMS Aero

Para el servicio ruso SMS Aero se necesitarán email y clave API. Ejemplo:

<?phprequire_once 'vendor/autoload.php';

use SmsAero\\SmsAeroClient;

$client = new SmsAeroClient('su_email@example.com', 'su_api_key');

try {    $response = $client->sendSms(        '71234567890',        'Texto del mensaje',        'NOMBRE_REMITENTE' // nombre del remitente registrado en el servicio    );    echo "SMS enviado. ID: " . $response->id;} catch (Exception $e) {    echo "Error: " . $e->getMessage();}?>

El método sendSms() devuelve un objeto de respuesta que contiene el estado de entrega, el ID del mensaje y el saldo.

Funcionalidades principales de las bibliotecas

• Envío de SMS individuales y masivos – se puede enviar un solo mensaje o una lista de números.
• Verificación del estado de entrega – consulta del estado por ID del mensaje.
• Gestión de remitentes – registro y selección del nombre del remitente.
• Trabajo con plantillas – para algunos proveedores se pueden usar plantillas de mensajes predefinidas.
• Saldo y estadísticas – obtención del saldo actual e informes