Envio de SMS usando Zenvia

Acio Pires e Willeson Souza

MANAUS-AM
NOV/2013
Histrico de Atualizaes
Data Verso Responsvel Alteraes
24 out 2013 1.0 Willeson Souza Verso inicial
21 nov 2013 1.1 Acio Pires Reviso e ajustes no contedo
Licea de Uso
Este trabalho est licenciado sob uma Licena Creative Commons Atribuio-Uso No-Comercial 2.5
Brasil. Para ver uma cpia desta licena, visite http://creativecommons.org/licenses/by-nc/2.5/br/ ou
envie uma carta para Creative Commons, 171 Second Street, Suite 300, San Francisco, California
94105, USA.
Su!"rio
0 !"tendo usu#rio e sen$a do %envia .............................................................................4
1 &ntrodu'o .....................................................................................................................4
2 (on)i*urando o uso de s$ell scri+t no servidor %a""i, ................................................4
3 - .estando o se o scri+t )oi con)i*urado correta/ente....................................................0
4 Visualizando se o S1S )oi enviado co/ sucesso...........................................................0
2 Adicionando o Scri+t no %a""i, ....................................................................................0
0 (on)i*urando o usu#rio Ad/in +ara rece"er alertas +ela /3dia S1S4%envia...............5
6 - (riando a a'o de envio de e/ails..............................................................................7
(onsidera'8es )inais.........................................................................................................13
#$io de SMS usado %e$ia
0 - O&tedo usu"rio e se'a do %e$ia
O primeiro passo para a execuo deste tutorial obter um acesso grtis ao Zenvia em
http://www.zenvia.com.br ou envie um e-mail para lucas.melgareco@zenvia.com.br solicitando uma
cotao para sua empresa, ser disponibilizado 20 SMS de testes.
1- (trodu)o
Neste tutorial ser visto como o SMS pode ajudar um administrador de rede a ficar atento aos
alertas do Zabbix*
O diferencial do ZENVA a entrega automtica do SMS como VOZ, quando o destino
indicado um telefone FXO. Ele permite multienderear o SMS, agend-lo, receb-lo e entreg-lo
com Short Number (mais garantido).
2 - +o,i-urado o uso de s'ell scri.t o ser$idor %a&&i/
Os shell scripts, dependendo das permisses de usurio definido para execut-los, tornam-se
disponveis para serem executados a partir da interface Web do Zabbix, clicando em um
determinado host em vrios locais da interface Web, tais como: o Dashboard, pgina com os dados
recentemente coletados, estado de gatilhos, eventos e mapas. Eles tambm podem ser executados
como uma ao previamente configurada pelo administrador que ser executada quando
determinado evento acontecer.
Os scripts so executados no servidor Zabbix ou no agente. Neste tutorial sero executados
script a partir do servidor para que toda vez que tiver um determinado evento acontecer, uma ao
ser executado para enviar o alerta via SMS, por meio do Zenvia.
Este tutorial foi testado em dois ambientes:
A!&iete 10 Zabbix 2.0.6 no Debian 6.0 e banco de dados PostgreSQL 8.X.
A!&iete 20 Zabbix 2.2.0 no Ubuntu 12.04 e banco de dados PostgreSQL 9.3.
Para comear configure a localizao padro de scripts de alerta no Zabbix. Edite o arquivo
za&&i/1ser$er*co, e informe o diretrio padro de scripts no parmetro mostrado a seguir.
AlertScriptsPath=/opt/zabbix/share/zabbix/alertscripts
Depois disso reinicie o servio zabbix-server.
Ate)o0
A localizao do arquivo padro de scripts de alertas no zabbix e comando para reiniciar o zabbix
server varia de acordo com os procedimentos de instalao do zabbix em cada distro GNU/Linux.
sso no ser mostrado aqui.
Em seguida crie um script com o nome ze$ia1s!s*s' e salve dentro do diretrio padro de
scripts usados pelo Zabbix conforme configurado anteriormente. Dentro do script adicione o
contedo abaixo.

#!/bin/sh
#
# albertofreire@yahoo.com.br
#
# Variveis do zabbix
DST="$1"
SUBJ="$2"
MSG="$3"
LOG=/tmp/zabbix_server.log
# Variveis de integrao da zenvia (POST/GET http)
# "dispatch=send" indica que envio simples
STE="http://api.zenvia360.com.br/Gatewayntegration/msgSms.do?dispatch=send"
# -------------------------------
# nforme aqui o seu login e senha de acesso ao Zenvia
CONTA="xxxxxxx"
CODE="xxxxxxx"
# --------------------------------
# Testa se o wget est instalado e qual seu path
PATH_WGET=$(whereis wget | awk '{print $2}')
if [ -z ${PATH_WGET} ]; then
echo "wget necessrio para continuar";
exit 1;
fi
# Configura os parametros para envio do sms
# O output-file foi utilizado para informar erros de autenticao com o servidor de gateway-sms
# Os logs do wget aparecero no zabbix_server.log
WGET="${PATH_WGET} --no-cache --no-cookies -S -O $LOG --post-data"
# Monta tudo e efetiva o envio
# Dependendo do gateway-sms pode-se ajustar os nomes dos input's do form http, ex:
# A Zenvia utiliza o 'account','code','to'... outros gateways utilizam nomes diferentes, basta alterar.
$($WGET "&account=${CONTA}&code=${CODE}&to=${DST}&from=${SUBJ}&msg=${MSG}" ${STE})
exit 0
Torne o arquivo executvel com o comando abaixo.
$ sudo chown -R zabbix:zabbix DR_SCRPTS_ALERT
$ sudo chmod 755 DR_SCRPTS_ALERT/zenvia_sms.sh
Ate)o0
No script altere as linhas iniciadas com CONTA e CODE para a conta e senha que sero a origem
do dados da integrao do Zenvia. No comando acima, substitua DR_SCRPTS_ALERT pela
localizao do arquivo zenvia_sms.sh.
3 2 3estado o se o scri.t ,oi co,i-urado correta!ete
Para testar execute o seguinte comando.
$ sudo DR_SCRPTS_ALERT/zenvia_sms.sh 55DDDNUMTELEFONE remetente "mensagem
Ode0
55 o cdigo do Brasil, DDD deve ser substitudo pelo DDD da cidade, NUMTELEFONE
deve ser substitudo pelo numero do telefone. Tudo isso deve ficar junto. Exemplo:
558312345678.
4e!etete0 deve ser substitudo pelo nome de quem est enviando a mensagem. Exemplo:
zabbix.
Mesa-e!0 deve ser substitudo pela mensagem que voc que quer seja enviada. Deve
estar entre aspas duplas e !eos de 120 caracteres. Exemplo: "SMS enviado por
Zemvia+Zabbix.
5 - Visualizado se o SMS ,oi e$iado co! sucesso
Visualize o log olhando o arquivo zabbix-server.log. Veja se h uma linha semelhante a 6 000
- Messa-e Set 7* Se sim, o SMS foi enviado com sucesso.
8 - Adicioado o Scri.t o %a&&i/
Acesse o menu Ad!iistra)o 9Ad!iistratio: ; 3i.os de !<dia 9Media t=.es: e clique
no boto +riar ti.o de !<dia 9+reate Media 3=.e:*
>i-ura 10 +adastrado u!a o$a !<dia*
Preencha as informaes da nova mdia, conforme mostrado abaixo:
?escri)o 9?escri.tio:0 SMS_Zenvia
3i.o 93=.e:0 Script
No!e scri.t 9Scri.t a!e:0 zenvia_sms.sh
Ati$o 9#a&led:0 Marque a opo.
Clique no boto Sal$ar 9Sa$e:.
>i-ura 20 +adastrado o scri.t de e$io de SMS*
>i-ura 30 Visualizado o scri.t cadastrado*
@ - +o,i-urado o usu"rio Ad!i .ara rece&er alertas .ela
!<dia SMS1%e$ia
Acesse o menu Ad!iistra)o 9Ad!iistratio: ; Usu"rios 9Users: e clique no usurio
Admin.
>i-ura 50 Selecioado o usu"rio Ad!i*
Clique na aba M<dia 9Media: e, em seguida, no link clique em Adicioar 9Add:.
>i-ura 80 Associado a o$a !<dia ao usu"rio Ad!i*
Preencha as informaes conforme mostradas abaixo e na Figura 5.
3i.o 93=.e:: zenvia_sms.sh
#$iar .ara 9Sed to:: Numero telefone a ser enviado o SMS. Onde: 55 o cdigo do Brasil,
acrescido do DDD da cidade e do numero do celular. Tudo isso deve ficar junto. Exemplo:
558312345678.
Auado ati$o 9B'e acti$e:: Coloque o horrio em que a pessoa ser notificada.
Usar se risco 9Use i, se$erit=:: Marque as opes de gravidades de alerta dos quais o usurio
deve ser notificado.
Status: Ativo (Enabled)
Clique no boto Adicioar 9Add:.
Depois que a nova mdia estiver cadastrada para o Administrador, clique em Sal$ar 9Sa$e:*
>i-ura @0 Visualizado a !<dia associad ao usu"rio Ad!i*
C 2 +riado a a)o de e$io de e-!ails*
Acesse o menu +o,i-ura)o 9+o,i-uratio: ; Aes 9Actios: e clique no boto +riar
A)o 9+reate Actio:*
>i-ura C0 +riado u!a o$a a)o*
Na aba A)o 9Actio: altere, inicialmente, apenas o campo No!e 9Na!e: conforme a Figura
7. O contedo da mensagem deve ter !eos de 120 caracteres.
>i-ura D0 #ditado a a&a A)o*
Na aba +odies 9+oditios: delete as condies existente e, em No$a codi)o 9NeE
coditio:, configure da seguinte maneira:
Severidade da Trigger (Trigger severity) = "nformation"
Severidade da Trigger (Trigger severity) = "Warning"
Severidade da Trigger (Trigger severity) = "Average"
Severidade da Trigger (Trigger severity) = "High"
Severidade da Trigger (Trigger severity) = "Disaster"
Clique em Adicioar 9Add:.
>i-ura F0 #ditado a a&a +odi)o*
Na aba Aes 9O.eratios: clique em No$a 9NeE:.
>i-ura 100 +riado u!a o$a codi)o*
Em ?etal'es da o.era)o 9O.eratio details:, configure as opes:
3i.o de o.era)o 9O.eratio t=.e:: Enviar mensagem (Send message).
Em #$iar .ara usu"rios 9Sed to Users: clique em Adicioar 9Add:. Selecione o usurio Admin
e clique em Selecioar 9Select:.
Em #$iar a.eas .ara 9Sed ol= to:, selecione SMS_Zenvia.
>i-ura 110 #ditado a a&a A)o*
Clique em Sal$ar 9Sa$e:.
>i-ura 120 Sal$ado a o$a a)o*
Agora que as aes foram definidas clique em Sal$ar 9Sa$e:.
Quando o evento acontecer, voc dever receber o SMS enviado pelo Zabbix+Zenvia.
+osideraes ,iais
Neste tutorial foi mostrado o envio de SMS via Zenvia, empresa de envio de SMS corporativo
de forma simples e com total segurana
No site da comunidade Zabbix Brasil, mais especificamente na pgina http://zabbixbrasil.org/?
page_id=7, voc pode encontrar outros tutoriais que mostram a instalao dos componentes Zabbix
Agent e Zabbix Proxy, alm de mostrar como usar a interface Web do Zabbix para monitorar alguns
tipos de equipamentos.
A-radeci!etos
A Deus Eterno, que com a Palavra do seu poder, tem nos sustentado e abenoado at
o dia de hoje.
Amigos: Alberto Freire, Hernandes Martins, Ediclia Michiles, comunidade do
zabbixbrasil.org.
Mesa-e!
Abrao e que Deus o(a) abenoe. Leia Provrbios 23:7 porque,
como imagina sua alma, assim . :)