Cette page décrit les étapes nécessaires pour configurer un projet Google Cloud pour l'intégration de la téléphonie.
Sélectionner ou créer un projet Google Cloud
Les trunks SIP sont associés à un projet uniquement 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 vers 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 distinct uniquement pour gérer les trunks SIP. Cela permet à une autre équipe d'être responsable des trunks. Dans l'interface utilisateur Trunk, 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 Resource Manager.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Autorisations
- Dans la console Google Cloud , accédez à IAM et administration > IAM.
- Sélectionnez un compte de service existant ou créez-en un, et assurez-vous que le rôle
Dialogflow API Adminlui est attribué. Ce rôle est requis pour l'intégration de la téléphonie.
Accès à l'API pour le numéro de téléphone
L'utilisation des méthodes d'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 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 Google Cloud que vous souhaitez associer à l'intégration. Vos projets existants sont disponibles 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 acceptées. - Laissez le champ
JWTtel quel ou saisissez votre valeurJWT. 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 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 Configurer l'IA conversationnelle pour SIP/SIPREC. Sous Créer un agent Dialogflow ES fictif…, cliquez sur Afficher le code et exécutez le code sans apporter de modifications. Cette commande crée un agent Dialogflow ES factice et définit son niveau sur "Enterprise". Un agent Dialogflow ES fictif est requis pour accéder aux points de terminaison de l'API Dialogflow. Chaque projet Google Cloud ne peut comporter 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 du pays que vous souhaitez associer à votre numéro de téléphone GTP.CX_AGENT_NAME: saisissez le nom de l'agent Agents de conversation (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 bien été créé. Cliquez sur Paramètres pour vérifier que l'agent est associé au bon projetGoogle Cloud et qu'il a été mis à niveau vers l'édition Essentials. - Accédez à la console Agent Assist.
Cliquez sur Profils de conversation dans le menu de gauche pour vérifier qu'un profil de conversation avec votre
CONVERSATION_PROFILE_NAMEa été créé. - Accédez à la console Insights sur l'IA conversationnelle. Vérifiez que toutes les transcriptions de conversations associées à votre agent d'agents conversationnels (Dialogflow CX) ont été importées.
(Facultatif) Demander une augmentation du quota pour la durée des appels de la passerelle de téléphonie Dialogflow CX
Les abonnements Dialogflow ES Essentials et Agents de conversation (Dialogflow CX) sont fournis avec des quotas standards. Si vous n'utilisez pas du tout Dialogflow, par exemple uniquement Agent Assist, la transcription ou l'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. Pour en savoir plus sur les quotas et découvrir comment demander une augmentation, consultez la page sur les quotas de Dialogflow.
(Facultatif) Activez la journalisation d'audit pour l'API Dialogflow.
Vous pouvez éventuellement activer la journalisation des audits pour l'API Dialogflow (dialogflow.googleapis.com) pour les journaux "Lecture administrateur", "Lecture de données" et "Écriture de données". Vous pouvez ainsi voir tous les appels individuels à l'API Conversational AI 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.
Étapes suivantes
Découvrez comment configurer un SBC.