Manual do usuário - SMS SOCIAL http://smssocial.gi.fic.ufg.br/

1. MANUAL DO USUÁRIO
v. 1.0.0

2. Desenvolvimento da aplicação e projeto
UNIVERSIDADE FEDERAL DE GOIÁS - UFG
L3P - Laboratório de Políticas Públicas Participativas - FIC / UFG
UNIVERSIDADE FEDERAL DE SÃO CARLOS - UFSCar
Núcleo de Estudos e Pesquisas emTecnologia,Cultura e Sociedade - DCHE/UFSCar - campus Sorocaba
Coordenação Geral
Prof. Dalton Lopes Martins (UFG) - Profa Teresa Mary de C. Pires Melo (UFSCar)
Coordenação Executiva
Paulo Pistili
Desenvolvimento
Willians Pedroso
Design e Arquitetura
Edvaldo de Goiás Pereira Pontes
Renato de Paula Mesquita
Elaboração do Manual do Usuário
Paulo Pistili
Willians Pedroso
Teresa Melo
Dalton Martins
Carla Hirata (Coletivo EntreLinhas)
Mariana Kz (Coletivo EntreLinhas)
Vítor Massao (Coletivo EntreLinhas)
SOROCABA/GOIÂNIA
2015 / 2016

3. MANUAL DO USUÁRIO
v. 1.0.0

5. 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

7. 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

8. 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

9. 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
Mensagem
Enviada
Mensagem
Recebida no
SMS Social
SMS Social Operadoras
Resposta
Mensagem
Recebida no
Celular
SMS Social Provedor Operadoras
Provedor
9
Celular 1 Celular 2
mensagem
enviada
mensagem
recebida
Operadora 1 Operadora 2

10. 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

11. 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

12. 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

13. 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

14. 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

15. 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

16. 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

17. 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

18. 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. 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/