Composant prédéfini de salutation

Le composant prédéfini "Greeting" (Message d'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 communes aux composants prédéfinis, ce composant prédéfini présente les limites suivantes :

• Le composant suppose que les numéros de téléphone des clients sont conservé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 contacter l'entreprise ne seront pas authentifiés par ce composant.

Exemples de dialogues

Les exemples de dialogues suivants illustrent des scénarios courants gérés par ce composant prédéfini. Ils montrent le comportement lorsque le composant est appelé par téléphone, ce qui déclenche l'intent de bienvenue 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 de l'appelant et reçoit un message d'accueil personnalisé.

Entrée utilisateur	Réponse de l'agent
	Bonjour [prénom de l'appelant]. Merci d'avoir contacté [nom de l'entreprise]. Nous nous engageons à vous aider à gérer vos finances. Comment pouvons-nous vous aider aujourd'hui ?

Utilisateur final non identifié

Le numéro de l'appelant n'est pas identifié et l'utilisateur final est accueilli avec le message d'accueil standard.

Entrée utilisateur	Réponse de l'agent
	Merci d'avoir contacté [nom de l'entreprise]. Nous nous engageons à vous aider à gérer vos finances. 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 :

Fonctionnalité	Format	Exemple
Flow	[Nom du composant]	Greeting
Paramètre	[nom_param]	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. Ils seront utilisés par une ou plusieurs conditions dans le flux pour déterminer le comportement du composant. Les paramètres à portée de flux doivent être définis sur la page d'accueil du composant, comme décrit ci-dessous. Les paramètres de portée session peuvent être définis par un flux appelant 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 "Greeting" (Message d'accueil).	chaîne

Pour configurer les paramètres d'entrée de ce composant, développez cette section pour obtenir des instructions.

1. Ouvrez la console Dialogflow CX.
2. Choisissez votre projet Google Cloud.
3. Sélectionnez votre agent.
4. Sélectionnez l'onglet Build (Créer).
5. Cliquez sur le composant importé dans la section Flows (Flux).
6. Cliquez sur la page de démarrage dans la section Pages.
7. Cliquez sur la route true (Vrai) sur la page de démarrage.
8. Dans la fenêtre "Route" (Route), modifiez les valeurs des Parameter Presets (Préréglages des paramètres) si nécessaire.
9. Cliquez sur Save (Enregistrer).

Paramètres de sortie

Les paramètres de sortie sont des paramètres de session qui restent actifs après la fermeture du composant. Ils 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" (faux).	booléen
auth_level	Indique le niveau d'authentification de l'appelant. Par défaut, la valeur est "null" (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 :

1. Importez le composant prédéfini.
2. Configurez le webhook flexible fourni avec vos services externes. Pour en savoir plus, consultez la section Configurer le webhook ci-dessous.

Configurer le 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 informations 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 la requête 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 la réponse 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 fournir un message d'accueil personnalisé.	chaîne

Pour configurer le webhook "Get Account Details" (Obtenir les informations du compte) pour ce composant, développez cette section pour obtenir des instructions.

1. Ouvrez la console Dialogflow CX.
2. Choisissez votre projet Google Cloud.
3. Sélectionnez votre agent.
4. Sélectionnez l'onglet Gérer.
5. Cliquez sur Webhooks.
6. Sélectionnez le webhook prebuilt_components_greeting:get_account_details.
7. Remplacez l'URL dans le champ URL de webhook de Dialogflow CX par le point de terminaison du service que vous souhaitez intégrer. Sélectionnez la Method (Méthode) appropriée dans le menu déroulant.
8. Vérifiez et mettez à jour le Request body (Corps de la requête) pour former le format de requête approprié pour votre webhook.
9. Vérifiez et mettez à jour la Response configuration (Configuration de la réponse) pour extraire des champs spécifiques de la réponse de votre webhook's response. Ne modifiez pas les noms des paramètres, car ils sont requis par le composant pour accéder aux valeurs des champs renvoyés.
10. Vérifiez et mettez à jour les paramètres d'Authentication (Authentification) si nécessaire.
11. Cliquez sur Save (Enregistrer).

Terminé

Votre agent et son webhook doivent maintenant être configurés et prêts à être testés.