---
title: Guida introduttiva a Echobell - configurazione completa
sidebarTitle: Guida introduttiva
description: "Configura Echobell in pochi minuti: crea canali di notifica, collega trigger webhook o via email e ricevi sul telefono avvisi push istantanei o chiamate."
---

# Guida introduttiva a Echobell

Benvenuto in Echobell, l'app di avvisi istantanei che ti aiuta a tenere sotto controllo le notifiche importanti. Che tu sia uno sviluppatore a cui servono avvisi webhook per la pipeline CI/CD, un amministratore di sistema che tiene d'occhio i server o un team che gestisce notifiche critiche, questa guida completa ti accompagna nella configurazione e nell'uso efficace di Echobell.

Alla fine di questa guida saprai come creare canali di notifica, configurare trigger webhook e via email, personalizzare i modelli delle notifiche e integrare Echobell con gli strumenti e i flussi di lavoro che già usi.

## Cos'è Echobell?

Echobell è un potente strumento di gestione delle notifiche pensato per sviluppatori, team DevOps e per chiunque abbia bisogno di avvisi istantanei affidabili. Fa da ponte tra i tuoi sistemi e il tuo dispositivo mobile, così le informazioni critiche ti raggiungono subito.

**Funzionalità principali:**

- **Integrazione webhook**: collega qualsiasi sistema in grado di inviare richieste HTTP: strumenti di monitoraggio, pipeline CI/CD, dispositivi IoT e molto altro
- **Trigger via email**: trasforma qualsiasi email in una notifica istantanea inoltrandola all'indirizzo email dedicato del tuo canale
- **Modelli personalizzati**: usa variabili dinamiche per creare notifiche informative e ricche di contesto
- **Tipi di notifica flessibili**: scegli tra notifiche normali, avvisi urgenti o notifiche in stile chiamata per i problemi critici
- **Privacy al primo posto**: la cronologia delle notifiche resta sul tuo dispositivo, non sui nostri server
- **Collaborazione in team**: condividi i canali con i colleghi e gestisci l'accesso degli iscritti

Scopri di più su [cosa rende unico Echobell](/it/docs/what-is-echobell) e dai un'occhiata alla [panoramica completa delle funzionalità](/it/docs/features).

![Panoramica di Echobell](/images/docs/screenshot-overview.en.webp)

## Concetti fondamentali

Prima di iniziare, chiariamo alcuni concetti chiave:

### Canali

Un **canale** è l'unità fondamentale con cui Echobell organizza e distribuisce le notifiche:

- Ogni canale ha un **nome** e un **colore** univoci, per riconoscere a colpo d'occhio le diverse fonti di avviso
- I canali contengono **[modelli di notifica](/it/docs/template)** che stabiliscono quali informazioni vengono inviate agli iscritti
- I canali si attivano tramite **[webhook](/it/docs/webhook)** o **[email](/it/docs/email-trigger)**
- Puoi creare canali tuoi oppure iscriverti a quelli condivisi da altri
- Ogni canale supporta le **[condizioni](/it/docs/conditions)**, per filtrare quali attivazioni inviano davvero una notifica
- I canali si possono condividere con i colleghi o con il pubblico tramite link di iscrizione sicuri

Pensa a un canale come a una pipeline di notifiche: i dati entrano dai trigger, vengono formattati dai modelli, filtrati dalle condizioni e recapitati come notifiche a tutti gli iscritti.

### Trigger

Un **trigger** è ciò che attiva un canale e gli fa inviare le notifiche. Echobell supporta due metodi di attivazione:

- **[Webhook](/it/docs/webhook)**: un endpoint URL che attiva il canale quando viene chiamato via HTTP GET o POST. Perfetto per l'integrazione con sistemi di monitoraggio, pipeline CI/CD, funzioni serverless e qualsiasi strumento in grado di inviare richieste HTTP.
  
- **[Trigger via email](/it/docs/email-trigger)**: un indirizzo email univoco collegato al canale. Quando arriva un'email a questo indirizzo, il canale si attiva. Ideale per gli avvisi via email, per inoltrare messaggi importanti o per i sistemi che supportano solo le notifiche via email.

Puoi usare entrambi i tipi di trigger contemporaneamente sullo stesso canale, con la massima flessibilità nel modo in cui invii gli avvisi. Scopri di più sull'[integrazione webhook](/it/docs/webhook) e sui [trigger via email](/it/docs/email-trigger).

### Tipi di notifica

Quando ti iscrivi a un canale puoi scegliere tra diversi [stili di notifica](/it/docs/notification), che determinano come compaiono gli avvisi sul tuo dispositivo:

- **Normale (attiva)**: notifica standard dell'app, che compare nel centro notifiche. Ideale per aggiornamenti non urgenti e avvisi informativi.

- **Urgente**: notifica ad alta priorità, capace di superare le modalità Full Immersion e le impostazioni Non disturbare. Consigliata per gli avvisi importanti che richiedono attenzione immediata ma non sono emergenze critiche.

- **Chiamata**: avviso in stile chiamata con suoneria e interfaccia a schermo intero, come quando ricevi una telefonata. Indispensabile per gli incidenti critici che richiedono una risposta immediata, come i disservizi in produzione o gli avvisi di sicurezza.

Il tipo di notifica da scegliere dipende dall'urgenza dei contenuti del canale. Se ti serve, puoi iscriverti più volte allo stesso canale con tipi di notifica diversi. Leggi la nostra [guida dettagliata alle notifiche](/it/docs/notification) per capire quando usare ciascun tipo.

## Primi passi

### 1. Configurare l'account

1. Scarica Echobell dall'[App Store](https://apps.apple.com/app/apple-store/id6743597198?pt=128151925&ct=docs-index-it&mt=8) / [Google Play](https://play.google.com/store/apps/details?id=one.echobell.echobellandroid)
2. Apri l'app e accedi con la tua email oppure con Apple

![Configurazione dell'account](/images/docs/screenshot-sign-in.en.webp)

### 2. Creare il primo canale

1. Dalla schermata principale, tocca il pulsante in basso a destra per aprire la vista **Canali**
2. Tocca il pulsante **+** per creare un nuovo canale
3. Inserisci un nome per il canale (ad esempio "Avvisi server")
4. Scegli un colore per identificare il canale
5. Configura i modelli di notifica:
   - **Modello del titolo**: quello che compare come intestazione della notifica
   - **Modello del corpo**: il contenuto dettagliato della notifica
6. Se vuoi, attiva l'iscrizione al canale per te stesso
7. Scegli un **tipo di notifica** per il canale (Normale, Urgente o Chiamata)
8. Salva il nuovo canale

![Creazione di un canale](/images/docs/screenshot-create-channel.en.webp)

### 3. Configurare un trigger

Una volta creato il canale, hai due modi per attivare le notifiche: tramite webhook o via email. Tocca il canale che hai appena creato per aprirne le impostazioni. Nelle impostazioni del canale trovi la sezione **Trigger**.

![Impostazioni del canale](/images/docs/screenshot-channel-settings.en.webp)

#### Trigger webhook

1. Tocca il pulsante **webhook** per copiare l'URL webhook generato
2. Integra questo URL nei tuoi sistemi (ad esempio monitoraggio dei server, pipeline CI/CD)
3. Quando l'URL viene chiamato, il canale si attiva

Puoi passare le variabili ai modelli delle notifiche in due modi:

```bash
# Example webhook call with query parameters
curl -X GET "https://hook.echobell.one/t/<channel-token>?server=production&status=critical&message=CPU%20usage%20at%2095%25"

# OR with JSON body
curl -X POST https://hook.echobell.one/t/<channel-token> \
  -H "Content-Type: application/json" \
  -d '{"server": "production", "status": "critical", "message": "CPU usage at 95%"}'
```

Queste variabili servono a riempire i modelli delle notifiche. Ad esempio, se il modello del titolo è `{{server}} - {{status}}`, il risultato sarà "production - critical".

**Variabili speciali:**

- `externalLink`: se includi questa variabile, viene mostrata come link cliccabile nei record delle notifiche

#### Trigger via email

1. Tocca il pulsante **email** per copiare l'indirizzo email generato per il canale
2. Quando arriva un'email a questo indirizzo, il canale si attiva

Con i trigger via email, Echobell estrae automaticamente queste variabili dall'email:

- `from`: l'indirizzo email del mittente
- `to`: l'indirizzo email del destinatario (l'indirizzo email del tuo canale)
- `subject`: l'oggetto dell'email
- `text`: il contenuto dell'email in testo semplice
- `html`: il contenuto HTML dell'email

Puoi usare queste variabili nei tuoi modelli, ad esempio `{{subject}}` o `{{text}}`.

### 4. Personalizzare i modelli di notifica

I modelli usano variabili che vengono riempite con i dati del trigger:

1. Nelle impostazioni del canale, apri **Modelli di notifica**
2. Per il modello del titolo puoi usare: `{{server}} - {{status}}`
3. Per il modello del corpo puoi usare: `{{message}} Detected at {{timestamp}}`
4. Le variabili si racchiudono tra doppie parentesi graffe: `{{variable_name}}`
5. Prova il modello con dati di esempio

### 5. Iscriversi ai canali

1. Puoi condividere con altri il link di iscrizione dei tuoi canali
2. Oppure puoi usare i link di iscrizione condivisi da altri per iscriverti ai loro canali
3. Tocca **Iscriviti** nella vista dei canali
4. Inserisci il link di iscrizione
5. Scegli il **tipo di notifica** che preferisci:
   - Normale per gli avvisi standard
   - Urgente per gli avvisi importanti
   - Chiamata per le situazioni critiche
6. Conferma l'iscrizione

## Impostazioni dell'app

Con queste impostazioni puoi personalizzare il modo in cui Echobell gestisce le notifiche:

- **Ripeti il contenuto vocale**: nelle notifiche con chiamata, questa impostazione fa ripetere il contenuto della notifica
- **Riprova le chiamate non riuscite**: riprova automaticamente le notifiche con chiamata fallite a causa della modalità Full Immersion o per altri motivi

## Privacy e archiviazione dei dati

Echobell mette la tua privacy al primo posto:

- Sui nostri server vengono conservati solo gli account utente, i canali e i dati delle iscrizioni
- Il contenuto e la cronologia delle notifiche restano in locale sul tuo dispositivo
- I dati dei tuoi avvisi non escono mai dal tuo controllo

## Prossimi passi

Ora che hai configurato il primo canale, dai un'occhiata a queste risorse per sfruttare al meglio Echobell:

### Guide essenziali

- **[Cos'è Echobell?](/it/docs/what-is-echobell)** - Scopri i concetti fondamentali e la filosofia dietro Echobell
- **[Panoramica delle funzionalità](/it/docs/features)** - Esplora tutte le funzionalità e le possibilità disponibili
- **[Guida ai modelli](/it/docs/template)** - Impara la sintassi dei modelli e crea notifiche dinamiche
- **[Condizioni](/it/docs/conditions)** - Impara a filtrare le notifiche in base ai dati del trigger
- **[Integrazione webhook](/it/docs/webhook)** - Approfondisci la configurazione dei webhook e le best practice
- **[Trigger via email](/it/docs/email-trigger)** - Configura l'attivazione delle notifiche via email

### Guide alle integrazioni

Collega Echobell agli strumenti e alle piattaforme più diffusi:

- **[Integrazione con Grafana](/it/docs/developer/grafana)** - Tieni d'occhio la tua infrastruttura con avvisi istantanei
- **[GitHub Actions](/it/docs/developer/github)** - Ricevi notifiche sugli eventi della pipeline CI/CD
- **[Prometheus](/it/docs/developer/prometheus)** - Configura gli avvisi per le metriche di Prometheus
- **[Home Assistant](/it/docs/developer/home-assistant)** - Notifiche dall'automazione della casa intelligente
- **[Monitoraggio uptime](/it/docs/developer/uptime-kuma)** - Avvisi sulla disponibilità di siti e servizi
- **[TradingView](/it/docs/trader/tradingview)** - Avvisi di trading e notifiche di mercato

### Best practice

- **Parti dalle basi**: crea prima canali semplici con modelli essenziali, poi aggiungi complessità un po' alla volta
- **Prova i modelli**: usa chiamate webhook di test per verificare che i modelli vengano resi correttamente prima di metterli in produzione
- **Usa le condizioni con criterio**: taglia il rumore impostando condizioni sui canali, così ricevi avvisi solo per gli eventi importanti
- **Scegli il tipo di notifica adatto**: riserva le notifiche "Chiamata" agli avvisi davvero critici, per evitare l'assuefazione agli allarmi
- **Organizza con i colori**: usa i colori dei canali in modo strategico, per riconoscere a colpo d'occhio la fonte di ogni avviso
- **Documenta i canali**: usa le note dei canali per annotare che cosa li attiva e come intervenire

### Casi d'uso comuni

Scopri come usano Echobell gli altri:

- **Monitoraggio dei server**: avvisi istantanei quando l'uso di CPU, memoria o disco supera le soglie
- **Notifiche CI/CD**: sai subito quando una build fallisce o un deploy va a buon fine
- **Avvisi e-commerce**: ricevi notifiche per nuovi ordini, problemi di pagamento o scorte in esaurimento
- **Monitoraggio della sicurezza**: avvisi critici per errori di autenticazione, attività sospette o eventi di sicurezza
- **IoT e casa intelligente**: notifiche da sensori, telecamere e sistemi di domotica
- **Coordinamento del team**: condividi i canali con i colleghi per gestire insieme gli incidenti

### Come ottenere aiuto

Ti serve assistenza o hai qualche domanda?

- **[Centro assistenza](/it/docs/support)** - Consulta le domande frequenti e le guide alla risoluzione dei problemi
- **Supporto via email**: scrivici a echobell@weelone.com
- **Community**: partecipa alle discussioni e condividi i tuoi casi d'uso con altri utenti di Echobell

Vuoi integrare Echobell nei tuoi sistemi? Dai un'occhiata alla nostra [guida all'integrazione webhook](/it/docs/webhook) oppure esplora le [integrazioni per sviluppatori](/it/docs/developer/github) per iniziare!