Configuración y protocolo del conector SMS sms-connector-protocol
Información general overview
Los SMS pueden limitarse a enviar mensajes de texto cortos sin formato, pero su sencillez lo convierte en un valioso canal de comunicación.
Existen dos maneras principales de enviar un SMS:
- Enviarlo manualmente desde un teléfono, la forma habitual de comunicarse directamente entre personas.
- Enviarlo desde Internet, la forma en que Adobe Campaign envía mensajes. Para eso, se necesita un proveedor de servicios de SMS que conecte Internet a la red móvil.
Adobe Campaign utiliza el protocolo SMPP para enviar SMS a un proveedor de servicios.
Este documento le guiará a través de la conexión configurada entre Adobe Campaign y un proveedor SMPP.
Los proveedores de SMPP a veces pueden desviarse de la especificación oficial, pero el conector de SMS en Adobe Campaign ofrece muchas opciones para adaptar su comportamiento para que sea compatible con la mayoría de los proveedores.
Protocolo SMPP smpp-protocol
Adobe Campaign Classic es compatible con la versión 3.4 del protocolo SMPP. Es un protocolo muy extendido que permite enviar SMS a un proveedor (SMSC) y recibir SMS, así como acuses de recibo. Para obtener más información, consulte la documentación de SMPP.
El equipo de red en el lado del proveedor de servicios SMS suele conocerse como SMSC.
Conexiones SMPP smpp-connections
Adobe Campaign se conecta al equipo de red del proveedor de servicios SMS a través de TCP. El protocolo SMPP establece conexiones TCP permanentes desde Adobe Campaign al proveedor. Adobe Campaign siempre inicia las conexiones TCP, incluso para recibir mensajes.
SMPP abre 1 o 2 conexiones TCP, dependiendo de su modo. Adobe Campaign siempre inicia todas las conexiones.
El protocolo SMPP puede funcionar en dos modos:
- Transmisor+receptor (o TX+RX): se utilizan dos conexiones TCP independientes para transmitir y recibir mensajes.
- Transceptor (o TRX): se utiliza una sola conexión TCP para transmitir y recibir mensajes.
PDU SMPP smpp-pdu
Las unidades de transmisión SMPP (“paquetes”) se denominan PDU. Una PDU contiene un comando, un estado, un número de secuencia y datos.
Cada PDU debe ser reconocida por una SMPP RESP PDU (respuesta sincrónica). Las solicitudes pueden canalizarse: el remitente puede enviar muchos comandos sin esperar RESP, el número de solicitudes que se pueden canalizar en cualquier momento se denomina ventana. RESP PDU puede llegar en cualquier orden, sin relación con el orden de su PDU iniciador correspondiente.
En el modo separado Transmisor+receptor, la conexión utilizada depende del tipo de mensaje transmitido. La conexión del transmisor se utiliza para MT y la conexión del receptor para MO y SR. Las solicitudes y respuestas para cada tipo de mensaje se envían a través de la misma conexión TCP.
Por ejemplo, al enviar un mensaje MT, se utiliza la conexión del transmisor y el RESP que reconoce el mensaje MT también se envía a través del canal del transmisor. Cuando recibe un MO (o un SR), la conexión del receptor se utiliza para recibir el MO y para enviar el RESP que reconoce el MO.
En Adobe Campaign Classic, para vincular SR con su MT correspondiente, SMSC devuelve un ID con los pasos SUBMIT_SM_RESP y DELIVER_SM. El identificador se almacena en el campo providerId de la tabla nms::providerMsgId y está vinculado a broadLogId y deliveryId. Esta operación de coincidencia se realiza mediante el proceso SMS al escribir en la base de datos.
Un SUBMIT_SM_RESP PDU exitoso activa el estado de mensaje “enviado” en el registro de envío, mientras que un DELIVER_SM (SR) PDU exitoso activa el estado de mensaje “recibido”.
Aspectos de seguridad security-aspects
El protocolo en sí no está cifrado. La mayoría de los proveedores implementan una variante de IP en la lista de permitidos, por lo que las direcciones IP del servidor Adobe Campaign deben declararse al proveedor.
Adobe Campaign permite pasar un inicio de sesión y una contraseña durante la fase de enlace. También admite SMPP a través de TLS. Cabe señalar que los certificados son necesarios para garantizar la seguridad adecuada. Aunque el conector SMPP permite omitir las comprobaciones de certificados, solo debe utilizarse para pruebas, ya que TLS sin certificados proporciona un nivel de seguridad significativamente inferior.
El conector utiliza los certificados predeterminados proporcionados por la biblioteca openssl del sistema. Generalmente lo proporciona el directorio /etc/ssl/certs en Debian. Este directorio lo proporciona el paquete “ca-certificates” de manera predeterminada, pero se puede personalizar.
Información en cada tipo de PDU information-pdu
Cada tipo de PDU tiene campos distintos que llevan diferentes partes de información. Estas PDU se detallan en la especificación SMPP 3.4.
Cada sección a continuación describe la PDU y su respuesta sincrónica (*_RESP PDU). Todas las PDU deben ser reconocidas por una RESP correspondiente, es una parte obligatoria de la especificación.
Las PDU pueden tener campos opcionales. Aquí solo se describen los campos más comunes. Consulte la especificación SMPP 3.4 para obtener más información.
BIND_TRANSMITTER / BIND_RECEIVER / BIND_TRANSCEIVER
Esta PDU se utiliza para iniciar una conexión al SMSC. Los modos Transmisor, Receptor y Transceptor solo cambian el tipo de SMS que se permite transferir a través de esta conexión, específicamente:
Campos notables en una BIND_* PDU:
-
system_id: Credenciales utilizadas para la autenticación. Se configura en la cuenta externa.
-
contraseña: Contraseña utilizada para la autenticación. Se configura en la cuenta externa.
-
system_type: Necesario para establecerse en un valor específico para algunos proveedores. Se configura en la cuenta externa, disponible en todas las versiones. A menudo distingue entre diferentes tipos de contratos, canales, países, etc.
-
addr_ton y addr_npi: Requerido por algunos proveedores. Establecido por la configuración
Bind TONyBind NPIen la cuenta externa. -
address_range: Requerido por algunos proveedores. La mayoría de las veces, esta es una lista de códigos abreviados permitidos en esta conexión. Se configura en la cuenta externa.
BIND_*_RESP no tiene un campo específico, confirma si la conexión se realizó correctamente o no.
UNBIND unbind
El sistema debe enviar esta PDU antes de desconectarse. Debe esperar la PDU correspondiente UNBIND_RESP antes de cerrar la conexión.
La conformidad con SMSC no debe cerrar la conexión, la conexión TCP está controlada por el conector Adobe Campaign.
SUBMIT_SM submit-sm
Esta PDU envía un MT al SMSC. Su PDU de respuesta proporciona el ID del MT.
Campos notables en una PDU SUBMIT_SM:
-
service_type: requerido por algunos proveedores. Se establece en las propiedades de envío.
-
source_addr_ton y source_addr_npi: indica qué tipo de dirección de origen se transmite. El significado de estos campos está estandarizado, pero dado que algunos proveedores lo utilizan de manera diferente, debe solicitar al proveedor su valor correcto. Se configura en la cuenta externa.
-
source_addr: la dirección de origen / oADC del MT. Se mostrará en el teléfono móvil. Establecido en la cuenta externa y el envío, el valor del envío tiene prioridad sobre el valor de la cuenta externa.
-
dest_addr_ton y dest_addr_npi: indica qué tipo de dirección de destino se transmite (por ejemplo, formato local o internacional). El significado de estos campos está estandarizado, pero dado que algunos proveedores lo utilizan de manera diferente, debe solicitar al proveedor su valor correcto. Se configura en la cuenta externa.
-
destination_addr: dirección de destinatario, número de teléfono o MSISDN.
-
esm_class: se utiliza para indicar si se usa UDH o no en el campo de texto. Habilitado automáticamente por el conector para SMS dividido si no se utiliza el modo
message_payload. -
priority_flag: prioridad de este mensaje sobre otros. Esto está ligado a la prioridad del propio envío.
-
validity_period: marca de tiempo después de la cual no se debe reintentar. Establecido en el envío mismo.
-
registered_delivery: indica si se solicita o no un SR. Adobe Campaign siempre establece este indicador excepto para las respuestas automáticas. Para los mensajes de varias partes, el indicador solo se establece para la primera parte. Todas las versiones tienen el mismo comportamiento.
-
data_coding: indica la codificación utilizada en el campo de texto. Consulte la sección Codificación de texto SMS (documentación de Campaign v8) para obtener más información.
-
short_message: el texto del mensaje. Si se usa UDH, también contiene el encabezado de UHD.
Adobe Campaign admite estos campos opcionales:
-
dest_addr_subunit: utilizado para especificar el destinatario del SMS: flash, móvil o tarjeta SIM. Se establece en las propiedades de envío.
-
message_payload: cuando se habilita en la cuenta externa, los mensajes largos se envían en una sola PDU y el texto se transmitirá en este campo en lugar de en el campo
short_message.
SUBMIT_SM_RESP submit-sm-resp
Esta PDU contendrá el ID del MT. Esto resulta útil para relacionarlo con SR entrante.
Algunos proveedores envían SUBMIT_SM_RESP después de enviar el SR. Para tener en cuenta ese comportamiento, Adobe Campaign espera 30 segundos antes de responder ID de mensaje no válido a un SR con un ID desconocido.
DELIVER_SM delivery-sm
El SMSC envía esta PDU a Adobe Campaign. Contiene un MO o un SR.
La mayoría de los campos tienen el mismo significado que su contraparte SUBMIT_SM. Esta es la lista de campos útiles:
-
source_addr: dirección de origen del MO/SR. Generalmente es un número de teléfono.
-
destination_addr: código corto que recibió el MO o el SR.
-
esm_class: se usa para saber si la PDU es un MO o un SR.
-
short_message: texto del mensaje. Para SR, contiene datos descritos en el apéndice B de la especificación del protocolo SMPP. Consulte Administración de errores de SR para obtener más detalles.
Adobe Campaign puede leer el ID del mensaje en el campo opcional receipted_message_id con alguna configuración.
DELIVER_SM_RESP deliver-sm-resp
Adobe Campaign envía esta PDU para reconocer SR y MO.
Adobe Campaign Classic reconoce SR y MO una vez insertados en la base de datos. Algunos errores de procesamiento pueden ocurrir incluso si se ha enviado una PDU DELIVER_SM_RESP correcta. Esta limitación se debe a la arquitectura de software de Adobe Campaign Classic.
ENQUIRE_LINK enquire-links
Esta PDU solo se utiliza para comprobar que la conexión está activa. Su frecuencia debe establecerse de acuerdo con las necesidades del proveedor.
Los 60 segundos predeterminados deben coincidir con la mayoría de las configuraciones establecidas en la cuenta externa.
ENQUIRE_LINK_RESP enquire-links-resp
Esta PDU reconoce que la conexión está activa.
SMS de varias partes (SMS largos) multipart
message_payload no son compatibles con los SMS entrantes (MO), lo que significa que los MO están limitados a 160 caracteres.Límite de rendimiento y basado en ventanas throughput-capping
La mayoría de los proveedores requieren un límite de rendimiento para cada conexión SMPP. Esto se puede lograr estableciendo un número de SMS en la cuenta externa. Tenga en cuenta que la limitación del rendimiento se produce por conexión, el rendimiento efectivo total es el límite por conexión multiplicado por el número total de conexiones. Esto se detalla en la sección Conexiones simultáneas.
Para alcanzar el máximo rendimiento posible, tendrá que ajustar la ventana de envío máxima. La ventana de envío es el número de SUBMIT_SM PDU que se puede enviar sin esperar a SUBMIT_SM_RESP. Consulte la sección Configuración de la ventana de envío (documentación de Campaign v8) para obtener más detalles.
SR y administración de errores (“Apéndice B”) sr-error-management
El protocolo SMPP define errores sincrónicos estándar en RESP PDU, pero no define códigos de error para SR. Cada proveedor utiliza sus propios códigos de error con su significado.
Se realiza una recomendación en la sección del apéndice B de la especificación del protocolo SMPP (página 167), pero esto no incluye los códigos de error reales ni su significado.
Para adaptarse a la administración de errores, se ha aprovechado el sistema de mensajes de banda ancha de Adobe Campaign para aprovisionar correctamente los errores y su gravedad (difícil, suave, etc.).
Como se mencionó anteriormente, hay dos tipos diferentes de errores:
- respuestas sincrónicas en el
SUBMIT_SM_RESPque se producen inmediatamente después de enviar el mensaje al SMSC - los recibos que pueden llegar mucho más tarde cuando el dispositivo móvil recibe el mensaje o cuando se agota el tiempo de espera del mensaje. En ese caso, el error se encuentra en un SR.
Cuando se recibe un SR, el estado y el error se pueden encontrar en su campo short_message (por ejemplo, para implementaciones conformes con el Apéndice B). El campo short_message de la PDU se denomina generalmente campo de texto porque contiene texto en MT. En el caso de SR, contiene información técnica más un subcampo denominado Texto. Estos 2 campos son diferentes y short_message en realidad contiene el campo Texto y otra información.
Los conectores de Adobe Campaign Classic (excepto Extended SMPP) utilizan un comportamiento codificado que depende del proveedor seleccionado. El SMPP genérico solo distingue entre éxito y error, sin ningún detalle. El registro de envíos puede contener información que no está garantizada.
Formato de campo de texto SR sr-text-field-format
La especificación recomienda utilizar este formato para el campo de texto SR. Es una lista de subcampos, separados por espacios con dos puntos para separar el nombre del campo y su valor. Los nombres de campo no distinguen entre mayúsculas y minúsculas.
Ejemplo de un campo de texto SR que coincide con la recomendación del Apéndice B:
id:1234567890 sub:001 dlvrd:001 submit date:1608011415 done date:1608011417 stat:DELIVRD err:000 Text:Hello Adobe world
El campo id es el ID recibido en el SUBMIT_SM_RESP PDU, el reconocimiento del MT.
sub y dlvrd deberían contar la cantidad de piezas enviadas y mensajes enviados, pero Adobe Campaign no lo utiliza, ya que el sistema de banda ancha proporciona una información mejor y más integrada.
Los campos submit date y done date son marcas de hora indicativas de cuándo se envió el mensaje MT y cuándo el dispositivo móvil envió el mensaje SR. Se esperan algunos problemas con los husos horarios o incluso marcas de hora incorrectas proporcionadas por los móviles con una fecha establecida incorrectamente.
El campo stat es importante porque indica el estado del mensaje. El único estado importante es DELIVRD, UNDELIV y REJECTD. El estado DELIVRD indica un resultado exitoso, los otros dos indican un error. Otros valores son posibles, pero suelen ser notificaciones intermedias, por ejemplo, el MT llegó al operador de telefonía móvil, pero no el teléfono móvil. Adobe Campaign ignora estas notificaciones intermedias.
El campo err contiene el código de error específico del proveedor. El proveedor debe proporcionar una tabla de posibles códigos de error junto con su significado para poder interpretar este valor.
Finalmente, el campo de texto en general contiene el principio del texto de MT. Adobe Campaign lo ignora y algunos proveedores no lo transmiten para evitar fugas de PII y consumo de ancho de banda de la red. Se puede utilizar durante la resolución de problemas para localizar el SR que coincide con un MT de prueba más fácilmente leyendo este campo.
Ejemplo de procesamiento SR en SMPP genérico de Adobe Campaign Classic Extended sr-processing
Este ejemplo muestra el caso de una implementación que sigue a la recomendación del Apéndice B, los valores predeterminados en la cuenta externa y un mensaje SMS MT correcto.
id:1234567890 sub:001 dlvrd:001 submit date:1608011415 done date:1608011417 stat:DELIVRD err:000 Text:Hello Adobe world
En primer lugar, la regex id extraction se aplica para extraer el ID y reconciliarlo con el MT correspondiente.
A continuación, la regex status extraction y la regex error code extraction se aplican para extraer estos campos y se anexan a la cadena.
El mensaje del “broadlog” se construye con esta información y la cadena original sin modificar se anexa como referencia:
SR ExampleProvider DELIVRD 000|MESSAGE=id:1234567890 sub:001 dlvrd:001 submit date:1608011415 done date:1608011417 stat:DELIVRD err:000 Text:Hello Adobe world
A continuación, el mensaje se normaliza, eliminando la parte MENSAJE para poder hacer coincidir varios mensajes con los mismos códigos de estado y error.
SR ExampleProvider DELIVRD 000|#MESSAGE#
Si el mensaje no se ha aprovisionado ya en la tabla de mensajes de “broadlog”, se creará una nueva entrada, con todo el mensaje como firstText y el mensaje normalizado. A continuación, el conector utiliza el éxito y la regex error para determinar si ha sido un éxito o un error:
-
Si coincide con la regex
success, se considera un éxito. -
Si coincide con la regex
error, el mensaje se califica como un error. -
Si ninguna de estas dos regex coincide, se ignora el SR. Podría ser una notificación intermedia, que Adobe Campaign no gestiona.
De forma predeterminada, todos los errores se aprovisionan como errores leves. Esto significa que los errores graves deben aprovisionarse a mano.
Parámetros de cuenta externa de SMPP SMPP-parameters-external
Cada implementación del protocolo SMPP tiene muchas variaciones. Para mejorar la compatibilidad y la adaptabilidad, hay muchos ajustes disponibles para cambiar el comportamiento del conector SMPP. Esta sección describe todos los parámetros y sus efectos en el conector.
Parámetros generales y enrutamiento general-parameters-routing
Limitar instancias de MTA para esta cuenta
Es posible establecer un límite en el número de instancias de MTA permitidas para conectarse al proveedor de SMPP. Cuando se selecciona, puede especificar cuántos MTA se pueden usar como máximo.
Esta opción permite un control más preciso del número de conexiones; consulte Conexiones simultáneas.
Si establece un valor mayor que el número de MTA en ejecución, todos los MTA se ejecutarán normalmente: esta opción es solo un límite y no puede generar MTA adicionales.
Si necesita controlar con precisión el número de conexiones, por ejemplo, el requisito del proveedor, se recomienda establecer siempre esta opción aunque la implementación actual tenga el número correcto de MTA en ejecución. Si después se agregan MTA adicionales, se respetará el límite de conexión.
Configuración de conexión connection-settings
Nombre de implementación de SMSC smsc-implementation-name
Define el nombre de la implementación de SMSC. Debe configurarse con el nombre de su proveedor. Póngase en contacto con el administrador o con el equipo de entregabilidad para saber qué añadir en este campo. La función de este campo se describe en la sección gestión de errores SR.
Número de conexiones secundarias MTA number-mta-child
En Adobe Campaign Classic, define el número de conexiones por elemento secundario MTA.
El conector SMPP extendido de Adobe Campaign Classic puede controlar el número de conexiones por elemento secundario de MTA. Para controlar el límite global de conexiones, tendrá que limitar el número de procesos secundarios de MTA, lo que a menudo significa tener una plataforma intermediaria dedicada para SMS.
Para Adobe Campaign Classic, puede haber un número diferente de conexiones de receptor y transmisor:
- Conexiones del transmisor = Número de conexiones secundarias MTA * número de procesos secundarios MTA * número de MTA (si se establece la respuesta automática) * número de conexiones secundarias MTA
Como se ha sugerido anteriormente, el proceso SMS de Adobe Campaign Classic abre más conexiones de transmisores si la respuesta automática está habilitada. Estas conexiones adicionales se utilizan para enviar las respuestas automáticas.
- Conexiones del receptor = Número de conexiones secundarias MTA
Si configura respuestas automáticas, el proceso SMS abrirá pares de transmisores/receptores, aumentando el número de conexiones de transmisores. Si no configuró ninguna respuesta automática, solo se abrirán conexiones de recepción.
Habilitar TLS en SMPP enable-TLS
Utilice TLS para conectarse al proveedor. La conexión se cifrará. La conexión TLS es administrada por la biblioteca OpenSSL. Todo lo aplicable a OpenSSL será verdadero para esta conexión.
Habilitar los seguimientos SMPP detallados en el archivo de registro enable-verbose-log-file
Esta configuración elimina todo el tráfico de SMPP en los archivos de registro. A menudo es necesario ajustar los parámetros durante la configuración inicial. Esto debe habilitarse al solucionar problemas del conector y compararse con el tráfico que ve el proveedor.
En Adobe Campaign Classic, la salida de registro se encuentra en el registro MTA para el tráfico relacionado con MT y en el registro SMS para el tráfico relacionado con MO y SR.
Configuración de conexión del receptor receiver-connection
Esta sección solo está visible en el modo separado transmisor + receptor.
Usar parámetros diferentes para el receptor receiver-parameters
Cuando la casilla está desactivada, se utiliza la misma configuración para el transmisor y el receptor.
Cuando la casilla está activada, la configuración de la sección Configuración de conexión se aplicará al transmisor y la configuración en los ajustes de conexión del receptor se aplicará al receptor.
Servidor receptor, puerto, cuenta, contraseña, tipo de sistema
Esta configuración se aplica al receptor cuando se encuentra en modo transmisor+receptor. Funcionan como la parte del transmisor, ver arriba para más detalles.
Configuración de canal SMPP smpp-channel-settings
Almacenar el MO entrante en la base de datos incoming-mo-storing
Cuando se habilita, el MO entrante se almacena en la tabla inSMS de la base de datos. Esta tabla se puede consultar mediante la actividad de consulta de cualquier flujo de trabajo.
Adobe Campaign Classic siempre almacena todos los MO en la base de datos de inSMS, por lo que esta opción no está disponible.
Habilitar actualizaciones de KPI en tiempo real durante el procesamiento de SR real-time-kpi
Cuando se habilita, los KPI se actualizan en tiempo real en la página de envío principal cuando se recibe un SR de error.
La desventaja puede ser un bajo rendimiento debido al contenido de la base de datos que genera. Si se deshabilita, las estadísticas se actualizan mediante el flujo de trabajo syncfromexec, que se ejecuta cada 20 minutos.
Adobe Campaign Classic tiene un mecanismo completamente diferente para los KPI, por lo que esta opción no está disponible.
Código corto short-code
Indica el código corto principal de la cuenta. Si se utilizan varios códigos cortos para esta cuenta o si se desconoce el código corto, deje este campo vacío.
Especificar código corto resulta útil para dos funciones:
-
La previsualización mostrará el código corto si no se proporciona ningún número de origen. Reflejará el comportamiento real en el teléfono móvil.
-
La configuración de lista de bloqueados de la función de respuesta automática solo envía a cuarentena al usuario de un código corto específico.
Detalles de SMSC SMSC-specifics
Estas configuraciones son ajustes avanzados que adaptan el conector de Adobe Campaign a la mayoría de las peculiaridades de implementación de SMPP.
Omitir comprobación de certificado TLS skip-tls
Cuando TLS está habilitado, omitir todas las comprobaciones de certificado.
Cuando se selecciona, la conexión ya no es segura, por lo que no debe habilitarse en producción.
Puede resultar útil para depurar o probar.
Puede elegir entre tres valores diferentes para la validación del certificado:
- Comprobación de certificación completa (incluido el nombre de host), predeterminada.
- Omita la verificación del nombre de host.
- Omita la verificación del certificado.
Regex aplicada para determinar el estado correcto/de error regex-applied
Cuando se encuentran mensajes con una combinación de campo stat/err desconocida, estas regex se aplican en el campo estadísticas (“stat”) para determinar si el SR fue un éxito o un error. Se omiten los valores de SR con los valores estadísticos que no coinciden con ninguna de estas expresiones regulares.
De forma predeterminada, los valores de estadística comienzan por DELIV, p. ej.: DELIVRD en el Apéndice B, se considera que se ha entregado correctamente y todos los valores de estadística que coincidan con errores, p. ej.: REJECTED, UNDELIV, se consideran errores.
Formato de ID en reconocimiento MT id-format-mt
Indica el formato del ID devuelto en el campo message_id del SUBMIT_SM_RESP PDU.
-
No modificar: El ID se almacena tal cual en la base de datos, como texto con codificación ASCII. No hay ningún procesamiento previo ni filtrado.
-
Número decimal : Se espera que el ID sea un número decimal en formato ASCII. Cuando se utiliza este ajuste, se eliminan los espacios iniciales y finales y los ceros al inicio.
-
Número hexadecimal: se espera que el ID sea un número hexadecimal en formato ASCII, sin 0x inicial ni h final. El ID se convierte a continuación en un número decimal antes de almacenarse en la base de datos.
-
Cadena hexadecimal: Se espera que el ID sea un texto con codificación ASCII que es en sí mismo una cadena de bytes codificados como hexadecimales. P. ej.: en la PDU encontrará
0x34 0x31 0x34 0x32 0x34 0x33, que se traduce como ASCII “414243”. A continuación, esta cadena se descodifica como una cadena hexadecimal de bytes y se obtiene “ABC” como resultado: almacenará el ID “ABC” en la base de datos.
Formato de ID en SR id-format-sr
Esto indica el formato del ID capturado por la regex Extraction del ID en el SR. Los valores tienen el mismo significado y el mismo comportamiento que el formato de MT anterior.
ID de SR o código de error en el campo opcional
Si se selecciona, el contenido de los campos opcionales se anexará al texto procesado por las expresiones regulares anteriores. El texto tendrá el formato 0xTAG:VALUE, 0xTAG siendo el valor hexadecimal de 4 dígitos de la etiqueta en mayúsculas, p. ej.: 0x002E.
Por ejemplo, es posible que desee capturar el ID en el campo receipted_message_id. Para ello, habilite esta casilla de verificación y el siguiente texto se agrega al estado:
0x001E:05e3299e-8d37-49d0-97c6-8e4fe60c7739
En este ejemplo, 0x001E es la etiqueta del campo opcional y UUID es el valor del campo.
Para capturar este valor, ahora puede establecer la siguiente regex en la regex de Extracción del ID en el campo SR:
\b0x001E:([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})\b
Etiqueta de ID de servicio
Permite añadir un TLV personalizado. Este campo establece la porción de etiqueta. El valor se puede personalizar por envío en el valor ID de servicio o programa en los parámetros avanzados del envío.
Esta configuración solo permite añadir una opción TLV por mensaje.
Respuesta automática enviada al MO automatic-reply
Esta función permite responder texto rápidamente a MO y controlar el envío de código corto a la lista de bloqueados.
Las columnas Palabra clave y Código corto definen condiciones para la activación de la respuesta automática. Si coinciden ambos campos, se envía el MO y se activa la acción adicional. Para especificar un comodín, debe dejar el campo vacío. La palabra clave coincide con la primera palabra alfanumérica del texto MO, omitiendo la puntuación y los espacios iniciales. Esto significa que el campo Palabra clave no puede contener espacios y debe ser una sola palabra.
La configuración Palabra clave es un prefijo. Por ejemplo, si especifica “AD”, coincidirá con “AD”, “ADAPT” y “ADOBE”. Si tiene varias palabras clave con un prefijo común, debe prestar atención al orden, ya que las palabras clave se procesan de arriba a abajo.
La columna Respuesta es el texto que se va a responder. No hay personalización disponible en este campo. Si deja este campo vacío, no se responderá ningún mensaje, pero la acción adicional se activará de todos modos.
La columna Acción adicional proporciona una acción adicional cuando tanto la Palabra clave como el Código corto coinciden, el código corto vacío coincide con todos los códigos cortos. Puede enviar a la cuarentena o quitar de la cuarentena, ningún valor responde al texto. Si especifica una Acción adicional pero deja vacío el campo Respuesta, la acción se ejecutará pero no se enviará ninguna respuesta. La cuarentena solo se aplica al código corto especificado o a todos los códigos cortos si el campo se deja vacío.
Todas las entradas de la tabla se procesan en el orden especificado, hasta que una regla coincida. Si varias reglas coinciden con un MO, solo se aplicará la regla superior.
Parámetros de plantilla de envíos de SMS sms-delivery-template-parameters
Algunos parámetros se pueden definir por la plantilla de envíos.
Parámetros de envío delivery-parameters
Modo de transmisión transmission-mode
Este campo indica el tipo de SMS que desea transferir: mensajes normales o flash, almacenados en el móvil o en la tarjeta SIM.
Esta configuración se transmite en el campo opcional dest_addr_subunit de SUBMIT_SM PDU.
-
Sin especificar no envía ningún campo opcional en la PDU.
-
Flash establece el valor en 1. Envía un mensaje flash que aparece en el dispositivo móvil y no se almacena en la memoria.
-
Normal establece el valor en 0. Envía un mensaje normal.
-
Guardar en un móvil establece el valor en 2. Le dice al teléfono que almacene el SMS en la memoria interna.
-
Guardar en un terminal establece el valor en 3. Le dice al teléfono que almacene el SMS en la tarjeta SIM.
Período de validez validity-period
El período de validez se transmite en el campo validity_period del SUBMIT_SM PDU. La fecha siempre está formateada con un formato de hora UTC absoluta, el campo de fecha finalizará con “00+”.
Conector SMPP genérico extendido acc-extended-connector
Las flechas representan flujos de datos.
Al enviar partes de envío, el MTA genera elementos secundarios de MTA. El número de procesos secundarios de MTA es dinámico y depende de una configuración en serverConf.xml. Cada elemento secundario de MTA crea una instancia del conector CSmppConnectorWorker que se conecta al proveedor del SMPP. Las conexiones se mantienen activas mientras el elemento secundario de MTA se mantenga activo, también se puede configurar en serverConf.xml.
El proceso del SMS solo procesa SR, se conecta al proveedor y deja la conexión abierta. El proceso se vuelve a conectar cada 10 minutos para volver a cargar la nueva configuración, lo cual es normal.
Entradas de MT, SR y “broadlog” que coinciden matching-mt
Se utiliza una tabla intermedia nmsProviderMsgId para almacenar los datos de MT y SR temporalmente antes de enviarse asincrónicamente al “broadlog”.
nmsProviderMsgId tiene 3 grupos de columnas:
-
Columnas actualizadas cuando se envía y se reconoce un mensaje MT:
iBroadLogId,iDeliveryId -
Columnas actualizadas cuando se recibe un SR:
iMsgId,iStatus -
Columnas que siempre se actualizan:
tsCreated,sProviderId
Cuando haya terminado el procesamiento de MT y SR, debe tener líneas completas, con información de “broadlog” e información de estado.
Aquí, iMsgId está vinculado a la tabla nmsBroadLogMsg, lo que indica el mensaje de estado/error completo.
El proceso de SMS busca líneas completas cada minuto y luego las procesa asincrónicamente:
- se lee la línea completa.
- El proceso del SMS calcula el nombre de la tabla de “broadlog” en función de la asignación de envíos.
- El proceso del SMS actualiza la tabla de “broadlog” con el ID del mensaje y el estado.
Conexión en paralelo y de rendimiento
Cada elemento secundario de MTA crea una cantidad configurable de conexiones, por lo que si se limita el número de elementos secundarios de MTA se limita el número de conexiones. Debido a que la correlación entre los procesos secundarios de MTA y el tráfico está correlacionado, se puede controlar de alguna manera pero sigue siendo impredecible.