Echobell Direct: avvisi webhook personali senza configurare un canale

Indice

• Cos'è Echobell Direct?
• Configurazione in 3 passaggi
• Passaggio 1: crea una chiave Direct
• Passaggio 2: copia il tuo URL webhook
• Passaggio 3: invia la tua prima notifica
• Livelli di urgenza
• Aggiungere contesto agli avvisi
• Direct e Canali a confronto
• Buone pratiche di sicurezza
• FAQ
• Articoli correlati

Echobell 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.

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:

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

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

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.

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.

Direct e Canali a confronto

Usa i canali quando gli avvisi devono raggiungere più persone o quando vuoi una formattazione coerente per un intero servizio. Documentazione sui modelli · Cos'è 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. Quando il tuo flusso di lavoro avrà bisogno di collaborazione o di modelli, i canali sono il passo successivo naturale.

Articoli correlati

• Documentazione dell'API Direct — riferimento completo dei campi ed esempi
• WebhookMCP + Echobell — notifiche di completamento delle attività AI con Direct
• Come aggirare la Full Immersion su iOS — scegliere il livello di urgenza giusto
• Notifiche webhook con Zapier — automazioni per chi non è sviluppatore
• Tipi di notifica — comportamento delle notifiche Normale, Urgente e con chiamata