Questo documento descrive i passaggi necessari per configurare un progettoGoogle Cloud per l'integrazione della telefonia.
Seleziona o crea un progetto Google Cloud
I trunk SIP sono connessi a un progetto solo per motivi di comunicazione, ma il loro effetto non è limitato a un progetto specifico.
Ad esempio, puoi avere tre progetti diversi (sviluppo, test, produzione). Se viene utilizzato lo stesso trunk SIP per tutte le comunicazioni da SBC a 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 e con lo stesso nome host non andranno a buon fine.
Puoi utilizzare un progetto diverso al solo scopo di gestire i trunk SIP. In questo modo, un team diverso può gestire i trunk e, all'interno della UI dei trunk, puoi stabilire diversi gruppi di SBC per lo sviluppo, i test e la produzione.
Per utilizzare i servizi forniti da Google Cloud, devi creare un progetto. Un progetto organizza tutte le tue risorse Google Cloud . Un progetto è costituito da un insieme di collaboratori, API abilitate (e altre risorse), strumenti di monitoraggio, dati di fatturazione e controlli degli accessi e autenticazione. Puoi creare un progetto o più progetti e utilizzarli per organizzare le tue risorse Google Cloud in una gerarchia delle risorse. Quando crei un progetto, prendi nota dell'ID progetto. Questo ID ti servirà per effettuare chiamate API. Per saperne di più sui progetti, consulta la documentazione di Resource Manager.
Nella console Google Cloud , nella pagina di selezione del progetto, seleziona o crea un progetto Google Cloud .
Ruoli richiesti per selezionare o creare un progetto
- Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico. Puoi selezionare qualsiasi progetto per 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'autorizzazioneresourcemanager.projects.create. Scopri come concedere i ruoli.
Autorizzazioni
- Nella console Google Cloud , vai a IAM e amministrazione > IAM.
- Seleziona un account di servizio esistente o creane uno nuovo e assegnagli il ruolo
Dialogflow API Admin. Questo ruolo è obbligatorio per l'integrazione della telefonia.
Accesso all'API Phone Number
L'utilizzo dei metodi dell'API per i numeri di telefono richiede un accesso speciale. Per saperne di più, contatta il tuo rappresentante di Google.
Configura Dialogflow, il profilo di conversazione e il numero di telefono
Questa sezione descrive come creare 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.
- Seleziona Importa notebook, quindi seleziona URL come origine dati. Inserisci l'URL del repository GitHub, quindi seleziona Importa.
- Nel campo
PROJECT_ID, inserisci l'ID progetto Google Cloud per il progetto che vuoi associare all'integrazione. Trova i tuoi progetti esistenti nel menu nella parte superiore della pagina della consoleGoogle 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 il campo viene lasciato vuoto, per impostazione predefinita viene utilizzato l'SSO. - Fai clic sul pulsante di riproduzione nella sezione Project in alto per eseguire quella sezione di codice. Quando richiesto, consenti al notebook di accedere alle tue credenziali Google.
- Espandi la sezione Configurazione dell'AI conversazionale per SIP/SIPREC. In Crea un agente Dialogflow ES fittizio…, fai clic su Mostra codice ed esegui il codice senza apportare modifiche. In questo modo viene creato un agente Dialogflow ES fittizio e il suo livello viene impostato su Enterprise. Per accedere agli endpoint dell'API Dialogflow è necessario un agente Dialogflow ES fittizio. Ogni progetto Google Cloud può avere un singolo 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 un valore personalizzato.SECURITY_SETTINGS: può essere qualsiasi stringa. Puoi utilizzare il valore predefinito o inserire un valore personalizzato.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 su Impostazioni per verificare che l'agente sia associato al progettoGoogle Cloud corretto e che sia stato eseguito l'upgrade alla versione Essentials. - Vai alla console di Agent Assist.
Fai clic su Profili di conversazione nel menu di navigazione per verificare che sia stato creato un profilo di conversazione con il
CONVERSATION_PROFILE_NAMEinserito. - Vai alla console di Conversational AI Insights. Verifica che tutte le trascrizioni delle conversazioni associate al tuo agente Dialogflow CX siano state importate.
(Facoltativo) Richiedi 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 affatto Dialogflow, ad esempio se utilizzi 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 i 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) Abilita l'audit logging per l'API Dialogflow
Per abilitare l'audit logging per l'API Dialogflow (dialogflow.googleapis.com) per Admin Read, Data Read e Data Write, utilizza questa funzionalità per visualizzare tutte le singole chiamate API di AI conversazionale effettuate e le credenziali utilizzate per l'autorizzazione e l'utilizzo. In questo modo puoi risolvere i problemi ed eseguire il debug in modo più efficace.
Passaggi successivi
- Scopri come configurare un SBC.