Envio SMS

Esse documento apresenta todas as funcionalidades do recurso de enviar SMS que a Uniware disponibiliza à seus clientes.

Instalando e configurando o serviço UniSMS.

Serviço que faz o transporte, via WEB, das mensagens SMS do Unilab para o servidor que envia SMSs, este por sua vez, envia para os telefones solicitados além da atualização do saldo de SMSs no Unilab. O serviço é instalado apenas nos clientes que adquiriram o serviço de SMS.

O arquivo ini do serviço, que contém as configurações de execução, deve estar na mesma pasta e possuir o mesmo nome do executável. Seu conteúdo original é:

[GERAL]
EXTRA=00001I0C99D28D00998D3
IP=localhost
BANCO=unilabw
PORTA=3309
USER=UNIWARE
DEBUG=0
[PROXY]
USAPROXY=0
BASICAUTHENTICATION=0
PROXYPASSWORD=
PROXYPORT=0
PROXYSERVER=
PROXYUSERNAME=

A instalação é realizada executando o serviço com o parâmetro: -install

A remoção do serviço é realizada executando o serviço com o parâmetro: -uninstall

Para visualizar o serviço, consulte o services.msc. O nome do serviço é iniciado por UniSMS_ junto ao nome da base em que ele está conectado.

A atualização do serviço será automática, verificando atualizações ao iniciar o serviço e de 4 em 4 horas.

Atualizando e configurando o Unilab.

Durante a atualização para a versão 3.01.021 do Unilab, mais especificamente ao abrir a tela principal, é verificado todos os números de celulares dos pacientes e médicos com a máscara padrão, marcado os números como aptos a receber SMS. A máscara pode ser configurada (e explicada também) pela interface de configurações do sistema.

Criado configuração para envio de mensagens SMS para Pacientes e Médicos. Nestas configurações é possível definir:

1. Ativar o recurso de envio. Se não estiver habilitada, nenhuma mensagem SMS será gerada.
2. O conteúdo de cada tipo das mensagens enviadas e se aquele tipo de mensagem será gerado.
3. O intervalo de horário em que as mensagens SMS podem ser enviadas.
4. O valor mínimo de SMS: quando o saldo estiver menor que essa quantidade, serão exibidos avisos para o usuário.
5. (Somente ao usuário Uniware) O tamanho do pacote representa a quantidade de mensagens SMS máxima enviada por vez ao servidor WEB.
6. (Somente ao usuário Uniware) A máscara de validação do celular. Esse campo permite somente a digitação de seus caracteres válidos, utilizado para verificar se um celular de médico ou paciente está apto a receber mensagens pelo sistema.
7. (Somente ao usuário Uniware) Um texto explicativo que por objetivo auxilia o usuário a cadastrar um celular corretamente.

Estas configurações podem ser encontradas em: Menu Cadastros >> Configurações >> Aba SMS.

Para finalizar a configuração do recurso de SMS no Unilab, deve-se contatar a Uniware e requisitar uma Chave M, cadastrando a chave em Outros >> Chave >> Chave M.

Adquirindo mais créditos.

Assim que configurado os sistemas UniSMS e Unilab, é necessário que o cliente possua créditos para enviar mensagens SMS para os celulares. Para tal, a tela de Compras de créditos (Menu SMS >> Comprar créditos) mostra o custo unitário das mensagens por quantidade comprada, então o cliente insere a quantidade desejada e na mesma interface já é informada previamente o valor do boleto que será emitido na confirmação da quantidade.

A falta de créditos não impede que as mensagens SMS sejam cadastradas, o serviço UniSMS passa a se comunicar com menos frequência com o servidor WEB e marca as mensagens que seriam enviadas como “Sem créditos” quando o servidor avisar o serviço que os créditos acabaram. Com o boleto pago, os créditos serão computados após um intervalo de tempo do pagamento. A consulta de mais créditos é realizada pelo serviço UniSMS a cada 30 minutos e, quando novos créditos são adicionados, o UniSMS volta à sua comunicação normal e o Unilab retorna as mensagens sem créditos para envio, ou cancela permanentemente seu envio, a critério do usuário.

Cadastrando mensagens de SMS.

Há cinco tipos de mensagens que o sistema envia para pacientes e médicos. São eles:

Agradecimento pela preferência

Essa mensagem SMS é gerada automaticamente para o paciente no momento em que é cadastrado um pedido em seu nome (Somente inclusão).

Recoleta de exames

Essa mensagem SMS é gerada automaticamente para o paciente quando marcando uma recoleta de amostra. É importante verificar que é gerada uma nova mensagem SMS para cada nova recoleta.

Resultado pronto

Essa mensagem SMS é gerada automaticamente para o paciente toda vez que um pedido fica totalmente liberado, impresso ou reimpresso, desde que antes da alteração o pedido se encontrava em uma situação anterior à liberado. É válido ressaltar que um pedido pode regredir sua situação geral, por cancelamento de resultados ou quaisquer partes do sistema que retornem a situação de um exame.

Aniversário de paciente

Essa mensagem SMS é gerada automaticamente para o paciente na data de seu aniversário.

Aniversário de médico

Essa mensagem SMS é gerada automaticamente para o médico na data de seu aniversário.

As mensagens SMS de aniversários são criadas automaticamente pelo serviço UniSMS, que uma vez ao dia verifica todos os médicos e pacientes que fazem aniversário na data atual e aceitam receber SMS, e inclui as mensagens SMS na fila.

Outra alternativa para gerar as mensagens SMS encontra-se na interface de pedidos, médicos e pacientes, pelo botão “Envia SMS”. O recurso nas interfaces de médicos e pacientes gera uma mensagem SMS manual somente para aniversários, seguindo a mesma regra da interface de pedido, que possibilita a geração manual de mensagem SMS para:

• Agradecimento;
• Recoleta (é necessário que o pedido tenha ao menos um exame com recoleta pendente);
• Resultado pronto (é necessário que ao menos um exame esteja liberado/impresso);
• Aniversário (só é habilitado num período total de quatorze dias entre a data de aniversário cadastrada do paciente).

Antes de gerar uma mensagem SMS manualmente o sistema avisa se já foram geradas outras mensagens SMS daquele tipo anteriormente.

Ciclo de vida de uma mensagem SMS.

Ao gerar uma mensagem SMS, seja ela automática ou manual, a mensagem será encaminhada à lista de SMS com a situação “Pendente”, significando que esta mensagem deverá ser enviada. O serviço UniSMS interage com essa lista a cada trinta segundos, selecionando as mensagens a serem enviadas (da mais antiga para a mais recente) e enviando as mensagens ao servidor WEB em um pacote de mensagens SMS, de tamanho definido nas configurações do Unilab.

A partir deste ponto, o servidor WEB pode informar que este cliente está sem créditos para enviar a mensagem, então o serviço marca a mensagem como “Sem crédito”, assim ela será enviada novamente quando o cliente adquirir mais créditos. O usuário do Unilab também pode optar em cancelar o envio dessas mensagens. O serviço marca como “Enviado” as mensagens SMS que foram validadas com o servidor WEB e dele as mensagens SMS vão à fila para o servidor de envio, contudo a mensagem consta como “Enviada” a partir do momento que o servidor WEB valida e recebe a mensagem SMS.

Sincronizando postos com central.

O envio de SMS, realizado pelo serviço UniSMS, consulta apenas um banco de dados, neste caso, o da central. Portanto, é as mensagens geradas nos postos de coleta são transmitidas para a central. Quando as mensagens forem enviadas, a central transmite as informações para o posto. Há outras configurações de SMS que o posto deve receber da central, são os itens 1, 2, 6 e 7 descritos no capítulo Atualizando e configurando o Unilab.

Monitorando mensagens de SMS.

A interface SMS >> Caixa de saída no Unilab permite monitorar as mensagens SMS geradas pelos sistemas do Unilab e UniSMS. Nessa interface aparece o monitor do serviço UniSMS, informando seu último registro no banco de dados, tenha o serviço conseguido uma conexão com sucesso ou não do servidor WEB.

Assim que for carregado as informações do UniSMS há a verificação se o cliente tem créditos para enviar mensagem (aparece a quantidade na tela também) e se há mensagens que não foram enviadas por falta de crédito, perguntando ao usuário se ele deseja marcar novamente as mensagens SMS para envio, é marcado a data e o usuário responsável que realizou essa decisão, alterando a situação da mensagem SMS de acordo com o ciclo de vida.

Os botões “Envia” e “Todos” geram novas mensagens SMS para envio, copiando as informações da mensagem marcada (no caso de enviar todas, é gerado uma mensagem SMS nova para cada mensagem SMS que aparece na lista).