Business Messages fornisce un'interfaccia utente web denominata Business Communications Developer Console. Puoi utilizzare questa console per creare, gestire e avviare gli agenti.
La Developer Console di Business Communications è diversa da Google Cloud Platform. (GCP) Utilizzi la Developer Console di Business Communications per gestire gli agenti di Business Messages, mentre la console di GCP gestisci le impostazioni specifiche di GCP (ad esempio, fatturazione e API) e altre risorse GCP.
Sebbene tu possa utilizzare la Developer Console di Business Communications per creare e gestire gli agenti, puoi utilizzare anche l'API Business Communications per creare e gestire gli agenti per scenari avanzati come l'integrazione nel tuo prodotto.
La guida rapida e le guide illustrative ti indicano i passaggi per utilizzare sia la console che le API. Questa pagina fornisce un riepilogo di alto livello del layout dell'interfaccia utente e dello scopo per cui viene utilizzata la console.
Come viene utilizzata la console
La console viene utilizzata per creare, gestire, aggiornare, verificare e avviare i tuoi agenti. Consente di:
- Configurare il Webhook e altre impostazioni dell'account partner.
- Creare e gestire gli agenti, che contengono tutte le proprietà e i dati che definiscono la rappresentazione colloquiale di un brand.
- Configura le impostazioni degli agenti non locali e la disponibilità dei messaggi.
- Crea e gestisci le località che rappresentano le sedi fisiche di un'attività.
- Recupera l'agente e i URL di test degli indirizzi per vedere come viene mostrata agli utenti una conversazione con l'agente.
- Esegui l'integrazione con Dialogflow per rispondere alle domande frequenti.
- Verifica l'agente e le sedi.
- Avvia l'agente e le località.
Schermata Home della console
Quando carichi la console inizialmente, viene visualizzata la schermata di selezione dell'agente. Il link Impostazioni account partner consente di aprire la pagina delle impostazioni account del partner.
Inoltre, la schermata Home consente di:
- Seleziona un agente esistente.
- Crea nuovi agenti.
- Ordinare gli agenti.
- Filtra gli agenti per account partner.
Per impostazione predefinita, gli agenti sono visualizzati in una visualizzazione schede. Gli agenti vengono ordinati in base all'ultimo aggiornamento. Per passare a una visualizzazione elenco, utilizza le opzioni Visualizza come sulla destra. Con la visualizzazione elenco, gli agenti possono essere ordinati per nome, tipo, stato e data dell'ultimo aggiornamento.
Se hai più account partner, è disponibile un selettore a discesa per l'account partner in cui puoi filtrare la selezione dell'agente in base a un account partner.
Impostazioni account
Dalla pagina Impostazioni puoi aggiornare:
- Nome attività
- Nome visualizzato
- Punto di contatto tecnico
- Webhook
Nel pannello di navigazione laterale, puoi accedere alla gestione dei brand e degli utenti, nonché ai tuoi account di servizio.
Gestione del brand
Un brand è un'attività, un'organizzazione o un gruppo. Un agente è la rappresentazione conversazionale di un brand.
Utilizza questa pagina per aggiungere, modificare e rimuovere i brand. La rimozione di un brand elimina anche tutti gli agenti associati. Un brand non può essere rimosso se è associato a un agente lanciato.
Gestione utenti
Utilizza questa pagina per aggiungere e rimuovere l'accesso ai tuoi account partner registrati. Per cambiare account, utilizza il menu a discesa nella barra di navigazione in alto.
Aggiungere un utente
Per aggiungere un utente, inserisci il suo indirizzo email nel campo di immissione dell'indirizzo email e seleziona il ruolo.
I nuovi utenti possono avere il ruolo di Gestore o Lettore. Un ruolo gestore ha accesso a tutte le funzionalità nella console, mentre un ruolo lettore fornisce l'accesso in sola lettura alle informazioni sull'agente e sulla posizione.
Quando aggiungi un nuovo utente, l'utente riceve un'email che lo informa che ora può accedere all'account partner.
L'indirizzo email con cui è stato originariamente registrato l'account partner ha il ruolo Proprietario.
Rimuovere un utente
Per rimuovere un utente:
- Individua nell'elenco l'utente che vuoi rimuovere.
- Fai clic sul pulsante .
- Seleziona Rimuovi utente.
- Conferma la rimozione.
L'utente rimosso riceve una notifica via email che lo informa che non ha più accesso all'account.
Non puoi rimuovere un utente con il ruolo Proprietario. Per modificare o rimuovere un proprietario, devi contattare l'assistenza.
Modificare un ruolo utente
Per aggiornare il ruolo di un utente:
- Trova l'utente di cui vuoi aggiornare il ruolo.
- Fai clic sul pulsante .
- Seleziona Modifica ruolo.
- Scegli un nuovo ruolo nel menu a discesa.
- Fai clic su Salva.
Account di servizio
Quando effettui chiamate alle API Business Communications e Business Messages, autentichi le chiamate con una chiave dell'account di servizio. Le chiavi degli account di servizio consentono di creare e gestire brand, agenti e località, nonché di inviare messaggi e richieste come agente.
Per generare una chiave dell'account di servizio, seleziona Account di servizio dal menu di navigazione laterale. Si apre la console di GCP per il progetto GCP associato all'account partner attualmente selezionato.
Per creare un account di servizio e una chiave:
- Fai clic su Crea account di servizio.
- In Nome account di servizio, inserisci il nome dell'agente, quindi fai clic su Crea.
- Fai clic su Fine.
- Individua il nuovo account di servizio nella tabella e fai clic su > Crea chiave.
- Scegli JSON, quindi fai clic su Crea.
Il browser scarica la chiave dell'account di servizio.
Selezione dell'agente
Dopo aver selezionato un agente, verrà visualizzata la pagina Panoramica dell'agente selezionato.
Viene visualizzata la panoramica:
- Nome brand
- Nome agente
- L'account partner in cui è stato creato l'agente.
- ID brand
- ID agente
- URL di test degli agenti che ti consentono di vedere come viene visualizzata dagli utenti una conversazione con l'agente e ti offrono l'opportunità di verificare l'infrastruttura di messaggistica
- Stato di verifica dell'agente
- Anteprima dell'agente
- Località associate all'agente
- Link alla documentazione pertinente
Il menu di navigazione a sinistra ti consente di accedere a:
- Informazioni agente
- Località
- Integrazioni
- Domande del sondaggio
- Log di debug
- Verifica
- Lancio
- Dashboard delle metriche
- Link alla documentazione pertinente
Informazioni agente
Per aggiornare le proprietà di un agente, utilizza la pagina delle informazioni dell'agente.
La pagina è suddivisa in due colonne. Utilizza i campi di immissione nella colonna a sinistra per aggiornare i campi dell'agente, ad esempio nome, logo, messaggio di benvenuto, spunti di conversazione e proprietà per l'agente e i punti di contatto non locali. Non puoi aggiornare alcuni campi, ad esempio Nome agente e Logo, dopo aver avviato l'agente.
Utilizza la colonna destra per ottenere gli URL di test per l'agente e visualizzare un'anteprima di come sarà l'agente sul dispositivo di un utente.
Gestione delle località
Utilizza questa pagina per aggiungere località, recuperare gli URL di test per le sedi dell'attività commerciale e verificare le sedi dopo aver verificato l'agente.
Integrazioni
Utilizza questa pagina per l'integrazione con Dialogflow e configura un bot per rispondere alle domande frequenti.
Sondaggi
Utilizza questa pagina per personalizzare il sondaggio per i clienti del tuo agente.
Log
Utilizza questa pagina per eseguire il debug dei problemi di recapito dei messaggi. I log sono disponibili per 14 giorni. Filtra per ID conversazione, ID messaggio, timestamp, direzione o stato per trovare i log pertinenti ai problemi degli utenti. Puoi anche controllare questa pagina per verificare di non avere inviato involontariamente messaggi non validi.
I log includono il payload dei messaggi, ad eccezione dei campi sensibili oscurati, come i contenuti del testo del messaggio. I messaggi non riusciti e rifiutati contengono dettagli aggiuntivi sugli errori per agevolare il debug.
Alcuni eventi, ad esempio gli indicatori di digitazione, non hanno ricevute di consegna e il loro stato è visualizzato come "Inviato".
Verifica
Utilizza questa pagina per inviare il tuo agente per la verifica.
Lancia
Utilizza questa pagina per lanciare l'agente per i punti di contatto per la località e non locali, nonché per lanciare le singole sedi.
