Utilização de um Telemóvel: Instalação e Utilização do Sistema FrontlineSMS para a Recolha de Dados de Base ou para o Envio de Mensagens (Secção III)

Neste suplemento (Secção III) ao guia de instruções Weaver sobre o FrontlineSMS, apresentamos a utilização de “Keywords” (Palavras-Chave) para recolha de dados e outras tarefas automatizadas.  Apresentarei diversos exemplos hipotéticos que são relevantes para a comunidade hidrometeorológica, mas existem muitíssimas possibilidades.  Se ainda não estiver familiarizado com a instalação ou funcionamento de base do FrontlineSMS, por favor leia a Secção I e a Secção II.

O que são Palavras-Chave?
Nas versões anteriores do FrontlineSMS, o software permitia fazer o seguimento de algumas informações de forma automatizada.  Era principalmente a função "Survey" (Pesquisa) que permitia efectuar esta tarefa.  “Surveys” (Pesquisas) permitia-lhe fazer análises ou totalizar as informações extraídas de mensagens SMS recebidas pelo sistema.

Por exemplo, poderá fazer uma Pesquisa de culturas plantadas.  Para o fazer pode criar uma Pesquisa intitulada 'Crop' (Cultura).  Este título torna-se então uma palavra de comando accionador / código em mensagens de texto recebidas por telemóvel que indicam ao FrontlineSMS que o texto recebido constitui uma resposta à Pesquisa.  Neste caso hipotético, sempre que o FrontlineSMS recebe um SMS começando por 'Crop' (Cultura), o programa saberá que deve começar a processar as informações baseado no resto do texto na mensagem.  Por exemplo, alguém poderá enviar uma mensagem 'Crop Maize' (Cultura de Milho).  Esta mensagem diz sucintamente, "Estou a responder à vossa inspecção sobre culturas plantadas.  Plantei milho".  O FrontlineSMS por sua vez acrescenta um ponto ou uma entrada para a categoria milho, ou se ninguém mais apresentou milho, é criada uma nova categoria.

A funcionalidade “Keywords” (Palavras-Chave) na nova versão do FrontlineSMS permite alargar o campo de acção inicial desta funcionalidade “Survey” (Pesquisa).  Uma “Keyword” (Palavra-Chave) é apenas um comando accionador que permite ao FrontlineSMS executar uma outra acção.  Esta acção pode ser uma resposta automática à pessoa que enviou a mensagem inicial.  A resposta automática pode mesmo ser enviada a um grupo de contactos em vez de a uma única pessoa, e em vez de uma resposta automática, a mensagem inicial podia ser reencaminhada para um grupo.  O programa poderia também enviar uma mensagem a um endereço de correio electrónico em vez de um SMS.  A função “Keywords” (Palavras-Chave) pode ser também usada para efectuar um pedido HTTP , que por sua vez poderá accionar praticamente qualquer acção posterior.

Em resumo, o módulo “Keywords” (Palavras-Chave) permite estender a funcionalidade do FrontlineSMS desde um simples cliente de envio de mensagens a uma ferramenta que pode accionar e gerir uma diversidade de processos por meio do envio de mensagens de texto por telemóvel.

Exemplo 1:  Boletim Meteorológico (Previsões) a Pedido
Neste primeiro exemplo, demonstrarei a capacidade do módulo “Keywords” (Palavras-Chave) para responder automaticamente às mensagens recebidas por SMS.  Por exemplo, poderá permitir às pessoas receberem diariamente, sob pedido, um boletim meteorológico.  Neste cenário de fluxo de trabalho, um agricultor ou um agente em extensão agrícola poderá enviar uma mensagem de texto por telemóvel para o seu sistema FrontlineSMS.  Esta mensagem começará com uma palavra-chave que na sua essência é o pedido de uma previsão meteorológica.  Digamos que é simplesmente um 'dailyforecast' (boletim meteorológico diário).  Quando recebe uma mensagem que começa por 'dailyforecast' (boletim meteorológico diário), o FrontlineSMS responderá à pessoa que o enviou com uma mensagem de previsão actualizada.

Para começar, terá que abrir a tabulação “Keywords” (Palavras-Chave).  Se a tabulação não estiver visível, na barra de menus abra “View” (Visualizar) e depois “Tabs” (Tabulações).  Deverá então certificar-se de que a tabulação “Keywords” (Palavras-Chave) está marcada.

Na janela “Keywords” (Palavras-Chave) observará o ecrã dividido em duas secções.  A zona à esquerda listará todas as suas “Keywords” (Palavras-Chave), mas certamente, neste momento, está vazia.

Pode proceder de três maneiras diferentes para criar uma nova “Keyword” (Palavra-Chave).  A primeira opção é simplesmente clicar com o botão direito do rato na zona do menu à esquerda, sobre o item 'Add keyword' (Adicionar Palavra-Chave).  Seleccione então 'New Keyword' (Nova Palavra-Chave).

Uma alternativa é simplesmente clicar no botão na base esquerda da tabulação “Keywords” (Palavras-Chave) intitulada 'New' (Novo).

Ambas as opções mostrarão uma nova mini janela que lhe pede para introduzir uma palavra-chave e uma descrição.

Nesta nova janela, sob "Create new keyword" (Criar Nova Palavra-Chave), deverá introduzir a palavra-chave actual que pretende que seja usada como um comando accionador. Isto não é simplesmente um título, mas é antes a palavra-chave do comando accionador actual que a pessoa que envia a mensagem usará como a primeira palavra da mensagem de texto.

Outra opção, além das duas acima mencionadas, é simplesmente começar a preencher o formulário no lado direito da tabulação “Keywords” (Palavras-Chave).

Utilizarei esta opção no meu exemplo.  Assim, criamos uma palavra-chave de previsão meteorológica diária para uma região específica.  Escolherei Kayunga no Uganda como um exemplo.  Para manter o comando accionador de certa forma curto e fácil de introduzir através de um telemóvel, encurtarei a palavra-chave para "DFKayunga".  Com um código mais curto, o utilizador não tem necessidade de perder tempo a escrever letras inutilmente.  Note também que não existe diferença entre as maiúsculas e as minúsculas, assim, o utilizador pode simplesmente escrever "dfkayunga" ou "DFKAYUNGA" e obter o mesmo resultado.  Presumo que as previsões meteorológicas são específicas de cada região, assim, Kayunga é mencionada pelo nome na palavra-chave.  Para enviar automaticamente os boletins meteorológicos para outras cidades ou regiões de um país, terá que criar palavras-chave individuais.

De seguida, necessitaremos criar uma mensagem que será uma resposta automática.  Neste caso introduzi previsões fictícias, mas é apenas para vos dar uma ideia.  Certifique-se de que marca a caixa para enviar a resposta automática.  Para terminar, clique em “Create” (Criar).

 A nossa “Keyword” (Palavra-Chave) aparecerá agora no menu à esquerda.  Pode seleccionar qualquer “Keyword” (Palavra-Chave) para a editar ou apagar.

É evidente que, para uma previsão diária, será necessário que um operador actualize o texto todos os dias, ou várias vezes por dia, no FrontlineSMS para assegurar que as previsões estejam actualizadas.  Um outro ponto importante a considerar é o formato e o comprimento do seu SMS.  Uma vez mais, cada SMS incorrerá num custo, por isso é melhor que o seu sistema responda com um simples SMS em vez de uma mensagem em várias partes.  Se decidir estabelecer este tipo de funcionalidade, terá de fazer experiências com o formato e as indicações que fornecerá aos meteorologistas que irão introduzir as informações.  Use abreviaturas sempre que possível, mas certifique-se de que não as encurta de tal modo que a mensagem não possa ser compreendida.  Igualmente, evite utilizar pontuação que prejudique a compreensão da mensagem.  No exemplo acima abreviei temperatura para 'Temp'.  Também não utilizei um ponto final na minha abreviatura, visto que cada ponto acrescentaria um carácter e assim aumentaria o comprimento da minha mensagem.  Será simplesmente necessário avaliar bem os seus destinatários para encontrar o justo equilíbrio entre a utilização de abreviaturas e clareza da mensagem.

Nota: existe um pequeno bug (erro de programação) na versão FrontlineSMS 1.5.8.  As “Keywords” (Palavras-Chave) cujo número de caracteres é um múltiplo de quatro (4, 8, 12), como por exemplo 'test', não funcionarão correctamente.  Por qualquer razão, o FrontlineSMS não reconhecerá as “Keywords” (Palavras-Chave) cujo número de caracteres são múltiplos de quatro.  É bem provável que este problema seja resolvido antes que leia este guia e tenha descarregado uma versão mais recente.  De qualquer forma, se tiver tentado utilizar “Keywords” (Palavras-Chave) e notar que as mensagens recebidas não são capturadas correctamente, tente encurtar ou alongar a palavra-chave em um caracter.  Por exemplo, quando comecei a testar o FrontlineSMS, criei uma “Keyword” (Palavra-Chave) de 'test'.  Isto não funcionou, mas quando a alterei simplesmente para 'tst', funcionou perfeitamente.  Para mais informações sobre este assunto, consulte os fóruns FrontlineSMS.

É agora o momento de testar a sua palavra-chave.  Com um outro telemóvel, envie uma mensagem para o seu sistema FrontlineSMS em que o SMS seja simplesmente 'dfkayunga' – ou outra palavra-chave que escolha criar.

Após ter enviado a mensagem do seu telemóvel, pode monitorizar o desenvolvimento do processo passando para a tabulação “Messages” (Mensagens) no FrontlineSMS.  Clique em 'All messages' (Todas as mensagens) no menu esquerdo para ver se recebeu uma mensagem.  Logo que a mensagem seja recebida, deverá ver que o FrontlineSMS envia uma resposta.  E certamente deverá receber brevemente o boletim meteorológico que criou no seu telemóvel.
É evidente, que este tipo de serviço de distribuição de informações 'on demand' (sob pedido) não é limitado ao simples envio de boletins meteorológicos.  Mas com este exemplo simples, estabelecemos uma funcionalidade razoavelmente avançada em apenas alguns minutos.

Exemplo 2:  Pedidos de Assistência no Terreno
No RANET, como com qualquer programa que implique locais no terreno distantes, é extremamente difícil ser avisado rapidamente quando existem dificuldades ou deficiências técnicas.  Sem outros meios de comunicação em certas zonas rurais, podem passar-se dias antes que uma mensagem possa ser enviada ao escritório central.  Além disso, as demoras podem ainda alongar-se se a mensagem for encaminhada para a pessoa errada, ou se aquela pessoa não estiver disponível.

Com o FrontlineSMS e a funcionalidade “Keywords” (Palavras-Chave), pode instalar uma 'help line' (linha de assistência) para as equipas no terreno.  Neste caso, eles podem enviar uma mensagem tal como 'TechSupport Station fuse blown' (Fusível da Estação TechSupport fundido).  Neste caso 'TechSupport' é o comando accionador da palavra-chave que indica ao FrontlineSMS que esta não é uma mensagem simples, mas antes uma mensagem que requer uma acção especial a ser tomada pelo FrontlineSMS.  O resto da mensagem ('Station fuse blown.') fornece alguns detalhes do problema técnico enfrentado pela comunidade.  Em vez de simplesmente receber a mensagem, utilizaremos o FrontlineSMS para, de forma activa, tentar contactar os chefes de projecto e os técnicos que podem prestar assistência.  Para o fazer, o FrontlineSMS enviará uma mensagem de texto por telemóvel, contendo o texto da mensagem inicial enviada do terreno, para um ou mais técnicos.  O FrontlineSMS reencaminhará, via correio electrónico, a mensagem de apoio técnico para diversos endereços de correio electrónico associados com os técnicos e chefes de projecto (é evidente que para que a funcionalidade de correio electrónico funcione, a estação de FrontlineSMS necessitará de uma ligação à internet).  Para terminar, o FrontlineSMS enviará também uma resposta automática para o terreno, informando-os que a mensagem foi recebida e que alguém tentará resolver o problema.

Tal como anteriormente, criaremos uma nova “Keyword” (Palavra-Chave).  Neste caso, a palavra de comando accionador é 'TechSupport'.  Introduzirei uma resposta automática para informar as pessoas no terreno que a mensagem foi recebida e está a ser encaminhada para alguém que pode ajudar.

Logo que esta seja criada, clique novamente na palavra-chave no menu esquerdo.  Observará sob o formulário do lado direito, que existe agora uma ligação para abrir opções avançadas.

Clique nesta ligação, e será exibido um novo ecrã.  Na base pode seleccionar o tipo de acção especial que o FrontlineSMS deverá executar.  Vamos escolher reencaminhar automaticamente a mensagem como um SMS para o telemóvel de um técnico.  Seleccione “Auto Forward” (Reencaminhar Automaticamente).

 Agora clique no botão adicionar à direita do menu de selecção.

Ao clicar no botão adicionar será exibida uma nova janela.  Nesta janela selecciona o grupo (tal como criado na sua lista de contactos) para o qual a mensagem será reencaminhada.  A seguir, necessitará de determinar o conteúdo da mensagem SMS reencaminhada.  No meu exemplo, comecei-a com 'URGENT:' (URGENTE:), e depois premi os botões 'Sender Name' (Nome do Expedidor) e 'Message Content' (Conteúdo da Mensagem).  Premindo estes botões, o programa insere variáveis dinâmicas no formulário.  Sem surpresa, estas variáveis permitem inserir o nome do expedidor / número de telemóvel e a mensagem no SMS que será reencaminhada para os técnicos.

Agora, quando o FrontlineSMS recebe uma mensagem que começa por TechSupport, o programa reencaminhará a mensagem para um grupo de contactos.  A mensagem reencaminhada começará por 'Urgent:' (Urgente:).  Será seguida pelo nome do expedidor, e depois, finalmente, a mensagem da pessoa que requer ajuda.

Embora eu opte por não o usar, pode seleccionar uma data de início e fim para este processo.  Embora não seja útil no nosso exemplo hipotético, isto poderá revelar-se útil se tiver um projecto ou outra actividade que termine após um certo período de tempo.  Por exemplo, determinadas informações governamentais são embargadas antes de uma determinada data de publicação. Assim, poderá configurar o seu sistema antecipadamente, mas poderá configurá-lo a não responder a pedidos até uma determinada data de início.  Igualmente, poderá ter previsões sazonais ou outras informações (previsões de ciclones) que já não são válidas após o fim de uma estação.  Assim, em vez de disponibilizar o acesso a informação desactualizada ao público, e fazer com que o seu sistema incorra em custos enviando-lhes informações inválidas, poderá ter a funcionalidade da “Keyword” (Palavra-Chave) desactivada numa determinada data.

Agora, finalmente, a nossa “Keyword” (Palavra-Chave) para apoio técnico está criada e também poderá reencaminhar a mensagem por correio electrónico.  Para o fazer, necessitamos de configurar uma conta de servidor SMTP.  Navegue até ao item de menu 'Setting' (Configurar) para seleccionar 'Email Settings' (Configurações de Correio Electrónico).

Vai ter que preencher o formulário seguinte para adicionar uma nova conta.  É importante que a informação SMTP seja preenchida, caso contrário o FrontlineSMS é incapaz de enviar mensagens.  Se não conhece esta informação, ela pode geralmente ser encontrada nas suas configurações de cliente de e-mail (Thunderbird, Outlook, etc.), ou então deverá contactar o seu administrador de rede local.  Para os países integrantes do RANET, pode ser fornecido um servidor SMTP.

Agora que a sua conta de correio electrónico foi criada, regresse à tabulação “Keywords” (Palavras-Chave).  Seleccione “E-mail” (Correio Electrónico) no menu de opções de processamento localizado na base do lado direito da tabulação.

Após seleccionar “E-mail” (Correio Electrónico), clique no botão de adicionar.  Isto exibirá a janela seguinte.

Este formulário é muito semelhante ao que preenchemos para reencaminhar a mensagem como um SMS.  Crie um assunto útil e, conforme desejado, adicione alguma informação dinâmica ao assunto, tal como 'Sender Name' (Nome do Expedidor), 'Sender Number' (Número do Expedidor), etc.  Adiciona estas variáveis ao posicionar o seu cursor no campo de assunto e clicando depois o botão apropriado para 'Sender Name' (Nome do Expedidor) ou semelhante.

Pode criar também uma mensagem standard para o corpo do correio electrónico.  Tal como com o campo de assunto, pode adicionar algumas variáveis dinâmicas que incluiriam a mensagem recebida, expedidor, etc.

Para o campo “From” (De), deverá seleccionar a conta de correio electrónico que criou anteriormente, ou seleccionar a conta de correio electrónico que pretende usar.  O FrontlineSMS usará ambos, o servidor SMTP e a conta de correio electrónico para enviar a mensagem.  

E finalmente, deverá seleccionar um endereço de correio electrónico (da sua lista de contactos) para o qual o SMS recebido será reencaminhado, ou escreva simplesmente o endereço de correio electrónico que pretende utilizar.  Pode configurar datas de início e fim como descrito anteriormente.

É tudo.  O seu guião da “Keyword” (Palavra-Chave) está pronto para correr.  Quando a primeira palavra de uma mensagem SMS recebida é 'TechSupport', o FrontlineSMS enviará em retorno uma resposta automática ao expedidor, informando-o que a mensagem foi recebida e que a assistência está a caminho.  O FrontlineSMS reencaminhará então a mensagem como um SMS a um ou mais técnicos definidos num grupo de mensagens da sua lista de contactos.  E finalmente, o FrontlineSMS reencaminhará a mensagem como um correio electrónico a um ou mais destinatários que designemos.

Exemplo 3:  Manter a Ligação entre os Gestores de Emergências
Uma das concepções originais do FrontlineSMS foi ajudar a manter grupos de indivíduos em pequenas organizações ligados via SMS.  Uma necessidade e aplicação hipotéticas desta funcionalidade de grupo poderá ser manter os gestores de emergências ligados.  Neste exemplo, criámos um grupo na nossa lista de contactos.  Poderemos designá-lo "EMs".  Agora, criamos uma “Keyword” (Palavra-Chave) tal como "EMsList" (Lista EMs).  Não crie uma mensagem de resposta automática ou outra funcionalidade.  Assumindo que leu os exemplos anteriores, não fornecerei detalhes sobre como criar uma nova “Keyword” (Palavra-Chave) nem como criar um grupo na tabulação “Contacts” (Contactos).

Com ambos criados, regresse à tabulação “Keywords” (Palavras-Chave) e seleccione a nossa palavra-chave "EMsList" (Lista EMs).  Agora, seleccione a opção de visualização avançada.

Na nova janela, use a lista de menu de processos para seleccionar “Auto Forward” (Reencaminhamento Automático), e depois clique no botão adicionar.

Será exibida uma nova janela.  Usámos esta funcionalidade anteriormente, no exemplo dois.  Aqui, seleccionaremos o nosso grupo criado recentemente: EMs.  Então configuraremos o modelo / formato de mensagem.  Aqui escolhi começar o SMS com "EMs:", que é então seguida pelo nome do expedidor.  Como é o FrontlineSMS que reencaminhará esta mensagem, não será identificado quem envia o SMS inicial.  A inserção desta informação consome uma parte da nossa quota de caracteres disponíveis quando redigimos um SMS, mas permite que a mensagem seja mais clara.  Isto é então seguido pela mensagem SMS real.

É tudo.  Agora, se tiver gestores de emergências ou qualquer grupo semelhante que necessita difundir mensagens para um outro grupo, pode usar a importante função “Keywords” (Palavras-Chave) para reencaminhar automaticamente os SMS.  Tudo o que os utilizadores necessitam fazer é enviar simplesmente um SMS para o modem FrontlineSMS e iniciarem as suas mensagens com a “Keyword” (Palavra-Chave) associada ao grupo de distribuição.  No nosso caso, esta “Keyword” (Palavra-Chave) era “EmsList” (Lista EMs).

Nota: embora eu tenha utilizado uma combinação de letras maiúsculas e minúsculas para a minha palavra-chave, isto não afectará a forma como um utilizador deve introduzir a palavra-chave num SMS.  O FrontlineSMS aceita EMsList, EMSLIST e emslist como a mesma palavra.  Utilizando uma combinação de letras maiúsculas e minúsculas no FrontlineSMS torna mais fácil gerir uma longa lista de “Keywords” (Palavras-Chave).  Simultaneamente, os seus utilizadores deverão introduzir a palavra-chave como for mais fácil para eles.  Em telemóveis pequenos, eles não necessitam perder tempo alternando a escrita de maiúsculas e minúsculas.

Exemplo 4:  Interface de Servidor Web
Este exemplo hipotético não será fornecido detalhadamente.  As aplicações são muitas e requerem alguma capacidade para criar roteiros paralelos no servidor.  Posto isto, suponha que pretendia que algumas mensagens ou relatórios de campo fossem automaticamente colocados num sítio na web.  Por exemplo, poderia ter uma rede de estações meteorológicas automatizadas (AWSs) que são capazes de enviar relatórios via SMS.  Certamente, estas podem ser configuradas para enviar mensagens para o FrontlineSMS, mas seria também útil que a informação pudesse também ser processada numa base de dados adequada para funções e análises operacionais e, da mesma forma, porque não colocar condições atmosféricas actuais na sua página de internet.  Uma vez mais, o FrontlineSMS e o seu módulo de “Keywords” (Palavras-Chave) pode ajudá-lo a fazer isto.

Tal como nos exemplos acima, deverá criar uma “Keyword” (Palavra-Chave).  Não crie uma resposta automática.  Uma vez criada, seleccione uma vez mais a “Keyword” (Palavra-Chave) da lista do menu esquerdo e depois, no menu direito, seleccione a opção de tabulação avançada.  Agora, seleccione a opção 'External Command' (Comando Externo) do menu de processos e clique no botão adicionar.

Deverá ser exibida uma nova janela.  Conforme ilustrado na imagem do exemplo abaixo, pode seleccionar um tipo de execução.  Se usar um pedido HTTP, o FrontlineSMS enviará uma série de variáveis para um roteiro que criou num sítio na web.  Este roteiro poderá ser PHP, ASP, etc.  O roteiro, terá a árdua tarefa de processar dados, colocar mensagens numa base de dados, colocar informações num sítio na web, etc. etc.  Ilustrei um exemplo de como isto pode ser introduzido sob a opção “Execution Details” (Detalhes de Execução).  Se não compreender totalmente o que aqui está exposto, não se preocupe.  Esta funcionalidade destina-se realmente a um administrador ou a um programador de um servidor, mas vale a pena conhecer as potencialidades gerais.  Para países membros do RANET, a equipa do RANET pode ajudar a escrever ou a reunir o código necessário para alcançar o seu objectivo.

O outro tipo de execução é "Command Line Execution" (Execução de Linhas de Comando).  Isto é sobretudo utilizado para accionar acções ou roteiros de linhas de comando no computador local.  Por exemplo, poderá ter um roteiro que informa a quantidade de espaço disponível em disco num servidor, copiar ficheiros para cópia de segurança, etc. etc.  Isto pode revelar-se útil se estiver a gerir um sistema à distância onde a internet não está disponível.  Enviando a um sistema FrontlineSMS um comando/palavra-chave especial, poderá obter relatórios de estado do computador, e reiniciá-lo, entre outros.

Não entrarei em detalhes, mas o Frontline SMS pode igualmente aguardar por uma resposta, e depois, baseado na resposta, enviar uma mensagem.  Um exemplo poderia ser como verificar o estado de um servidor à distância.  Por exemplo, digamos que está no terreno.  Poderá enviar uma mensagem SMS à sua instalação FrontlineSMS.  Este SMS seria uma “Keyword” (Palavra-Chave) que envia um “HTTP Request” (Pedido HTTP) ao seu servidor pedindo algum tipo de informação de estado.  O seu servidor, através de um roteiro paralelo de servidor, devolve uma resposta, que é então reencaminhada uma vez mais para o seu telemóvel.  Isto pode revelar-se útil para consultar o estado do sistema ou outras informações armazenadas numa base de dados.

Pode igualmente utilizar esta funcionalidade para uma versão mais avançada do exemplo de previsão meteorológica sob pedido discutida anteriormente.  Em alternativa a ter os seus operadores a introduzir informações diariamente no FrontlineSMS, as previsões podem ser retiradas de uma base de dados ou ficheiro de texto alojados num servidor.  Isto será mais vantajoso se a previsão já fizer parte dos seus procedimentos operacionais normais.

Em resumo, a função “External Command” (Comando Externo) adiciona uma importante funcionalidade para estabelecer a interface do FrontlineSMS com servidores e outras infraestruturas informáticas.  Além disso, é a melhor forma para assegurar que a interface do FrontlineSMS possa comunicar com as infraestruturas e operações legais.  Não esqueça que os conhecimentos de uma linguagem de roteiro paralelo de servidor, tais como PHP ou ASP, serão necessários.   Para o RIPI e outros participantes do RANET, o RANET pode escrever roteiros e funcionalidades personalizados mediante pedido.