Recomendaciones y buenas prácticas

Recomendaciones API

Consejos para una integración SMS API

En esa sección encontrarás las recomendaciones y aspectos técnicos a tener en cuenta en cualquier integración con una API SMS. Los consejos y recomendaciones que se recogen aquí se pueden aplicar a cualquier integración con cualquier proveedor SMS. No obstante, se describen algunas funcionalidades y características propias de la plataforma LabsMobile.

Nuestro departamento técnico cuenta con profesionales con más de 10 años de experiencia en el sector SMS. Tras innumerables integraciones hemos elaborado esta lista de puntos clave y temas a revisar en cualquier integración SMS.

Rogamos encarecidamente que todo usuario que integre sus aplicaciones con nuestra API SMS compruebe y revise los siguientes puntos:

 Configuración

Se recomienda revisar la configuración de la cuenta. En especial:

Preferencias de la cuenta

• Idioma
• País por defecto (para añadir el prefijo a los envíos, procesos de importación, etc.).
• Zona Horaria
• Moneda
• Máximo de mensajes por día

Configuración de las notificaciones

• Activación de las notificaciones deseadas
• Email/s para la recepción de notificaciones, alertas, códigos 2FA.
• Alerta de saldo personalizada

Datos de facturación y contacto

• Teléfono móvil verificado

 Seguridad

Conexión https

Se debe utilizar siempre una URL que incorpore el protocolo HTTPS en cualquier versión API.

     https://api.labsmobile.com/...

Token API

Es muy recomendable usar un token API como contraseña en las conexiones API. Es posible generar tantos tokens API como sean necesarios en el apartado 'Seguridad y contraseñas' de la cuenta LabsMobile.

El beneficio de esta medida es doble. Añade más seguridad al no exponer la contraseña general de la cuenta y además no es necesario modificar la integración API cuando se cambie la contraseña de la cuenta.

Se aconseja crear un token API por cada proyecto, aplicación o uso diferenciado.

Filtro IP

Es posible limitar las direcciones IPs permitidas de origen para realizar peticiones a la API de LabsMobile.

En el apartado 'Preferencias de la cuenta' se puede añadir una o varias direcciones IPs de los servidores o sistemas del cliente que accedan a la API.

Esta medida bloquea cualquier acceso no permitido de terceros aunque dispongan de una contraseña o token válidos.

Contraseñas y 2FA

Es necesario guardar la contraseña de acceso a la cuenta (y tokens API) encriptada y a buen recaudo siguiendo los estándar de seguridad.

Es recomendable no intercambiar o comunicar ninguna credencial por email o canal no cifrado que pueda ser interceptado por terceros.

También recomendamos modificar con frecuencia cualquier credencial de acceso o autenticación (realizar un cambio de contraseña como mínimo cada 6 meses).

Es obligatorio la autenticación 2FA (mediante contraseña y código de seguridad) en el acceso al panel de control de la cuenta LabsMobile. De esta forma se protege el acceso no permitidos a datos confidenciales/personales y se preserva el saldo y métodos de pago de la cuenta.

 Consumo y tipología SMS

Tipos de mensaje SMS

Existen dos tipos de mensajes SMS: Estándar y Unicode. Estos dos tipos de mensajes se diferencian en los caracteres que pueden contener y su capacidad.

Los mensajes SMS estándar pueden contener hasta 160 caracteres del alfabeto GSM. Es decir, es posible enviar los siguientes caracteres: ABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyz0123456789@£¥èéùìòÇØøÅåΔΦΓΛΩΠΨΣΘΞÄÖÑܧäöñüà_^|{}[~]€ÆæßÉ!/\"#¤%&'()*+,-.|:;<=>?.

Los mensajes SMS unicode pueden contener cualquier carácter, símbolo, emoji, etc. pero la capacidad máxima es de 70 caracteres.

Es posible enviar mensajes SMS concatenados (ya sean estándar o unicode) que el destinatario verá como un único mensaje.

Créditos por envío

Los consumo de créditos de un envío se calcula en función del país de destino, tipología SMS (estándar o unicode) y la longitud de los caracteres del mensaje.

Cada país de destino tiene su coste por SMS (coste unitario por SMS estándar) que se puede consultar en el apartado Precios SMS.

Si el texto del mensaje contiene sólo caracteres del alfabeto GSM se envirán SMS estándar que tendrán un coste en créditos en función del país destino y longitud del mensaje:

De 1 a 160 caracteres GSM => X

De 161 a 306 caracteres GSM => 2X

De 307 a 459 caracteres GSM => 3X

De 460 a 612 caracteres GSM => 4X

(Siendo X el coste unitario del país o países de destino)

En el caso de SMS unicode el cálculo de créditos se realiza de la siguiente forma:

De 1 a 70 caracteres => X

De 71 a 134 caracteres => 2X

De 135 a 201 caracteres => 3X

De 202 a 268 caracteres => 4X

(Siendo X el coste unitario del país o países de destino)

No se recomienda enviar mensajes con una longitud mayor a 4 segmentos concatenados.

En caso de duda es posible consultar el número de créditos de un mensaje o envío en cualquier formulario de envío de la aplicación WebSMS.

Características por destino

Cada destino tiene características específicas de envío SMS determinadas por los operadores de telefonía de cada país.

En concreto en función del país puede variar:

Remitente. En función de la legíslación o los operadores de telefonía de cada país el campo remitente se podrá personalizar en cada envío (dinámico), que tenga un valor fijo (numérico, alfanumérico - longcode o shortcode) o aleatório.

Confirmación de entrega. Existen confirmaciones de entrega de re en el que operador local confirma la validez del mensaje. O confirmaciones de entrega de dispositivo en el que el terminal del destinatario confirma la recepción del SMS.

Horario permitido. Según la legislación o las normas de los operadores es posible que exista una limitación horaria de envío de mensajes SMS. Los mensajes enviados fuera de este horario permitido se bloqeuarán y no serán entregados.

Contenido y usos. Según el destino pueden existir limitaciones en el contenido (mensajes políticos, marcas comerciales, entidades financieras, palabras clave prohibidas, etc.) y el uso o aplicación (transaccionales o promocionales).

Recepción SMS. El servicio de recepción SMS puede estar disponible con números virtuales longcode o shortcode.

Las particularidades de cada país las puedes consultar en el apartado 'Créditos y servicios por país' y como advertencia al realizar cualquier envío en WebSMS. También puedes contactar con nuestro Centro de Soporte.

 Filtros y límites

Filtro antiduplicados

La plataforma LabsMobile dispone de un filtro para evitar enviar mensajes duplicados a un mismo destinatario.

Se consideran mensajes duplicados a partir del segundo SMS con el mismo texto y remitente enviado al mismo destinatario durante 60 minutos. Estos mensajes no se envían, no generan coste y se etiquetan como duplicados.

Es posible desactivar este filtro en las 'Preferencias de la cuenta'.

Filtro horario

A través del apartado 'Preferencias de la cuenta' es posible establecer un horario no permitido de envíos.

Cualquier envío realizado en estas horas no permitidas se bloquea temporalmente y se enviará en la siguiente hora permitida.

Los envíos bloqueados se pueden consultar y cancelar en el apartado 'Programados' de la cuenta.

Filtro por país

En las 'Preferencias de la cuenta' se pueden configurar los países posibles de destino de los mensajes de la cuenta. En el caso que no se defina ningún país la cuenta podrá enviar a cualquier destino.

Los envíos a países no permitidos se bloquearán y no tendrán coste.

Máximo diario y por envío

En las 'Preferencias de la cuenta' se define un máximo de mensajes por día (100.000 por defecto) y máximo números en un mismo envío (10.000 por defecto).

En caso de alcanzar alguno de los límites se bloquearan los mensajes temporalmente a la espera de una validación manual por parte de nuestro personal.

 Avisos y notificaciones

Aviso de saldo

La plataforma avisará por email cuando la cuenta llegue a un límite inferior de 10 créditos.

Además en la 'Configuración de las notificaciones' es posible establecer una alerta personalizada cuando el saldo llegue a un número determinado de mensaje al país por defecto.

Recargas automáticas

Para evitar agotar el saldo de la cuenta y no interrumpir los envíos es recomendable configurar las 'Recargas automáticas'.

Las recargas automáticas establecen un límite de saldo en el cual se realizará una compra o recarga de créditos establecida.

 Pruebas sugeridas

Caracteres especiales: En función de la versión y formato de la API (URL, XML, JSON, etc) es necesario condificar los valores o escapar una serie de caracteres especiales (como por ejemplo & ' " ! + < = >).

Prefijo de país: Es obligatorio añadir el prefijo del país de destino de cada número. La única excepción son los envíos al país configurado por defecto. En este caso la plataforma añadirá el prefijo de forma automática.

Sin texto: Verificar que nunca se realice un envío sin el campo texto o con un mensaje vacío.

Sin remitente: Es posible enviar mensajes sin el campo remitente y en ese caso se adoptará el remitente por defecto de la cuenta.

Sin destinatario: Verificar que nunca se realice un envío sin destinatarios.

Mensajes concatenados: Comprobar la longitud de los mensajes y limitar si se desea a un número determinado de segmentos concatenados.

Mensajes unicode: Elegir si se desea enviar mensajes unicode y en ese caso comprobar el coste y variables.

Variables: Comprobar los posibles valores de variables y que estas variables no contengan caracteres no permitidos o sobrepasen la longitud permitida o deseada.

Resultado llamada API: Comprobar el resultado (códigos de error) de cualquier llamada a la API. De forma que se puedan establecer alertas, etiquetar mensajes enviados y reintentos en caso de error de conexión.