Certains produits et fonctionnalités sont en cours de changement de nom. Les fonctionnalités de playbook et de flux génératifs sont également en cours de migration vers une console unique. Consultez les détails.

Configurer un projet Google Cloud

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 et production). Si la même jonction SIP est utilisée pour toutes les communications SBC vers GTP, seule la première demande de création de la jonction SIP aboutira. Les autres demandes de création de la jonction SIP dans la même région/avec 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 des trunks, 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 console Google Cloud , sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud .

Rôles requis pour sélectionner ou créer un projet

Sélectionnez 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 devez disposer du rôle Créateur de projet (roles/resourcemanager.projectCreator), qui contient l'autorisation resourcemanager.projects.create. Découvrez comment attribuer des rôles.

Accéder au sélecteur de projet

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 Admin lui est attribué. Ce rôle est requis pour l'intégration de la téléphonie.

Accès à l'API pour les numéros de téléphone

L'utilisation des méthodes de l'API Phone Number 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 JWT tel quel ou saisissez votre valeur JWT. 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 factice…, cliquez sur Afficher le code et exécutez le code sans le modifier. Cette commande crée un agent Dialogflow ES fictif 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 projet Google Cloud ne peut comporter qu'un seul agent Dialogflow ES.
Développez la section Script to create a ConversationProfile... 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 ConversationProfile gé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_agent a 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_NAME a été créé.
Accédez à la console Insights sur l'IA conversationnelle. Vérifiez que toutes les transcriptions de conversations associées à votre agent 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 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 d'audit pour l'API Dialogflow (dialogflow.googleapis.com) pour les journaux Lecture administrateur, Lecture de données et Écriture de données. Vous pourrez ainsi 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.

Étapes suivantes

Découvrez comment configurer un SBC.

Configurer un projet Google Cloud Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.