Ad ogni regola è possibile associare una o più azioni, ovvero le operazioni da eseguire al verificarsi della regola.
Sono disponibili i seguenti tipi di azioni:
- Azione Mail
- Azione HTTP
- Azione MQTT
- Azione Telegram
Azione SMS(è possibile inviare SMS utilizzando le azioni HTTP)
Per ogni azione è possibile specificare la condizione da notificare:
- Accensione, l'allarme si è attivato
- Spegnimento, l'allarme si è spento
- Entrambi, entrambi i cambi di stato dell'allarme
Segnaposto
A seconda delle variabili utilizzate nella regola è possibile utilizzare i seguenti segnaposti nel testo delle azioni:
- i valori delle variabili al momento dell'allarme, con la sintassi %%variabile%%
es. %%x0%% - i valori delle variabili precedenti al momento dell'allarme, con la sintassi %%variabile_1%%
es. %%x0_1%% - il valore della sostituzione valore, con la sintassi %%variabile_sub%%
es. %%x0_sub%% - il valore della note di sostituzione valore, con la sintassi %%variabile_sub_notes%%
es. %%x0_sub%% - la descrizione del segnale/dispositivo/widget/report associato alla variabile, con la sintassi %%variabile_desc%%
es. %%x0_desc%% - la descrizione del dispositivo del segnale/report associato alla variabile, con la sintassi %%variabile_device_desc%%
es. %%x0_device_desc%% - il token del segnale/dispositivo associato alla variabile, con la sintassi %%variabile_token%%
es. %%x0_token%% - il token del dispositivo associato alla variabile, con la sintassi %%variabile_device_token%%
es. %%x0_device_token%% - se la regola contiene un report, il link per il download del file pdf generato, con la sintassi %%variabileReport_pdf%%
es. %%x0_pdf%% - se la regola contiene un widget, il link per il download del file csv generato, con la sintassi %%variabileReport_csv%%
es. %%x0_csv%% - la data in cui si è verificata la formula, con la sintassi %%alarm_date%%. La data verrà inserita nel formato non modificabile 24/07/2018 08:04.
Azione Mail
L'azione Mail permette di specificare i campi:
- Destinatari
- CC e CCN, compilabili dopo aver aggiunto almeno un destinatario
- Oggetto
- Testo
Azione HTTP
L'azione HTTP permette di specificare i campi:
- Metodo, è possibile selezionare fra POST, GET, PUT, DELETE
- URL, l'indirizzo a cui inoltrare la richiesta, dev'essere specificato l'intero indirizzo, inclusi http o https
- Header, permette l'inserimento a piacere di header nella richiesta specificando per ognuno la chiave e il valore
- Payload:
- se il testo inserito nel payload è in formato JSON viene utilizzato il campo json della richiesta
- se il testo inserito non è convertibile in JSON:
- di default viene utilizzo il campo body
- se il testo inserito viene preceduto da text: viene utilizzato il campo text con quanto specificato dopo la parola chiave
Azione MQTT
L'azione MQTT permette di specificare i campi:
- URL, l'indirizzo del broker MQTT
- Client ID, l'id con cui identificare il client
- Username e Password, per autenticarsi
- Topic, il topic su cui pubblicare
- QOS payload
- Payload, il messaggio da pubblicare sul topic
Azione Telegram
Per la configurazione e l'invio di allarmi al bot Telegram è disponibile un articolo dedicato al link Allarmi sul bot.
Azione SMS (Twilio + Azione HTTP)
Per poter inviare SMS è necessario avere un proprio account Twilio.
E' possibile inviare SMS utilizzando le azioni HTTP in pochi step:
- Creare un'azione HTTP con metodo POST
- Impostare l'URL a
dove SID e AUTH-TOKEN sono forniti da Twilio Consolehttps://<SID>:<AUTH-TOKEN>@api.twilio.com/2010-04-01/Accounts/<SID>/Messages.json
- Impostare un header con:
- chiave:
Content-Type
- valore:
application/x-www-form-urlencoded
- chiave:
- Il payload dovrà essere del tipo
dove:Body=<Testo SMS>&From=<FROM>&To=<TO>
- Testo SMS è il messaggio che si vuole mandare
- FROM è il numero di telefono all’interno di Twilio
- TO è il numero di telefono destinatario (preceduto da prefisso)
0 Commenti