Cette page décrit la procédure à suivre pour configurer un Google Cloud projet pour l'intégration de la téléphonie.
Sélectionner ou créer un Google Cloud projet
Les jonctions SIP ne sont connectées à un projet que pour des raisons de communication, mais leur impact ne se limite pas à un projet spécifique.
Par exemple, vous pouvez avoir trois projets différents (développement, test, production). Si la même jonction SIP est utilisée pour toutes les communications SBC à GTP, seule la première requête de création de la jonction SIP réussira. Les autres requêtes de création de la jonction SIP dans la même région/le même nom d'hôte échoueront.
Nous vous recommandons d'utiliser un projet différent dans le seul but de gérer les jonctions SIP. Cela permet à une autre équipe d'être responsable des jonctions. Dans l'interface utilisateur des jonctions, elle peut établir différents groupes de SBC pour le développement, les tests et la production.
Pour utiliser les services fournis par Google Cloud, vous devez créer un projet. Un projet permet d'organiser toutes vos ressources Google Cloud . Il se compose d'un ensemble de collaborateurs, d'API activées (et d'autres ressources), d'outils de surveillance, d'informations de facturation, et de contrôles d'authentification et d'accès. Vous pouvez créer un projet, ou en créer plusieurs et les utiliser pour organiser vos ressources Google Cloud dans une hiérarchie des ressources. Lorsque vous créez un projet, notez l'ID du projet. Vous en aurez besoin pour effectuer des appels d'API. Pour en savoir plus sur les projets, consultez la documentation concernant Resource Manager.
Dans la Google Cloud console, sur la page de sélection du projet, sélectionnez ou créez un Google Cloud projet.
Rôles requis pour sélectionner ou créer un projet
- Sélectionner un projet : la sélection d'un projet ne nécessite pas de rôle IAM spécifique Vous pouvez sélectionner n'importe quel projet pour lequel un rôle vous a été attribué.
-
Créer un projet : pour créer un projet, vous avez besoin du rôle Créateur de projet
(
roles/resourcemanager.projectCreator), qui contient l'autorisationresourcemanager.projects.create. Découvrez comment attribuer des rôles.
Accéder au sélecteur de projet
Autorisations
- Dans la Google Cloud console, accédez à IAM et administration -> IAM.
- Sélectionnez un compte de service existant ou créez-en un, puis assurez-vous qu'il dispose du rôle
Dialogflow API Adminqui lui est attribué. Ce rôle est requis pour l'intégration de la téléphonie.
Accès à l'API de numéro de téléphone
L'utilisation des méthodes de l'API de numéro de téléphone nécessite un accès spécial. Pour plus d'informations, contactez votre représentant Google.
Configurer Dialogflow, le profil de conversation et le numéro de téléphone
Cette section vous explique comment créer un profil de conversation d'IA conversationnelle avec un numéro de téléphone Google Telephony Platform (GTP) associé.
- Accédez à Colab Enterprise Si vous y êtes invité, activez les API Compute Engine, Dataform et Vertex.
- Cliquez sur Import notebooks (Importer des notebooks), puis sélectionnez URL comme source de données. Saisissez l'URL de ce dépôt GitHub, puis cliquez sur IMPORT.
- Dans le champ
PROJECT_ID, saisissez l'ID du projet que vous souhaitez associer à l'intégration. Google Cloud Vous trouverez vos projets existants dans le menu déroulant en haut de la page de la console Cloud. - Saisissez la région de votre choix dans le champ
REGION. Toutes les régions Dialogflow sont compatibles. - Laissez le champ
JWTtel quel ou saisissez votre valeurJWTici. Si vous ne renseignez pas ce champ, l'authentification unique est utilisée par défaut. - Cliquez sur le bouton de lecture dans la section Project (Projet) en haut de la page pour exécuter cette section de code. Lorsque vous y êtes invité, autorisez le notebook à accéder à vos identifiants Google.
- Développez la section Configuring Conversational AI for SIP/SIPREC (Configurer l'IA conversationnelle pour SIP/SIPREC). Sous Create a dummy Dialogflow ES agent... (Créer un agent Dialogflow ES factice…), cliquez sur Show code (Afficher le code) et exécutez le code sans apporter de modifications. Cela crée un agent Dialogflow ES factice et définit son niveau sur Enterprise. Un agent Dialogflow ES factice est requis pour accéder aux points de terminaison de l'API Dialogflow. Chaque Google Cloud projet ne peut avoir qu'un seul agent Dialogflow ES.
- Développez la section Script to create a
ConversationProfile... (Script pour créer unConversationProfile…) pour afficher le code.CONVERSATION_PROFILE_NAME: peut être n'importe quelle chaîne. Vous pouvez utiliser la valeur par défaut ou saisir la vôtre.SECURITY_SETTINGS: peut être n'importe quelle chaîne. Vous pouvez utiliser la valeur par défaut ou saisir la vôtre.PHONE_NUMBER_COUNTRY_CODE: saisissez le code pays que vous souhaitez associer à votre numéro de téléphone GTP.CX_AGENT_NAME: saisissez le nom de l'agent Dialogflow CX auquel vous souhaitez associer le profil de conversation généré.
- Exécutez le code. Le résultat inclura le nom du
ConversationProfilegénéré, les paramètres de sécurité et le numéro de téléphone GTP. - Accédez à la console Dialogflow ES
pour vérifier qu'un agent nommé
Dummy_ES_agenta été créé. Cliquez sur Settings (Paramètres) pour vérifier que l'agent est associé au bon Google Cloud projet et qu'il a été mis à niveau vers l'édition Essentials. - Accédez à la
console Agent Assist.
Cliquez sur Conversation profiles (Profils de conversation) dans le menu de gauche pour vérifier qu'un profil de conversation avec le
CONVERSATION_PROFILE_NAMEque vous avez saisi a été créé. - Accédez à la console Conversational AI Insights. Vérifiez que toutes les transcriptions de conversation associées à votre agent Dialogflow CX ont été importées.
(Facultatif) Demander une augmentation de quota pour la durée des appels Dialogflow CX Phone Gateway
Les abonnements Dialogflow ES Essentials et Dialogflow CX sont fournis avec des quotas disponibles standards. Si vous n'utilisez pas Dialogflow du tout, par exemple uniquement Agent Assist, Transcription ou Enregistrement des appels, votre quota par défaut est le même que celui de Dialogflow ES Essentials.
Vous pouvez demander une augmentation de quota si nécessaire en fonction de votre trafic estimé. Dans la plupart des cas d'utilisation, le quota standard est suffisant pour la configuration et les tests, mais les applications d'exécution nécessitent une augmentation. Consultez la page Quotas Dialogflow pour obtenir des informations sur les quotas et des instructions pour demander une augmentation.
(Facultatif) Activer la journalisation d'audit pour l'API Dialogflow
Vous pouvez éventuellement activer la journalisation d'audit pour l' API Dialogflow (dialogflow.googleapis.com) pour les lectures administrateur, les lectures de données et les écritures de données. Cela vous permet de voir tous les appels d'API d'IA conversationnelle individuels effectués, ainsi que les identifiants utilisés pour l'autorisation et la consommation. Cela peut être utile pour le dépannage et le débogage.
Étape suivante
Découvrez comment configurer un SBC.