Envío de SMS en Kotlin: Biblioteca API

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

En el desarrollo web moderno, la capacidad de enviar mensajes SMS de forma programática sigue siendo una función demandada, desde la autenticación de dos factores hasta las notificaciones de estado de pedidos. Si usas Kotlin para el backend (Ktor, Spring Boot) o una aplicación móvil (Android), necesitarás una herramienta confiable para trabajar con proveedores de SMS. En este artículo, exploraremos la biblioteca API para enviar SMS en Kotlin, sus capacidades, ejemplos de integración y mejores prácticas.

¿Qué es una biblioteca API para enviar SMS?

Una biblioteca API es un conjunto de clases y funciones que abstrae el trabajo con solicitudes HTTP al servidor del proveedor de SMS. En lugar de formar manualmente la URL, los encabezados y analizar JSON, llamas a métodos simples de Kotlin: sendSms(phone, message). La biblioteca se encarga de la autenticación, serialización, reintentos en caso de errores de red y el manejo de respuestas.

Principales capacidades de la biblioteca

Envío simple de SMS — especificar el número del destinatario, el texto y opcionalmente el nombre del remitente (nombre alfa).
Envío por lotes — enviar un mismo mensaje a una lista de números.
Verificación de estado — obtener información sobre la entrega (entregado, en cola, error).
Soporte para diferentes proveedores — Twilio, Vonage (Nexmo), SMSC.ru, Smsc.ua y otros.
Asincronía — todos los métodos devuelven funciones suspend o Deferred para corrutinas.
Registro y manejo de errores — mecanismos integrados para depuración.

Instalación y configuración

La biblioteca se distribuye a través de Maven Central o JitPack. Agrega la dependencia en build.gradle.kts:

// build.gradle.kts (para Gradle Kotlin DSL)dependencies {    implementation("com.example:sms-api:1.0.0")    // si usas Ktor Client    implementation("io.ktor:ktor-client-core:2.3.0")    implementation("io.ktor:ktor-client-okhttp:2.3.0")}

Para Android, agrega también el permiso de Internet en AndroidManifest.xml.

Ejemplo básico de envío de SMS

Veamos un ejemplo mínimo de envío de un solo mensaje a través del proveedor SMSC.ru (similar para otros).

import com.example.smsapi.SmsClientimport com.example.smsapi.model.SmsRequestimport com.example.smsapi.model.SmsResponse

suspend fun sendSingleSms() {    // Creamos el cliente con las credenciales    val client = SmsClient.create(        login = "your_login",        password = "your_password",        provider = SmsProvider.SMSC    )

    // Formamos la solicitud    val request = SmsRequest(        phone = "+71234567890",        message = "Su código de confirmación: 1234",        sender = "MyApp" // nombre alfa, si es compatible    )

    // Enviamos y obtenemos la respuesta    val response: SmsResponse = client.send(request)

    when (response.status) {        SmsStatus.SUCCESS -> println("SMS enviado, ID: ${response.id}")        SmsStatus.ERROR -> println("Error: ${response.errorMessage}")        else -> println("Estado desconocido")    }}

Envío por lotes

Para enviar un mismo mensaje a varios números, usa el método sendBatch:

val phones = listOf("+71234567890", "+70987654321", "+71112223344")val batchRequest = BatchSmsRequest(    phones = phones,    message = "Estimados clientes, ¡la promoción se extiende hasta el viernes!",    sender = "ShopBot")

val batchResponse = client.sendBatch(batchRequest)batchResponse.results.forEach { result ->    println("Teléfono: ${result.phone}, estado: ${result.status}")}