docs: precise SNEK callback config for JSON POST body

- Step-by-step field-by-field callback config table
- Common pitfall documented: don't paste JSON body in "Line pattern"
- Exact JSON body template format (spaces around colons required)
- Companion dashboard deployment steps

Backend also cleaned up: unified query-string / JSON body parsing
via a single _num() helper instead of nested try/except blocks.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

README.md

@@ -237,39 +237,65 @@ C'est là que ça devient puissant : à chaque message reçu, SNEK peut faire un
 
 ### Configuration
 
-Dans la UI SNEK → onglet **Callbacks** → **Add callback** :
-- **URL** : `http://mon-service.mon-ns.svc.cluster.local:3000/api/sigfox`
-- **Method** : POST
-- **Content-Type** : `application/json`
-- **Body** : template avec variables SNEK (voir doc SNEK)
+### Configurer un callback dans la UI SNEK
 
-### Exemple de body template
+Dans SNEK → onglet **Callbacks** → **New** (dans la section DATA callbacks) :
+
+| Champ | Valeur |
+|-------|--------|
+| **Type** | `UPLINK` |
+| **Channel** | `URL` |
+| **Send duplicate** | décoché |
+| **Url pattern** | ton endpoint (ex: `http://mon-service.mon-ns.svc.cluster.local/webhook`) |
+| **Line pattern** | *(vide)* |
+| **Content type** | `application/json` |
+| **Method** *(apparaît selon channel)* | `POST` |
+| **Body** *(apparaît une fois Method=POST + Content-Type=application/json)* | template JSON ci-dessous |
+
+Body template (format exact — respecter les espaces autour des `:`) :
 
 ```json
 {
-  "device": "{device}",
-  "time": "{time}",
-  "data": "{data}",
-  "rssi": {rssi},
-  "snr": {snr},
-  "seqNumber": {seqNumber}
+    "device" : "{device}",
+    "data" : "{data}",
+    "time" : {time},
+    "rssi" : {rssi},
+    "snr" : {snr},
+    "seqNumber" : {seqNumber}
 }
 ```
 
-Variables disponibles :
-- `{device}` : ID hex du device
-- `{time}` : timestamp Unix
-- `{data}` : payload en hex
-- `{rssi}` : force du signal reçu
-- `{snr}` : rapport signal/bruit
-- `{seqNumber}` : compteur de séquence
+⚠️ **Piège classique** : ne pas coller le JSON dans **Line pattern**. Ce champ fait une substitution char-par-char et refuse tout ce qui n'est pas un nom de variable connu (tu obtiens `Wrong values. Please fix: ...`). Le body JSON va dans le champ **Body** qui n'apparaît qu'après avoir choisi Method=POST et Content-Type=application/json.
+
+### Variables disponibles
+
+`{device}` `{time}` `{data}` `{rssi}` `{snr}` `{seqNumber}` `{duplicate}` `{station}` `{avgSnr}` `{LQI}`
 
 ### Cas d'usage
 
-- **Ingester dans une base** : POST vers une API Node/Go/Python qui insert dans Postgres/InfluxDB
-- **Alertes** : POST vers Telegram bot API pour notification instantanée
-- **Bus de messages** : POST vers Kafka REST proxy, RabbitMQ HTTP plugin, etc.
-- **Dashboard live** : POST vers un WebSocket relay (Socket.io, Server-Sent Events)
+- **Dashboard live** : dossier [`dashboard/`](./dashboard/) — Flask + SQLite + SSE + Chart.js prêt à l'emploi
+- Ingérer dans une base (Postgres, InfluxDB via une API custom)
+- Alertes Telegram / Slack / Discord
+- Bus de messages Kafka / RabbitMQ
+
+### Dashboard intégré (companion service)
+
+Un mini dashboard responsive est fourni dans [`dashboard/`](./dashboard/) — il reçoit les callbacks SNEK, décode les 6 modes Sens'it (Standby, Temperature, Light, Door, Vibration, Magnet), stocke en SQLite et affiche en temps réel via Server-Sent Events. Tailwind + Chart.js.
+
+Pour le déployer :
+
+```bash
+cd dashboard
+docker build --platform linux/amd64 -t 192.168.1.100:30500/snek-dashboard:latest .
+docker push 192.168.1.100:30500/snek-dashboard:latest
+kubectl apply -f ../deploy/dashboard.yaml
+```
+
+Puis configure le callback SNEK avec l'URL :
+```
+http://snek-dashboard.snek.svc.cluster.local/webhook
+```
+et le body JSON template ci-dessus. Ouvre `http://<lb-ip-dashboard>` dans un navigateur.
 
 ---