Questa pagina descrive i passaggi necessari per configurare un progetto Google Cloud per l'integrazione della telefonia.
Seleziona o crea 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 viene utilizzato lo stesso trunk SIP per tutta la comunicazione 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 al solo scopo di gestire i trunk SIP. In questo modo, un altro team può essere responsabile dei trunk e, all'interno dell'interfaccia utente del trunk, può stabilire diversi gruppi di SBC per lo sviluppo, il test e la produzione.
Per utilizzare i servizi forniti da Google Cloud, devi creare un progetto. che organizza tutte le risorse Google Cloud . Un progetto è composto 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 più progetti e utilizzarli per organizzare le risorse Google Cloud in una gerarchia delle risorse. Quando crei un progetto, prendi nota dell'ID progetto. Avrai bisogno di questo ID per effettuare chiamate API. Per saperne di più sui progetti, consulta la documentazione di Resource Manager.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
Autorizzazioni
- Nella console Google Cloud , vai a IAM e amministrazione -> IAM.
- Seleziona un account di servizio esistente o creane uno nuovo e assicurati che gli sia assegnato il ruolo
Dialogflow API Admin. Questo ruolo è necessario per l'integrazione della telefonia.
Accesso API al numero di telefono
L'utilizzo dei metodi API del numero di telefono richiede un accesso speciale. Per saperne di più, contatta il tuo rappresentante di Google.
Configurare Dialogflow, il profilo di conversazione e il numero di telefono
Questa sezione illustra la procedura di creazione di un profilo di conversazione di AI conversazionale con un numero di telefono della Google Telephony Platform (GTP) associato.
- Vai a Colab Enterprise. Se richiesto, abilita le API Compute Engine, Dataform e Vertex.
- Fai clic su Importa blocchi note, quindi seleziona URL come origine dati. Inserisci questo URL del repository GitHub, poi fai clic su IMPORT.
- Nel campo
PROJECT_ID, inserisci l'ID progetto per il progetto che vuoi associare all'integrazione. Google Cloud I tuoi progetti esistenti sono disponibili nel menu a discesa nella parte superiore della pagina della console Cloud. - Inserisci la regione che hai scelto nel campo
REGION. Sono supportate tutte le regioni Dialogflow. - Lascia il campo
JWTcosì com'è o inserisci qui il valore diJWT. Se lasciato vuoto, viene utilizzato l'SSO per impostazione predefinita. - 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 di Google.
- Espandi la sezione Configurazione dell'AI conversazionale per SIP/SIPREC. Nella sezione 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. Per accedere agli endpoint API Dialogflow, è necessario un agente Dialogflow ES fittizio. Ogni progetto Google Cloud 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 inserirne uno personalizzato.SECURITY_SETTINGS: può essere qualsiasi stringa. Puoi utilizzare il valore predefinito o inserirne uno 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 Conversational Agents (Dialogflow CX) a cui vuoi associare il profilo 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 all'edizione Essentials. - Vai alla console Agent Assist.
Fai clic su Profili conversazione nel menu a sinistra per verificare che sia stato creato un profilo conversazione con il
CONVERSATION_PROFILE_NAMEche hai inserito. - Vai alla console Conversational AI Insights. Verifica che tutte le trascrizioni delle conversazioni associate al tuo agente Conversational Agents (Dialogflow CX) siano state importate.
(Facoltativo) Richiedi un aumento della quota per la durata delle chiamate del gateway di telefonia Dialogflow CX
Gli abbonamenti a Dialogflow ES Essentials e Conversational Agents (Dialogflow CX) includono quote standard disponibili. Se non utilizzi Dialogflow, ad esempio solo Agent Assist, Trascrizione o Registrazione chiamate, la tua 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) Abilita l'audit logging per l'API Dialogflow
Se vuoi, puoi attivare la registrazione degli audit 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 Conversational AI effettuate e le credenziali utilizzate per l'autorizzazione e il consumo. Ciò può essere utile per la risoluzione dei problemi e il debug.
Passaggi successivi
Scopri come configurare un SBC.