Introducción
Enviar SMS a través de API es una de las formas más utilizadas para comunicarse con clientes, en esta guía descubrirá cómo realizar la integración con API para enviar SMS de la mejor forma posible. Es importante tener en cuenta determinados factores para estar seguro de que sus procesos de negocio siempre funcionarán al 100%.
¿Qué lenguaje de programación debo usar para enviar SMS?
El envío de SMS es independiente del lenguaje de programación a usar, esto quiere decir que debe utilizar el lenguaje de programación que actualmente usen en el proyecto en el cual desean integrar este servicio, en Afilnet le ofrecemos el código listo para copiar y pegar para cualquier lenguaje de programación, esté código le permite enviar SMS de forma sencilla y rápida, pero si realmente desea que su solución sea mejor, siga todas las indicaciones posibles de esta guía.
Sin embargo, nunca debe integrar el envío de SMS en un lenguaje que se ejecuten en el lado del cliente (por ejemplo en el navegador), ya que sus credenciales quedarán expuestas al usuario. Estos lenguajes que debe evitar son: Javascript o VBScript
¿Qué tengo que tener en cuenta a la hora de enviar SMS a través de API?
Remitente
El remitente es el origen del SMS, en muchas destinaciones el remitente se puede personalizar, lo que le permite indicar aquí el nombre de su empresa. Debe tener en cuenta que el remitente tiene una longitud máxima de 11 caracteres. Esto quiere decir que cualquier remitente de mayor longitud será acotado o reemplazado.
Tenga en cuenta que la personalización del remitente no está admitido por todas las operadoras y existen diferente legislación en países del mundo. Por lo que es importante que revise esta información en nuestra página de información de SMS, para ello acceda a la página de tarifas, y pulse en "información sobre cobertura".
Codificación SMS
Codificación GSM 03.38
Hay que tener en cuenta que el SMS es un estándar basado en la codificación GSM 03.38, la cual tiene algunas restricciones de caracteres que puede influir en que los destinatarios reciban correctamente el contenido del SMS.
Los caracteres compatibles con la codificación GSM 03.38 son los siguientes:
Así mismo, debe tener en cuenta la longitud del SMS, un SMS con codificación GSM 03.38 tiene una longitud máxima de 160 caracteres, si envía SMS de mayor longitud estos se enviarán concatenados y se recibirá en el destinatario cómo un sólo SMS.
Codificación Unicode
La codificación Unicode le permite enviar cualquier tipo de carácter por SMS, lo que le da acceso no solo a enviar acentos en sus SMS, sino también compatibilidad con lenguajes no latinos (árabe, chino, griego, ruso, etc.). Si desea enviar Unicode, debe saber que la longitud de un SMS Unicode es de 70 caracteres.
Integrar SMS API en su software de forma exitosa
A la hora de realizar la integración del envío de SMS en su aplicación, siga nuestras indicaciones, que no solo le permitirán integrar el envío de SMS desde API, sino que le permitirán sacar el máximo partido a este canal. Nuestro objetivo no es solo que su empresa realice una correcta integración de la API y pueda enviar SMS. Este artículo le permitirá evitar problemas de conectividad, compatibilidad y seguridad, así cómo, la generación de información de valor que le permitan crear métricas para la toma de decisiones.
Identificación del envío realizado
En Afilnet cuando envíe un SMS recibirá un identificador del envío, este identificador debe guardarse junto con los datos del SMS enviado, ya que le permitirá consultar el estado de entrega de dicho SMS en cualquier momento.
Obtener y utilizar el estado de entrega
Una vez ha realizado el envío, es importante conocer el estado de entrega, ya que en algunos casos pueden existir incidencias a nivel de red o simplemente que el destinatario ya no existe o no esté disponible. Para ello en Afilnet le ofrecemos una API en donde consultar el estado en cualquier momento. El estado de entrega es imprescindible porque nos indica si el SMS ha sido entregado o, por el contrario, no ha podido ser posible. Ahora bien, si el SMS no ha sido entregado, debería tener un trigger que notifique de que dicho SMS no ha sido entregado o que active el envío de la notificación por otro medio (llamada de voz, email, mensajería instantánea, etc.).
Creación de un archivo log para la API
Es importante que disponga de un log en el cual poder consultar la información de los envíos realizados, el estado de entrega, etc. Este archivo es importante porque le ayudará a sacar conclusiones sobre los destinos de sus SMS. Es posible, por ejemplo, que esté enviando SMS de forma continuada a destinatarios que ya no existen. Por lo que es aconsejable que además de la creación de un log, disponga de una herramienta que monitorice este log en busca de patrones que le ofrezcan información adicional.
Securizar la conexión con la API
La seguridad a la hora de conectar con la API es imprescindible, por lo que si está realizando una integración deben tener en cuenta estas medidas de seguridad. La correcta implementación de la seguridad de sus integraciones le permite evitar problemas antes que estos surjan.
Logs de peticiones
Nunca guarde las credenciales de la API en ningún log de ningún tipo, las credenciales son datos confidenciales que le podrían permitir a terceros suplantar su identidad. Aunque los archivos de logs normalmente se guardan en directorios no accesibles, estos pueden quedar al descubierto en caso de un acceso no autorizado.
Activar filtros por IP (Lista Blanca)
Es importante que solo puedan conectar con la API de SMS las IPs que realmente tengan autorización para tal fin.
La API de Afilnet le permite definir las IPs que tendrán acceso a la API y, por tanto, podrá enviar SMS. Este filtro evitará que si alguien tiene acceso a sus credenciales pueda enviar SMS (Tenga en cuenta que debe poner los medios para que esto nunca ocurra, y ponerle solución tan pronto cómo ocurra).
Nunca compartas credenciales
Nunca compartas tus credenciales, ni con el equipo de desarrollo, ni con sus clientes, ni con nadie del equipo que no esté autorizado.
La plataforma de Afilnet le permite gestionar credenciales y compartir estás solo con las personas que lo necesiten, cuando lo necesiten. Una vez este acceso no sea necesario, puede revocarlo desde la misma plataforma de Afilnet. Esta característica le permite tener un control más avanzado de las personas o roles, que tienen acceso con el servicio de envío de SMS.
Creación de roles / departamentos / franquiciados
Es importante que cuando realiza la integración de una API en la plataforma a la que acceden diferentes entidades de cualquier tipo, disponer de una forma de diferenciar quien está realizando el envío de SMS. Esto puede permitirle llevar un control detallado del uso que realiza cada persona, departamento, franquicia, etc. del servicio de SMS.
En Afilnet tiene la posibilidad de crear una estructura organizativa con diferentes roles y accesos, esto no solo le permitirá independizar cada identidad a la hora de realizar el envío de SMS, también le da la posibilidad de realizar un seguimiento de cada identidad de forma independiente y llevar un control de acceso, gastos y facturación.
Quiero que me ayuden con la integración de la API de SMS
Nuestra empresa está especializada en la integración del envío de SMS a través de API, por ello, le ofrecemos en esta guía información detallada de que debe tener en cuenta a la hora de integrar el envío de SMS y la mejor forma posible para realizar la integración. Esto le garantizará que sus comunicaciones siempre tengan éxito.
Referencias
[Wikipedia] https://en.wikipedia.org/wiki/GSM_03.38