Lista de tareas para una integración de API SMS. Checklist completo.

24 de febrero de 2021

SMS masivo desde 2002

Si quieres 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 asegurarte 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 debes tener en cuenta para concluir todo el proceso.

Queremos ayudarte en esta tarea y te 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ás un archivo pdf descargable para poder marcar los pasos de la lista según los vayas completando.

Integración SMS API checklist

Análisis previo

Prepara 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?, ¿cumple RGPD?
  • Países con cobertura: ¿vas 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.
  • Mensajes de dos vías: Si necesitas recibir respuesta de los usuarios a los que has 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 y no del proveedor.
  • Tasas de envío. ¿cuántos SMS por segundo voy a necesitar enviar?

Comprueba si existe ya algún módulo SMS para tu 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.

Elige 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 tu software es incluso posible que tengas que descartar alguno antes de empezar. Los más comunes para el envío de SMS son:

Selecciona 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.

Elección del proveedor

Condiciones técnicas

Selecciona un proveedor que ofrezca el tipo de API que te interesa y soporta el lenguaje que quieres emplear.

  • Revisa con detenimiento la documentación técnica de la API del proveedor. Presta también atención a los parámetros opcionales del servicio porque pueden ofrecer funcionalidades adiciones de interés.
  • Plantea tu lista de requisitos al proveedor para ver cuáles cumple.
  • Solicita una cuenta de prueba gratuita.

Condiciones económicas

  • Consulta las tarifas 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?
  • Pregunta si existen cuotas mensuales o anuales de algún tipo.
  • Comprueba qué medios de pago ofrecen (tarjeta, transferencia bancaria…)

Condiciones legales y reputación

  • Revisa los términos del contrato
  • Revisa las condiciones de uso
  • Comprueba la reputación del proveedor.

Prueba de concepto

  • Ayudas a la integración: Pregunta 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.
  • Realiza una prueba sencilla con un código básico para asegurarte únicamente de que hay conectividad y has podido emplear correctamente la API para enviar un SMS.
  • Asegúrate de capturar la respuesta de la API para saber que el proceso ha sido correcto.
  • Procesa 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: Gestiona la confirmación de entrega si en tu país está disponible este servicio.
  • Tiempos de espera: Presta atención a los tiempos de espera máximos para detectar posibles problemas de comunicación con el API del proveedor.
  • Soporte: Si estás teniendo problemas en la integración consulta la FAQ del proveedor o contacta con su servicio técnico

Integración del envío de SMS en tu software

  • Integra el código que has probado en tu software, adecuando el estilo y las prácticas de programación de tu negocio.
  • Formato de los números de teléfono: Asegúrate de que los números de teléfono de tu base de datos tienen el formato requerido por la API. Revisa la política de prefijos.
  • Tamaño de los mensajes: comprueba que los textos de los mensajes a enviar no superan los 160 caracteres. Si alguno debe rebasarlo, estudia 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 necesitas enviar caracteres especiales, infórmate sobre los SMS unicode.
  • Gestión del crédito restante: Evalúa cómo gestionar el número de mensajes disponibles en tu cuenta a partir de la API
  • Tamaño de los paquetes de SMS en cada petición: Si prevés que vas que enviar paquetes de mensajes muy grandes consulta con el proveedor sobre la mejor forma de hacerlo para optimizar la comunicación con la API.
  • Lee siempre la respuesta de la API antes de hacer otra petición. Es posible que se produzca algún error y se tienes que decidir cómo actuar antes de seguir con el envío.
  • Pruebas: Diseña una batería de tests que permitan evaluar el correcto comportamiento del software.

Modelo de distribución

Si has integrado el envío de SMS en un software que distribuyes debes plantearte cómo vas a gestionar las cuentas de tus clientes. Revisa las siguientes opciones con el proveedor.

  • Puedes administrar una cuenta multiusuario donde tú compres al proveedor y repartas SMS entre tus clientes, añadiendo un margen a las tarifas para obtener beneficio. En este caso tendrás que asumir la tarea comercial y de soporte.
  • Puedes trasladar la labor de gestión al proveedor ofreciendo sus datos a aquellos clientes tuyos que quieran utilizar el envío de SMS.

Compra y puesta en marcha

  • Efectúa el pago y almacena el contrato del proveedor.
  • Ejecuta la batería de tests antes de poner el servicio en producción

Descarga el documento

Para facilitar el proceso hemos creado el siguiente documento que puedes imprimir para ir marcando los pasos según los vayas completando.

Checklist integración SMS