---
title: "Echobell Direct: avvisi webhook personali senza configurare un canale"
date: 2026-03-05
description: "Echobell Direct ti dà un URL webhook personale per ricevere notifiche istantanee da script, job CI e strumenti di automazione, senza dover configurare un canale."
author: Nooc
authorAvatarLink: /images/avatars/nooc.webp
authorLink: https://nooc.me
tags:
  - Echobell
  - Echobell Direct
  - avvisi istantanei
  - notifiche push
  - annuncio
---

[Echobell Direct](/it/docs/direct) è una modalità di avviso personale che salta del tutto la configurazione dei canali. Crei una chiave Direct, ottieni un URL webhook e invii in POST un `title` e un `body` per ricevere subito una notifica sul tuo dispositivo. Niente iscritti, niente modelli, nessuna configurazione di instradamento.

Questa guida spiega cos'è Direct, come configurarlo e quando conviene usarlo al posto dei canali.

## Cos'è Echobell Direct?

Ogni chiave Direct genera un URL webhook univoco (`/d/{token}`). Invia una richiesta a quell'URL e la notifica arriva immediatamente sul tuo dispositivo.

Usa Direct quando ti servono:

- Notifiche personali da script, cron job o pipeline CI
- Titolo e corpo personalizzati per ogni richiesta, invece di modelli fissi
- Una configurazione rapida, senza dover impostare un canale completo

Se ti servono notifiche condivise, modelli riutilizzabili o invii condizionali, usa invece i [canali tramite webhook](/it/docs/webhook).

## Configurazione in 3 passaggi

### Passaggio 1: crea una chiave Direct

Apri Echobell, tocca **Direct** nell'elenco dei canali e crea una chiave. Assegnale il nome del servizio a cui appartiene (ad esempio `CI Server`, `Cron`, `AI Tasks`).

### Passaggio 2: copia il tuo URL webhook

Ogni chiave ha un URL in questo formato:

```text
https://hook.echobell.one/d/YOUR_KEY_TOKEN
```

Tratta questo URL come un segreto: chiunque lo possieda può inviarti notifiche.

### Passaggio 3: invia la tua prima notifica

```bash
curl -X POST https://hook.echobell.one/d/YOUR_KEY_TOKEN \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Deploy failed",
    "body": "api-service failed health check",
    "notificationType": "time-sensitive",
    "externalLink": "https://dashboard.example.com/deploys/123"
  }'
```

Riferimento completo dei campi: [Direct API](/it/docs/direct)

## Livelli di urgenza

Direct supporta `notificationType`, così puoi adattare l'urgenza all'evento:

- `active` — aggiornamenti ordinari
- `time-sensitive` — avvisi importanti che superano la Full Immersion
- `calling` — incidenti critici (richiede un abbonamento Premium attivo, altrimenti passa a time-sensitive)

Per tutti i dettagli sul comportamento, vedi [Tipi di notifica](/it/docs/notification).

## Aggiungere contesto agli avvisi

Includi `externalLink` nel corpo della richiesta per allegare un URL alla notifica: comodo per arrivare direttamente al log di un deploy, a una dashboard o a una pull request.

Per gli agenti AI e le attività asincrone di lunga durata, Direct è un modo semplice per farsi avvisare quando il lavoro è finito, senza controllarne lo stato a mano. Vedi anche: [WebhookMCP + Echobell](/it/blog/get-notified-with-webhook-mcp).

## Direct e Canali a confronto

| | Direct | Canali |
|---|---|---|
| Destinatari | Solo personale | Condivisi con il team |
| Modelli | Contenuto per singola richiesta | Modelli fissi e riutilizzabili |
| Tempo di configurazione | Meno di un minuto | Richiede la configurazione del canale |
| Condizioni | Non supportate | Supportate |

Usa i canali quando gli avvisi devono raggiungere più persone o quando vuoi una formattazione coerente per un intero servizio. [Documentazione sui modelli](/it/docs/template) · [Cos'è Echobell](/it/docs/what-is-echobell)

## Buone pratiche di sicurezza

- Conserva i token Direct in variabili d'ambiente o in un gestore di segreti, mai nel codice
- Crea una chiave per ogni servizio, così puoi revocarle singolarmente
- Ruota subito i token se un URL potrebbe essere trapelato
- Riserva `calling` agli incidenti veri: abusarne porta all'assuefazione agli avvisi

## FAQ

**Direct è solo per sviluppatori?** No. Può usarlo chiunque abbia uno strumento in grado di inviare richieste HTTP.

**Direct supporta le richieste GET?** Sì, ma è consigliato il POST con JSON.

**Cosa succede se il mio abbonamento scade e uso `calling`?** La notifica passa automaticamente a `time-sensitive`.

---

Inizia dalla [guida a Direct](/it/docs/direct). Quando il tuo flusso di lavoro avrà bisogno di collaborazione o di modelli, i [canali](/it/docs/webhook) sono il passo successivo naturale.

## Articoli correlati

- [Documentazione dell'API Direct](/it/docs/direct) — riferimento completo dei campi ed esempi
- [WebhookMCP + Echobell](/it/blog/get-notified-with-webhook-mcp) — notifiche di completamento delle attività AI con Direct
- [Come aggirare la Full Immersion su iOS](/it/blog/how-to-bypass-ios-focus-mode-for-critical-alerts) — scegliere il livello di urgenza giusto
- [Notifiche webhook con Zapier](/it/blog/zapier-webhook-notifications-to-phone) — automazioni per chi non è sviluppatore
- [Tipi di notifica](/it/docs/notification) — comportamento delle notifiche Normale, Urgente e con chiamata