Integração de SMS para REDCap

O que é o REDCap

REDCap (Research Electronic Data Capture) é uma aplicação Web segura concebida para apoiar a recolha de dados para estudos de investigação. A aplicação permite a criação de bases de dados e a realização de inquéritos em linha, o que a torna ideal para uma vasta gama de projectos orientados para os dados.

O REDCap é particularmente reconhecido pela sua flexibilidade no tratamento de estratégias complexas de recolha de dados e pela sua capacidade de se adaptar a diferentes necessidades de investigação. O sistema também garante a integridade dos dados com pistas de auditoria abrangentes e tem gestão de direitos de utilizador para proteger informações sensíveis.

Desenvolvido na Universidade de Vanderbilt, o REDCap é utilizado globalmente em mais de uma centena de países, o que realça a sua fiabilidade e eficácia.

REDCap e SureSMS

A integração entre o REDCap e o SureSMS é efectuada através do serviço a que chamamos mail-to-sms no SureSMS. Isto significa que o REDCap gera e-mails que o SureSMS envia como mensagens SMS para os destinatários no REDCap.

No REDCap, o SMS pode ser utilizado para otimizar a comunicação através das funcionalidades "Convites para inquéritos automatizados" e "Alertas e notificações". Isto permite aos utilizadores configurar e-mails que se convertem automaticamente em mensagens SMS, melhorando as taxas de resposta e garantindo informação atempada. Estas funcionalidades facilitam a manutenção dos participantes actualizados e envolvidos em projectos de investigação.

Antes de começar

Antes de começar, convém ter em conta os seguintes pontos:

Precisa de poder responder à mensagem SMS? Expandir

Existem duas formas de enviar mensagens SMS. Uma é com um número de telefone como remetente e a outra é com um texto como remetente. Se optar por enviar com um número de telefone, o destinatário pode responder à mensagem SMS. Se optar por enviar com um texto, o destinatário não pode responder à mensagem. Provavelmente já tentou receber um SMS do SMS-Service, do cabeleireiro ou de um serviço semelhante. Estas não podem ser respondidas. Se decidir enviar com um texto (o que a maioria dos utilizadores do REDCap faz), tem de escolher um nome de remetente.

Qual deve ser o nome do remetente? Expandir

Tem de escolher um nome de remetente para as suas mensagens SMS. Neste caso, o protocolo internacional de SMS limita-o a 11 caracteres, incluindo espaços, hífenes, pontos, etc. Tente arranjar um nome que faça com que o destinatário o associe ao seu projeto de investigação. Se enviar links nas suas mensagens, é mais provável que os utilizadores cliquem no link se acreditarem que foi uma fonte credível que enviou a mensagem.

Como é que vai pagar o serviço? Expandir

Tem duas opções de pagamento:

Pagamento por cartão de crédito

Ao escolher o pagamento online por cartão de crédito, deposita um montante na sua conta SureSMS. Cada vez que envia, deduzimos o montante do SMS do seu saldo. Quando o seu saldo atingir o nível de alerta definido (por defeito, 10 DKK), receberá um e-mail. Também pode ativar o carregamento automático. Receberá automaticamente uma fatura quando tiver efectuado o pagamento.

Pagamento por fatura/EAN

Também pode optar por pagar por fatura. Todos os meses, enviaremos uma fatura relativa à utilização do mês anterior. A fatura pode ser enviada por EAN ou por correio eletrónico. Nota: para as facturas, existe um montante mínimo de 100,- DKK por mês.

Quanto é que custa?

Quando utiliza o SureSMS, custa uma pequena quantia por cada SMS que envia, a partir de 0,28 DKK por SMS enviado para números dinamarqueses. Tenha em atenção que um SMS só pode ter 160 caracteres. (leia mais) sobre os preços aqui.)

Não existe qualquer taxa de instalação ou de manutenção. No entanto, custa pelo menos 100 DKK por mês se pretender receber facturas via EAN.

Se quiser receber respostas SMS, precisa de ter um solução bidirecional . Tem uma taxa de subscrição de 99,- DKK por mês.

Como configurar o REDCap e o SureSMS

A integração entre o REDCap e o SureSMS requer a configuração em ambos os sistemas. É necessário começar por configurar o SureSMS e, em seguida, passar para o REDCap e configurar os últimos elementos.

Configuração no SureSMS

Para utilizar o SureSMS da REDCap, necessita de uma conta SureSMS e de uma chave API do SureSMS. De seguida, apresentamos os passos necessários para configurar o SureSMS.

Criar uma chave API

 

1. 1. Aceda à sua conta SureSMS aqui https://app.suresms.com
      Se ainda não tem uma conta, pode criar uma aqui Criar uma conta SMS Gateway

 

1. 1. Selecionar chaves API no menu

 

1. 1. Clique em Options (Opções) no canto superior direito e selecione "SureSMS API key" (Chave da API SureSMS) no menu.

 

1. 1. No nome pode escrever-se, por exemplo, REDCap

 

1. 1. Clique em Guardar

 

1. 1. Copie a nova chave da API para a poder utilizar mais tarde.

 

 

Definir o nome do remetente

 

1. 1. Selecione Definições -> Nome do remetente no menu

 

1. 1. No canto superior direito, clique em "Opções" e, em seguida, clique em "Encomendar novo remetente alfanumérico".

 

1. 1. Preencher o campo com o nome do remetente pretendido e clicar em "Encomendar"

 

1. 1. A aprovação do nome do remetente é manual e pode demorar até 24 horas a ser aprovada (normalmente, no espaço de uma hora)

 

1. 1. Quando o nome for aprovado, volte a esta página e selecione a caixa de verificação "É predefinido"

 

 

Criar pagamento

A sua conta tem 50 mensagens SMS gratuitas quando é criada. Todas as mensagens enviadas com uma conta de teste terminam com uma frase que indica que foram enviadas a partir de uma conta de teste. Para configurar o pagamento, clique no grande botão vermelho na parte superior que diz "CONTA DE TESTE". Em seguida, siga as instruções para mudar para uma conta de produção.

Agora já está tudo pronto no SureSMS e pode passar para o REDCap.

Configurar o REDCap

Criámos um guia para a configuração do REDCap em PDF. Pode ser descarregado Distribuição do inquérito através do sureSMS no âmbito da diretriz REDCap.

Testar a configuração

No processo de teste da sua configuração, várias coisas podem correr mal.

• O REDCap não envia uma mensagem de correio eletrónico para o SureSMS
• O SureSMS recebe o e-mail mas não consegue associá-lo à sua conta
• O SureSMS pode associar o correio eletrónico à sua conta, mas não pode entregar a mensagem SMS

O REDCap não envia correio para o SureSMS

Em primeiro lugar, é necessário verificar se o REDCap enviou corretamente a mensagem. Para isso, abra o separador "Registo de notificações" e veja as mensagens enviadas:

Aqui é necessário prestar especial atenção ao facto de a mensagem ter sido enviada, quem é o destinatário e se existe alguma coisa no texto. O destinatário, em particular, pode ser problemático. O importante é que conste o número de telefone.apikey.[dinapikey]@2sms.nu. Desde que haja conteúdo na mensagem, ela deve ser enviada. Pode sempre corrigir o conteúdo mais tarde.

O SureSMS não recebe correio

Se o SureSMS receber um e-mail mas não o conseguir associar a uma conta, este não será enviado como SMS. Este é o problema mais difícil de encontrar. Isto acontece porque a mensagem SMS não é adicionada à sua conta SureSMS - precisamente porque não a conseguimos encontrar. Normalmente, isto acontece porque o destinatário do e-mail não está configurado corretamente.

Dê uma boa vista de olhos ao campo Destinatário no Registo de notificações. O formato deve ser um sinal de mais, seguido do código do país e do número de telefone. Depois, a APIKey ou o seu nome de utilizador e um ponto final. Depois, o seu código SureSMS ou a APIkey que utiliza. O endereço de correio eletrónico deve terminar com @2sms.nu.

Verifique se não existem pontos e vírgulas, parênteses rectos ou parênteses rectos no nome do destinatário.

Tente utilizar o seu cliente de correio eletrónico normal para enviar para um nome de destinatário que tenha copiado da lista de destinatários. Se for bem sucedido, é porque a REDCap não consegue enviar-nos a mensagem de correio eletrónico. Pode testar se o seu nome de utilizador e palavra-passe estão corretos iniciando sessão em https://app.suresms.com.

O SureSMS recebe correio mas não envia SMS

O último passo na resolução de problemas é verificar se o SureSMS está a receber o e-mail mas não a enviar a mensagem SMS. Pode verificar isto iniciando sessão em https://app.suresms.com e clique em Mensagens no menu e depois em Caixa de saída. Na caixa de saída, a sua SMS aparecerá, mas terá um estado que não é "Entregue". Ao passar o rato sobre o estado, pode ver o que correu mal.

Normalmente, isso deve-se ao facto de o indicativo do país estar errado. Pode acontecer que o número tenha dois indicativos de país - ou seja, +454512345678 ou que não exista qualquer indicativo de país. Também pode acontecer que a ligação na mensagem tenha sido "apanhada" pelo nosso filtro de SPAM.

Tenha em atenção que o SureSMS não enviará a mesma mensagem para o mesmo destinatário no espaço de 10 minutos. Neste caso, a mensagem terá o estatuto SPAM. Pode evitar esta situação alterando ligeiramente o texto que envia.

Problemas com alterações de linha

Quando o REDCap envia a mensagem, esta é enviada em HTML. Isto é feito com muitos códigos diferentes. O SureSMS remove estes códigos e tenta criar uma SMS em texto simples. Em particular, o REDCap pode fazer quebras de linha de várias maneiras e isso pode causar problemas. Se não conseguir que o REDCap faça uma quebra de linha, tente escrever <br> onde pretende uma quebra de linha. Se quiser duas quebras de linha uma a seguir à outra, tente utilizar o código <br2>.

As quebras de linha contam como um carácter na SMS, por isso não conte os quatro ou cinco caracteres de código ao calcular o comprimento da sua SMS.

Depois de o ter configurado e verificado que a mensagem SMS tem o aspeto pretendido, pode iniciar sessão em https://app.suresms.com, localizar a mensagem e clicar em Info junto à mensagem. Aqui pode ver quanto custa e qual a duração da mensagem.