In questa pagina vengono descritti i passaggi necessari per configurare un Google Cloud progetto per l'integrazione della telefonia.
Selezionare o creare un Google Cloud progetto
I trunk SIP sono collegati a un progetto solo per motivi di comunicazione, ma il loro impatto non è limitato a un progetto specifico.
Ad esempio, potresti avere tre progetti diversi (sviluppo, test, produzione). Se lo stesso trunk SIP viene utilizzato per tutte le comunicazioni SBC-GTP, solo la prima richiesta di creazione del trunk SIP andrà a buon fine, mentre le altre richieste di creazione del trunk SIP nella stessa regione/nome host non andranno a buon fine.
Ti consigliamo di utilizzare un progetto diverso esclusivamente per la gestione dei trunk SIP. In questo modo, un team diverso può essere responsabile dei trunk e, all'interno dell'interfaccia utente Trunk, può creare gruppi diversi di SBC per sviluppo, test e produzione.
Per utilizzare i servizi forniti da Google Cloud, devi creare un progetto. Un progetto organizza tutte le tue Google Cloud risorse. Un progetto è costituito da un insieme di collaboratori, API abilitate (e altre risorse), strumenti di monitoraggio, informazioni di fatturazione, e controlli di autenticazione e accesso. Puoi creare un progetto, oppure creare più progetti e utilizzarli per organizzare le tue Google Cloud risorse in una gerarchia di risorse. Quando crei un progetto, prendi nota dell' ID progetto. Avrai bisogno di questo ID per effettuare chiamate API. Per ulteriori informazioni sui progetti, consulta la documentazione di Resource Manager.
Nella Google Cloud console, nella pagina di selezione del progetto, seleziona o crea un Google Cloud progetto.
Ruoli necessari per selezionare o creare un progetto
- Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico: puoi selezionare qualsiasi progetto su cui ti è stato concesso un ruolo.
-
Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto
(
roles/resourcemanager.projectCreator), che contiene l'resourcemanager.projects.createautorizzazione. Scopri come concedere i ruoli.
Autorizzazioni
- Nella Google Cloud console, vai a IAM e amministrazione -> IAM.
- Seleziona un account di servizio esistente o creane uno nuovo e assicurati che gli sia stato assegnato il ruolo
Dialogflow API Admin. Questo ruolo è necessario per l'integrazione della telefonia.
Accesso all'API per i numeri di telefono
L'utilizzo dei metodi dell'API per i numeri di telefono richiede un accesso speciale. Per ulteriori informazioni, contatta il tuo rappresentante di Google.
Configurare Dialogflow, il profilo di conversazione e il numero di telefono
Questa sezione ti guida nella procedura di creazione di un profilo di conversazione di AI conversazionale con un numero di telefono della piattaforma di telefonia Google (GTP) associato.
- Vai a Colab Enterprise Se richiesto, abilita le API Compute Engine, Dataform e Vertex.
- Fai clic su Importa notebook, quindi seleziona URL come origine dati. Inserisci l'URL del repository GitHub, quindi fai clic su IMPORT.
- Nel campo
PROJECT_ID, inserisci l' Google Cloud ID progetto del progetto che vuoi associare all'integrazione. Puoi trovare i progetti esistenti nel menu a discesa nella parte superiore della pagina nella console Cloud. - Inserisci la regione scelta nel campo
REGION. Sono supportate tutte le regioni di Dialogflow. - Lascia il campo
JWTcosì com'è o inserisci qui il valoreJWT. Se lasciato vuoto, per impostazione predefinita viene utilizzato il Single Sign-On. - Fai clic sul pulsante di riproduzione nella sezione Progetto in alto per eseguire quella sezione di codice. Quando richiesto, consenti al notebook di accedere alle tue credenziali Google.
- Espandi la sezione Configurazione di AI conversazionale per SIP/SIPREC. In Crea un agente Dialogflow ES fittizio..., fai clic su Mostra codice ed esegui il codice senza apportare modifiche. Viene creato un agente Dialogflow ES fittizio e il suo livello viene impostato su Enterprise. È necessario un agente Dialogflow ES fittizio per accedere agli endpoint dell'API Dialogflow. Ogni Google Cloud progetto può avere un solo agente Dialogflow ES.
- Espandi per visualizzare il codice nella sezione Script per creare un
ConversationProfile....CONVERSATION_PROFILE_NAME: può essere qualsiasi stringa. Puoi utilizzare il valore predefinito o inserire il tuo.SECURITY_SETTINGS: può essere qualsiasi stringa. Puoi utilizzare il valore predefinito o inserire il tuo.PHONE_NUMBER_COUNTRY_CODE: inserisci il codice paese che vuoi associare al tuo numero di telefono GTP.CX_AGENT_NAME: inserisci il nome dell'agente Dialogflow CX a cui vuoi associare il profilo di conversazione generato.
- Esegui il codice. L'output includerà il nome del
ConversationProfilegenerato, le impostazioni di sicurezza e il numero di telefono GTP. - Vai alla console Dialogflow ES
per verificare che sia stato creato un agente denominato
Dummy_ES_agent. Fai clic Impostazioni per verificare che l'agente sia associato al Google Cloud progetto corretto e che sia stato eseguito l'upgrade all'edizione Essentials. - Vai alla
console Agent Assist.
Fai clic su Profili di conversazione nel menu a sinistra per verificare che sia stato creato un profilo di conversazione con il
CONVERSATION_PROFILE_NAMEinserito. - Vai alla console AI conversazionale Insights. Verifica che tutte le trascrizioni delle conversazioni associate al tuo agente Dialogflow CX siano state importate.
(Facoltativo) Richiedere un aumento della quota per la durata delle chiamate di Dialogflow CX Phone Gateway
Gli abbonamenti a Dialogflow ES Essentials e Dialogflow CX includono quote standard disponibili. Se non utilizzi Dialogflow, ad esempio solo Agent Assist, Trascrizione o Registrazione delle chiamate, la quota predefinita è la stessa della quota di Dialogflow ES Essentials.
Se necessario, puoi richiedere un aumento della quota in base al traffico stimato. Nella maggior parte dei casi d'uso, la quota standard è sufficiente per la configurazione e il test, ma le applicazioni di runtime richiedono un aumento. Consulta la pagina delle quote di Dialogflow per i dettagli sulle quote e le istruzioni per richiedere un aumento.
(Facoltativo) Abilitare i log di controllo per l'API Dialogflow
Facoltativamente, puoi abilitare i log di controllo per l' API Dialogflow (dialogflow.googleapis.com) per lettura amministrativa, lettura dei dati e scrittura dei dati. In questo modo puoi visualizzare tutte le singole chiamate API di AI conversazionale effettuate e le credenziali utilizzate per l'autorizzazione e il consumo. Questa funzionalità può essere utile per la risoluzione dei problemi e il debug.
Passaggi successivi
Scopri come configurare un SBC.