Extras

Informes de entrega

El software de SMSEagle le permite habilitar informes de entrega para cada SMS enviado. Los informes de entrega son una función que permite recibir una confirmación de que el SMS fue recibido en el teléfono del destinatario.

Para habilitar los informes de entrega, vaya a la interfaz web > menú Settings y establezca “Delivery Reports” en “Yes”

Una vez que los informes de entrega estén habilitados en la interfaz web, puede verificar si el SMS fue entregado al destinatario:

En la interfaz web En el menú Folders > Sent items > abra el mensaje que desea verificar. Presione “Show Details“ en la esquina superior derecha del mensaje. El campo “Modem Status” contiene información sobre el estado de entrega

Usando Webhooks La función CallbackURL permite definir un webhook para el cambio de estado de entrega. Los webhooks son endpoints HTTP estándar implementados en su aplicación externa que aceptarán solicitudes HTTP del dispositivo SMSEagle. Los webhooks le evitan tener que enviar solicitudes continuamente al dispositivo SMSEagle preguntando por el estado del mensaje. Consulte más detalles en el capítulo Callback URL de este Manual del Usuario.
Usando API

Use el método “read_sms” para obtener datos de un SMS seleccionado en la carpeta sentitems. Los datos contendrán las columnas “Status” y “DeliveryDateTime” que incluyen información sobre el estado de entrega del mensaje. Para obtener más información sobre los posibles valores de la columna “Status”, consulte la tabla “Field Description Of Response Data – Sentitems Folder” en la Referencia de APIv1.

Conexión directa a la base de datos de SMSEagle

La base de datos de SMSEagle funciona con el motor de base de datos PostgreSQL. Puede usar un acceso directo a la base de datos para leer/escribir mensajes SMS directamente desde/hacia la base de datos mediante consultas SQL.

El acceso a la base de datos para aplicaciones externas está deshabilitado de forma predeterminada. Para habilitarlo, vaya a la interfaz web > menú Settings y habilite el siguiente ajuste:

Una vez habilitado el acceso a la base de datos, es posible conectarse a la base de datos desde una aplicación externa utilizando las siguientes credenciales:

Host: dirección IP de su dispositivo
Nombre de la base de datos: smseagle
Usuario: smseagleuser
Contraseña: postgreeagle

Inyectar SMS cortos usando SQL

El ejemplo más simple es un mensaje de texto corto (limitado a 160 caracteres):

INSERT INTO outbox (
    DestinationNumber,
    TextDecoded,
    CreatorID,
    Coding,
    Class,
    SenderID
) VALUES (
    '1234567',
    'This is a SQL test message',
    'Program',
    'Default_No_Compression',
    -1,
    'smseagle1'
);
INSERT INTO user_outbox (
    id_outbox,
    id_user
) SELECT CURRVAL(pg_get_serial_sequence('outbox','ID')), 1;

En el ejemplo anterior, el mensaje pertenecerá al usuario con id_user 1 (por defecto “admin”). Puede encontrar los valores de id_user para otros usuarios en la tabla public.»user». El campo SenderID contiene el número de identificación del módem SMSEagle. Para el módem 1, SenderID = smseagle1, SenderID = smseagle2 para el módem 2, etc.

Inyectar SMS largos usando SQL

Insertar mensajes de varias partes es un poco más complicado, también necesita construir el encabezado UDH y almacenarlo escrito en hexadecimal en el campo UDH. A menos que tenga una buena razón para hacerlo manualmente, use la API.

Para un mensaje de texto largo, el UDH comienza con 050003 seguido de un byte como referencia del mensaje (puede colocar cualquier valor hexadecimal ahí, pero debe ser diferente para cada mensaje, D3 en el siguiente ejemplo), un byte para el número de mensajes (02 en el ejemplo, debe ser único para cada mensaje que envíe al mismo número de teléfono) y un byte para el número del mensaje actual (01 para el primer mensaje, 02 para el segundo, etc.).

Por ejemplo, un mensaje de texto largo de dos partes podría verse de la siguiente manera:

INSERT INTO outbox (
    "DestinationNumber",
    "CreatorID",
    "MultiPart",
    "UDH",
    "TextDecoded",
    "Coding",
    "Class",
    "SenderID"
) VALUES (
    '1234567',
    'Program',
    'true',
    '050003D30201',
    'Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, qui',
    'Default_No_Compression',
    -1,
    'smseagle1'
)
INSERT INTO outbox_multipart (
    "ID",
    "SequencePosition",
    "UDH",
    "TextDecoded",
    "Coding",
    "Class"
) SELECT
    CURRVAL(pg_get_serial_sequence('outbox','ID')),
    2,
    '050003D30202',
    's nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.',
    'Default_No_Compression',
    -1;
INSERT INTO user_outbox (
    id_outbox,
    id_user
) SELECT
    CURRVAL(pg_get_serial_sequence('outbox','ID')),
    1;

Nota: Agregar UDH significa que tiene menos espacio para el texto, en el ejemplo anterior solo puede usar 153 caracteres en un solo mensaje.

Scripts de limpieza de la base de datos

Hemos agregado algunos scripts útiles que pueden usarse para eliminar mensajes SMS de la base de datos a través de la CLI de Linux. Los scripts se encuentran en el siguiente directorio: /opt/scripts/

db_delete – script para eliminar SMS de las carpetas Inbox, SentItems anteriores a la fecha proporcionada. Uso: ./db_delete YYYYMMDDhhmm
db_delete_7days – script para eliminar SMS de las carpetas Inbox, Sentitems anteriores a 7 días. Uso: ./db_delete_7days
db_delete_allfolders – script para limpiar las carpetas de la base de datos PostgreSQL (Inbox, SentItems, Outbox). Diseñado especialmente para ejecutarse periódicamente mediante cron. Uso: ./db_delete_allfolders
db_delete_select - script para eliminar SMS de la carpeta de base de datos elegida (Inbox, Outbox, SentItems, Trash). Uso: ./db_delete_select {inbox|outbox|sentitems|trash}

Agregar script al demonio cron del sistema

Cree un archivo dentro del directorio /etc/cron.d/ con el nombre que desee (por ejemplo, pico db_cleaner)

Ejemplo de contenido de este archivo: 0 0 1 * * root /opt/scripts/db_delete_allfolders

Esto ejecutará el script de limpieza cada día 1^ro del mes.

Agente SNMP

“Simple Network Management Protocol (SNMP) es un protocolo estándar de Internet para gestionar dispositivos en redes IP. Se utiliza principalmente en sistemas de gestión de redes para supervisar dispositivos conectados a la red en busca de condiciones que requieran atención administrativa” (fuente: Wikipedia).

El dispositivo SMSEagle tiene un agente Net-SNMP integrado. El agente SNMP proporciona acceso al árbol MIB de Linux Host del dispositivo y, además (mediante la extensión NET-SNMP-EXTEND-MIB), permite el acceso a métricas personalizadas específicas de SMSEagle.

Las métricas SNMP disponibles que describen el estado de un dispositivo SMSEagle son:

Nombre de la métrica	Descripción	OID
GSM_Signal1	Devuelve la intensidad de la señal 3G/4G en porcentaje para el módem 1. Rango de valores: 0-100. Si el módem está desconectado de la red celular, GSM_Signal devuelve 0.	.1.3.6.1.4.1.8072.1.3.2.3.1.2.11.71.83.77.95.83.105.103.110.97.108.49
GSM_Signal[X]	Devuelve la intensidad de la señal 3G/4G en porcentaje para el módem X. Rango de valores: 0-100. Si el módem está desconectado de la red celular, GSM_Signal devuelve 0.	.1.3.6.1.4.1.8072.1.3.2.3.1.2.11.71.83.77.95.83.105.103.110.97.108.[48+X]
GSM_NetName1	Devuelve el nombre de la red celular en el módem 1	.1.3.6.1.4.1.8072.1.3.2.3.1.2.12.71.83.77.95.78.101.116.78.97.109.101.49
GSM_NetName[X]	Devuelve el nombre de la red celular utilizada en el módem X	.1.3.6.1.4.1.8072.1.3.2.3.1.2.12.71.83.77.95.78.101.116.78.97.109.101.[48+X]
GSM_ModemState[X] donde X es el número del módem	Devuelve información sobre el estado del módem, habilitado/deshabilitado	.1.3.6.1.4.1.8072.1.3.2.3.1.2.11.77.111.100.101.109.83.116.97.116.101.49 (para el 1er módem) .1.3.6.1.4.1.8072.1.3.2.3.1.2.11.77.111.100.101.109.83.116.97.116.101.50 (para el 2do módem) etc.
FolderOutbox_Total	Devuelve el número de mensajes SMS en la carpeta Outbox (longitud de la cola de salida)	.1.3.6.1.4.1.8072.1.3.2.3.1.2.18.70.111.108.100.101.114.79.117.116.98.111.120.95.84.111.116.97.108
FolderInbox_Total	Devuelve el número de mensajes SMS en la carpeta Inbox	.1.3.6.1.4.1.8072.1.3.2.3.1.2.17.70.111.108.100.101.114.73.110.98.111.120.95.84.111.116.97.108
FolderSent_Last24H	Devuelve el número de mensajes SMS enviados desde el dispositivo en las últimas 24 horas	.1.3.6.1.4.1.8072.1.3.2.3.1.2.18.70.111.108.100.101.114.83.101.110.116.95.76.97.115.116.50.52.72
FolderSent_Last1M	Devuelve el número de mensajes SMS enviados desde el dispositivo durante el último mes	.1.3.6.1.4.1.8072.1.3.2.3.1.2.17.70.111.108.100.101.114.83.101.110.116.95.76.97.115.116.49.77
FolderSent_Last24HSendErr	Devuelve el número de mensajes SMS enviados con error en las últimas 24h. El error ocurre cuando el módem 3G no puede enviar el mensaje SMS o el mensaje es rechazado por el operador 3G/4G (esto sucede sobre todo cuando el saldo de una tarjeta SIM de prepago se ha agotado)	.1.3.6.1.4.1.8072.1.3.2.3.1.2.25.70.111.108.100.101.114.83.101.110.116.95.76.97.115.116.50.52.72.83.101.110.100.69.114.114
SIM_State[X] donde X es el número del módem	Devuelve información del estado físico de la SIM	.1.3.6.1.4.1.8072.1.3.2.3.1.2.10.83.73.77.95.83.116.97.116.101.49 (para el 1er módem) .1.3.6.1.4.1.8072.1.3.2.3.1.2.10.83.73.77.95.83.116.97.116.101.50 (para el 2do módem) etc.
SIM_RegState[X] donde X es el número del módem	Devuelve información del estado de registro de la tarjeta SIM en la red móvil.	.1.3.6.1.4.1.8072.1.3.2.3.1.2.13.83.73.77.95.82.101.103.83.116.97.116.101.49 (para el 1er módem) .1.3.6.1.4.1.8072.1.3.2.3.1.2.13.83.73.77.95.82.101.103.83.116.97.116.101.50 (para el 2do módem) etc.

Valores de resultado

Usando OID

Los valores de resultado para cada métrica personalizada están disponibles y pueden obtenerse desde el OID indicado en la tabla anterior.

Usando el nombre textual

Alternativamente, los valores de resultado para cada métrica personalizada pueden obtenerse usando nombres textuales desde el árbol OID bajo: NET-SNMP-EXTEND-MIB::nsExtendOutputFull.»[METRIC NAME]»

Por ejemplo: Valor de resultado para el parámetro GSM_Signal1: NET-SNMP-EXTEND-MIB::nsExtendOutputFull.»GSM_Signal1»

Si la herramienta SNMP que ha elegido no puede acceder a los objetos NET-SNMP-EXTEND-MIB, puede descargar las definiciones MIB desde: https://www.smseagle.eu/download/NET-SNMP-EXTEND-MIB.txt

Lectura de los valores de resultado Para probar la lectura de los valores de los parámetros desde el agente SNMP, puede usar cualquier herramienta disponible para el protocolo SNMP (por ejemplo: la librería NET-SNMP para Linux o iReasoning MiB-Browser para Windows).