Lista de tareas para una integración de API SMS. Checklist completo.
24 / 02 / 2021
Tiempo de lectura: 6 min
Si quiere integrar el envío de SMS en un software a través de una API SMS siempre conviene seguir una lista de tareas detallada para asegurarse que no se olvida nada importante.
Los desarrolladores de software suelen centrarse en pensar cómo escribir el código correcto para poder enviar un mensaje pero existen muchos otros aspectos que debe tener en cuenta para concluir con éxito todo el proceso.
Queremos ayudarle en esta tarea y le ofrecemos lo que para nosotros sería una lista completa de tareas para la integración de API SMS. Al final del artículo encontrará un archivo pdf descargable para poder marcar los pasos de la lista según los vaya completando.
Análisis previo
Prepare una lista de requisitos
Los requisitos no sólo tienen que ser técnicos, sino sobre el servicio en general y las características que debe ofrecer el proveedor.
- Soporte técnico: ¿es gratuito?¿con qué rapidez responden?
- Seguridad: ¿el proveedor cumple con la normativa de seguridad?
- Países con cobertura: ¿va a enviar a un único país o es necesario que el proveedor tenga cobertura internacional?
- Remitente: ¿se puede personalizar el remitente del mensaje? En la mayor parte de los casos esta característica no depende del proveedor sino del país y las operadoras de telefonía. En México no es posible.
- Mensajes de dos vías: Si necesita recibir respuesta de los usuarios a los que ha enviado SMS.
- Mensajes programados. En algunos casos los SMS no son para su envío inmediato, sino que se programan con fecha y hora para su envío.
- Confirmación de entrega: cuando es necesario registrar si el teléfono ha recibido el SMS y en qué fecha y hora. Al igual que el remitente, normalmente esta característica depende del país y las operadoras de telefonía celular y no del proveedor. Las operadoras de telefonía celular en México no ofrecen esta característica.
- Tasas de envío. ¿cuántos SMS por segundo voy a necesitar enviar?
Compruebe si existe ya algún módulo SMS para su software
A veces no es necesario reinventar la rueda. Si ya existe un plugin o módulo para el envío de SMS que añade la funcionalidad deseada no es necesario realizar ningún desarrollo adicional.
En muchos casos, si los módulos no cumplen con la funcionalidad deseada completamente, sí que permiten configurar el proveedor y proporcionan una función para el envío de SMS. Utilizar esta función en lugar de crear una nueva también puede ahorrar tiempo.
Elija el tipo de API
Dentro de las API hay varios protocolos y no todos son igual de fáciles de implementar. En función de su software es incluso posible que tenga que descartar alguno antes de empezar. Los más comunes para el envío de SMS son:
- HTTP Post
- web service Rest JSON
- web service SOAP
- mail2SMS. Convierte un correo electrónico en un SMS
Seleccione el lenguaje de programación
En la mayor parte de los casos el lenguaje que se elige está determinado por el entorno de ejecución, es decir el software en el que se quiere integrar el envío de SMS: php, Java, .NET, Python, Delphi, Perl etc.
Paga solo por lo que necesitas
Sin cuotas de alta
Sin permanencia
Elección del proveedor
Condiciones técnicas
Seleccione un proveedor que ofrezca el tipo de API que le interesa y soporte el lenguaje que quiere emplear.
- Revise con detenimiento la documentación técnica de la API del proveedor. Preste también atención a los parámetros opcionales del servicio porque pueden ofrecer funcionalidades adiciones de interés.
- Plantee su lista de requisitos al proveedor para ver cuáles cumple.
- Solicite una cuenta de prueba gratuita.
Condiciones económicas
- Consulte los precios de los paquetes de SMS para cada país de destino. Este es un punto muy importante, pero no hay que olvidar verlo desde la perspectiva de calidad/precio.
- ¿Los mensajes que se adquieran tienen caducidad?
- Pregunte si existen cuotas mensuales o anuales de algún tipo.
- Comprueba qué medios de pago ofrecen (tarjeta, transferencia bancaria…)
Condiciones legales y reputación
- Revise los términos del contrato
- Revise las condiciones de uso
- Compruebe la reputación del proveedor.
Prueba de concepto
- Ayudas a la integración: Pregunte al proveedor si dispone de un módulo, plugin, librería o código fuente de ejemplo para facilitar la tarea de escribir el código.
- Realice una prueba sencilla con un código básico para asegurarse únicamente de que hay conectividad y ha podido emplear correctamente la API para enviar un SMS.
- Asegúrese de capturar la respuesta de la API para saber que el proceso ha sido correcto.
- Procese los posibles errores. Los errores pueden ocurrir en la propia petición con sus correspondientes códigos de error de la API o errores en las comunicaciones (firewall, proxy, timeout de conexión…).
- Confirmación de entrega: Gestione la confirmación de entrega si en su país está disponible este servicio. Recuerde que en México no está disponible.
- Tiempos de espera: Preste atención a los tiempos de espera máximos para detectar posibles problemas de comunicación con el API del proveedor.
- Soporte: Si está teniendo problemas en la integración consulte la FAQ del proveedor o contacte con su servicio técnico
Integración del envío de SMS en su software
- Integre el código que ha probado en su software, adecuando el estilo y las prácticas de programación de su negocio.
- Formato de los números de teléfono: Asegúrese de que los números de celular de su base de datos tienen el formato requerido por la API: normalmente formato internacional incluyendo el prefijo (52 en México). Revise la política de prefijos.
- Tamaño de los mensajes: compruebe que los textos de los mensajes a enviar no superen los 160 caracteres. Si alguno debe rebasarlo, estudie cómo conseguirlo en la API con los SMS concatenados.
- Caracteres del mensaje: Comprueba que todos los caracteres que se van a enviar estén permitidos. Si necesita enviar caracteres especiales, infórmese sobre los SMS unicode.
- Gestión del crédito restante: Evalúe cómo gestionar el número de mensajes disponibles en su cuenta a partir de la API
- Tamaño de los paquetes de SMS en cada petición: Si prevé que va que enviar paquetes de mensajes muy grandes consulte con el proveedor sobre la mejor forma de hacerlo para optimizar la comunicación con la API.
- Lea siempre la respuesta de la API antes de hacer otra petición. Es posible que se produzca algún error y se tiene que decidir cómo actuar antes de seguir con el envío.
- Pruebas: Diseñe una batería de tests que permitan evaluar el correcto comportamiento del software.
Modelo de distribución
Si ha integrado el envío de SMS en un software que distribuye debe plantearse cómo va a gestionar las cuentas de sus clientes. Revise las siguientes opciones con el proveedor.
- Administrar una cuenta multiusuario donde compra al proveedor y reparte SMS entre sus clientes, añadiendo un margen a las tarifas para obtener beneficio. En este caso tendrá que asumir la tarea comercial y de soporte.
- Puede trasladar la labor de gestión al proveedor ofreciendo sus datos a aquellos clientes suyos que quieran utilizar el envío de SMS.
Compra y puesta en marcha
- Efectúe el pago y almacene el contrato del proveedor.
- Ejecute la batería de tests antes de poner el servicio en producción
Descargue el documento
Para facilitar el proceso hemos creado el siguiente documento que puede imprimir para ir marcando los pasos según los vayas completando.