Webhooks
La piattaforma Iottly può inviare una notifica a un servizio esterno ogni volta che un device connesso genera un messaggio. Questo permette al tuo backend di reagire in tempo reale — senza necessità di polling.
Gestire i webhooks
Dalla dashboard del tuo progetto, clicca il pulsante OPEN in alto a destra per aprire il pannello delle impostazioni, poi naviga su Configure webhooks.
In questo pannello puoi:
- visualizzare i webhook attivi del progetto
- configurare un nuovo webhook
- eliminare i webhook non più necessari
Nota: Puoi configurare fino a 5 webhook per progetto.
Configurare un webhook
Clicca Add webhook per aprire il modulo di creazione.
Compila i seguenti campi:
| Campo | Descrizione |
|---|---|
| Description | Nome leggibile per questo webhook |
| URL | L’endpoint HTTPS del tuo servizio che riceverà le notifiche |
| Type | iottly per messaggi dall’agent Iottly, user per messaggi dagli script utente |
| Channel | Stringa opzionale per filtrare i messaggi in base al campo channel |
| Payload only | Se attivo, consegna solo il payload del messaggio invece dell’intero envelope |
| HTTP headers | Fino a 5 header personalizzati inviati con ogni richiesta (es. per autenticazione) |
Clicca Create webhook al termine.
Come funzionano i webhooks
Quando un device del tuo progetto invia un messaggio, Iottly consegna immediatamente una richiesta HTTP POST al tuo URL webhook:
- Headers: gli header personalizzati che hai configurato
- Body (JSON):
{
"msg": {
// il messaggio ricevuto dal device
}
}
Applicazione di esempio
Per un’implementazione di riferimento funzionante in Python, consulta il repository ufficiale:
tomorrowdata/iottly-webhook-example ↗
Relazione con la Command API
I webhook sono monodirezionali — device → tuo backend. Per inviare comandi nella direzione opposta (tuo backend → device) usa la Command API.