Azioni di una regola

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

    https://<SID>:<AUTH-TOKEN>@api.twilio.com/2010-04-01/Accounts/<SID>/Messages.json

    dove SID e AUTH-TOKEN sono forniti da Twilio Console
  • Impostare un header con:
    • chiave:Content-Type
    • valore:application/x-www-form-urlencoded
  • Il payload dovrà essere del tipo

    Body=<Testo SMS>&From=<FROM>&To=<TO>

    dove:
    • 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)
Altre domande? Invia una richiesta

0 Commenti

Accedi per aggiungere un commento.