NotifyHub
Documentazione

Schnellstart

Inizia ad inviare notifiche multicanale in pochi minuti. Segui questi 6 passaggi per configurare il tuo workspace, collegare il primo canale e inviare il primo messaggio.

1

Registrati e crea il workspace

Crea il tuo account su notify.trovido.com. Dopo la registrazione verrai guidato nella creazione del tuo primo workspace. Ogni workspace ha le sue API key, i suoi canali e i suoi destinatari separati.

Suggerimento: Puoi creare workspace multipli per separare ambienti (produzione, staging) o progetti diversi.

2

Configura il primo canale

NotifyHub supporta 8 canali: WhatsApp, Telegram, Email, SMS, Push, Discord, Slack e Messenger. Ti consigliamo di iniziare con Email (basta un server SMTP) oppure WhatsApp per la massima efficacia.

Veloce Email (SMTP)

Configura host, porta, username e password SMTP. Pronto in 2 minuti.

Consigliato WhatsApp

Richiede account Meta Business e WABA. Tasso di apertura >95%.

Guida completa canali →

3

Aggiungi i destinatari

Aggiungi i contatti manualmente dalla dashboard oppure importa una lista da file CSV. Puoi anche usare l'API per creare destinatari programmaticamente.

Formato CSV
nome,cognome,email,telefono,canale
Mario,Rossi,[email protected],+393331234567,whatsapp
Laura,Bianchi,[email protected],,email

Tag: Organizza i destinatari con tag (es. "clienti-vip", "newsletter") per segmentare gli invii e creare automazioni mirate.

4

Crea il primo template

I template ti permettono di riutilizzare messaggi con variabili dinamiche. Usa la sintassi {{nome}} per personalizzare ogni messaggio.

Esempio template
Ciao {{nome}},

il tuo ordine #{{ordine_id}} e' stato confermato!
Riceverai aggiornamenti sulla spedizione su questo canale.

Grazie per aver scelto {{nome_azienda}}!

WhatsApp: I template WhatsApp devono essere approvati da Meta prima dell'uso. Invia il template per approvazione dalla sezione Templates del portale.

5

Invia il primo messaggio

Puoi inviare dalla dashboard (Broadcast), oppure via API REST con una semplice chiamata POST.

cURL - Invio via API
curl -X POST https://notify.trovido.com/api/notifyhub/v1/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "whatsapp",
    "to": "+393331234567",
    "template": "welcome_message",
    "variables": {
      "nome": "Mario",
      "nome_azienda": "La Mia Azienda"
    }
  }'
PHP - Con Guzzle
$response = Http::withToken('YOUR_API_KEY')
    ->post('https://notify.trovido.com/api/notifyhub/v1/send', [
        'channel'   => 'email',
        'to'        => '[email protected]',
        'subject'   => 'Benvenuto!',
        'body'      => 'Ciao Mario, benvenuto nella nostra piattaforma.',
    ]);

// Risposta: {"id": "msg_abc123", "status": "queued"}
Node.js - Con Fetch
const response = await fetch('https://notify.trovido.com/api/notifyhub/v1/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    channel: 'telegram',
    to: 'chat_id_123456',
    body: 'Ciao! Questo e\' un messaggio di test da NotifyHub.',
  }),
});

const data = await response.json();
// { id: "msg_abc123", status: "queued" }

Documentazione API completa →

6

Installa il widget sul tuo sito

Aggiungi il widget di chat al tuo sito web con un semplice snippet JavaScript. I visitatori potranno contattarti direttamente dal canale preferito.

Snippet da inserire prima di </body>
<script
  src="https://notify.trovido.com/widget/loader.js"
  data-workspace="YOUR_WORKSPACE_SLUG"
  data-position="bottom-right"
  data-brand-color="#FF8400"
  async
></script>

Personalizzazione: Puoi configurare colori, posizione, messaggio di benvenuto e canali disponibili dalla sezione Widget del portale.

Prossimi passi

STAG
https://notify.trovido.com