MANUAL DO USUÁRIOv. 1.0.0

Desenvolvimento da aplicação e projeto

UNIVERSIDADE FEDERAL DE GOIÁS - UFGL3P - Laboratório de Políticas Públicas Participativas - FIC / UFG

UNIVERSIDADE FEDERAL DE SÃO CARLOS - UFSCarNúcleo de Estudos e Pesquisas em Tecnologia, Cultura e Sociedade - DCHE/UFSCar - campus Sorocaba

Coordenação GeralProf. Dalton Lopes Martins (UFG) - Profa Teresa Mary de C. Pires Melo (UFSCar)

Coordenação ExecutivaPaulo Pistili

DesenvolvimentoWillians Pedroso

Design e ArquiteturaEdvaldo de Goiás Pereira PontesRenato de Paula Mesquita

Elaboração do Manual do UsuárioPaulo PistiliWillians PedrosoTeresa MeloDalton MartinsCarla Hirata (Coletivo EntreLinhas)Mariana Kz (Coletivo EntreLinhas)Vítor Massao (Coletivo EntreLinhas)

SOROCABA/GOIÂNIA2015 / 2016

MANUAL DO USUÁRIOv. 1.0.0

Sumário

Introdução ............................................................................................................................7

1. Principais funcionalidades ..............................................................................................7

1.1. Por que o Wordpress? ............................................................................................................8

1.2. Pré-requisitos .........................................................................................................................8

2. Funcionamento do SMS Social .......................................................................................9

2.1. Como as mensagens são enviadas e recebidas? ....................................................................9

2.2. Personalização .....................................................................................................................10

2.3. Perfis de usuários .................................................................................................................10

3. Iniciando o SMS SOCIAL ................................................................................................11

3.1. Login ....................................................................................................................................11

3.2. Página inicial ........................................................................................................................12

3.3. Cadastrando instituições ......................................................................................................12

3.4. Configurando perfis de usuário ............................................................................................13

3.5. Gerenciando grupos .............................................................................................................14

3.6. Gerenciando contatos ..........................................................................................................15

3.7. Exportar contatos .................................................................................................................15

3.8. Importar contatos ................................................................................................................15

3.9. Mensagens ...........................................................................................................................16

3.10. Mensagens enviadas ............................................................................................................17

3.11. Mensagens recebidas ...........................................................................................................18

3.12. Relatórios .............................................................................................................................19

Considerações finais .........................................................................................................19

Introdução

O SMS Social é uma ferramenta de gestão de grupos de contatos e envio de mensagens do tipo SMS. Tem como principal objetivo potencializar a relação entre determinada instituição e seu público a partir de um meio de comunicação acessível e personalizado. Com o enfoque principal na área social é uma ferramenta pensada para gestores e profissionais que trabalham com diferentes políticas públicas e que precisam de um veículo de comunicação direto com seu público.

Este manual do usuário apresenta as principais funcionalidades do SMS Social e os pré-requisitos necessários para instalação. A instalação do SMS Social exige conhecimentos técnicos. No entanto, após a instalação pode ser operado por qualquer pessoa. O SMS Social é uma aplicação intuitiva e de fácil aprendizagem.

1. Principais funcionalidades

l Envio e recebimento de mensagens SMS: para contatos individuais, bem como para grupos de usuários; l Gerenciamento de contas de usuários utilizadores do serviço; l Cadastro de grupos de contatos; l Cadastro de contatos; l Associação de contatos cadastrados a grupos de contatos; l Possibilidade de importação de planilha de contatos; l Criação de relatórios de envio e recebimento de mensagens de fácil exportação; l Integração com APIs de operadoras brasileiras para envio e recebimento de SMS.

Para maiores informações sobre instalação e configuração do SMS Social, consulte o Guia de instalação da aplicação, disponível no link: http://smssocial.gi.fic.ufg.br/tutoriais

7

API significa Application Programming Interface ou, em português, Interface de Programação de Aplicativos. É o conjunto de padrões de programação para integração entre sistemas. O provedor do sistema de envio de mensagens fornece uma série de códigos de programação para que o SMS Social possa incorporar suas funções em sua programação. Para saber mais sobre APIs, acesse: https://pt.wikipedia.org/wiki/Interface_de_programação_de_aplicações

1.1 Por que o Wordpress?

O SMS Social foi desenvolvido para ser utilizado a partir do software livre de gerenciamento de con-teúdo web Wordpress, possibilitando à aplicação:

- ser um ferramenta acessível que funcione via internet; - ser disponibilizada gratuitamente; - ser personalizável; - permitir o aprimoramento pela comunidade de usuários e desenvolvedores Wordpress.

O Wordpress é um potente gerenciador de conteúdo web que possibilita ao usuário desenvolver sites, blogs e portais. Fácil de usar, flexível e que possibilita a criação de projetos pequenos e simples a projetos mais complexos. Além disso, o Wordpress possibilita a instalação de uma vasta gama de plugins e temas que podem ser adicionados ao projeto e possui uma comunidade participativa na proposição de novas ferramentas, conteúdos e informação sobre o Wordpress.

1.2 Pré-requisitos

Para o funcionamento da ferramenta são necessários alguns pré-requisitos:

l Um domínio na web para utilizar a aplicação. Você pode utilizar um domínio que já possui ou criar um novo para o SMS Social. Importante: O SMS Social é uma aplicação que assume o controle total do site, alterando configurações e conteúdo previamente instalados. É importante criar um domínio exclusivo para o SMS Social; l Contratar um serviço de hospedagem para seu site ou utilizar um serviço já existente; l Instalar a versão mais recente do Wordpress; l Contratar um serviço de envio e recebimentos de mensagens.

No caso desta primeira versão do SMS Social, utilizamos o serviço da empresa Zenvia, que gerencia o envio e recebimento de mensagens SMS para as principais operadoras de telefonia móvel do país.

Saiba mais em: https://wordpress.org/ e https://br.wordpress.com/

Saiba mais sobre o Zenvia em: http://www.zenvia.com.br/pt/

8

2. Funcionamento do SMS Social 2.1 Como as mensagens são enviadas e recebidas?

No modelo como enviamos nossas mensagens pelo celular a informação é transmitida da seguinte forma:

Já com a utilização do SMS Social integrada a um provedor, a informação é transmitida da seguinte forma.

Funciona assim: após instalar o SMS Social, você entrará em contato com uma empresa de envio de SMS, este tipo de empresa é conhecida como provedor ou gateway. É uma espécie de portal que transmite a informação de um aparelho ou software para as operadoras de telefonia celular, que em seguida transmite a outro aparelho celular e vice-versa.

Assim como no envio de mensagens por nosso celular este serviço tem um custo, que varia de empresa para empresa. Entre em contato com o provedor e faça uma análise das possibilidades de contratação. Muita atenção neste momento, pois em alguns casos existem cobranças e planos diferentes quando se deseja apenas enviar mensagens pela ferramenta ou quando deseja enviar e receber mensagens.

O SMS Social está configurado para realizar ambas as operações, no entanto, a efetivação do serviço depende do plano contratado.

Lembramos que o SMS Social está configurado para o provedor da empresa Zenvia nesta primeira versão. Caso queira utilizar outro serviço, será necessário refazer a integração entre o SMS Social e o provedor.

O provedor deverá fornecer toda a documentação da integração com o SMS Social além do usuário e senha para acessar o serviço.

SMS Social Gateway Operadoras

MensagemEnviada

MensagemRecebida noSMS Social

SMS Social OperadorasResposta

MensagemRecebida no

Celular

SMS Social Provedor Operadoras

Provedor

9

Celular 1 Celular 2mensagem

enviadamensagem

recebidaOperadora 1 Operadora 2

2.2 Personalização

O SMS Social pode ser personalizado, pois fornece todo o código para que qualquer pessoa com conhecimento em programação web possa alterar as funções, cores e conteúdo da ferramenta. Você pode, por exemplo, alterar o logo do SMS Social e colocar o logo da instituição em que trabalha ou até mesmo alterar as cores da aplicação e muitos outros itens.

2.3 Perfis de usuários

A aplicação está vinculada às configurações do painel principal do Wordpress. Ao instalar o Wordpress, o administrador do site em que o SMS Social está instalado poderá definir contas para cada usuário. Existem três níveis de usuários para a aplicação:

l Se você fará a instalação e administração do site Wordpress de sua instituição: ADMINISTRADOR WORDPRESS.

- Tem acesso total a todas as funções do sistema.

l Se você irá cadastrar e gerenciar funcionários e gestores de determinada instituição que utilizarão a ferramenta e precisa visualizar as mensagens enviadas e recebidas, ver contatos, gerar relatórios e escolher o provedor: ADMINISTRADOR.

- Tem acesso a todas as funções do sistema, exceto ao painel de configurações do Wordpress.

l Se você é responsável por gerenciar contatos, criar grupos, enviar mensagens e extrair relatórios: GESTOR.

- Tem acesso a todas as funções do sistema, exceto funções administrativas, como por exemplo, escolher um provedor ou gerenciar contas de usuários.

10

Cada perfil de usuário está vinculado a uma instituição. No momento em que um usuário está vinculado a uma instituição, ele só poderá visualizar as informações dessa instituição. Caso queira visualizar outras instituições, precisará alterar isso em seu cadastro.

Portanto, para iniciar a utilização do sistema, o administrador do site Wordpress precisa for-necer um usuário e senha de administrador para que a ferramenta possa ser utilizada.

3. Iniciando o SMS SOCIAL

Agora que o SMS SOCIAL já está online, instalado em um site, personalizado, com o usuário e senha do plano contratado e você já tem um login e senha, poderá começar a utilizar o SMS SOCIAL. Lembrando que o primeiro acesso ao SMS SOCIAL deve ser feito por um usuário administrador wordpress ou por um usuário administrador, pois apenas estes dois perfis têm permissão para criar novos usuários de nível gestor e cadastrar o provedor. Os tópicos a seguir apontam uma visão geral da aplicação a partir do usuário administrador.

3.1 Login

Na tela de login, insira seu usuário e senha para acessar a aplicação.

O link fale conosco envia uma mensagem para o administrador wordpress da sua aplicação.

No item ajuda, você encontrará alguns links como este manual do usuário e um link para o site da aplicação.

11

3.2 Configurando o provedor

É possível configurar o provedor de envio de mensagens pelo menu admin do SMS Social.

Acesse: Admin > Provedor > selecione o provedor cadastrado > insira usuário e senha fornecidos pelo provedor.

Neste primeiro acesso e teste da ferramenta é importante o auxílio do administrador wordpress, recomenda-se que o cadastramento do provedor seja feito por este profissional.

3.3 Cadastrando instituições

Uma das primeiras ações para o uso da aplicação é o cadastramento das instituições que utiliza-rão o sistema. Caso o administrador wordpress não tenha feito isso no momento do cadastro do usuário ADMINISTRADOR, você pode fazer agora na própria ferramenta.

Acesse o menu Admin > Instituição > +Instituição > Digite o nome da instituição.

Ex.: “Biblioteca Central”, “CRAS - Zona Norte”, “EM Profa Maria de Lourdes”

A partir da instituição criada, você poderá criar os usuários gestores de cada instituição que utilizarão a aplicação.

12

Você pode criar quantas instituições forem necessárias, no entanto, só poderá visualizar uma instituição por vez.

Veja o exemplo abaixo de uma situação concreta para definir perfis de usuário:Digamos que você seja responsável pela secretaria de cultura de um município e alguns equipamentos culturais da cidade utilizarão o SMS Social para se comunicar com seu público direto. Você poderá cadastrar o museu, a biblioteca, o centro cultural, o teatro, entre outros. E para cada equipamento cultural, você poderá criar um usuário gestor para cada instituição.

3.4 Configurando perfis de usuário

Agora que você criou uma instituição, já pode associar seu cadastro a esta instituição.

No menu vá para Admin > Usuário > Editar. Além de inserir a instituição criada, você pode alterar outras informações da sua conta.

Para criar um novo usuário, vá no menu Admin > Usuário > +Usuário. Você poderá criar outro usuário administrador ou outro usuário gestor.

13

3.5 Gerenciando grupos

Todos os contatos do SMS Social devem ser associados a um ou mais grupos de contatos. Um grupo de contatos pode ser organizado a partir do público a quem se destina a mensagem ou de determinada organização da instituição. Por exemplo, em uma biblioteca pode haver um grupo de leitores de literatura infanto-juvenil, um grupo de sarau e um grupo de jogos teatrais.

Caso você queira enviar mensagens para todos os contatos da sua instituição, você também pode cadastrar um grupo GERAL ou TODOS em que obrigatoriamente todos os usuários estarão cadastrados.

Acesse: Contatos > Grupos > +Grupo.

Em descrição do grupo, digite o nome do grupo. Ex.: GERAL

Terminado o cadastro, você pode editar ou excluir o grupo criado.

Importante: Ao excluir um grupo, automaticamente os contatos cadastrados serão excluídos, exceto em casos em que o contato cadastrado estiver em mais de um grupo.

14

3.6 Gerenciando contatos

No menu Contatos > Pessoas > +Pessoas, você poderá cadastrar um novo contato.

Primeiro, escolha o grupo deste contato e clique em Incluir. Caso tenha mais grupos cadas-trados, você pode adicionar este contato em quantos grupos for necessário, basta selecionar o novo grupo e clicar em Incluir.

Em seguida, insira o nome do contato e o telefone. Você deve utilizar o modelo apresentado na tela: Cód. do país + DDD + Telefone. Ex.: 551599009900. Você também pode colocar o e-mail do contato.

Em Contatos > Pessoas, você pode visualizar o contato cadastrado, editar e excluir.

3.7 Exportar contatos

O SMS Social possibilita a exportação de contatos. No menu Pessoas, no fim da lista de contatos você encontrará o botão EXPORTAR DADOS, basta clicar e um arquivo com todos os contatos será exportado.

3.8 Importar contatos

No SMS Social também é possível importar contatos. No menu Contatos > Importar, basta selecionar o grupo em que os contatos serão cadastrados e adicionar um arquivo no formato (csv) com a seguinte estrutura: nome do contato;5511999999991.

15

3.9 Mensagens

Para enviar mensagens, siga para o menu Mensagem > Nova. Você poderá enviar mensagens para grupos ou para contatos individuais desde que estejam previamente cadastrados no sistema. O procedimento para ambos é o mesmo.

1) Selecione a aba Grupos ou Contatos 2) Selecione o grupo ou contato e clique em Incluir 3) Feito isso, você poderá categorizar essa mensagem. Adicione categorias que possam auxiliar a busca e análise das mensagens enviadas pelos usuários da aplicação.

16

Ex.: Na seguinte mensagem: “[SMS SOCIAL] No dia 14/01 haverá o lançamento da aplicação SMS Social no Núcleo ETC da UFSCar, participe!”

Esta mensagem pode ser categorizada a partir das escolhas de cada instituição, mas a título de exemplo, podemos colocar como categorias: evento, software.

Para inserir uma categoria, basta digitar o nome da categoria e clicar em ADD. Repita a operação para adicionar outras categorias.

4) Em Envio programado, você pode adicionar Data e Hora de envio. Caso queira enviar imediatamente a mensagem, deixe este campo em branco. 5) A mensagem do SMS Social segue o padrão texting SMS de celulares convencionais, com limite de 160 caracteres.

Feito isso, basta clicar em Enviar Msg.

3.10 Mensagens enviadas

Visualize mensagens enviadas no menu Mensagens > Enviadas

Há uma série de possibilidades de pesquisa das mensagens enviadas e filtros de visualização. Além disso, você pode:

- Visualizar mensagens enviadas, para reenviá-las caso queira. - Exportar todas as mensagens enviadas.

17

3.11 Mensagens recebidas

Em Mensagens > Recebidas é possível:

- Visualizar mensagens recebidas - Responder mensagens

Para evitar lentidão no tráfego de mensagens, o recebimento de mensagens não atualiza automaticamente. Para visualizar novas mensagens clique no botão Atualizar, na janela de mensagens recebidas.

Você pode conferir o envio e recebimento de mensagens consultando o painel do provedor contratado e, assim, avaliar se não há problemas com a integração do SMS Social com o provedor.

18

19

3.12 Relatórios

Os relatórios do SMS Social possibilitam a visualização em forma de gráficos: Mensagens Enviadas, Recebidas e dos Créditos gastos. Os gráficos podem ser baixados em quatro formatos diferentes.

O relatório de créditos está baseado nos custos debitados da conta do provedor SMS. Esta função depende do tipo de conta contratada no provedor.

Considerações finais

Esta primeira versão do SMS Social busca ser uma ferramenta intuitiva e prática de gerenciamen-to de contatos e envio de mensagens SMS que possibilite a criação de modelos de comunicação para gestores e profissionais que trabalham com políticas públicas de diferentes áreas. Informações detalhadas sobre o projeto e contato com os desenvolvedores encontram-se em nosso site.

Para maiores informações: http://smssocial.gi.fic.ufg.br/