ENVÍO DE SMS A TRAVÉS DE FTP INALAMBRIA INTERNACIONAL C O N F I D E N C I A L Enero de 2015
Contenido 1. Descripción general... 3 2. Datos de conexión... 3 3. Estructura de carpetas... 4 4. Estructura del contenido del archivo... 4 4.1.1. Envío personalizado:... 4 4.1.2. Envío masivo:... 5 5. Estructura del nombre del archivo... 5 6. Caracteres validos e inválidos en los mensajes de texto... 6 6.1.1. Caracteres válidos:... 6 6.1.2. Caracteres inválidos:... 6
Envío de SMS a través de FTP 1. DESCRIPCIÓN GENERAL Inalambria busca continuamente nuevas opciones para la facilidad y satisfacción de sus clientes. Con este fin se ha desarrollado un sistema que permite realizar envíos de mensajes de texto masivos o personalizados, transfiriendo un archivo en texto plano (.txt) con una estructura específica a uno de nuestros servidores a través del protocolo FTP (File Transfer Protocol). Este método puede ser utilizado para realizar automatizaciones y permite envíos de millones de mensajes. Si la conexión se va a realizar de forma manual es importante que el cliente descargue un cliente FTP como por ejemplo Filezilla. 2. DATOS DE CONEXIÓN Para acceder y transferir el archivo, el cliente deberá establecer una conexión mediante el protocolo FTP con los siguientes datos: Nombre Servidor Nombre de usuario Contraseña Valor imp.inalambria.com Datos suministrados por Inalambria para la identificación y acceso del cliente Puerto 21 Si la validación de los datos es exitosa, se observará el listado de carpetas generadas por Inalambria:
3. ESTRUCTURA DE CARPETAS Dump: En esta carpeta se copian los archivos que no se procesaron correctamente debido a inconsistencias en los formatos prestablecidos. Input: En esta carpeta se deben transferir los archivos que se deseen que sean procesados. Log: En esta carpeta se generan logs automáticos del procesamiento de los archivos. Processed: En esta carpeta se copian todos los archivos que se han terminado de procesar correctamente. Processing: En esta carpeta se copian todos los archivos que están siendo procesados en el momento. Temp: En esta carpeta se crean archivos temporales necesarios para el procesamiento de los archivos. 4. ESTRUCTURA DEL CONTENIDO DEL ARCHIVO Para satisfacer la necesidad de nuestros clientes se han desarrollado dos estructuras de tipo de envío: envío masivo y envío personalizado. El envío masivo es el que a una cantidad determinada de números celulares se les envía el mismo mensaje. En el envío personalizado se envía un mensaje distinto a cada número celular. 4.1.1. Envío personalizado: La estructura del archivo para un envío personalizado es: {Número celular}{tabulación}{mensaje de texto personalizado} Quedando de la siguiente manera:
Adicionalmente, los envíos personalizados permiten programar cada mensaje con una fecha de envío diferente, si el cliente lo desea, quedando de la forma: {Número celular}{tabulación}{mensaje de texto personalizado}{tabulación}senddate={fecha y hora de envío} El formato de la fecha y hora es: dd/mm/yyyy HH:mm:ss 4.1.2. Envío masivo: La estructura del archivo para un envío masivo es: Message: {Mensaje de texto que se desea enviar} Device: {Listado de números celulares a los que se les desea envía el mensaje de texto separados por saltos de línea} 5. ESTRUCTURA DEL NOMBRE DEL ARCHIVO El nombre de archivos de texto deben seguir hora}_{tipo de envío}.txt en donde: la estructura: {Cuenta}_{Fecha y Nombre Cuenta Descripción Cuenta del cliente que se utiliza para el envío. Fecha y hora Fecha y hora de programación de los mensajes. Si se desea que los mensajes se envíen en el mismo momento se debe colocar la fecha y hora actual. El formato debe ser yyyymmddhhmmss
Tipo de envío Se especifica el tipo de envío, si es personalizado se coloca la letra P en caso contrario si es masivo se coloca la letra M. Un ejemplo seria: aramirez_20150114150000_p.txt e indicaría que la cuenta que se utilizaría para el envío seria aramirez, la fecha de envío de los mensajes seria el miércoles 14 de enero de 2015 a las 3 de la tarde y que es un envío personalizado. 6. CARACTERES VALIDOS E INVÁLIDOS EN LOS MENSAJES DE TEXTO 6.1.1. Caracteres válidos:! " # $ % & ' ( ) * +, -. / 0 1 2 3 4 5 6 7 8 9 : ; < = >? @ A B C D E F G H I J K L M N O P Q R S T U V W X Y Z [ \ ] ^ _ ` a b c d e f g h i j k l m n o p q r s t u v w x y z { } ~ 6.1.2. Caracteres inválidos: ª «± ² ³ μ ¹ º» ¼ ½ ¾ À Á Â Ã Ä Å Æ Ç È É Ê Ë Ì Í Î Ï Ð Ñ Ò Ó Ô Õ Ö Ø Ù Ú Û Ü Ý Þ ß à á â ã ä å æ ç è é ê ë ì í î ï ð ñ ò ó ô õ ö ø ù ú û ü ý þ ÿ