Accueil
/
Intégrations
/
Intégration des SMS aux systèmes spécialisés
/
Intégration de SMS pour REDCap

Table des matières

Ajouter un en-tête pour commencer à générer la table des matières

Intégration de SMS pour REDCap

Qu'est-ce que REDCap ?

REDCap (Research Electronic Data Capture) est une application web sécurisée conçue pour faciliter la collecte de données dans le cadre d'études de recherche. L'application permet de créer des bases de données et de réaliser des enquêtes en ligne, ce qui la rend idéale pour un large éventail de projets axés sur les données.

REDCap est particulièrement reconnu pour sa flexibilité dans la gestion de stratégies complexes de collecte de données et sa capacité à s'adapter à différents besoins de recherche. Le système garantit également l'intégrité des données grâce à des pistes d'audit complètes et dispose d'une gestion des droits des utilisateurs pour protéger les informations sensibles.

Développé à l'Université de Vanderbilt, REDCap est utilisé mondialement dans plus d'une centaine de pays, ce qui souligne sa fiabilité et son efficacité.

REDCap et SureSMS

L'intégration entre REDCap et SureSMS se fait par le biais du service que nous appelons mail-to-sms dans SureSMS. Cela signifie que REDCap génère des courriers électroniques que SureSMS envoie sous forme de messages SMS aux destinataires de REDCap.

Dans REDCap, les SMS peuvent être utilisés pour optimiser la communication grâce aux fonctions "Invitations automatisées à l'enquête" et "Alertes et notifications". Cela permet aux utilisateurs de configurer des courriels qui se convertissent automatiquement en messages SMS, améliorant ainsi les taux de réponse et garantissant une information opportune. Ces fonctions permettent de tenir les participants informés et de les impliquer dans les projets de recherche.

Avant de commencer

Avant de commencer, vous pouvez prendre en considération les points suivants :

Vous devez pouvoir répondre au message SMS ?

Il existe deux façons d'envoyer des messages SMS. L'une consiste à utiliser un numéro de téléphone comme expéditeur et l'autre à utiliser un texte comme expéditeur. Si vous choisissez d'envoyer un numéro de téléphone, le destinataire peut répondre au message SMS. Si vous choisissez d'envoyer un texte, le destinataire ne peut pas répondre au message. Vous avez probablement essayé de recevoir un SMS de SMS-Service, du coiffeur ou d'une personne similaire. Il n'est pas possible d'y répondre. Si vous décidez d'envoyer un texte (ce que font la plupart des utilisateurs de REDCap), vous devez choisir un nom d'expéditeur.

Quel doit être le nom de l'expéditeur ?

Vous devez choisir un nom d'expéditeur pour vos messages SMS. Ici, le protocole SMS international vous limite à 11 caractères, y compris les espaces, les traits d'union, les points, etc. Essayez de trouver un nom qui permette au destinataire de l'associer à votre projet de recherche. Si vous envoyez des liens dans vos messages, les utilisateurs seront plus enclins à cliquer sur le lien s'ils pensent que c'est une source crédible qui a envoyé le message.

Comment allez-vous payer le service ?

Vous avez deux possibilités de paiement :

Paiement par carte de crédit

En choisissant le paiement en ligne par carte de crédit, vous déposez un montant sur votre compte SureSMS. Chaque fois que vous envoyez un SMS, nous déduisons le montant du SMS de votre solde. Lorsque votre solde atteint le niveau d'alerte défini (10 DKK par défaut), vous recevez un courrier électronique. Vous pouvez également activer le rechargement automatique. Vous recevrez automatiquement une facture lorsque vous aurez payé.

Paiement par facture/EAN

Vous pouvez également choisir de payer par facture. Chaque mois, nous vous envoyons une facture pour la consommation du mois précédent. La facture peut être envoyée par EAN ou par e-mail. Remarque : pour les factures, le montant minimum est de 100 DKK par mois.

Combien cela coûte-t-il ?

Lorsque vous utilisez SureSMS, vous payez un petit montant pour chaque SMS que vous envoyez, à partir de 0,28 DKK par SMS envoyé vers des numéros danois. Veuillez noter qu'un SMS ne peut contenir que 160 caractères. (lire plus sur les prix ici.)

Il n'y a pas de frais d'installation ni de frais permanents. Cependant, il faut compter au moins 100 DKK par mois si vous souhaitez recevoir des factures par le biais de l'EAN.

Si vous souhaitez recevoir des réponses par SMS, vous devez disposer d'une solution bidirectionnelle . L'abonnement est de 99 DKK par mois.

Comment configurer REDCap et SureSMS ?

L'intégration entre REDCap et SureSMS nécessite une configuration dans les deux systèmes. Vous devez commencer par configurer SureSMS, puis passer à REDCap et apporter les dernières touches.

Configuration dans SureSMS

Pour utiliser SureSMS à partir de REDCap, vous avez besoin d'un compte SureSMS et d'une clé API de SureSMS. Vous trouverez ci-dessous les étapes à suivre pour configurer SureSMS.

Créer une clé API

Connectez-vous à votre compte SureSMS ici https://app.suresms.com
Si vous n'avez pas de compte, vous pouvez en créer un ici Créer un compte pour la passerelle SMS
Sélectionnez les clés API dans le menu
Cliquez sur Options dans le coin supérieur droit et sélectionnez "SureSMS API key" dans le menu.
Dans le nom, vous pouvez écrire par exemple REDCap
Cliquez sur Enregistrer
Copiez la nouvelle clé API afin de pouvoir l'utiliser ultérieurement.

Définir le nom de l'expéditeur

Sélectionnez Paramètres -> Nom de l'expéditeur dans le menu
Dans le coin supérieur droit, cliquez sur "Options", puis sur ".Commander un nouvel expéditeur alphanumérique".
Remplissez le champ avec le nom de l'expéditeur souhaité et cliquez sur "Commander"
L'approbation du nom de l'expéditeur est manuelle et peut prendre jusqu'à 24 heures (généralement dans l'heure qui suit).
Une fois le nom approuvé, revenez sur cette page et cochez la case "Est par défaut".

Créer un paiement

Votre compte dispose de 50 SMS gratuits lors de sa création. Tous les messages envoyés avec un compte de test se terminent par une phrase indiquant qu'ils ont été envoyés à partir d'un compte de test. Pour mettre en place le paiement, cliquez sur le gros bouton rouge en haut qui dit "COMPTE DE TEST". Suivez ensuite les instructions pour passer à un compte de production.

Vous avez maintenant terminé avec SureSMS et vous pouvez passer à REDCap.

Mise en place de REDCap

Nous avons créé un guide de configuration de REDCap au format PDF. Il peut être téléchargé Distribution de l'enquête par sureSMS dans le cadre de la ligne directrice REDCap.

Test de l'installation

Au cours du processus de test de votre installation, plusieurs choses peuvent se produire.

REDCap n'envoie pas d'email à SureSMS
SureSMS reçoit l'e-mail mais ne peut pas l'associer à votre compte.
SureSMS peut associer l'e-mail à votre compte mais ne peut pas délivrer le message SMS.

REDCap n'envoie pas de courrier à SureSMS

Vous devez d'abord vérifier que REDCap a bien envoyé le message. Pour ce faire, ouvrez l'onglet "Notification log" et regardez les messages envoyés :

Dans ce cas, il convient de vérifier si le message a bien été envoyé, qui est le destinataire et s'il y a quelque chose dans le texte. Le destinataire, en particulier, peut poser problème. L'important est qu'il soit indiqué numéro de téléphone.apikey.[dinapikey]@2sms.nu. Tant que le message contient du contenu, il doit être envoyé. Vous pouvez toujours corriger le contenu par la suite.

SureSMS ne reçoit pas de courrier

Si SureSMS reçoit un courriel mais ne peut pas l'associer à un compte, il ne sera pas envoyé sous forme de SMS. C'est le problème le plus difficile à résoudre. En effet, le message SMS n'est pas ajouté à votre compte SureSMS, précisément parce que nous ne le trouvons pas. En général, cela se produit parce que le destinataire de l'e-mail n'est pas correctement configuré.

Examinez attentivement le champ Destinataire dans le journal des notifications. Le format doit être un plus, suivi du code du pays et du numéro de téléphone. Puis l'APIKey ou votre nom d'utilisateur et un point. Puis votre code SureSMS ou la clé API que vous utilisez. L'adresse électronique doit se terminer par @2sms.nu.

Vérifiez que le nom du destinataire ne contient pas de points-virgules, de crochets ou de parenthèses souples.

Essayez d'utiliser votre client de messagerie habituel pour envoyer un message à un nom de destinataire que vous avez copié à partir de la liste des destinataires. Si vous y parvenez, c'est que REDCap ne peut pas nous envoyer l'e-mail. Vous pouvez vérifier si votre nom d'utilisateur et votre mot de passe sont corrects en vous connectant à https://app.suresms.com.

SureSMS reçoit du courrier mais n'envoie pas de SMS

La dernière étape du dépannage consiste à vérifier que SureSMS reçoit bien l'e-mail mais n'envoie pas le message SMS. Vous pouvez le vérifier en vous connectant à https://app.suresms.com et cliquez sur Messages dans le menu, puis sur Boîte d'envoi. Votre SMS apparaît dans la boîte d'envoi, mais son état n'est pas "Livré". En passant votre souris sur le statut, vous pouvez voir ce qui n'a pas fonctionné.

En général, c'est parce que l'indicatif de pays est erroné. Il se peut que le numéro ait deux indicatifs de pays - par exemple +454512345678 - ou qu'il n'y ait pas d'indicatif de pays du tout. Il se peut également que le lien contenu dans le message ait été "repéré" par notre filtre anti-spam.

Veuillez noter que SureSMS n'enverra pas le même message au même destinataire dans les 10 minutes qui suivent. Dans ce cas, le message aura le statut SPAM. Vous pouvez éviter cela en modifiant légèrement le texte que vous envoyez.

Problèmes liés aux changements de ligne

Lorsque REDCap envoie le message, celui-ci est envoyé en HTML. Il contient de nombreux codes différents. SureSMS supprime ces codes et tente de créer un SMS en texte clair. En particulier, REDCap peut faire des sauts de ligne de différentes manières, ce qui peut poser des problèmes. Si vous n'arrivez pas à faire en sorte que REDCap fasse un saut de ligne, essayez de taper <br> à l'endroit où vous souhaitez un saut de ligne. Si vous voulez deux sauts de ligne l'un après l'autre, essayez d'utiliser le code suivant <br2>.

Les sauts de ligne comptent comme un caractère dans le SMS, donc ne comptez pas les quatre ou cinq caractères du code dans le calcul de la longueur de votre SMS.

Une fois que vous l'avez configuré et que vous avez vérifié que le message SMS se présente comme il se doit, vous pouvez vous connecter à https://app.suresms.com, trouver le message et cliquer sur Info à côté du message. Vous verrez alors combien coûte le message et quelle est sa durée.