Skip to content

Latest commit

 

History

History
134 lines (102 loc) · 6.92 KB

README.md

File metadata and controls

134 lines (102 loc) · 6.92 KB
Raw

nvoip-zabbix

Scripts para uso com a plataforma Zabbix integrada com a API da Nvoip.

Intruções

  • Para usar os scripts, é necessário ter uma conta e um token válido na Nvoip. Você pode criar sua conta gratuitamente em https://www.nvoip.com.br
  • Sinta-se livre para criar e contribuir com os códigos deste repositório. Também fique a vontade para reportar bugs relacionados ao uso da API com a linguagem PHP.
  • Acesse https://www.nvoip.com.br/api para acessar a documentação da nossa API.

Scripts by Nvoip:

Disparo de SMS Shell Script - send_sms_nvoip_zabbix.sh

Este script irá disparar um SMS quando uma Trigger do Zabbix for acionada. Para isso, é necessário também configurar uma Midia no Zabbix. Como usar (Testado no Zabbix 3.4):

  1. Copie o arquivo send_sms_nvoip_zabbix.sh no diretório de Scripts de Alerta do Zabbix (No nosso caso ficou em /usr/lib/zabbix/alertscripts). Para consultar onde é este diretório na sua versão do Zabbix acesse o arquivo zabbix_server.conf (Geralmente em /etc/zabbix/zabbix_server.conf) e procure a linha: AlertScriptPath. Altere a linha token_auth com o seu Token da Nvoip.

  2. Ajuste as permissões do arquivo com os comandos: chown zabbix:zabbix (ou o usuário que definiu pro Zabbix) e chmod 777.

  3. Acesse seu Zabbix, vá em Administração > Tipo de Mídia e clique em Criar Tipo de Mídia e use as configurações abaixo:

Nome: SMS Nvoip
Tipo: Script
Nome Script: send_sms_nvoip_zabbix.sh
Parâmetro:
{ALERT.SENDTO}
{ALERT.SUBJECT}
{ALERT.MESSAGE}
{HOST.NAME1}
Ativo: Sim

  1. Vá em Configurações > Usuários, selecione o usuário que irá receber o SMS. Clique em Mídia, Adicionar. Configure com os dados abaixo:
    Tipo: SMS Nvoip
    Enviar para: (Coloque aqui o celular que irá receber o SMS (Atualmente somente celulares brasileiros). Formato: DDD+Número. Exemplo: 11911112222.
    Ativo quando: 1-7,00:00-24:00 (Ou de acordo com a sua preferência)
    Usar se severidade: Marque as opções de severidade da trigger que irá disparar o SMS.
    Ativo: Sim

  2. Pronto. Agora você irá receber o SMS.

Disparo de Torpedo de Voz Shell Script - send_torpedovoz_nvoip_zabbix.sh

Este script irá disparar uma ligação de voz lendo o problema ocasionado através de TTS.

Como usar (Testado no Zabbix 3.4):

  1. Copie o arquivo send_sms_nvoip_zabbix.sh no diretório de Scripts de Alerta do Zabbix (No nosso caso ficou em /usr/lib/zabbix/alertscripts). Para consultar onde é este diretório na sua versão do Zabbix acesse o arquivo zabbix_server.conf (Geralmente em /etc/zabbix/zabbix_server.conf) e procure a linha: AlertScriptPath. Altere a linha token_auth com o seu Token da Nvoip.

  2. Ajuste as permissões do arquivo com os comandos: chown zabbix:zabbix (ou o usuário que definiu pro Zabbix) e chmod 777.

  3. Acesse seu Zabbix, vá em Administração > Tipo de Mídia e clique em Criar Tipo de Mídia e use as configurações abaixo:

Nome: Torpedo de Voz Nvoip
Tipo: Script
Nome Script: send_torpedovoz_nvoip_zabbix.sh
Parâmetro:
{ALERT.SENDTO}
{ALERT.SUBJECT}
Ativo: Sim

  1. Vá em Configurações > Usuários, selecione o usuário que irá receber o SMS. Clique em Mídia, Adicionar. Configure com os dados abaixo:
    Tipo: Torpedo de Voz Nvoip
    Enviar para: (Coloque aqui o celular que irá receber o SMS (Atualmente somente celulares brasileiros). Formato: DDD+Número. Exemplo: 11911112222.
    Ativo quando: 1-7,00:00-24:00 (Ou de acordo com a sua preferência)
    Usar se severidade: Marque as opções de severidade da trigger que irá disparar a ligação.
    Ativo: Sim

  2. Pronto. Agora você irá receber o Torpedo de Voz.

English Version

PHP language scripts and libraries for use with the Nvoip API.

Instructions

  • To use the scripts, you must have a valid Nvoip account and token. You can create your account for free at https://www.nvoip.com.br
  • Feel free to create and contribute code from this repository. Also feel free to report bugs related to the use of the API with the PHP language.
  • Visit https://www.nvoip.com.br/api to access our API documentation.

Scripts by Nvoip:

SMS Shell Script Trigger send_sms_nvoip_zabbix.sh

This script will trigger an SMS when a Zabbix Trigger is triggered. For this, it is also necessary to configure a media in Zabbix. How to use it (Tested on Zabbix 3.4):

  1. Copy the send_torpedovoz_nvoip_zabbix.sh file to the Zabbix Alert Scripts directory (In our case it was / usr/lib/zabbix/alertscripts). To see where this directory is in your version of Zabbix go to the zabbix_server.conf file (usually /etc/zabbix/zabbix_server.conf) and look for the line: AlertScriptPath. Change the token_auth line with your Nvoip Token.

  2. Set the file permissions with the commands: chown zabbix: zabbix (or the user who set it for Zabbix) and chmod 777.

  3. Access your Zabbix, go to Administration> Media Type and click Create Media Type and use the settings below:

Name: SMS Nvoip
Type: Script
Script Name: send_sms_nvoip_zabbix.sh
Parameter:
{ALERT.SENDTO}
{ALERT.SUBJECT}
{ALERT.MESSAGE}
{HOST.NAME1}
Active: Yes

  1. Go to Settings> Users, select the user who will receive SMS. Click Media, Add. Configure with the data below:
    Type: SMS Nvoip
    Send to: (Enter here the phone that will receive the SMS (Currently only Brazilian mobile phones.) Format: DDD + Number. Example: 11911112222.
    Active when: 1-7,00:00-24:00 (Or according to your preference)
    Use if severity: Check the trigger severity options that will trigger SMS.
    Active: Yes

  2. Ready. You will now receive the SMS.

SMS Shell Script Trigger send_sms_nvoip_zabbix.sh

This script will trigger an SMS when a Zabbix Trigger is triggered. For this, it is also necessary to configure a media in Zabbix. How to use it (Tested on Zabbix 3.4):

  1. Copy the send_torpedovoz_nvoip_zabbix.sh file to the Zabbix Alert Scripts directory (In our case it was / usr/lib/zabbix/alertscripts). To see where this directory is in your version of Zabbix go to the zabbix_server.conf file (usually /etc/zabbix/zabbix_server.conf) and look for the line: AlertScriptPath. Change the token_auth line with your Nvoip Token.

  2. Set the file permissions with the commands: chown zabbix: zabbix (or the user who set it for Zabbix) and chmod 777.

  3. Access your Zabbix, go to Administration> Media Type and click Create Media Type and use the settings below:

Name: Voice Call Message Type: Script
Script Name: send_torpedovoz_nvoip_zabbix.sh
Parameter:
{ALERT.SENDTO}
{ALERT.SUBJECT}
Active: Yes

  1. Go to Settings> Users, select the user who will receive SMS. Click Media, Add. Configure with the data below:
    Type: Voice Call Message Send to: (Enter here the phone that will receive the SMS (Currently only Brazilian mobile phones.) Format: DDD + Number. Example: 11911112222.
    Active when: 1-7,00:00-24:00 (Or according to your preference)
    Use if severity: Check the trigger severity options that will trigger the Voice Call Message.
    Active: Yes

  2. Ready. You will now receive the Voice Call Message.