Configuración de canales

Prerequisiti

• Account Meta Business verificato
• WhatsApp Business Account (WABA) creato in Meta Business Suite
• Numero di telefono dedicato (non associato a WhatsApp personale)

Configurazione

1. Vai su Meta Business Suite → Account WhatsApp Business e crea un WABA
2. Aggiungi un numero di telefono e verificalo tramite SMS o chiamata
3. Crea un System User con permessi whatsapp_business_messaging
4. Genera un Permanent Access Token per il System User
5. In NotifyHub, vai su Impostazioni → Canali → WhatsApp e inserisci: Phone Number ID, WABA ID e Access Token
6. Configura il Webhook URL fornito da NotifyHub nella configurazione del WABA su Meta
7. Sottoscrivi il campo messages nel webhook

Template WhatsApp

Per inviare messaggi proattivi (non in risposta a un messaggio dell'utente), devi usare template pre-approvati da Meta. Puoi crearli e inviarli per approvazione direttamente dal portale NotifyHub.

Configurazione

1. Apri Telegram e cerca @BotFather
2. Invia /newbot e segui le istruzioni per creare il bot
3. Copia il Bot Token fornito da BotFather
4. In NotifyHub, vai su Impostazioni → Canali → Telegram e inserisci il token
5. NotifyHub configurera' automaticamente il webhook del bot

Onboarding utenti

I tuoi utenti possono iscriversi inviando /start tuo-slug al bot. Verranno automaticamente aggiunti come destinatari nel tuo workspace.

https://t.me/YOUR_BOT_USERNAME?start=YOUR_WORKSPACE_SLUG

Configurazione SMTP

1. Vai su Impostazioni → Canali → Email
2. Inserisci i dati del tuo server SMTP: host, porta (587 per TLS), username e password
3. Configura il mittente (From Name e From Email)
4. Invia un'email di test per verificare la configurazione

Verifica dominio (consigliata)

Per migliorare la deliverability, configura i record DNS del tuo dominio:

SPF:   v=spf1 include:tuoserver.com ~all
DKIM:  selector._domainkey.tuodominio.com → CNAME
DMARC: _dmarc.tuodominio.com → "v=DMARC1; p=quarantine"

Configurazione

1. Crea un account su Twilio o Vonage (Nexmo)
2. Ottieni le API Key: Account SID e Auth Token (Twilio) oppure API Key e API Secret (Vonage)
3. Acquista un numero di telefono abilitato SMS dal provider
4. In NotifyHub, vai su Impostazioni → Canali → SMS e seleziona il provider
5. Inserisci le credenziali API e il numero mittente

Configurazione

1. In NotifyHub, vai su Impostazioni → Canali → Push
2. Genera le chiavi VAPID (pubbliche e private) oppure inserisci le tue
3. Aggiungi il service worker al tuo sito web
4. Implementa la richiesta di permesso notifiche nel frontend

self.addEventListener('push', function(event) {
  const data = event.data.json();
  event.waitUntil(
    self.registration.showNotification(data.title, {
      body: data.body,
      icon: data.icon || '/icon-192.png',
      data: { url: data.url }
    })
  );
});

self.addEventListener('notificationclick', function(event) {
  event.notification.close();
  if (event.notification.data.url) {
    event.waitUntil(clients.openWindow(event.notification.data.url));
  }
});

async function subscribePush() {
  const registration = await navigator.serviceWorker.register('/sw.js');
  const subscription = await registration.pushManager.subscribe({
    userVisibleOnly: true,
    applicationServerKey: 'YOUR_VAPID_PUBLIC_KEY'
  });

  // Invia subscription a NotifyHub via API
  await fetch('https://notify.trovido.com/api/notifyhub/v1/push/subscribe', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ subscription })
  });
}

Configurazione

1. Vai su Discord Developer Portal e crea una nuova Application
2. Nella sezione Bot, crea il bot e copia il token
3. Abilita i Message Content Intent nelle impostazioni del bot
4. Invita il bot nel tuo server con il link OAuth2 (scope: bot, permissions: send messages)
5. In NotifyHub, vai su Impostazioni → Canali → Discord e inserisci il Bot Token
6. Seleziona il server e il canale predefinito per le notifiche

Configurazione con Incoming Webhook

1. Vai su api.slack.com/apps e crea una nuova App
2. Abilita Incoming Webhooks nella configurazione dell'app
3. Clicca "Add New Webhook to Workspace" e seleziona il canale di destinazione
4. Copia il Webhook URL generato
5. In NotifyHub, vai su Impostazioni → Canali → Slack e inserisci il Webhook URL

https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

Configurazione

1. Devi avere una Pagina Facebook associata al tuo business
2. Nella Meta Developer Console, crea un'App e aggiungi il prodotto Messenger
3. Genera un Page Access Token con permessi pages_messaging
4. Configura il webhook con l'URL fornito da NotifyHub e sottoscrivi l'evento messages
5. In NotifyHub, inserisci il Page Access Token e il Page ID