Integración de SMS para REDCap

Qué es REDCap

REDCap (Research Electronic Data Capture) es una aplicación web segura diseñada para apoyar la recogida de datos para estudios de investigación. La aplicación ofrece tanto la creación de bases de datos como la realización de encuestas en línea, por lo que resulta ideal para una amplia gama de proyectos basados en datos.

REDCap goza de especial reconocimiento por su flexibilidad a la hora de gestionar estrategias complejas de recopilación de datos y su capacidad para adaptarse a las distintas necesidades de la investigación. El sistema también garantiza la integridad de los datos con exhaustivos registros de auditoría y dispone de gestión de derechos de usuario para proteger la información sensible.

Desarrollado en la Universidad de Vanderbilt, REDCap se utiliza a escala mundial en más de cien países, lo que pone de relieve su fiabilidad y eficacia.

REDCap y SureSMS

La integración entre REDCap y SureSMS tiene lugar a través del servicio que llamamos mail-to-sms en SureSMS. Esto significa que REDCap genera correos electrónicos que SureSMS envía como mensajes SMS a los destinatarios en REDCap.

En REDCap, los SMS pueden utilizarse para optimizar la comunicación a través de las funciones "Invitaciones automáticas a encuestas" y "Alertas y notificaciones". Esto permite a los usuarios configurar correos electrónicos que se convierten automáticamente en mensajes SMS, lo que mejora los índices de respuesta y garantiza la puntualidad de la información. Estas funciones facilitan mantener a los participantes informados y comprometidos con los proyectos de investigación.

Antes de empezar

Antes de empezar, quizá quieras tener en cuenta los siguientes puntos:

¿Necesitas poder responder al mensaje SMS? Ampliar

Hay dos formas de enviar mensajes SMS. Una es con un número de teléfono como remitente y la otra es con un texto como remitente. Si eliges enviar con un número de teléfono, el destinatario puede responder al mensaje SMS. Si eliges enviar con un texto, el destinatario no puede responder al mensaje. Seguramente habrás probado a recibir un SMS de SMS-Service, de la peluquería o similar. Estos no se pueden responder. Si decides enviar con un texto (lo que hacen la mayoría de los usuarios de REDCap), debes elegir un nombre de remitente.

¿Cuál debe ser el nombre del remitente? Ampliar

Debe elegir un nombre de remitente para sus mensajes SMS. Aquí, el protocolo internacional de SMS te limita a 11 caracteres, incluidos espacios, guiones, puntos, etc. Intenta idear un nombre que haga que el destinatario lo asocie con tu proyecto de investigación. Si envías enlaces en tus mensajes, es más probable que los usuarios hagan clic en el enlace si creen que es realmente una fuente creíble la que ha enviado el mensaje.

¿Cómo pagará el servicio? Ampliar

Tiene dos opciones de pago:

Pago con tarjeta de crédito

Al elegir el pago en línea con tarjeta de crédito, depositas una cantidad en tu cuenta SureSMS. Cada vez que envíes, deduciremos el importe del SMS de tu saldo. Cuando tu saldo alcance el nivel de alerta establecido (por defecto es de 10 DKK), recibirás un correo electrónico. También puedes activar la recarga automática. Recibirás automáticamente una factura cuando hayas pagado.

Pago mediante factura/EAN

También puede optar por pagar mediante factura. Cada mes le enviamos una factura por el uso del mes anterior. La factura puede enviarse por EAN o por correo electrónico. Atención: el importe mínimo de las facturas es de 100 DKK al mes.

¿Cuánto cuesta?

Cuando utilizas SureSMS, cuesta una pequeña cantidad por cada SMS que envías, a partir de 0,28 DKK por SMS enviado a números daneses. Ten en cuenta que un SMS sólo puede tener 160 caracteres. (leer más sobre los precios aquí.)

No hay gastos de instalación ni de mantenimiento. Sin embargo, si desea recibir facturas a través de EAN, le costará al menos 100 DKK al mes.

Si quieres recibir respuestas por SMS, necesitas tener un solución bidireccional . Tiene una cuota de suscripción de 99 DKK al mes.

Cómo configurar REDCap y SureSMS

La integración entre REDCap y SureSMS requiere la configuración en ambos sistemas. Tienes que empezar por configurar SureSMS, luego pasar a REDCap y configurar los toques finales.

Configuración en SureSMS

Para utilizar SureSMS desde REDCap, necesitas una cuenta SureSMS y necesitas una clave API de SureSMS. A continuación repasamos los pasos necesarios para configurar SureSMS.

Crear una clave API

 

1. 1. Inicie sesión en su cuenta SureSMS aquí https://app.suresms.com
      Si no tiene una cuenta, puede crearla aquí Crear cuenta de SMS Gateway

 

1. 1. Seleccione Claves API en el menú

 

1. 1. Haz clic en Opciones en la esquina superior derecha y selecciona "Clave API SureSMS" en el menú.

 

1. 1. En el nombre puede escribir, por ejemplo, REDCap

 

1. 1. Haga clic en Guardar

 

1. 1. Copie la nueva clave API para poder utilizarla más adelante.

 

 

Establecer nombre de remitente

 

1. 1. Seleccione en el menú Configuración -> Nombre del remitente

 

1. 1. En la esquina superior derecha, haga clic en "Opciones" y, a continuación, en "Pedir nuevo remitente alfanumérico".

 

1. 1. Rellene el campo con el nombre del remitente deseado y haga clic en "Pedir".

 

1. 1. La aprobación del nombre del remitente es manual y puede tardar hasta 24 horas en aprobarse (normalmente en una hora)

 

1. 1. Una vez aprobado el nombre, vuelva a esta página y marque la casilla "Es predeterminado".

 

 

Crear pago

Su cuenta dispone de 50 mensajes SMS gratuitos cuando se crea. Todos los mensajes enviados con una cuenta de prueba terminan con una frase que indica que ha sido enviado desde una cuenta de prueba. Para configurar el pago, haz clic en el botón rojo grande de la parte superior que dice "CUENTA DE PRUEBA". A continuación, siga las instrucciones para cambiar a una cuenta de producción.

Ahora ya has terminado en SureSMS y puedes pasar a REDCap.

Configuración de REDCap

Hemos creado una guía para configurar REDCap en PDF. Se puede descargar Distribución de encuestas a través de sureSMS dentro de la directriz REDCap.

Probar la configuración

En el proceso de prueba de su configuración, varias cosas pueden salir mal.

• REDCap no envía un correo electrónico a SureSMS
• SureSMS recibe el correo electrónico pero no puede vincularlo a su cuenta
• SureSMS puede asociar el correo electrónico con su cuenta pero no puede entregar el mensaje SMS

REDCap no envía correo a SureSMS

Primero debe comprobar que REDCap ha enviado el mensaje correctamente. Para ello, abra la pestaña "Registro de notificaciones" y observe los mensajes enviados:

Aquí hay que prestar especial atención a si el mensaje se ha enviado, quién es el destinatario y si hay algo en el texto. El destinatario en particular puede ser problemático. Lo importante es que ponga número de teléfono.apikey.[dinapikey]@2sms.nu. Mientras haya contenido en el mensaje, debería enviarse. Siempre puedes corregir el contenido después.

SureSMS no recibe correo

Si SureSMS recibe un correo electrónico pero no puede asociarlo a una cuenta, no se enviará como SMS. Este es el problema más difícil de encontrar. Esto se debe a que el mensaje SMS no se añade a tu cuenta de SureSMS, precisamente porque no podemos encontrarlo. Normalmente, esto ocurre porque el destinatario del mensaje no está configurado correctamente.

Fíjese bien en el campo Destinatario del Registro de notificaciones. El formato debe ser un signo más, seguido del código de país y, a continuación, el número de teléfono. A continuación, tu APIKey o tu nombre de usuario y un punto. A continuación, tu código SureSMS o la APIkey que utilices. La dirección de correo electrónico debe terminar con @2sms.nu.

Compruebe que no hay punto y coma, corchetes ni paréntesis en el nombre del destinatario.

Intente utilizar su cliente de correo habitual para enviar a un nombre de destinatario que haya copiado de la lista de destinatarios. Si tiene éxito, es porque REDCap no puede enviarnos el correo electrónico. Puede comprobar si su nombre de usuario y contraseña son correctos accediendo a https://app.suresms.com.

SureSMS recibe correo pero no envía SMS

El último paso para solucionar el problema es comprobar que SureSMS recibe el correo electrónico pero no envía el mensaje SMS. Puede comprobarlo iniciando sesión en https://app.suresms.com y haga clic en Mensajes en el menú y luego en Bandeja de salida. En la bandeja de salida aparecerá tu SMS, pero tendrá un estado que no es "Entregado". Si pasas el ratón por encima del estado, podrás ver qué ha fallado.

Normalmente, se debe a que el código de país es incorrecto. Puede ser que el número tenga dos códigos de país, por ejemplo +454512345678, o que no haya ningún código de país. También puede ser que el enlace del mensaje haya sido "capturado" por nuestro filtro de SPAM.

Tenga en cuenta que SureSMS no enviará el mismo mensaje al mismo destinatario en un plazo de 10 minutos. En este caso, tendrá el estado SPAM. Puedes evitarlo cambiando ligeramente el texto que envías.

Problemas con los cambios de línea

Cuando REDCap envía el mensaje, lo hace en HTML. Esto es con muchos códigos diferentes. SureSMS elimina estos códigos e intenta crear un SMS en texto plano. En particular, REDCap puede hacer saltos de línea de varias maneras y esto puede causar problemas. Si no consigues que REDCap haga un salto de línea, prueba a escribir <br> donde desee un salto de línea. Si desea dos saltos de línea uno tras otro, pruebe a utilizar el código <br2>.

Los saltos de línea cuentan como un carácter en el SMS, así que no cuentes los cuatro o cinco caracteres de código al calcular la longitud de tu SMS.

Una vez que lo hayas configurado y hayas comprobado que el mensaje SMS tiene el aspecto deseado, puedes entrar en https://app.suresms.com, buscar el mensaje y hacer clic en Info junto al mensaje. Aquí podrás ver cuánto cuesta y cuánto dura.