[Sobre o Zabbix] Integração de Alertas Zabbix com WhatsApp (YowSup)

Neste tutorial irei ensinar a como realizar a integração dos Alertas do Zabbix com o WhatsApp usando a ferramenta YowSup.

Neste tutorial estarei usando:

• CentOS 7
• Zabbix Server 4.0.1
• YowSup 3.2.3

Meu GIT com o projeto atualizado com os arquivos novos e versão do WhatsApp: https://github.com/everaldoscabral/yowsup

Só baixarem o projeto do meu GIT que irá funcionar perfeitamente! Foi testado dia 12/01/2022.

Caso não tenha um bom entendimento da ferramenta Zabbix, conhecimento em Linux, não aconselho a tentar realizar a implementação, por mais que eu tente facilitar o máximo possível no tutorial. Mas problemas podem surgir.

Lembrando que, o número a ser usado será de USO EXCLUSIVO da ferramenta. Antes de associar à ferramenta, caso seja uma linha que nunca tenha usado WhastApp, use-a por mais ou menos 1 semana. Para depois associar à ferramenta.

Sem mais delongas vamos por a mão na massa.

ATUALIZAÇÃO 12/01/2022!

Antes de iniciar necessitamos que, no Arquivo do Agent e do Server tenha:

Timeout=30

AllowRoot=1

E na hora que informar o número que irá receber os Alertas (Mída do Usuário) utilizem:

NUMERO@s.whatsapp.net

Informação adicional:

Outra coisa em relação ao envio de notificações para grupos, é que na Mídia de Usuário do Zabbix o campo "Send to" deve estar nesse formato: 5521xxxxxxxxx-xxxxxxxxxx@g.us. Para grupos deve se utilizar @g.us ou invés de @s.whatsapp.net. Mas se estiver enviando para um único número o final deve ser @s.whatsapp.net.

##Instalação do Python 3.6 e complementos necessários

yum install python-devel
yum install libevent-devel
yum install https://repo.ius.io/ius-release-el7.rpm
yum install python36u python36u-libs python36u-devel python36u-pip
yum install gcc git vim
yum install epel-release
yum install python-pip
yum install unzip wget

##Instalando dependências do YowSup conforme documentação (https://github.com/tgalal/yowsup/blob/master/setup.py)

python3.6 -m pip install --upgrade pip
python3.6 -m pip install consonance==0.1.3-1
python3.6 -m pip install appdirs
python3.6 -m pip install python-axolotl==0.2.2
python3.6 -m pip install requests
python3.6 -m pip install cryptography
python3.6 -m pip install six==1.10
python3.6 -m pip install argparse
python3.6 -m pip install pyaxmlparser

##Baixando YowSup e extraia para onde quiser. Esse caminho da extração será informado posteriormente.

git clone https://github.com/everaldoscabral/yowsup.git
cd yowsup

##Antes de iniciar é necessário alterar o MD5, Version e realizar upgrade do Protocolo WA 4.0. Para que não gere a mensagem de "old version".

##Alterando MD5 e Version. Isso será necessário todas as vezes que acontecer a mensagem supracitada ("old version").

vim yowsup/env/env_android.py

##Editar os campos _MD5_CLASSES E _VERSION

##Existe um script que coleta essas informações de forma fácil e rápida, segue link para download do script ou aqui também para download. Lembre-se de dar permissão de execução ao script e realizar o download do .apk do WhatsApp direto do site oficial.

#A forma de execução do script é:

python3 "script" "caminho do .apk"

#Supondo que tudo esteja no caminho /tmp, a execução é:

python3 dexMD5.py WhatsApp.apk

#A saída do script é a forma abaixo, basta copiar os dados e alterar nos campos citados:

Atuais dados dia 13/01/2022:

Version: 2.22.2.71

ClassesDex: Z0Q/+1av/0QrSugRSYAOoA==

#Agora é necessário realizar algumas modificações em alguns arquivos para realizar o upgrade do protocolo WA 4.0. Conforme link (https://github.com/tgalal/yowsup/pull/2924/files). Caso não queira editar, seguem arquivos editados para download. Lembrando de colocar no mesmo caminho:

##Criando arquivo de configuração do YowSup

vim /etc/zabbix/zap.conf

cc=55                                 #Código do País

phone=5579xxxxxxxx        #Composto com Código + DD + Número sem dígito 9

##Registrando (-E android sempre ter // -d debug)
##Você receberá um SMS com o código de ativação

python3.6 yowsup-cli registration -r sms -c /etc/zabbix/zap.conf -E android -d

##Código recebido e registrando

python3.6 yowsup-cli registration -R xxxxxx -c /etc/zabbix/zap.conf -d

##Após registrar terá que ter o status assim: status: b'ok'
##Após registrar agora é a hora de testar o envio de mensagem teste para um número. Dentro do executável "yowsup-cli" você pode trocar a chamada da versão para a 3.6, assim como eu fiz. Na primeira linha faz assim: #!/usr/bin/env python3.6

python3.6 ./yowsup-cli demos -c /etc/zabbix/zap.conf -s 5579xxxxxxxx "Mensagem de teste"

Agora temos a ferramenta totalmente funcional! Vamos agora para a parte do Zabbix.

##Criando um script para envio de Alertas
##Abaixo segue download do script que estou utilizando. Lembrando de dar permissão de execução chmod 777
##Aonde basta informar os os itens conforme seu cenário, seu gosto:

YOWSEXEC
CONF
LOG

zabbix-alertas-whatapp.sh

• $1 – Destino. Quem receberá a notificação.
• $2 – Assunto. Texto do assunto da notificação.

##O script deverá ficar em /usr/lib/zabbix/alertscripts ou o caminho que você escolher conforme arquivo de configuração do Zabbix Server. Para testar a execução do script segue mais abaixo.

./zabbix-alertas-whatapp.sh 5579xxxxxxxx "Teste"

##Também pode verificar a execução dando tail no arquivo de log:

tail -f /tmp/whatsapp.log

Agora basta criar um tipo de mídia na interface web do Zabbix e cadastrar a mídia para o usuário receber a notificação.



Cadastrando a mídia do usuário conforme o exemplo abaixo: 

VERIFICAR ATUALIZAÇÃO 05/06/2020, INÍCIO DO POST.

Uma imagem vale mais do que mil palavras.

Lembrando que é necessário criar a ação no Zabbix Server conforme print abaixo:

Bônus! 

É possível enviar alertas para um número ou para um Grupo, que é o que eu utilizo. Para isso, o número associado deve estar no Grupo depois basta pegar o ID do Grupo:

./yowsup-cli demos --yowsup --config /etc/zabbix/zap.conf
/L
/groups list 

Basta anotar o campo ID conforme destacado.

Bônus 2!

Caso tente enviar mensagens e fique a mensagem de "Aguardando essa mensagem. Isso pode demorar um pouco". Basta deletar o arquivo axolotl.db que fica em /root/.config/yowsup/5579xxxxxxxx. Também dê permissão de chmod 777 nessa pasta.

Todas às vezes que adicionar alguém no Grupo, será necessário deletar esse arquivo. Então melhor criar o Grupo, adicionar o contato bem como as pessoas que farão parte.

Bônus 3!

Eu tive que instalar tudo novamente no meu novo telefone, instalei o WhatsApp e quando começaram a chegar as notificações como imaginei, chegou aquela mensagem: "Aguardando essa mensagem. Isso pode demorar um pouco."?

Tentei deletar o arquivo axolotl.db que fica em /root/.config/yowsup, ainda sim não surtiu efeito. Então usei o comando find / -name axolotl.db e para minha surpresa, me mostrou mais outro diretório (/var/lib/zabbix/.config/yowsup) com este arquivo. Pois bem, bastou eu deletar também o arquivo deste diretório e voltei a receber normalmente os alertas. \O/

Bom pessoal espero ter ajudado e estou à disposição.

Abraços
\O