# Pushover

# Introducción

**Ver**. 31-10-2022

Con este plugin puedes interactuar con todas las opciones de la API de mensajería de pushover para mandar mensajes a dispositivos. Estas opciones son las siguientes : toker, user, message, attachment, device, html, priority, sound, timestamp, title, url y url\_title.

<div id="bkmrk-tipo%3A-plug-in-de-ser"><div>**Tipo**: Plug-in de servidor / también se puede configurar como plug-in de agente.</div></div>

# Matriz de compatibilidad

<table border="1" id="bkmrk-sistemas-donde-se-ha"><tbody><tr><td>**Sistemas donde se ha probado**</td><td>CentOS 7 / RHEL 8 / RockyLinux 8

</td></tr><tr><td>**Sistemas donde debería funcionar**</td><td>Cualquier sistema linux

</td></tr></tbody></table>

# Pre requisitos

- Tener el **Data Server** de Pandora FMS habilitado
- Tener el **Plugin Server** de Pandora FMS habilitado

# Configuración

**Crear alerta del plugin**

Para configurar una alerta del plugin se debe introducir el comando para ejecutar el plugin y sus parámetros, para ello se debe crear un comando de alerta.

En este menu se puede usar la macro \_field&lt;X&gt;\_ que contendrá el valor de los atributos.

[![image-1667567668009.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-11/scaled-1680-/image-1667567668009.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-11/image-1667567668009.png)

Los parámetros se pueden rellenar abajo, en los campos, cada uno hace referencia a las macros utilizadas, además se pueden ocultar ciertos valores, usando la opción HIde.

[![image-1667567677309.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-11/scaled-1680-/image-1667567677309.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-11/image-1667567677309.png)

Lo siguiente será crear una acción de alerta que llamará al comando creado previamente.

[![image-1667567702762.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-11/scaled-1680-/image-1667567702762.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-11/image-1667567702762.png)

[![image-1667567714796.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-11/scaled-1680-/image-1667567714796.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-11/image-1667567714796.png)

**Ejemplo de mensaje creado por la alerta en la vista de la aplicación**

[![image-1667568014294.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-11/scaled-1680-/image-1667568014294.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-11/image-1667568014294.png)

[![image-1667568045159.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-11/scaled-1680-/image-1667568045159.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-11/image-1667568045159.png)

# Parámetros

<table border="1" id="bkmrk-par%C3%A1metro-descripci%C3%B3" style="border-collapse: collapse; width: 100%; height: 377px;"><tbody><tr style="height: 29px;"><td style="width: 50%; height: 29px;">Parámetro</td><td style="width: 50%; height: 29px;">Descripción</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;"><div><div>--token</div></div></td><td style="width: 50%; height: 29px;">el token de la API de tu aplicación (obligatorio)</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">--user</td><td style="width: 50%; height: 29px;">tu clave de usuario/grupo (o la de tu usuario objetivo), visible al iniciar sesión en nuestro panel de control; a menudo denominada USER\_KEY en nuestra documentación y ejemplos de código (obligatorio)</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">--message</td><td style="width: 50%; height: 29px;">su mensaje (requerido)</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">--html</td><td style="width: 50%; height: 29px;">pon 1 para activar el análisis HTML</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">--priority</td><td style="width: 50%; height: 29px;">un valor de -2, -1, 0 (por defecto), 1, o 2</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">--timestamp</td><td style="width: 50%; height: 29px;">una marca de tiempo Unix de una hora para mostrar en lugar de cuando nuestra API lo recibió</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">--title</td><td style="width: 50%; height: 29px;">el título de tu mensaje, de lo contrario se utiliza el nombre de tu aplicación</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">--url</td><td style="width: 50%; height: 29px;">una URL suplementaria para mostrar con tu mensaje</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">--url\_title</td><td style="width: 50%; height: 29px;">un título para la URL especificada como parámetro url, de lo contrario sólo se muestra la URL</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">--device</td><td style="width: 50%; height: 29px;">el nombre de uno de tus dispositivos para enviar sólo a ese dispositivo en lugar de a todos los dispositivos</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">--attachment</td><td style="width: 50%; height: 29px;">una imagen adjunta para enviar con el mensaje. Debes poner la ruta de la imagen, seguida del nombre de la imagen y el formato de la misma, separados por '|' , por ejemplo : '/home/alejandro/Documentos/pushover/icono.jpg|icono.jpg|jpeg'.</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">--sound</td><td style="width: 50%; height: 29px;">el nombre de un sonido soportado para anular su elección de sonido por defecto</td></tr></tbody></table>

# Ejecución manual

```
./pandora_pushover --token <token> --user <user key> --message <message> [ --html < 1 for activate> ] [ --priority <number priority> ] [ --timestamp <timestamp> ] [ --title <title> ] [ --url <url> ] [ --url_title <url title> ] [ --device <device > ] [ --attachment <image> ] [ --sound <sound name> ]
```

[![image-1667224475469.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-10/scaled-1680-/image-1667224475469.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-10/image-1667224475469.png)

Vista de los mensajes en la app.

[![image-1667224500988.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-10/scaled-1680-/image-1667224500988.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-10/image-1667224500988.png)