EN

Integración SMS con Zabbix

Envía notificaciones SMS a través de la plataforma LabsMobile integrada con el sistema de monitorización de redes Zabbix. Configura tu aplicación Zabbix para que se puedan enviar alertas y notificaciones vía SMS en segundos con LabsMobile.


Funcionalidades

  • Envío de alertas.

Requisitos

  • Aplicación Zabbix instalada y funcionando. Más información en zabbix.com
  • Una cuenta de usuario en LabsMobile. Sigue el siguiente enlace para crear una nueva cuenta: Regístrate.
  • Tener instalada la libreria cURL en PHP. Más información en curl.installation.php

Importante Para que este módulo funcione correctamente, es imprescindible que la Librería cURL esté instalada y habilitada en tu entorno PHP en Zabbix.


Autenticación

En la integración con Zabbix la autenticación se realiza con dos parámetros:

  • El nombre de usuario (username) de la cuenta que debe indicarse en el campo username.
  • El tokenapi que se debe asignar en el campo password. Este tokenapi se puede generar desde la sección Configuración API de tu cuenta.

Recomendación Se pueden generar tokens API desde la Configuración API de la cuenta. Recomendamos cambiar el token frecuentemente y utilizar diferentes tokens para cada uso, conexión o integración.


Instalación

  1. Descarga el módulo SMS LabsMobile para Zabbix en un archivo .zip o clona nuestro repositorio de GitHub.

Módulo LabsMobile

Ingresa al siguiente enlace y descarga el Módulo SMS LabsMobile.


  1. Copia todos los archivos en el directorio de scripts de alertas (AlertScripts) de tu instancia de Zabbix. La ruta del directorio es /usr/lib/zabbix/alertscripts.
  1. Configura los permisos y el propietario de los archivos y directorios.
Permisos
chown -R zabbix:zabbix /usr/lib/zabbix/alertscripts
chown -R zabbix:zabbix /var/log/zabbix-server/sms/
chmod 755 /usr/lib/zabbix/alertscripts/sms.php
  

  1. Indica las credenciales de LabsMobile username y tokenapi en el archivo config.php que se encuentra en la ruta /usr/lib/zabbix/alertscripts. También puedes indicar el remitente de tu preferencia.
Autenticación
<?php 
define('GATEWAY_TYPE', 'LabsMobile');
define('GATEWAY_PARAMS', [
    'username' => 'myUsername',
    'password' => 'myToken',
    'sender' => 'Zabbix',
]);
  
  1. En Zabbix, debes ir la opción Administration > Media Types o Alerts > Media Types, según la versión que estes usando.


  1. Crea un nuevo Media Type, indicando el nombre del script, el tipo como script y en Script name ingresa sms.php. Finalmente, agrega los siguientes parámetros: {ALERT.SENDTO}, {ALERT.SUBJECT},{ALERT.MESSAGE} y haz clic en Add.


  1. En Zabbix, ve a Administration > Users, edita un usuario que tenga un número móvil asociado y asigna el usuario al script creado, indicando el nombre del script y el número móvil.


  1. Realiza pruebas del script desde el dashboard de Zabbix en la opción Administration > Media Types o Alerts > Media Types. Debes buscar el nombre del script, hacer clic en la opción Test e indicar todos los parámetros del script.


  1. También puedes realizar pruebas desde la terminal.
Envío SMS
 
su -l zabbix -s /bin/bash
cd /usr/lib/zabbix/alertscripts
./sms.php 31123451234 "test" "this is a test"
  
  1. Puedes consultar los SMS enviados en el directorio /var/log/zabbix-server/sms/.