• No se han encontrado resultados

En los ejemplos de esta documentación se usa el símbolo {:name} para tu nombre de usuario y {:pass} para tu contraseña.

N/A
N/A
Protected

Academic year: 2021

Share "En los ejemplos de esta documentación se usa el símbolo {:name} para tu nombre de usuario y {:pass} para tu contraseña."

Copied!
10
0
0

Texto completo

(1)

SMTP XML API

Permite enviar SMS mediante correo electrónico.

Aspectos generales

En los ejemplos de esta documentación se usa el símbolo {:name} para tu nombre de usuario y {:pass} para tu contraseña. Para enviar SMS/MMS mediante la plataforma de envío de SMS vía email de Lleida Networks, simplemente debe enviar un email con los siguientes parámetros:

Asunto Vacío.

Destinatario xmlsms@sms.lleida.net

Cuerpo del mensaje El cuerpo del mensaje debe ir formateado según la especificación de las secciones 1, 2, o 3.

Elementos comunes

Elemento dst

Este elemento debe contener uno o más subelementos num, cada uno de los cuales contiene un número de teléfono destinatario del mensaje:

Ejemplo de petición

<dst> <num>+34600000000</num> <num>+41700000000</num> <num>+33888888888</num> </dst>

Los números de teléfono deben indicarse en formato internacional (es decir, con el signo + al principio del código de país). No hay un límite definido para la cantidad de destinatarios de un mensaje, pero se recomienda no sobrepasar los 1000. Tenga en cuenta que en las URL se deben codificar correctamente los símbolos especiales. Por ejemplo en este caso %2B

que corresponde al símbolo +.

Elemento src

Este elemento contiene el remitente del mensaje, el remitente puede ser numérico o alfanumérico. Si el remitente es alfanumérico, éste no puede superar los 11 carácteres de longitud, si es numérico, no puede superar los 15 carácteres.

(2)

Ejemplo de petición

<sms>

<user>:name</user>

<password>:pass</password> <src>miremitente</src>

...

Elemento txt

El elemento txt contiene el texto del SMS que se enviará. En el caso que la longitud del texto sea mayor que el límite de caracteres por SMS (160 en caso de mensajes de texto con codificación ASCII, y 70 en el caso de mensajes en codificación Unicode), el SMSC de Lleida Networks dividirá el mensaje en varios SMS encadenados.

Este elemento dispone de dos parámetros opcionales, enconding y charset, para el caso que el texto del mensaje esté en una codificación diferente de la especificada en la cabecera del XML. Un ejemplo sería el caso que el XML esté codificado en ISO-8859-1 y se quiera enviar un SMS en Unicode.

Si el texto del mensaje está en una codificación diferente de la del XML, el parámetro encoding debe tener el valor base64, y el contenido del elemento txt debe estar codificado en base64. De este modo se evita el problema deque el XML no sea válido por encontrar caracteres no permitidos en la codificación utilizada. Además, el parámetro charset debe contener el código de caracteres utilizado (por ejemplo, 'utf-16' para codificación Unicode). Cuando el servidor de la API se encuentra con estos parámetros, primero descodifica el texto de base64, y posteriormente lo importa según el charset especificado. Debe remarcarse que los parámetros enconding y charset no afectan a la codificación del SMS resultante: su única función es poder incluir texto en cualquier charset dentro del XML. La codificación que tendrá el SMS cuando se envíe depende del contenido del elemento data_coding.

El siguiente ejemplo especifica como texto del SMS la frase "Hello world", pero utilizando la codificación utf-16.

Ejemplo

<txt encoding="base64" charset="utf-16">

/v8ASAB1AGwAbABvACAAdwBvAHIAbABk

</txt>

Elemento data_coding

Este elemento opcional controla la codificación en que se enviará el SMS (ver la especificación de la 3GPP número TS 23.038). Los dos valores permitidos son: text, sólo se permiten en el texto del mensaje los caracteres del alfabeto ISO-8859-1. En cambio, con el valor 'unicode' se puede utilizar caracteres de cualquier alfabeto del mundo (siempre y cuando el teléfono receptor lo permita), ya que el SMS es enviado en utf-16.

(3)

del elemento txt.

El siguiente ejemplo envía un SMS que contiene las letras griegas alfa y beta:

Ejemplo de petición

<?xml version="1.0" encoding="ISO-8859-1"?>

<sms>

<user>:name</user>

<password>:pass</password> <dst>

<num>+3088888888</num> </dst>

<txt encoding="base64" charset="utf-16">

/v8DsQ0y

</txt>

<data_coding>unicode</data_coding> </sms>

Elemento delivery_receipt

Este elemento activa la petición de notificación de entrega para el SMS. El elemento puede estar vacío, o contener una dirección de correo electrónico.

Si contiene una dirección de correo electrónico, se enviará un mail a esta dirección cuando la operadora notifique algún cambio de estado del mensaje, que pueden ser Delivered, Buffered (fuera de cobertura o apagado), Acknowledged (by the operator SMC) o Rejected.

Si el elemento aparece vacío, se activa igualmente la petición de notificación. Cuando se reciba, el estado del mensaje se anota en las bases de datos del SMSC de Lleida Networks, y puede ser consultado mediante la intranet de usuario.

Este elemento dispone de cuatro atributos opcionales que se utilizan para activar y configurar el servicio de SMS certificado. En el atributo lang se indica el idioma en que se desea recibir el certificado de recepción, cuyo valor por defecto es Español. El atributo cert_type debe contener el tipo de certificado que se quiere consultar: D para el tipo certificado y T para los contratos.

Los atributos cert_name y cert_name_id se utilizan para indicar la razón social y el NIF que aparecerá en la certificación del PDF.

(4)

Código Idioma Código Idioma DE Alemán CA Catalán ES Español FR Francés EN Inglés IT Italiano NL Neerlandés PT Portugués

IMPORTANTE: Si se activa el servicio de SMS certificado, el elemento delivery_receipt debe contener el correo electrónico dónde se enviará el certificado de recepción. En caso de no contener el correo electrónico aparecerá el error -8: Correo electrónico incorrecto.

Ejemplo de envío de SMS con notificación via email:

<?xml version="1.0" encoding="ISO-8859-1"?>

<sms>

<user>:name</user>

<password>:pass</password> <dst>

<num>+3460000000</num> <num>+3466666666</num> </dst>

<txt>El texto del mensaje</txt> <delivery_receipt>

micorreo@electronico.es

</delivery_receipt> </sms>

Ejemplo de envío de SMS con petición de estado de entrega sin enviarla a un email:

<?xml version="1.0" encoding="ISO-8859-1"?>

<sms>

<user>:name</user>

(5)

<dst>

<num>+3460000000</num> <num>+3466666666</num> </dst>

<txt>El texto del mensaje</txt> <delivery_receipt/>

</sms>

Ejemplo de envío de SMS con certificado de recepción:

<?xml version="1.0" encoding="ISO-8859-1"?>

<sms>

<user>:name</user>

<password>:pass</password> <dst>

<num>+3460000000</num> <num>+3466666666</num> </dst>

<txt>El texto del mensaje</txt>

<delivery_receipt lang = "ES" cert_type="D"> micorreo@electronico.es

</delivery_receipt> </sms>

Elemento allow_answer

Este elemento permite especificar que el envío del mensaje se realice con un remitente numérico largo para que el destinatario pueda responderlo. Si el usuario tiene un número própio asignado se utilizará éste, sino se asignará uno dinámico.

Cuando se especifica este elemento no puede aparecer el elemento src.

Ejemplo de petición

<?xml version="1.0" encoding="ISO-8859-1"?>

<sms>

<user>:name</user>

<password>:pass</password> <dst>

<num>+3460000000</num> <num>+3466666666</num> </dst>

<txt>El texto del mensaje</txt> <allow_answer/>

(6)

</sms>

Elemento mt_id

Este elemento permite que el usuario asigne un identificador único para cada mensaje, que posteriormente se puede utilizar para consultar el estado del mensaje.

El contenido del elemento debe ser una cadena alfanumérica única, a la que posteriormente el sistema añadirá el número de destino para formar el identificador.

Ejemplo de petición

<?xml version="1.0" encoding="ISO-8859-1"?>

<sms>

<user>:name</user>

<password>:pass</password> <dst>

<num>+3460000000</num> <num>+3466666666</num> </dst>

<txt>El texto del mensaje</txt> <mt_id>ABCDE1234</mt_id>

</sms>

Tal como se ha indicado, el sistema añade el teléfono de destino al identificador para poder gestionar el caso de

multienvíos. En el ejemplo anterior, el identificador generado para el primer mensaje sería ABCDE1234:+34600000000, y para el segundo sería ABCDE1234:+34666666666.

IMPORTANTE: Si con el mismo mt_id se repite el destinatario, la consulta de estado sólo devolverá la información del último enviado.

Elemento schedule.

Con este elemento se puede especificar la fecha y hora en que se desea que se entregue el mensaje en destino. De este modo es posible realizar un envío de mensajes programado a una fecha y hora concretas. El formato de la fecha debe ser YYYYMMDDhhmm.

Ejemplo de petición

Este ejemplo programaría el mensaje de texto para ser entregado a los dos destinatarios el día 1 de Diciembre del 2007 a las 13:50.

<?xml version="1.0" encoding="ISO-8859-1"?>

<sms>

(7)

<password>:pass</password> <dst>

<num>+3460000000</num> <num>+3466666666</num> </dst>

<txt>El texto del mensaje</txt> <schedule>200712011350</schedule> </sms>

Elemento mail

Este elemento permite especificar una dirección de correo electrónico a la que se enviará el reporte con el resultado del envío del mensaje y el saldo disponible en la cuenta del usuario que realiza el envío.

<sms>

<user>:name</user>

<password>:pass</password> <dst>

<num>+3460000000</num> <num>+3466666666</num> </dst>

<txt>this is the SMS text</txt> <mail>my@mail.com</mail>

</sms>

Tipos de MMS

MMSPermite enviar y recibir contenidos multimedia, incorporando sonido, video, fotos o cualquier contenido disponible en el futuro.

WappushEl envío de un Wappush es significativamente más económico que el envío de un MMS, y es obligatorio para contenidos que no son multimedia, por ejemplo, juegos Java. En contrapartida, es menos directo para el usuario final, ya que éste debe autorizar la descarga del contenido.

WaplinkEl formato del cuerpo del mensaje para este tipo de envios es parecido al de enviar un SMS. El teléfono recibirá un mensaje de navegador (mensaje WAP) con el comentario que se envía y la URL para entrar a la página o descargarse el contenido.

Mime Types soportados

Tipos de contenido permitidos en los MMS. Los MMS pueden incluir los siguientes formatos de contenido: Imágenesformatos GIF y JPEG (normal y progresivo)

image/gif image/jpeg

SonidoAMR, WAV, MP3 y MIDI

audio/amr audio/x-wav audio/mpeg

(8)

audio/midi

Videoformatos 3GP y MPEG4

video/3gpp video/mpeg

Es necesario tener en cuenta que el operador de red, al configurar su MMSC, decide qué tipos de contenido pueden enviarse al terminal del usuario y cuáles no.

Para los Waplink se pueden configurar mas MimesTypes que no están en esta lista.

Formato de los SMIL

Lleida.net no se responsabiliza del formato incorrecto de un SMIL enviado mediante esta API. Es responsabilidad de la aplicación cliente generar un SMIL bien formado y correcto.

SMIL Recommendation: http://www.w3.org/TR/SMIL (http://www.w3.org/TR/SMIL/) SMIL 2 version: http://www.w3.org/TR/SMIL2 (http://www.w3.org/TR/SMIL2/) SMIL 3 version: http://www.w3.org/TR/SMIL3 (http://www.w3.org/TR/SMIL3/)

Envío de SMS

El cuerpo del mensaje debe estar en XML, y no debe aparecer ningún otro contenido a parte de éste (firmas, etc). El root element del XML debe ser el tagsms.

Parámetros

userLogin del usuario en la plataforma de envíos de SMS de Lleida.net.

passwordContraseña del usuario en la plataforma de envíos de SMS de Lleida.net.

txtEl texto del SMS.

dstContiene uno o más elementos num, con los números destino del SMS.

srcOpcional. Contiene el remitente del mensaje.

data_codingOpcional. Especifica la codificación del SMS.

delivery_receiptOpcional. Activa la notificación de entrega.

allow_answerOpcional. Activa el envío con remitente numérico largo.

mt_idOpcional. Especifica un identificador único para el mensaje.

scheduleOpcional. Especifica la hora en que se desea entregar el mensaje en destino.

mailOpcional. Un email de control, al cual se enviará un mensaje con el resultado de la operación y el saldo disponible.

Ejemplo

<?xml version="1.0" encoding="ISO-8859-1"?>

<sms>

<user>:name</user>

<password>:pass</password> <dst>

<num>+34600000000</num> <num>+34666666666</num> </dst>

<txt>el texto del mensaje</txt> </sms>

(9)

Envío de Waplink

El formato del cuerpo del mensaje para este tipo de envios es parecido al de enviar un SMS. El teléfono recibirá un mensaje de navegador (mensaje WAP) con el comentario que se envía y la URL para entrar a la página o descargarse el contenido. El

root element del XML debe ser waplink.

Con los envíos del Waplink no se puede activar la opción de SMS Certificado. En el parámetro delivery_receipt los atributos opcionales lang y cert_type no se deben introducir.

Parámetros

userLogin del usuario en la plataforma de envíos de SMS de Lleida.net.

passwordContraseña del usuario en la plataforma de envíos de SMS de Lleida.net.

txtEs el texto que le aparece como comentario del mensaje al destinatario antes de descargar su contenido.

dstContiene uno o más elementos num, con los números destino del SMS.

urlEnlace web (URL), normalmente será un link a una imagen, melodía o aplicación.

delivery_receiptOpcional. Activa la notificación de entrega.

mailOpcional. Un email de control, al cual se enviará un mensaje con el resultado de la operación y el saldo disponible.

Ejemplo

<waplink>

<user>:name</user>

<password>:pass</password> <dst> <num>+3460000000</num> <num>+3466666666</num> </dst> <url> http://www.miweb.es/imagen.jpg </url> <txt> Descripción </txt> <delivery_receipt> micorreo@electronico.es </delivery_receipt> </waplink>

Envío de MMS

El formato del cuerpo del mensaje para el envío de MMS es similar al anterior, pero con algunos cambios. En primer lugar, el archivo multimedia a enviar (imágen, melodía, etc) se debe incluir en el mail como attachment, por lo que el cuerpo del correo debe ir codificado según el estándar MIME con content-type 'multipart/mixed' y donde la primera parte corresponde al XML de control y la segunda parte corresponde al archivo. Las aplicaciones de correo realizan este paso automáticamente y sólo hace falta escribir en el cuerpo el XML de control y luego añadir el attachment. En cambio, si se realiza el envío desde una aplicación, se debe realizar la codificación explícitamente (hay librerías MIME disponibles para casi todos los lenguajes de programación). Es importante que las cabeceras MIME de la subparte correspondiente al fichero multimedia incluyan el

(10)

content-type de los datos, ya que en caso contrario los teléfonos móviles no serán capaces de leer el fichero. El root element del XML debe ser obligatoriamente el tagmms.

Parámetros

userLogin del usuario en la plataforma de envíos de SMS de Lleida.net

passwordContraseña del usuario en la plataforma de envíos de SMS de Lleida.net

txtEs el texto que le aparece como comentario del mensaje al destinatario antes de descargar su contenido.

dstContiene uno o más elementos num, con los números destino del MMS

subjectAsunto del MMS.

waplinkOpcional. Indica si debe enviarse el mensaje como WAPPUSH

mailOpcional. Un email de control, al cual se enviará un mensaje con el resultado de la operación y el saldo disponible.

Ejemplo

<mms>

<user>:name</user>

<password>:pass</password> <dst>

<num>+3460000000</num> <num>+3466666666</num> </dst>

<subject>Envio MMS</subject> <txt>

el texto que se mostrará a continuación del contenido multimedia

</txt> <waplink/> </mms>

Referencias

Documento similar

Sanz (Universidad Carlos III-IUNE): &#34;El papel de las fuentes de datos en los ranking nacionales de universidades&#34;.. Reuniones científicas 75 Los días 12 y 13 de noviembre

(Banco de España) Mancebo, Pascual (U. de Alicante) Marco, Mariluz (U. de València) Marhuenda, Francisco (U. de Alicante) Marhuenda, Joaquín (U. de Alicante) Marquerie,

Missing estimates for total domestic participant spend were estimated using a similar approach of that used to calculate missing international estimates, with average shares applied

The part I assessment is coordinated involving all MSCs and led by the RMS who prepares a draft assessment report, sends the request for information (RFI) with considerations,

Ciaurriz quien, durante su primer arlo de estancia en Loyola 40 , catalogó sus fondos siguiendo la división previa a la que nos hemos referido; y si esta labor fue de

 Para recibir todos los números de referencia en un solo correo electrónico, es necesario que las solicitudes estén cumplimentadas y sean todos los datos válidos, incluido el

La determinación molecular es esencial para continuar optimizando el abordaje del cáncer de pulmón, por lo que es necesaria su inclusión en la cartera de servicios del Sistema

En la última parte (sección 4), defen- deré que un enfoque adecuado para dar cuenta de la moralidad de jueces o abogados puede ser reconstruido con provecho si utilizamos los