Migachat

On Ottobre 27, 2023, Posted by , In Italiano, With Commenti disabilitati su Migachat

Manuale Utente di Migachat

Il modulo Migachat è un assistente AI versatile e uno strumento di integrazione progettato per permettere alle aziende di gestire le interazioni degli utenti tramite l’AI. Serve a vari scopi, tra cui lo sviluppo di chatbot, il supporto clienti basato sull’AI, piattaforme educative e altro.

IMPOSTAZIONI Per una configurazione API dettagliata, fare riferimento a questa documentazione.

CONFIGURAZIONE DEL MODULO

Impostazione ChatGPT API:

    • Nell’Operazione del Modulo, selezionare ChatGPT API.
    • Aggiungere l’ID dell’Organizzazione: Ottenere questo da Impostazioni dell’Organizzazione.
    • Aggiungere la Chiave Segreta: Recuperare questa da Chiavi API.
    • Dopo aver salvato il modulo, il sistema verificherà le credenziali inserite. Credenziali errate impediranno il salvataggio.

Impostazione Webhook e Web-Service:

    • Nell’Operazione del Modulo, selezionare il Webhook.
    • Aggiungere un URL Webhook valido.
    • Usare il Token di Autenticazione fornito nella richiesta del servizio web, che può essere rigenerato in qualsiasi momento.

Configurazione di OpenAI (Disponibile solo se è selezionata la ChatGPT API):

    • Dopo aver configurato il modulo, specificare il modello AI da utilizzare per il tuo chatbot.
    • Selezionare il Modello: Scegliere il Modello OPEN AI ChatGPT.
    • Aggiungere un Limite di Sistema per questo modello: Impostare il limite di token per il prompt di sistema in base al limite di token del modello.
    • Aggiungere un Limite Totale per il Prompt: Specificare il limite di token per il prompt di sistema più la cronologia della chat da inviare con la richiesta API.

CONFIGURAZIONE DEL PROMPT DI SISTEMA PER OPENAI CHATGPT

    • Gestisci il prompt di sistema abilitandolo o disabilitandolo. Aggiungi il testo del prompt di sistema.

    • Puoi ottimizzare il prompt di sistema cliccando su “Ottimizza prompt di sistema”.
    • Questo verrà ottimizzato tramite la ChatGPT API.
    • Viene visualizzato un modello a comparsa.
    • Qui puoi mantenere il prompt di sistema esistente o salvare il nuovo prompt di sistema ottimizzato.

Configurazioni API del Bridge (API per Terze Parti):

    • Configurare le impostazioni di sicurezza, inclusi un token di autenticazione e limiti di token per le interazioni.
    • Token di Autenticazione: Un token di autenticazione API per l’autenticazione delle richieste.
    • Aggiungere una Durata Complessiva per il Limite dei Token: Impostare la durata per il limite di token per tutti gli ID di CHAT in un’istanza (predefinito: 24 ore).
    • Aggiungere un Limite Totale dei Token: Definire il limite di token per tutti gli ID di CHAT in un’istanza (predefinito: 2.500.000 Token).
    • Selezionare la Durata del Limite dei Token per ID di Chat Singolo: Impostare la durata per il limite di token di un singolo ID di CHAT (predefinito: 60 minuti).
    • Aggiungere un Limite di Token per ID di Chat Singolo: Specificare il limite di token per un singolo ID di CHAT (predefinito: 100.000 Token).
    • Aggiungere una Risposta per il Superamento del Limite di Chat Utente: Configurare la risposta quando un singolo ID di CHAT raggiunge il limite di token, e verrà automaticamente tradotto nella lingua della chat precedente.
    • Impostare il Limite di Token per la Risposta AI: Definire il limite di token per le risposte AI, che sarà lo stesso per tutti i modelli AI.
    • Abilitare o Disabilitare la funzionalità Bridge API.

Archivio Chat dell’App:

In questa sezione è possibile accedere alle statistiche dell’applicazione, visualizzare report ed esplorare i log delle chat dei clienti.

  • Recuperare le statistiche delle chat dell’app e scaricare un file CSV con statistiche come Clienti Attivi Totali, Token di Prompt Totali e Token di Completamento Totali.
  • Esportare una chat completa dei clienti attivi in un determinato periodo.
  • Ottenere le chat dei clienti per un dato intervallo di date, visualizzare la cronologia delle chat e l’uso dei token. È possibile eliminare l’intera cronologia delle chat di un cliente selezionato e scaricare un file CSV per l’intervallo di date e il cliente.

 

Archivio Chat API (BridgeAPI):

In questa sezione è possibile accedere alle statistiche di BridgeAPI, visualizzare report ed esplorare i log delle chat degli ID di CHAT.

    • Importa il registro chat Bridge API tramite CSV.
    • Ottenere le statistiche delle chat di BridgeAPI e scaricare un file CSV, compresi gli ID di CHAT attivi totali, i token di prompt totali e i token di completamento totali.
    • Esportare una chat completa degli ID di CHAT attivi in un determinato intervallo di date.
    • Accedere alle chat dei clienti per un dato intervallo di date, visualizzare la cronologia delle chat e l’uso dei token, ed eliminare l’intera cronologia delle chat di un cliente selezionato.
    • È possibile eliminare l’intera cronologia delle chat delle API per un’istanza del modulo cliccando su “Cancella la cronologia delle chat delle API”.
  • Il formato CSV per importare la chat è:

Log:

La sezione dei Log consente di visualizzare i log delle ultime 30 chat in tutto il sistema e di vedere eventuali errori riscontrati durante le interazioni.

  • Ricevere notifiche push per i nuovi messaggi ricevuti.
  • Restare informati sull’attività delle chat e sugli aggiornamenti.

DOCUMENTAZIONE IMPOSTAZIONI OPERATORE

PANORAMICA

  • Il pannello Impostazioni Operatore nell’applicazione Migachat consente di configurare varie impostazioni per le interazioni con gli operatori all’interno dell’app, inclusa l’attivazione o la disattivazione di funzionalità per le chat in-app e tramite API Bridge, la configurazione di webhook, la gestione di prompt e risposte per le interazioni utente e la gestione delle notifiche email.

FORM IMPOSTAZIONI

Chat In-App

  • Etichetta: Abilitato per la chat in-app?
  • Tipo di campo: Dropdown (Sì/No)
  • Descrizione: Abilita o disabilita le impostazioni per gli operatori nella chat in-app.

Chat API Bridge

  • Etichetta: Abilitato per la chat API Bridge?
  • Tipo di campo: Dropdown (Sì/No)
  • Descrizione: Abilita o disabilita le impostazioni per gli operatori nella chat API Bridge.

URL DEL WEBHOOK

  • Etichetta: URL Webhook
  • Tipo di campo: Input di testo
  • Descrizione: L’URL a cui verranno inviate le notifiche del webhook. Questo webhook deve accettare richieste POST. La richiesta POST conterrà i seguenti parametri:

– chat_type (in_app, api)
– user_id
– app_id
– app_name
– instance_id
– operator_request_id
– user_email
– user_mobile
– date_time
– last_five_history

PROMPT DI SISTEMA

  • Etichetta: Prompt di sistema per verificare se l’utente ha richiesto un contatto con l’operatore
  • Tipo di campo: Textarea
  • Descrizione: Prompt personalizzato per analizzare l’input dell’utente e determinare se desidera parlare con un operatore.
    Prompt predefinito:
    Analizza questa stringa di testo che un utente ha scritto nella nostra chat di supporto (prompt utente). Rispondi con 1 se è sufficientemente probabile che significhi che l'utente vuole parlare con un operatore. Se non è abbastanza chiaro e in tutti gli altri casi rispondi con 0.

MESSAGGI PERSONALIZZATI

Messaggio per chiedere se l’utente vuole essere chiamato dall’operatore

  • Etichetta: Testo per richiedere una chiamata dall’operatore
  • Tipo di campo: Textarea
  • Descrizione: Messaggio personalizzato per chiedere agli utenti se desiderano una chiamata da un operatore.
    Messaggio predefinito:
    Vuoi che uno dei nostri operatori ti chiami? (Scrivi Sì o No)

Messaggio di conferma chiamata dall’operatore

  • Etichetta: Testo di conferma chiamata dall’operatore
  • Tipo di campo: Textarea
  • Descrizione: Messaggio personalizzato per confermare che un operatore contatterà l’utente.
    Messaggio predefinito:
    Perfetto, ho avvisato i miei colleghi. Ti contatteranno a breve. Ora puoi continuare a chiedermi informazioni se vuoi.

Messaggio di rifiuto chiamata dall’operatore

  • Etichetta: Testo di rifiuto chiamata dall’operatore
  • Tipo di campo: Textarea
  • Descrizione: Messaggio personalizzato se l’utente rifiuta una chiamata dall’operatore.
    Messaggio predefinito:
    Da quanto ho capito, non sei interessato a una chiamata da parte di uno dei nostri operatori. Possiamo continuare a chattare su altri argomenti se vuoi.

EMAIL AGGIUNTIVE

  • Etichetta: Aggiungi email separate da virgola per inviare notifiche
  • Tipo di campo: Textarea
  • Descrizione: Elenco di indirizzi email aggiuntivi a cui inviare notifiche. Per impostazione predefinita, l’email sarà inviata agli amministratori.

Oggetto dell’email

  • Etichetta: Oggetto dell’email
  • Tipo di campo: Textarea
  • Descrizione: Oggetto delle email di notifica.
    Oggetto predefinito:
    Un cliente ha richiesto di contattare un operatore.

Template dell’email

  • Etichetta: Template dell’email
  • Tipo di campo: Textarea
  • Descrizione: Template per le email di notifica. Il template può contenere i seguenti segnaposto:
    – @@app_id@@
    – @@app_name@@
    – @@instance_id@@
    – @@user_name@@
    – @@user_email@@
    – @@user_mobile@@
    – @@chat_id@@
    – @@chat_type@@
    – @@operator_request_id@@
    – @@date_time@@
    – @@last_five_history@@

RICHIESTE DI CHIAMATA DALL’OPERATORE

Questa sezione mostra una tabella con i dati delle richieste degli operatori, inclusi:

  • ID Utente
  • Nome
  • Email
  • Mobile
  • Data e Ora
  • Tipo di Bot
  • Stato
  • Azione (ad esempio, accettare una richiesta in sospeso)

GESTIONE DEI PROMPT DELL’UTENTE

  • Richiesta Iniziale: Se l’API Bridge è abilitata e l’utente non ha già richiesto un operatore, analizza il prompt dell’utente utilizzando il prompt di sistema configurato. Se è probabile che l’utente desideri parlare con un operatore, imposta il flag asked_for_operator e chiedi conferma all’utente.
  • Conferma Utente: Se l’utente ha già richiesto un operatore, analizza la risposta dell’utente per confermare se desidera una chiamata. Se confermato, salva la richiesta, invia notifiche webhook ed email, quindi reimposta il flag asked_for_operator e avvisa l’utente che un operatore lo contatterà a breve. Se rifiutato, reimposta il flag e informa l’utente che la richiesta non è stata effettuata.

INTERFACCIA DELL’APPLICAZIONE

  • L’interfaccia dell’applicazione offre un’esperienza user-friendly simile a quella di un chatbot, accessibile dopo aver effettuato l’accesso.
  • Puoi copiare la risposta dell’AI cliccando sull’icona degli appunti.

 

LINK: https://support.migastone.com/it/hrf_faq/migachat-2/

← →