Le composant prédéfini de l'accueil récupère le numéro de téléphone de l'appelant (ANI), le cas échéant. Si le numéro de téléphone est récupéré, le composant effectue une authentification logicielle à l'aide du numéro de téléphone, en le validant par rapport aux numéros de téléphone enregistrés. L'agent accueille ensuite l'utilisateur final avec un message personnalisé en fonction des informations de son compte.
Limites
En plus des limites courantes des composants prédéfinis, ce composant prédéfini présente les limitations suivantes:
- Le composant suppose que les numéros de téléphone des clients sont gérés dans un système CRM (Customer Relationship Management) ou un autre service.
- Les clients existants qui utilisent un autre numéro de téléphone pour être contactés ne seront pas authentifiés par ce composant.
Exemples de boîtes de dialogue
Les exemples de boîtes de dialogue suivants illustrent les scénarios courants gérés par ce composant prédéfini. Les exemples de boîtes de dialogue illustrent le comportement lorsque le composant est appelé via la téléphonie, ce qui déclenche l'intent d'accueil par défaut et la première réponse de l'agent au début de la conversation.
Utilisateur final authentifié
L'utilisateur final est identifié en fonction du numéro appelant et reçoit un message d'accueil personnalisé.
| Entrée utilisateur | Réponse de l'agent |
|---|---|
| Bonjour [Caller First Name]. Merci de nous avoir contactés. [Nom de l'entreprise] s'engage à vous aider à gérer votre santé financière. Comment pouvons-nous vous aider aujourd'hui ? |
Utilisateur final non identifié
Le numéro de l'appelant de l'utilisateur final n'est pas identifié, et l'utilisateur final est accueilli par le message de bienvenue standard.
| Entrée utilisateur | Réponse de l'agent |
|---|---|
| Merci de nous avoir contactés. [Nom de l'entreprise] s'engage à vous aider à gérer votre situation financière. Comment pouvons-nous vous aider aujourd'hui ? |
Conventions d'attribution de noms
Ce composant prédéfini utilise les conventions d'attribution de noms suivantes:
| Caractéristique | Format | Exemple |
|---|---|---|
| Flux | [Component Name] | Message d'accueil |
| Paramètre | [param_name] | ani_auth |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_greeting:get_account_details |
Paramètres d'entrée
Les paramètres d'entrée sont des paramètres utilisés pour configurer certains comportements du composant. Les paramètres seront utilisés par une ou plusieurs conditions du flux pour déterminer le comportement du composant. Les paramètres de portée de flux doivent être définis sur la page de démarrage du composant, comme décrit ci-dessous. Les paramètres de portée de session peuvent être définis par un flux d'appel ou sur la page de démarrage de ce composant.
Ce composant prédéfini accepte les paramètres d'entrée suivants:
| Nom du paramètre | Description | Format d'entrée |
|---|---|---|
| $flow.company_name | Capture le nom de l'entreprise qui sera utilisé de manière dynamique dans l'invite de salutation. | chaîne |
Pour configurer les paramètres d'entrée de ce composant, développez cette section pour obtenir des instructions.
- Ouvrez la console Dialogflow CX.
- Choisissez votre projet Google Cloud.
- Sélectionnez votre agent.
- Sélectionnez l'onglet Compilation.
- Cliquez sur le composant importé dans la section Flux.
- Cliquez sur la page de démarrage dans la section Pages.
- Cliquez sur la route true (vraie) sur la page de démarrage.
- Dans la fenêtre "Itinéraire", modifiez les valeurs des préréglages de paramètres si nécessaire.
- Cliquez sur Enregistrer.
Paramètres de sortie
Les paramètres de sortie sont des paramètres de session qui restent actifs après la sortie du composant. Ces paramètres contiennent des informations importantes collectées par le composant. Ce composant prédéfini fournit des valeurs pour les paramètres de sortie suivants:
| Nom du paramètre | Description | Format de sortie |
|---|---|---|
| ani_auth | Ce paramètre capture le résultat de l'authentification basée sur l'ANI. Par défaut, la valeur est "false". | booléen |
| auth_level | Indique le niveau d'authentification de l'appelant. Par défaut, la valeur est nulle. -1 indique que l'utilisateur n'a pas été authentifié par son ANI. 0 indique que l'authentification ANI a réussi. | entier |
Configuration de base
Pour configurer ce composant prédéfini:
- Importez le composant prédéfini.
- Configurez le webhook flexible fourni avec vos services externes. Pour ce faire, consultez la section "Configuration du webhook" ci-dessous.
Configuration du webhook
Pour utiliser ce composant, vous devez configurer les webhooks flexibles inclus afin de récupérer les informations nécessaires à partir de vos services externes.
Obtenir les détails du compte
Le webhook prebuilt_components_greeting:get_account_details est utilisé par le composant pour identifier l'appelant à l'aide de son ANI. Si le numéro de téléphone de l'appelant existe dans le service externe configuré, les informations pertinentes pour personnaliser l'expérience sont récupérées, y compris le nom et l'adresse e-mail de l'appelant.
Paramètres de requête de l'API
Les paramètres suivants sont fournis par le composant en tant qu'entrées de la requête API.
| Nom du paramètre | Description | Format de sortie |
|---|---|---|
| phone_number | Numéro de téléphone de l'appelant (ANI) | entier |
Paramètres de réponse de l'API
Les paramètres suivants sont extraits de la réponse de l'API pour être utilisés par le composant.
| Nom du paramètre | Description | Format de sortie |
|---|---|---|
| user_first_name | Prénom de l'utilisateur final, utilisé pour envoyer un message d'accueil personnalisé. | chaîne |
Pour configurer le webhook "Get Account Details" (Obtenir les informations du compte) pour ce composant, développez la section pour obtenir des instructions.
- Ouvrez la console Dialogflow CX.
- Choisissez votre projet Google Cloud.
- Sélectionnez votre agent.
- Sélectionnez l'onglet Gérer.
- Cliquez sur Webhooks.
- Sélectionnez le webhook prebuilt_components_greeting:get_account_details.
- Remplacez l'URL dans le champ URL du webhook des agents conversationnels (Dialogflow CX) par le point de terminaison du service avec lequel vous souhaitez vous intégrer. Sélectionnez la méthode appropriée dans le menu déroulant.
- Examinez et modifiez le corps de la requête pour créer le format de requête approprié pour votre webhook.
- Examinez et mettez à jour la configuration de la réponse pour extraire des champs spécifiques de la réponse de votre webhook. Ne modifiez pas les noms des paramètres, car ils sont requis par le composant pour accéder aux valeurs des champs renvoyées.
- Examinez et modifiez les paramètres Authentification si nécessaire.
- Cliquez sur Enregistrer.
Terminé
Votre agent et son webhook devraient maintenant être configurés et prêts à être testés.