Ordine
...
Logo Aaia
Notifiche Discord

🔔 Notifiche Discord

Configura le notifiche webhook Discord per ricevere avvisi istantanei quando gli utenti interagiscono con il tuo chatbot AAIA. Questa potente integrazione assicura che il tuo team non perda mai richieste importanti dei clienti inviando notifiche in tempo reale direttamente al tuo server Discord.

📋 Panoramica

Le notifiche Discord funzionano attraverso webhook, permettendo al tuo chatbot AAIA di inviare messaggi automatici a canali Discord specifici quando gli utenti:

  • Richiedono supporto umano attraverso il chatbot
  • Chiedono di essere contattati dal tuo team
  • Attivano lo strumento send_discord_notification
  • Hanno bisogno di escalation oltre le capacità del chatbot

🚀 Configurazione Webhook Discord

Passo 1: Creare un Webhook Discord

Per ricevere notifiche, devi prima creare un webhook nel tuo server Discord:

  1. Apri Discord e naviga al tuo server
  2. Fai click destro sul canale dove vuoi ricevere notifiche
  3. Seleziona “Modifica Canale” dal menu contestuale
  4. Clicca sulla tab “Integrazioni”
  5. Clicca “Crea Webhook” o “Nuovo Webhook”
  6. Personalizza il tuo webhook:
    • Dagli un nome come “AAIA Support Bot”
    • Scegli un avatar (opzionale)
    • Seleziona il canale target
  7. Copia l’URL del Webhook - ti servirà per la configurazione AAIA

Passo 2: Configurare AAIA-WP

Una volta ottenuto l’URL del webhook, configuralo nel tuo admin WordPress:

  1. Naviga alle Impostazioni

    • Vai a Impostazioni → Aaia XP nel tuo admin WordPress
    • Clicca sulla tab “Assistente”

  2. Abilita Strumenti

    • Trova la sezione “Strumenti e Funzionalità”
    • Attiva “Abilita Strumenti”
    • Questo attiva sia la funzionalità email che Discord

  3. Inserisci URL Webhook

    • Nella sezione “Configurazione Strumenti”
    • Incolla l’URL del tuo webhook Discord in “URL Webhook Discord”
    • Clicca “Testa Webhook” per verificare la connessione

Passo 3: Testa la Configurazione

Dopo la configurazione, testa l’integrazione:

  1. Clicca il pulsante “Testa Webhook” nel tuo pannello admin
  2. Controlla il tuo canale Discord per un messaggio di test
  3. Se ha successo, sei pronto a ricevere notifiche live

🔧 Formato URL Webhook

Il tuo URL webhook Discord dovrebbe apparire così:

https://discord.com/api/webhooks/[WEBHOOK_ID]/[WEBHOOK_TOKEN]

Esempio:

https://discord.com/api/webhooks/1234567890123456789/AbCdEfGhIjKlMnOpQrStUvWxYz1234567890AbCdEfGhIjKlMnOpQr

Mantieni questo URL sicuro poiché chiunque vi abbia accesso può inviare messaggi al tuo canale Discord.

📱 Tipi di Notifiche

Notifiche Richieste Supporto

Quando gli utenti attivano notifiche Discord, il tuo team riceve:

Formato Messaggio:

🚨 **Richiesta Supporto dal Sito Web**

**Messaggio Utente:** [Domanda originale utente]
**Pagina:** [URL dove è avvenuta la chat]
**Ora:** [Timestamp]
**IP Utente:** [Se disponibile]

Conversazione completa disponibile nell'admin WordPress.

Avvisi Escalation

Per problemi complessi che richiedono attenzione immediata:

⚠️ **Urgente: Escalation Utente**

**Problema:** [Breve descrizione]
**Preoccupazione Utente:** [Problema specifico]
**Azione Suggerita:** [Prossimi passi raccomandati]

🤖 Configurazione Chatbot

Istruzioni di Sistema

Aggiungi queste istruzioni al prompt di sistema del tuo chatbot per assicurare notifiche Discord appropriate:

Quando gli utenti chiedono aiuto umano, hanno bisogno di parlare con qualcuno,
o hanno problemi che non puoi risolvere, usa lo strumento send_discord_notification
per avvisare il team di supporto su Discord. Includi contesto rilevante
e suggerisci azioni di follow-up appropriate.

Condizioni di Attivazione

Il chatbot invia automaticamente notifiche Discord quando gli utenti:

  • Dicono frasi come “Ho bisogno di aiuto da un umano”
  • Esprimono frustrazione o confusione
  • Fanno domande tecniche complesse oltre l’ambito del bot
  • Richiedono di parlare con team vendite o supporto
  • Incontrano problemi che il chatbot non può risolvere

🎛️ Configurazione Avanzata

Webhook Multipli

Per organizzazioni più grandi, considera di configurare webhook diversi per:

  • Supporto Generale: #richieste-supporto
  • Problemi Tecnici: #supporto-tecnico
  • Richieste Vendite: #avvisi-vendite
  • Escalation Urgenti: #supporto-prioritario

Integrazione Bot Discord

Per funzionalità avanzate, crea un bot Discord dedicato che può:

  • Creare ticket di supporto automaticamente
  • Assegnare membri del team alle richieste
  • Tracciare tempi di risposta e risoluzione
  • Fornire riassunti delle conversazioni

Organizzazione Canali

Struttura il tuo server Discord efficacemente:

📢 CANALI SUPPORTO
├── 🔔 #notifiche-aaia
├── 💬 #discussione-supporto
├── ✅ #ticket-risolti
└── 📊 #metriche-supporto

📊 Monitoraggio e Analisi

Tracciamento Notifiche

Monitora le prestazioni della tua integrazione Discord:

  • Volume notifiche giornaliere
  • Tempo di risposta agli avvisi Discord
  • Tassi di risoluzione da supporto attivato Discord
  • Coinvolgimento membri team con notifiche

Strategie di Ottimizzazione

Migliora il tuo sistema di notifiche Discord:

  1. Riduci Rumore: Allena il chatbot a gestire più query indipendentemente
  2. Prioritizza Avvisi: Usa canali diversi per notifiche urgenti vs. routine
  3. Template Risposta: Crea risposte Discord rapide per problemi comuni
  4. Formazione Team: Assicura che tutti i membri del team sappiano gestire avvisi Discord

🔒 Best Practice Sicurezza

Sicurezza Webhook

Proteggi i tuoi webhook Discord:

  • Mantieni URL Privati: Non condividere mai URL webhook pubblicamente
  • Rigenera Regolarmente: Crea nuovi webhook periodicamente
  • Limita Accesso: Condividi solo con membri del team autorizzati
  • Monitora Uso: Osserva pattern di notifica inaspettati

Privacy Dati

Assicura conformità con regolamenti privacy:

  • Consenso Utente: Informa gli utenti che i loro messaggi potrebbero essere condivisi con il team
  • Minimizzazione Dati: Includi solo informazioni necessarie nelle notifiche
  • Politiche Ritenzione: Stabilisci linee guida chiare per ritenzione messaggi Discord

🛠️ Risoluzione Problemi

Problemi Comuni

Notifiche Non Appaiono:

  • Verifica che l’URL webhook sia corretto e completo
  • Controlla permessi canale Discord
  • Assicura che “Abilita Strumenti” sia attivato nelle impostazioni AAIA
  • Testa connessione webhook usando il pulsante test

Troppe Notifiche:

  • Rivedi istruzioni di sistema chatbot
  • Aggiusta sensibilità trigger
  • Implementa filtri notifiche
  • Considera l’uso di canali separati per tipi diversi

Contesto Mancante nei Messaggi:

  • Controlla impostazioni cronologia conversazione
  • Verifica che cattura contesto pagina sia abilitata
  • Rivedi istruzioni prompt chatbot
  • Assicura configurazione strumenti appropriata

Test e Debug

Test Manuale:

  1. Usa il pulsante “Testa Webhook” nell’admin
  2. Fai attivare una richiesta supporto a un collega
  3. Monitora Discord per messaggi in arrivo
  4. Verifica formattazione e contenuto messaggi

Modalità Debug:

  • Abilita logging debug WordPress
  • Controlla log errori per fallimenti webhook
  • Monitora richieste di rete all’API Discord
  • Verifica validità certificato SSL

📱 Mobile e Gestione Team

App Mobile Discord

Assicura che il tuo team possa rispondere rapidamente:

  • Notifiche Push: Abilita notifiche mobile Discord
  • Avvisi Canale: Configura suoni notifica specifici per canali supporto
  • Risposte Rapide: Usa l’app mobile Discord per conferme veloci

Coordinazione Team

Organizza il tuo team di supporto efficacemente:

  1. Proprietà Risposta: Usa reazioni Discord per rivendicare richieste supporto
  2. Aggiornamenti Stato: Aggiornamenti regolari su progresso ticket
  3. Procedure Escalation: Protocolli chiari per problemi complessi
  4. Gestione Turni: Canali diversi per fusi orari diversi

🚀 Prossimi Passi

Dopo aver configurato le notifiche Discord:

  1. Testa Accuratamente: Invia più notifiche test per verificare funzionalità
  2. Forma il Tuo Team: Assicura che tutti comprendano il workflow Discord
  3. Imposta Obiettivi Risposta: Stabilisci tempi target per avvisi Discord
  4. Monitora Prestazioni: Traccia efficacia notifiche e risposta team
  5. Itera e Migliora: Rivedi e ottimizza regolarmente il sistema notifiche

Le notifiche Discord collegano l’assistenza automatizzata e il supporto umano, assicurando che il tuo team possa fornire eccellente servizio clienti mantenendo tempi di risposta rapidi.

📚 Documentazione Correlata