---
title: "Integrazione Upptime - Avvisi di monitoraggio uptime"
sidebarTitle: Upptime
description: Integra Upptime con Echobell per ricevere notifiche push o chiamate nel momento esatto in cui il tuo sito va offline. Guida alla configurazione basata su GitHub Actions.
---

import { Step, Steps } from "fumadocs-ui/components/steps";

# Integrazione Upptime

Puoi inoltrare gli eventi di disservizio e di ripristino di Upptime direttamente a Echobell, così il tuo team riceve avvisi push urgenti o chiamate senza dover costruire una pipeline separata. Questa guida si concentra sulla parte Echobell della configurazione e usa le variabili di notifica native di Upptime. Per le opzioni specifiche di Upptime, consulta la [documentazione ufficiale sulle notifiche](https://upptime.js.org/docs/notifications).

## Perché usare Echobell per gli avvisi di Upptime

- Escalation con chiamata per i disservizi critici, mentre i controlli di routine restano notifiche push normali o urgenti
- Modelli e variabili per mostrare in ogni avviso il sito coinvolto, lo stato, il codice di risposta e il link alla issue su GitHub
- Nessuna infrastruttura aggiuntiva: basta un URL webhook sicuro per ogni canale Echobell

## Prerequisiti

- Un repository Upptime già esistente con GitHub Actions attivo
- I permessi per aggiungere secret al repository GitHub
- Un canale Echobell con un URL webhook (nell'app apri il canale → copia il suo URL webhook)

<Steps>
<Step>
### Prepara un canale Echobell

1. Crea o apri un canale in Echobell e scegli lo stile di notifica che preferisci (normale, urgente o chiamata).
2. Copia l'URL webhook del canale: ha questa forma `https://hook.echobell.one/t/<channel-token>`.
3. (Facoltativo) Imposta un modello che usi variabili come `{{site}}`, `{{status}}`, `{{code}}`, `{{url}}` e `{{issue}}`, così i tuoi avvisi restano strutturati.
</Step>
<Step>

### Aggiungi i secret di Upptime per Echobell

Nel tuo repository Upptime vai su **Settings → Secrets and variables → Actions** e aggiungi:

- `NOTIFICATION_CUSTOM_WEBHOOK=true`
- `NOTIFICATION_CUSTOM_WEBHOOK_URL=https://hook.echobell.one/t/<channel-token>?site=$SITE_NAME&status=$STATUS&url=$SITE_URL&issue=$ISSUE_URL&code=$RESPONSE_CODE&emoji=$EMOJI`
- (Facoltativo) `NOTIFICATIONS_DOWN_MESSAGE=$EMOJI $SITE_NAME is $STATUS ($RESPONSE_CODE) – $ISSUE_URL`
- (Facoltativo) `NOTIFICATIONS_UP_MESSAGE=$EMOJI $SITE_NAME is back up – $SITE_URL`

Note:

- I parametri di query portano i dati strutturati dentro Echobell. Upptime aggiunge le variabili ed Echobell le conserva come variabili del modello (`site`, `status`, `url`, `issue`, `code`, `emoji`).
- Mantieni l'URL codificato (se personalizzi i testi, sostituisci gli spazi con `%20`) per non rompere la richiesta.
- Gli altri provider di notifica e le altre strategie continui a gestirli in Upptime: qui aggiungi solo ciò che serve a Echobell e lascia il resto nell'interfaccia dei secret di GitHub.
</Step>
<Step>

### Mappa le variabili in Echobell

Usa un modello conciso per mantenere leggibili gli avvisi:

```
Title: {{emoji}} Upptime: {{site}} is {{status}}
Body: Response {{code}} · {{url}}
External link: {{issue}}
```

Per i siti ad alta priorità puoi impostare lo stile di notifica del canale su "Urgente" o "Chiamata", lasciando gli altri sulle push normali.

</Step>
<Step>
### Testa l'integrazione

- Fai puntare temporaneamente un URL monitorato a un endpoint inesistente oppure metti in pausa un servizio per provocare un errore.
- Verifica che l'avviso arrivi in Echobell con i campi del modello valorizzati.
- Ripristina il servizio e controlla il messaggio di ripristino.
</Step>
</Steps>

## Risoluzione dei problemi

- Assicurati che `NOTIFICATION_CUSTOM_WEBHOOK` e `NOTIFICATION_CUSTOM_WEBHOOK_URL` siano scritti esattamente come nell'elenco dei secret.
- Se cambi il token del canale Echobell, aggiorna il secret.
- Per errori lato Upptime o per aggiungere altri provider, consulta la [documentazione ufficiale](https://upptime.js.org/docs/notifications) e i log di GitHub Actions.